How does an Eclipse user change their OS password using Eterm?

View a step-by-step screencast of this process:

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?

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 install the Solar client?

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:

The installation URL will look similar to: http://192.168.0.100:2080/

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:

http://172.17.188.36:2080/SolarInstallService.jnlp

How do I install or update the RealPort drivers for my Digi PortServer on Linux?

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:

rpm -e dgrp

Download the latest drivers, for example:

mkdir -p /esupport/digi && cd /esupport/digi
wget -c http://ftp1.digi.com/support/driver/40002086_AA.src.rpm

Download and install the Red Hat kernel source:

yum -y install kernel-headers-`uname -r` kernel-devel-`uname -r` rpm-build gcc ncurses-devel

Compile the drivers:

rpmbuild --rebuild /esupport/digi/40002086_Z.src.rpm

Install the drivers:

rpm -Uvh /usr/src/redhat/RPMS/x86_64/dgrp-1.9-39.x86_64.rpm

OR

rpm -Uvh /root/rpmbuild/RPMS/x86_64/dgrp-1.9-39.x86_64.rpm

Edit udev to set permissions for tty devices:

vim /etc/udev/rules.d/10-dgrp.rules

Locate the “tty_dgrp” entry, and modify it as displayed below:

KERNEL=="tty_dgrp*", PROGRAM="/usr/bin/dgrp_udev %k", NAME="%c", GROUP="lp", MODE="0666", OPTIONS="last_rule"

Adding Digi Ports to Linux

If this is a new Digi, setup the ports in the following manner:

dgrp_cfg_node init (ttyid) (ip_address) (number_of_ports)

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:

vfxadmin class -d -a modem1 fax1

How do I add a user in AIX?

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.
ln -sf /u2/eclipse/.profile /home/johndoe/.profile
  • 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.