Installing Genesys Administrator Extension Server on a Linux Host

Prerequisite: The environment variable for JRE_HOME has been configured (see Step 2 of Setting up the Host for Genesys Administrator Extension Server).

  1. Copy the installation package (IP) to the host machine.
  2. Navigate to the folder to which you copied the IP, and change the permissions of the installation file by entering the following command:
    chmod 755 install.sh
  3. Run the installation file to extract and copy the necessary files by entering the following command:
    ./install.sh

  4. Note: When you install Genesys Administrator Extension, you might receive the following error message that indicates that installation was unsuccessful:
    Unable to find configuration information. Either you have not used configuration wizards and the GCTISetup.ini file was not created or the file is corrupted.
    Ignore this message; Genesys Administrator Extension was installed successfully.
  5. Navigate to the folder in which you installed GAX and run the gax_startup.sh file.

Note: The GAX installer creates a setenv.sh file that enables you to adjust the memory settings for GAX. The setenv.sh file defines the memory (RAM) settings for GAX to 1024 MB. You can change the memory setting in the setenv.sh file to a different value. If you enable TLS encryption, ensure that you make the following updates to the setenv.sh file. The setenv.sh file contains the following lines:

# Uncomment the following lines only if you are going to use TLS. Don't forget to set the correct path and password.
#export JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStore=/path_to_jre/jre6/lib/security/cacerts"
#export JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStorePassword=secret_password"

# This line defines the memory (RAM) settings for GAX. If you have more RAM available for GAX, adjust both values accordingly
export JAVA_OPTS="$JAVA_OPTS -Xms1024m -Xmx1024M"

# Uncomment following line to activate psdk.logs, it's recommended to let this option deactivated
#export JAVA_OPTS=%JAVA_OPTS% -Dcom.genesyslab.platform.commons.log.loggerFactory=com.genesyslab.platform.commons.log.Log4JLoggerFactoryImpl
# Enable this option for SSL Debugging
#export JAVA_OPTS=%JAVA_OPTS% -Djavax.net.debug=all
Follow the instructions in the first line by uncommenting the indicated lines below it and setting the path and password.
You must create a trust store and set the trust store path accordingly. Refer to the Genesys Administrator Extension 8.1.4 Deployment Guide for more information.