Configuring WebSphere Liberty in GRS 9.0

Support for Java 8 in GRS release 9.0 means that previous WebSphere versions supported in Java 7 are not available. The only WebSphere available for Java 8 is WebSphere Liberty. Verification has been performed using version 8.5.5.7.

Configuring WebSphere Liberty to Run GRAT and GRE

1. Set the JAVA_HOME and PATH environment variables. These are used by the ./server command.
2. Create the Liberty server by navigating to [WAS Liberty Home]/bin and executing the command ./server create grs.
3. Navigate to [WAS Liberty Home]/usr/servers/grs and create a directory called ExternalLibs. Copy the JDT core .jar file to ExternalLibs from [WAS Liberty Home]/lib. The .jar file should be similar to com.ibm.ws.org.eclipse.jdt.core.[version].jar.
4. If GRAT is configured to use a database via a configuration Data Access Point, add the appropriate drive .jar in the ExternalLibs directory created above. Otherwise skip this step. For example, if using the PostgreSQL database, add a driver file like postgresql-[version].jdbc4.jar to the ExternalLibs directory.
5. Navigate to the [WAS Liberty Home]/usr/servers/grs directory and edit the server.env file to add JAVA_HOME. For example, if JAVA_HOME is /usr/java8_64, then add this line at the end of the file:

JAVA_HOME=/usr/java8_64

6. Create file jvm.options in directory [WAS Liberty Home]/usr/servers/grs to set the JVM memory parameters—Genesys recommends using the information here to tune performance for GRE and GRAT.
7. Update the server.xml file (the server configuration file at [WAS Liberty Home]/usr/servers/grs) thus:
1. Add <webContainer deferServletLoad="false"/> under the <server> element.
2. Add <applicationMonitor updateTrigger="disabled" /> under the <server> element.
3. Add host="*" attribute to the httpEndpoint element if you want any hosts to be able to access this application.
4. Add the following application elements under the root element (that is, the <server> element):

<!-- GRAT Application: IMPORTANT! Remove classLoader element in below Application if not using an external database otherwise replace "[database driver file]" with the appropriate driver file name -->
<application context-root="genesys-rules-authoring" type="war" id="genesys-rules-authoring"
       location="genesys-rules-authoring.war" name="genesys-rules-authoring">
       <classloader>
            <privateLibrary>
                       <file name="ExternalLibs/[database driver file].jar" id="databasedriver"></file>
                </privateLibrary>
        </classloader>
</application>
<!-- GRE Application: IMPORTANT! Replace "[JDT core jar file name]" with the file name -->
<application context-root="genesys-rules-engine" type="war" id="genesys-rules-engine"
       location="genesys-rules-engine.war" name="genesys-rules-engine">
       <classloader>
            <privateLibrary>
                       <file name="ExternalLibs/[JDT core jar file name].jar" id="jdt"></file>
                </privateLibrary>
        </classloader>
</application>

Important
Make sure <featureManager> has only <feature>jsp-2.2</feature> and nothing else. Adding any other feature might interfere with the already existing libraries in the application.
8. For GRAT:
1. Create directory genesys-rules-authoring.war under [WAS Liberty Home]/usr/servers/grs/apps directory.
2. Extract the contents of the genesys-rules-authoring.war file into genesys-rules-authoring.war directory. Navigate to genesys-rules-authoring.war directory and execute command jar -xvf [Path to GRAT .war].
9. For GRE:
1. Create directory genesys-rules-engine.war under [WAS Liberty Home]/usr/servers/grs/apps directory.
2. Extract the contents of the genesys-rules-engine.war file into genesys-rules-engine.war directory. Navigate to genesys-rules-engine.war directory and execute command jar -xvf [Path to GRE .war].
10. Start the server by navigating to [WAS Liberty Home]/bin and executing EITHER command ./server run grs OR command ./server start grs.