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_Z.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.

How do I manage Linux print queues?

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

To administer print jobs, first log into the server as root before running any of the following commands.

UniVerse Spooler Commands

  • To view the status of a UV print queue:
usa -p lp1
  • To enable a UV print queue:
usa +o -p lp1
  • To manually start the UV spooler:
cd /u2/uv
bin/usd /usr/spool/uv -t
    • To cancel print jobs from the UV Spooler:

For a specific job number:

usm -k 12345

For an entire queue:

usm -k -p lp1

Linux (CUPS) Spooler Commands

  • To view the status of all print queues:
lpc status
  • To check the status of a single print queue and view a list of pending jobs:
lpc status lp1
lpstat -P lp1
lpstat -plp1
  • To remove a single print job:
cancel lp1-1234
  • To remove all print jobs in a queue:
cancel -a lp1
  • To enable  a queue:
cupsenable lp1
  • To disable a queue:
cupsdisable lp1
  • To enable all queues:
lpstat -p | grep disabled | awk '{print $2}' | xargs cupsenable
  • To print a test job:
echo test | lpr -P lp1
  • To restart/refresh the cups service:
service cups restart

Resources

How do I add a new OS user in Linux?

Add a user from the command line

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

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:
useradd -G eclipse 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/.bash_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.
  • 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.

For step-by-step instructions with screenshots for using the graphical interface, see the official Red Hat documentation on Users and Groups