Jump to: navigation, search

Deploying GRE in Genesys Administrator


To install GRE on Configuration Servers 8.1.0 or later, Genesys Administrator 8.1.0 or later is required.

Procedure Summary

  1. Import the installation package into Genesys Administrator.
  2. Install the GRE IP.
  3. Configure the Rules Engine application.


Import the installation package into Genesys Administrator.

  1. On the Deployment tab of Genesys Administrator, select Import.
  2. Select Installation CD-ROM.
  3. Click Next.
  4. Browse to the MediaInfo.xml file on the CD or the CD image location on the network (the path must be in UNC format).
  5. Click Next.
  6. To import the installation package, select GRE for your operating system as well as the appropriate type in the list:
    • For Management Framework 8.1, the type is Business Rules Execution Server.
    • For Management Framework 8.0 and earlier, the type is Genesys Generic Server.
  7. Select Next to start the import.
  8. Click Finish when the import is complete.

Install the GRE IP

  1. Select the Deployment tab in Genesys Administrator. The list of installation packages will now display GRE.
  2. Right-click and select Install Package for the IP for your operating system and type.
  3. Click Next to start the installation wizard. The following parameters must be defined/selected:
    1. Application Name for the GRE application
    2. Target Host—The host to which the .war file will be copied during the installation procedure.
    3. Working Directory—The directory in which the .war file will be created.
    4. Client Side IP Address (optional).
    5. Client Side Port (optional).
    6. Configuration Server hostname.
    7. Configuration Server port.
    8. Important
      For a secure connection, the Configuration Server port should be of type Auto Detect (Upgrade).
    9. Connection delay time in seconds
    10. Reconnect Attempts.

Configure the Rules Engine application

  1. In the [Server Info] section, verify the default listening port, as well as the connector port on which the Rules Engine Servlet receives requests:
    • The ID value is the name of the Rules Engine web application. The default name of this application is genesys-rules-engine.
    • The Listening port is the connector port of the servlet container. For example, on Tomcat the default listening port is 8080.
    • The Connection Protocol must be http.
  2. On the Tenants tab, add the Tenants that will be available to the Rules Engine.
  3. On the Connections tab, add a connection to Message Server if you want to use network logging.
  4. On the Options tab, configure options. In addition to the standard logging options that you can configure, you can configure an option named fileEncoding in the [log] section. fileEncoding specifies the encoding that is to be used during creation of the log file, for example, UTF-8. This value is optional. If you do not specify this option, the server's locale information will determine the log file encoding. This option is available for both GRE and GRAT. Also, the log4j2.xml file that is included in both components supports a similar option, log4j.appender.runtime.Encoding. The log4j2.xml file is used for initial log configuration prior to the reading of the log configuration from the Configuration Server database.
  5. There are several optional configuration options to work with in the Configuration Options Reference Guide.
  6. Save your changes.

Next Steps

Deploy the genesys-rules-engine.war file to your application server. See Deploying the .WAR files.

This page was last edited on May 17, 2022, at 09:17.
Comments or questions about this documentation? Contact us for support!