How do I use PuTTY with my Eclipse server?

  • Download and run putty.exe
  • Enter your server’s Host Name (or IP address)
  • Select either SSH (preferred, secure, works some AIX servers and all RHEL servers) or Telnet (insecure, works with all Eclipse servers)
  • Optionally, you may give the session a name and Save for future connections
  • Select Open to launch the telnet/ssh session
  • Enter your root login credentials

How do I cancel faxes in the VSIFAX queue?

Many times it’s quicker to cancel faxes from the VSI-FAX queue in AIX, Linux or Windows instead of from the Eclipse outgoing fax status queue.

To cancel all faxes for a certain user (for example, johndoe):

vfxcancel -u johndoe "*"

To locate the job number and cancel a single fax (for example, job number 1234):

vfxstat
vfxcancel 1234
For more information on the many VSIFAX administration command functions, see the VSI-FAX Reference Addendum.

How to Purge the Outgoing Fax Queue

If the outgoing fax queue has old and/or stale information, it may be necessary to purge this queue.  To do this, open two separate sessions: one Eterm session logged into the Eclipse application, and an SSH root session. This is an advanced procedure, so proceed at your own risk or call Eclipse for assistance. This should be done after all valid faxes have gone out as it will clear EVERYTHING in the outgoing queue.

From Eterm’s main menu, press F2 -> T (TCL)
At the ; prompt, type in this command:

;clear.file.real fax.queue

After you hit ENTER, the session will most likely hang for a while, because there will be a lock on the file. Now, from the root session, find the Process ID for FAX.FEEDBACK3 with this command:

ps -ef | grep FAX

The Process ID (PID) will be the first set of number on the line with FAX.FEEDBACK3. For example:

[root@eclipse enp]# ps -ef | grep FAX
eclipseB  7248 29271  0 11:32 ?        00:00:01 phantom PHW FAX.FEEDBACK3
root     11469  7149  0 11:57 pts/2    00:00:00 grep FAX

Kill that process with this command:

kill -4 7248

The outgoing fax queue should now be clear and the fax feedback phantom should automatically start within 1 minute.

Type “exit” to close the root session and hit “ESC” to exit the TCL screen.

How do I add or change a VSI-FAX modem?

Identifying the Serial Port

Before adding or changing a modem, verify the port name.

On Linux, you can typically get a list of serial ports using:

ls -l /dev/tty*

On AIX, you can get a list of the serial ports using:

lsdev -Cc tty

Once you have identified the appropriate serial port, you may continue with adding or changing the modem(s) in VSI-FAX.

If you are having difficulty identifying the serial port device name(s), please refer to the manufacturer’s documentation or contact your support provider.

Adding a New Modem

To add a modem, use the following command, where /dev/ttyACM1 is the new modem’s serial port, modem2 is the name we’d like to give the VSI-FAX modem, and fax1 is the name of the VSI-FAX modem pool and Eclipse fax device:

vfxadmin device -a -d -v /dev/ttyACM1 modem2
vfxadmin class -d -a modem2 fax1

To verify that the change is in place:

vfxstat -a

Modifying an Existing Modem

To change a modem’s port on either Linux or AIX, use the following command (where /dev/ttyD00 is the existing modem’s new serial port, and modem1 is the name of the VSI-FAX modem you’re updating):

vfxadmin device -u -v /dev/ttyD00 modem1

To verify that the change is in place:

vfxstat -a

How do I enable the UniRPC daemon?

Installation

  • Check /etc/services file for an existing entry:
grep 31438 /etc/services
  • If it doesn’t exist, add the necessary line to the /etc/services file manually, or using the commands below:
uvrpc           31438/tcp                       # uvNet rpc port
cp /etc/services /etc/services.`date +%Y%m%d.%H%M%S`
echo "uvrpc           31438/tcp                       # uvNet rpc port" >> /etc/services
  • Start the UniRPC daemon manually:
/u2/unishared/unirpc/unirpcd
  • The UniRPC daemon will start automatically on future boots from the main UniVerse startup script

Troubleshooting

  • Telnet to the local server on port 31438 and make sure there’s a response
[root@firestorm ~]# telnet localhost 31438
Trying 127.0.0.1...
Connected to localhost.localdomain (127.0.0.1).
Escape character is '^]'.

^]
telnet> quit
Connection closed.
  • Check for the unirpcd process
ps -ef|grep unirpcd