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.


  1. 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.
  2. Install the GRE IP. Select the Deployment tab in Genesys Administrator. The list of installation packages will now display GRE. Right-click and select Install Package for the IP for your operating system and type. 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.

    11. Important
      Items a through i will be written to the bootstrapconfing.xml file in the .war file. Any subsequent updates to the parameters will have to be made in that file.

    12. On the next screen, enter Connection ID and Connection Port for GRE.
    13. Edit the Connection port for the genesys-rules-engine connection. The Connection Port is the connector port of the servlet container. For example, on Tomcat the default listening port is 8080. The Connection Protocol can be set in the configuration part under Provisioning.
    14. Verify the previously defined installation parameters on the Deployment Summary screen.
  3. 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.
  • On the Tenants tab, add the Tenants that will be available to the Rules Engine.
  • On the Connections tab, add a connection to Message Server if you want to use network logging.
  • 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 logging 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 log4j.properties file that is included in both components supports a similar option, log4j.appender.runtime.Encoding. The log4j.properties file is used for initial log configuration prior to the reading of the log configuration from the Configuration Server database.
  • There are several optional configuration options in the settings section:
    • verify-deploy-address indicates whether to verify that the TCP address of the application that is deploying rules is that of an associated Genesys Rules Authoring Tool. The default value is true.
    • sequential-mode specifies whether to run the GRE in sequential mode. In sequential mode, no additional data can be inserted or modified after the initial data set, simplifying the GRE operations. The default value is false.
    • max-number-rule-executions specifies the maximum number of rules to be executed during a request. This option is used to detect unwanted recursions when sequential-mode is false. Once the maximum is reached, an error is reported. The default value is 10000.
    • deployed-rules-directory (which, before release 8.1.3, must be manually added if you want to assign it a value) specifies the directory in which to keep the working copy of deployed rule packages. When a package is deployed, a copy of the deployed package is placed here. When the GRE is restarted, all packages that are defined in this directory are loaded and made available for execution. Specifying a deployed-rules-directory is recommended. If deployed-rules-directory is not assigned a value, the rule packages will be placed in the WEB-INF\config sub-directory within the genesys-rules-engine web application directory. At this location the deployed rule packages may get deleted when an updated .war file is deployed.
    • esp-worker-threads (new in release 8.1.2), specifies the maximum number of worker threads available when using the ESP interface to execute rules. The default for this value is 5 threads.
  • Save your changes.
  • End

    Next Steps

    This page was last edited on June 25, 2013, at 09:14.


    Comment on this article:

    blog comments powered by Disqus