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.
- 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.
Set up the database
Choose one of the following database types:
Oracle[+] Click to show section
(Optional) Enable UTF-8 character encoding for Oracle databases
To enable UTF-8 character encoding for Oracle databases in Genesys Administrator Extension, you must ensure that:
- Configuration Server 8.1.2 or higher is installed.
- UTF-8 string encoding is enabled on Configuration Server 8.1.2 or higher.
The database character set must be set to AL32UTF8 to support the use of UTF-8 character encoding. To verify the character set, use the following SQL command:
SELECT * FROM NLS_DATABASE_PARAMETERS;
In the response, if NLS_CHARACTERSET is set to AL32UTF8, no additional actions are required. Otherwise, refer to the Oracle support guide for more information about character set migration:
Microsoft SQL[+] Click to show section
PostgreSQL[+] Click to show section
Set up the host
Install the GAX server on a host
Linux[+] Click to show section
Windows[+] Click to show section
Deploy GAX (Existing Management Framework Deployment)[+] Click to show section
Deploy GAX 8.5.000.65 or Later and Management Framework 8.5.x/8.1.x[+] Click to show section
Deploy GAX 8.5.000.58 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.
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