CONNX Installation Procedure - UNIX

The installation instructions for your UNIX system can be found on the Empower web site.

  1. Download the appropriate UNIX installation package from Empower to your computer.

  2.  Double-click on the installation package icon to launch the Install Shield Wizard for CONNX Client.

    installUnix_02.bmp

  3. If the target system has an FTP, SFTP or SCP server enabled, skip to step 5.
     

  4. If the target system does not have an FTP, SFTP or SCP server enabled, select the Manual Copy Installation option and click the Begin Client Installation button.  This option will create the necessary install files in the UNIXCLIENT\TEMPINST subdirectory of the CONNX installation directory.  Move these files via an alternate copy method to the Unix server and then proceed to step 11 below.

  5. Select the desired transfer method (FTP, SFTP or SCP)
     

  6. In the Server text box, enter the TCP/IP host name or address for your system platform.
     

  7. In the User ID text box, enter a privileged user account name.
     

  8. In the Password text box, enter a user account password. (The password appears as ********).

    Note: Server, User ID and Password are required fields.
     

  9. By default, the CONNX client data is sent to your home directory. If you wish to send it to another location, enter the name of the alternate directory in the UNIX Directory text box.  If the specified directory does not exist, it will be created.

  10. Click the Install button. This action starts an FTP, SFTP or SCP session and copies the selected components to the target server. The progress of the copy will be displayed in the status pane on the installer..

  11. An ftp window appears saying the files were successfully copied to the system.
     

  12. If the CONNX client is not installed, an error box appears. Select Files from the menu.  The sub menu has options to view the FTP log as well as the FTP script.  The FTP logs have a timestamp appended to the name.  Select the appropriate log file and check for errors.  If the resolution to the problem requires a call to technical support, please provide the log file as well as the script file to the support representative.

    Note: If the files fail to copy via the Client Installation's FTP, SFTP or SCP session, please use the Manual Copy Installation as outlined in step 4 above.
     

  13. Once the files are copied, a dialog box appears asking you to log on to your system and run the installclient shell script.

    Uxinst8.gif
     

  14. To run the installclient shell script, start a terminal emulator on the UNIX server and type the appropriate user name and password.  
     

  15. Type ./installclient and then press <Enter>.

    You will see a screen that gives three options. With SQL Gateway a License server is required in order to use the product. In many circumstances when a Unix Client is desired, it might be desirable to have the license server on the same machine. If this is the case, you would select option 2. If you wish to use an existing License Server, that might be running on a different machine, then select option 1. If you wish to install the License Server only, then select option 3.and then press <Enter>. Press <Enter> to install to current directory or enter a new install path at the prompt. The contents of the compressed files are unzipped to a CONNX directory in the install directory.

    installclient1.jpg


    If option 2 is selected, you will notice that it will try to install the License Server on your UNIX Machine as localhost with an address of 7501. After this installation script has been run, the License Server will be automatically invoked. In the future, you can start/stop or check the status of the License Server by invoking the script, licenseserver. This script is in the CONNX folder. The parameters to this script are [start|stop|status]. So to start the license server, you would type, ./licenseserver start. You might consider adding this to your startup script in order to have the license server running when the UNIX machine is running. The screen below shows the case where option 2 is selected.

    installclient2.jpg

     

  1. The final output should read:

CONNX UNIX 
 Client Installation Complete.
  1. To run the CONNX client, add the correct location of the registry files (64 and 32 bit) and the environment variables (CONNXREGISTRY and CONNXREGISTRY64) pointing to the correct location of the registry files to the env list. For example, add the entries:

export CONNXREGISTRY=<LocationOfRegistry>/connxreg.db
export CONNXREGISTRY64=<LocationOfRegistry>/connxreg64.db
 

 

to the startup profile of any user that runs the CONNX client application. The location of the registry is specified during the client installation or by default is the same folder in which the CONNX client is installed.

  1. Close the telnet server session.
     

  2. Click the Done button.

Important: All UNIX instructions must be entered as lowercase characters.

  1. If you installing a Unix system with a ODBC driver manager, follow the instructions in Completing CONNX Installation for UNIX ODBC Drivers.

  1. If you are installing a Unix system with a JDBC server, follow the instructions in Completing CONNX Installation for JDBC Servers.

  1. The first part of the UNIX CONNX installation process is complete. Refer to the appropriate Post-Installation Checklist to complete any additional requirements for each database you install.