Upgrading the JBoss application server for version 8.8

To upgrade the JBoss application server, include the latest version of the NexJ-specific files on the server. Then, ensure that you have the version of the application server, Java, and JDBC driver, as indicated in the Release Notes document for your product.
Important: Before starting this task, back up your application server.
To upgrade the JBoss application server for NexJ CRM version 8.8:
  1. On the application server, install the correct version of the JDK.
  2. For Windows instances, update the JAVA_HOME system variable to reflect the location of the JDK. For Linux instances, set JAVA_HOME in the ~.bashrc file.
  3. Ensure that the latest supported version of the JBoss application server is installed, including the latest supported version of the Apache Log4j utility.
  4. Copy the correct version of the JDBC driver, such as jtds-1.2.2-7.jar or ojdbc6-11.2.0.3.jar, to the %JBOSS_HOME%\server\projectdir\lib directory and remove any old versions. The JDBC driver also needs to be copied to the %JAVA_HOME%\jre\lib\ext directory.
    Note: When you update the server or environment file for your deployment using NexJ Studio, ensure that the Path field in the Data Source Connections tab contains the correct version of the JDBC driver. For example, jtds-1.2.2-7.jar.
  5. For each node in the cluster, copy the following file from the %NEXJ_PLUGIN% directory to the %JBOSS_HOME% directory.
    File to copy Copy to directory
    %NEXJ_PLUGIN%\nexj-boot.jar %JBOSS_HOME%\lib
  6. Ensure that the memory allocation parameters are set to the latest recommended values.
    Update the JAVA_OPTS variable in the %JBOSS_HOME%\bin\run.conf.bat file to the following recommended values:
    Note: The heap space values in the following table are examples. They are dependent on your specific environment, and factors that include the number of concurrent users, and number of nodes in your server cluster.
    Table 1. Recommended JVM memory parameter values
    Java option description Recommended value Java option code
    Maximum heap space 2048 MB -Xmx2048m
    Minimum heap space 2048 MB -Xms2048m
    Maximum permanent generation (permgen) space 256 MB -XX:MaxPermSize=256m
    Minimum permanent generation (permgen) space 256 MB -XX:PermSize=256m
    Default stack size 8192 KB -Xss8192k
    Default thread stack size 8192 KB -XX:ThreadStackSize=8192k
    The updated set JAVA_OPTS line in the run.conf.bat file should look similar to the following:
    set "JAVA_OPTS=-Xms2084m -Xmx2084m -XX:PermSize=256m -XX:MaxPermSize=256m -Xss8192k -XX:ThreadStackSize=8192k"
The JBoss application server is updated for NexJ CRM version 8.8.
Note: Before deploying your application, you must configure the application server to use standards-compliant TCP stacks. See Configuring TCP on application servers.