Deploying Genesys Administrator Extension (New Deployment)
Prerequisites
- Genesys Deployment Agent (GDA) must be installed on port 5000 on the server that will run Configuration Server and Database Server.
- The installation packages for Configuration Server and Database Server are located in a location accessible to the GAX host machine.
- Connect to GAX locally by opening a supported web browser and navigating to the location of your GAX host (for example:
http://localhost:8080/gax/).
Note: Setup Mode is accessible only through a local connection. You cannot use Setup Mode if you connect remotely to the GAX host.
- Select the Username field and enter
root
. By default, there is no password.
- Click Log In.
- Choose Install a New Deployment.
- In the Installation Packages pane, provide the following information:
- Configuration Server IP Path—Enter the path to the Configuration Server installation package .zip file (Windows) or
tar.gz file (Linux). The file
must contain the ip and Templates directories.
- Database Server IP Path—Enter the path to the Database Server installation package .zip file (Windows) or
tar.gz file (Linux). The file must contain
the ip and Templates directories.
- Click Next.
- In the Configuration Server Details section, provide the following information. Some fields are populated by default values.
- Installation Path on Target Host—Enter the installation path in which to install Configuration Server.
- Primary Configuration Server Host—Enter the name of the Primary Configuration Server host.
- Port—Enter the port number for the Primary Configuration Server.
- Target Host OS Type—Select the operating system used by the target host.
Note: 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. See the Genesys Administrator Extension 8.1.4 Deployment Guide
for more information on operating systems that are supported by GAX.
- Management Port—Enter the port number for the Primary Management Port.
- Click Next.
- (Optional) Click the Install Backup Configuration Server check box to install a Backup Configuration Server.
You must provide the following information:
- (Optional) Backup Configuration Server Host—Enter the name of the Backup Configuration Server host.
- (Optional) Port—Enter the port number for the Backup Configuration Server.
- (Optional) Management Port—Enter the port number for the Backup Management Port.
- Click Next.
- In the Database Server Details section, provide the following information. Some fields are populated by default values.
- Installation Path on Target Host—Enter the installation path in which to install Database Server.
- Port—Enter the port number for the database.
- Click Next.
- In the Configuration Server Database section, provide the following information. Some fields are populated by default values.
- Database Server Type—Select the database type to be used by GAX: Oracle, PostgreSQL, or Microsoft SQL Server.
- Database Host—Enter the name of the database host.
- Port—Enter the port number for the database.
- Database Name—Enter the name of the database.
- Username—Enter the user name to use when accessing the database.
- Password—Enter the password to use when accessing the database.
Note: GAX uses default values for some deployment parameters. These default values are not presented to the user.
If you want to override these default values, you must edit the following files in the \conf directory:
- asd_hostinfo.properties
- asd_silentini_.properties
- A progress indicator displays while GAX performs the deployment. If an error occurs, an error message displays and you can either
cancel or restart the deployment process.
- Click Next.
- In the Configuration Server Details section, provide the following information.
- Administrator Extension Application Object Name—Enter the name of the GAX Application object.
- Click Next.
- In the Administrator Extension Database Details section, provide the following information. Some fields are populated by
default values.
- Database Server Type—Select the database type to be used by the GAX database: Oracle, PostgreSQL, or MS SQL Server.
- Database Host—Enter the name of the GAX database host.
- Port—Enter the port number for the GAX database.
- Database Name—Enter the name of the GAX database.
- Username—Enter the user name to use when accessing the GAX database.
- Password—Enter the password to use when accessing the GAX database.
- Click Next.
- GAX verifies the database version and creates (or updates) the database access configuration. If an error occurs, an error message displays
and you can either cancel or restart the deployment process.
- Click Finish.
- GAX restarts to finish the setup operation. When it is done, GAX displays the login screen and you can login to GAX.
Note: Setup Mode reads SQL script files from IPs and executes them on the target database through a JDBC connection.
SQL script files should follow these rules:
<Script> ::= {[<Statement>] | [<Delimiter>] | [<Comment>]}
A script consists of a sequence of statements or comments, with or without delimiters in between.
<Comment> ::= "/*"{ <any_character>} "*/"|//{ <any_character>}<Line Separator>|"--"{ <any_character>}<EOL>
A single-line comment starts with "//"
or "--"
and ends with the line.
A multi-line comment starts with "/*"
and ends with "*/"
.
< Delimiter > ::= "go"|"/"|";"
An instance of go
or /
is a strong delimiter which delimits any statements.
An instance of ;
is a weak delimiter which delimits all other statements except <CreateProcedure>
.
<Quotations> ::= '{<any_character>}'|"{<any_character>}"
Quotations can appear inside a statement. Any characters inside quotations are not treated as a statement, delimiter, or comment.
<Statement> ::= <CreateProcedure>|<SimpleStatement>
<CreateProcedure>::="CREATE PROCEDURE"|"CREATE OR REPLACE PROCEDURE"{<any_character>|<Quotations>}"go"|"/"|<EOF>
<SimpleStatement>::="INSERT"|"UPDATE"|"DELETE"|"DROP"|"CREATE"|"ALTER"|"COMMIT"|"ROLLBACK"|"MERGE"|"TRUNCATE"{<any_character>|<Quotations>}[<Delimiter>]
A create procedure statement must be specifically delimited by a strong delimiter.
A simple statement can be delimited by a delimiter, a comment, or another statement.
- All keywords are case insensitive.