Jump to: navigation, search

Deploying Genesys Administrator Extension

This page describes how to install and deploy Genesys Administrator Extension. Before beginning your installation, ensure that you have met the prerequisites listed in Prerequisites. If you plan to install any of the modules in Genesys Administrator Extension, refer to Prerequisites for Genesys Administrator Extension Modules before using them.

Genesys Administrator Extension can be deployed via Setup Mode or the command line.

  • Although Configuration Server might support more database types, GAX only supports the following database types: Oracle, Microsoft SQL Server, and PostgreSQL.
  • Although Management Framework supports various operating systems, GAX can only deploy Configuration Server and Database Server on Windows Server 2003/2008/2012 or Red Hat Enterprise Linux 5.5/6.x. See Prerequisites for more information on operating systems that are supported by GAX.

Deploying Genesys Administrator Extension via Setup Mode

Setup Mode can set up new instances of GAX to connect to an existing Management Framework deployment. You can also use Setup Mode to install and configure new Genesys deployments. In the latter scenario, Setup Mode will install GAX, Configuration Server, and Database Server (where applicable). After these components are installed, you can use the installation package (IP) management features of GAX to deploy other installation packages.

To access Setup Mode, you must be a local user on the machine upon which GAX will be installed. You are considered a local user if you are using this machine in person or via a remote desktop connection.

The following table describes how to deploy GAX via Setup Mode.

<multistep> Set up the database= Choose one of the following database types:


[+] Click to show section

Microsoft SQL

[+] Click to show section


[+] Click to show section

|-| Set up the host=

Procedure: Setting up the host for Genesys Administrator Extension server


  1. If Java Server JRE 6 or 7 is not already installed on the host machine where Genesys Administrator Extension will be installed, install it now by downloading it from the following website:


    Refer to the Oracle documentation for more information on how to install the tar.gz package.

  2. Important
    GAX only supports the 64-bit version of Oracle Java HotSpot Server VM.
  3. Set the following environment variables for your host, as follows:
    1. Linux

      Insert the following lines into the /etc/profile file:

      • export JRE_HOME=/usr/lib/java/jre-<version of Java downloaded>/jre
      • export PATH = $PATH: /usr/lib/java/jre-<version of Java downloaded>/jre/bin
      Log out and log in again to activate the new environment variables in the current session.
    2. Windows
      • Create a new System Variable named JRE_HOME and use the path that was used during installation as the value (for example, C:\Programs\Java\jre1.6.0_23).
      • Edit the Path variable and append C:\Programs\Java\jre1.6.0_23\bin to the existing value.
  4. Install Local Control Agent on this host. For detailed instructions, refer to the Framework Deployment Guide.

|-| Install the GAX server on a host=


[+] Click to show section


[+] Click to show section

|-| Deploy GAX=

Deploy GAX (Existing Management Framework Deployment)

[+] Click to show section

Deploy GAX or Later and Management Framework 8.5.x/8.1.x

[+] Click to show section

Deploy GAX or Earlier and Management Framework 8.1.x

[+] Click to show section

|-| Add SCS Connection= GAX must have a connection to Solution Control Server (SCS) for the System Dashboard to function.

Procedure: Adding a Connection to SCS from GAX


Solution Control Server is installed and configured.


  1. In GAX, go to Configuration Manager.
  2. Hover over the Environment icon and select Applications in the pop-up list.
  3. In the Applications list, open the Application object for GAX.
  4. In the GAX Application object details window, click the Connections tab.
  5. Click Add.
  6. In the pop-up window, enter information about the connection to SCS. Refer to the procedure "Creating Application Objects" on the Applications page for more information.
  7. Click OK.
  8. Click Save.
  9. Restart GAX.


Deploying GAX via the Command Line

You can also deploy GAX (with or without Management Framework) via the command line by using a setup file to provide deployment instructions. This feature is useful for situations in which you cannot access the GAX host via a remote desktop connection.

Choose a procedure below.

[+] Deploy GAX into existing Management Framework deployment

[+] Deploy GAX and Management Framework

This page was last edited on July 17, 2020, at 15:53.
blog comments powered by Disqus