If you need to change your Eclipse user’s OS password (the one entered at the “white” Eterm login screen):
Log into Eterm
Select F2-System
Select TCL
At the TCL prompt (; semicolon), type sh and hit ENTER
At the user’s shell prompt ($ dollar sign), type passwd and hit ENTER
Follow the prompts to set your new password
When finished, type exit to exit the shell.
Hit ESC to exit TCL mode
If your new password is not being accepted, you may be violating your company’s password policy by attempting to set a password that is too short or based on a dictionary word. You will need to contact your system administrator to set your password or relax the password restrictions. If you would like your Eterm users to have no OS password, please see How do I set a blank user password in Linux?
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):
The Solar client is installed directly from your application server using Java. The only prerequisite is Java 6, which you can find on the web start page below.
To access the server, you will need to know the correct web start URL to enter in your web browser. To assemble this, you will need to know two pieces of information:
To install Solar, navigate to the URL using the web browser of your choice and click the Click Here to Install Solar Eclipse button.
If you receive an error, make sure that Java 6 is installed. If not, use the Click Here to Install Java link to install the appropriate version of Java. You will need administrator privileges to install Java, but not Solar.
Solar is a Java Webstart application, so it is installed on a per-user basis, not a per-workstation basis like Eterm. The benefit is that all users, even non-administrator users, can install Solar. The downside is that you cannot load Solar one time for all users of the workstation. You may, however, create a normal Windows shortcut to the Solar URL, which will allow users to click a single link to launch Solar, regardless of whether it was previously installed or not.
To give users a direct link from which to install or launch Solar, you may send a hyperlink or create shortcut directly to the web start URL. To obtain this URL, right-click on the Click Here to Install Solar Eclipse link and copy the URL. The URL should be similar to to following:
To use the Digi PortServer, you’ll need to install the appropriate RealPort drivers for your kernel.
Additionally, any time the kernel is upgraded, you’ll need to recompile and reinstall the drivers. As such, it is important to plan your kernel upgrades in advance and perform testing after the first boot using a new kernel.
Screencast
Installing or Upgrading the Digi RealPort Drivers
If the drivers are already installed, uninstall the existing drivers:
Example (change the IP address and number of ports to match your device):
dgrp_cfg_node init D 192.168.100.111 1
Starting the Digi Service
When the drivers have been installed, and the ports have been configured, start the Digi service to activate the serial ports:
service dgrp_daemon restart
Adding Digi Ports to VSI-FAX
If you are configuring VSI-FAX for the first time, or if you’re adding a new fax modem to your environment, you’ll need to make VSI-FAX aware of the new modem’s serial port location. For example, to create a new modem called modem1 at the serial port location /dev/ttyD00:
vfxadmin device -a -d -v /dev/ttyD00 modem1
After adding the modem to VSI-FAX, you will also need to add the modem to the default fax “pool” or class. To add the new modem1 to the default fax “pool” named fax1:
As with every command entered when performing system administration tasks from a command line, syntax is important. Please make sure that every character is entered exactly as shown below. To avoid common syntactical mistakes, we recommend you copy and paste the entire example commands into a text editor, make the necessary changes, and then paste the resulting commands into your terminal session.
NOTE: in the example below, we are adding a user with the username “johndoe.” Replace “johndoe” with the username you wish to add to the system.
Log into your server as root
Create a new user that’s a member of the “eclipse” user group:
mkuser johndoe
Set the user’s Linux login password:
passwd johndoe
NOTE: if you attempt to set a weak password, you may see a warning. If you are willing to accept using a weak password, simply type it in again and confirm to proceed. If you would like to create a user with a blank password, please see this article.
Create a link for the user’s profile, which will automatically launch Eclipse when they login:
Important: please verify that the order of arguments in the command is correct: /u2/eclipse/.profile must come first, followed by a space, and then the new user’s profile directory.
Important: please note there is a space between the source and destination locations.
Open Eterm and log into the server using the newly created username and password. If you added the user correctly, you will be presented with the blue Eclipse login screen.
Troubleshooting
If you are presented with a prompt to update the directory’s VOC, modify the /u2/eclipse/.profile file as root, adding the following block of code before the “Setup the Eclipse environment” section:
# Move to the Eclipse account home directory
export ECLIPSEHOME=/u2/eclipse
cd $ECLIPSEHOME
If you’re still not able to log in using the new user’s credentials, please open a support request, and the Eclipse support team will provide assistance.