Warning: The following procedures have been tested with specific distributions of Solaris snd Linux; consult your system documentation to ensure that these steps are correct before starting. Review the run levels (rc#.d) and sequence numbers (S# and K#) given for appropriate values. Only the system administrator should perform these changes.

Note: This section applies to Cleo Harmony and Cleo VLTrader only.

Note: This section contains numerous command line examples referring to VersaLex, VersaLexc, and VersaLexd.  Please substitute VersaLex with your specific product name (either VLTrader, or Harmony).  For example, VersaLexd in practice becomes either VLTraderd, or Harmonyd.

Note: Prior to starting VersaLex as a UNIX daemon, you can verify that VersaLex is operational using the following command from the directory where VersaLex is installed:

  ./  VersaLex c -s "service" –m 

Starting as a daemon on Solaris

1. Log in as root.
2. Change to the directory where VersaLex is installed.
3. Verify that the HRMHOME or VLTHOME variable in the VersaLexd script points to the directory where VersaLexCleo HarmonyCleo VLTrader is installed.

4. Copy the VersaLexd script to the startup/shutdown scripts directory:

   cp  VersaLex  d /etc/init.d/ . 

5. Create a symbolic link to start the VersaLex application:

   ln -s /etc/init.d/VersaLexd /etc/rc3.d/S98VersaLexd

6. Create a symbolic link to stop the VersaLex application:

   ln -s /etc/init.d/VersaLexd /etc/rc2.d/K98VersaLexd

7. Log out and reboot your system.

8. After you reboot, display the VersaLex GUI. Change to the directory where VersaLexCleo HarmonyCleo VLTrader is installed and run:

   ./VersaLex

Running as a daemon on Linux

1. Log in as root.
2. Change to the VersaLex installed directory.
3. Verify the LEXHOME or VLTHOME variable in the VersaLexd script points to the VersaLexCleo HarmonyCleo VLTraderCleo LexiCom installed directory.

4. Copy the VersaLexd script to the startup/shutdown scripts directory:

   cp VersaLexd /etc/rc.d/init.d/ . 

5. Create a symbolic link to start the VersaLex application.

   ln -s /etc/rc.d/init.d/VersaLexd /etc/rc.d/rc5.d/S98VersaLexd

6. Create a symbolic link to stop the VersaLex application:

   ln -s /etc/rc.d/init.d/VersaLexd /etc/rc.d/rc4.d/K98VersaLexd

7. Log out and reboot your system.

8. After you reboot, display the VersaLexCleo GUI. Change to the directory where VersaLex is installed:

   ./VersaLex

Starting as a daemon on systemd

1. Log in as root.
2. Change to the VersaLex installed directory.

3. Create a unit file in /etc/systemd/system/VersaLexd.service. The values you use in your unit file will vary depending on whether the Log errors and warnings in System Event/Syslog File option is enabled. See Logs for information about this option.

   If the Log errors and warnings in System Event/Syslog File option is not enabled, use the following:

   [Unit]
   Description=Start VersaLex daemon
   
   [Service]
   Type=oneshot
   ExecStart=/versalex/versalexd start
   ExecStop=/versalex/versalexd stop
   RemainAfterExit=yes
   
   [Install]
   WantedBy=multi-user.target  

   If the Log errors and warnings in System Event/Syslog File option is enabled, use the following:

   [Unit]
   Description=Start VersaLex daemon
   
   [Service]
   Type=simple
   ExecStart=/root/Harmony/Harmonyc -s service
   ExecStop=/root/Harmony/Harmonyc -s service,stop
   
   [Install]
   WantedBy=multi-user.target  

4. If stdout and stderr are not already being sent to journald, include the following in your unit file in the [Service] section:

   StandardOutput=journal
   StandardError=journal
   

5. Run systemctl enable VersaLexd.service
6. Verify the HRMHOME or VLTHOME variable in the VersaLexd script points to the VersaLex installed directory.
7. Log out and reboot your system.
8. Verify VersaLex is active.

Entropy and Linux systems

Java uses random numbers when encrypting data. In Linux, they are pulled from /dev/random, which is populated by interactions with the computer (mouse movement, keyboard presses, etc). With a Linux headless system (no interactive UI), these interactions rarely happen, which means it is more likely the Cleo Java processes will use up all the random numbers in /dev/random. In this case, calls to get a random number are blocked until there are more random numbers available and the overall effect is that the Linux machine will run slowly.

The rngd utility uses /dev/urandom to help seed /dev/random and keep it populated even when using many random numbers.

To check available entropy, use the following command:

cat /proc/sys/kernel/random/entropy_avail 

RedHat 6/CentOS 6

Use rngd to create entropy for RedHat 6/CentOS 6 systems:

Install rngd if not already present

yum -y install rng-tools 

nano /etc/sysconfig/rngd

    #include the following statement to feed urandom from random every 5 seconds 
     EXTRAOPTIONS="-r /dev/urandom -o /dev/random -t 5" 

service rngd 
start chkconfig rngd on 

RedHat 7/CentOS 7

Use rngd to create entropy for RedHat 7/CentOS 7 systems. Install rngd if not already present.

yum -y install rng-tools 

Run the following command to create service file:

systemctl start rngd 

Run the following command and edit the file as shown:

nano /usr/lib/systemd/system/rngd.service 

    #add the following statement 
     ExecStart=/sbin/rngd -f -r /dev/urandom 

systemctl daemon-reload 
systemctl start rngd 
systemctl status rngd 

Ubuntu Linux

Use rngd to create entropy for Ubuntu Linux systems. Install rngd-tools if not already present.

sudo apt-get install rng-tools

Run the following command and edit the file as shown:

sudo nano /etc/default/rng-tools 
    #add the following statement 
     HRNGDEVICE=/dev/urandom 
sudo /etc/init.d/rng-tools restart