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:
-
On the application server, install the correct version of the
JDK.
-
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.
-
Ensure that the latest supported version of the JBoss application
server is installed, including the latest supported version of the
Apache Log4j utility.
-
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.
-
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 |
-
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.