Ensure that you have the version of the application
server, Java, and JDBC driver, as indicated in the Release Notes document
for your product. Then include the latest version of the NexJ-specific files
on the server.
Before starting this task, back up your application
server.
To upgrade the JBoss application server for NexJ Contact
version 6.1:
-
On the application server machine, install the correct version of
the JDK.
-
Update the JAVA_HOME system variable to reflect the location of
the JDK.
-
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-6.jar or
ojdbc6.jar, to the
%JBOSS_HOME%\server\projectdir\lib
directory, and remove any old versions.
Note: When you are updating the server or environment file for
your deployment using NexJ Studio, ensure
that the Path field in the Data
Source Connections tab points to the correct version of
the JDBC driver. For example,
jtds-1.2.2-6.jar.
-
For each node in the cluster, copy the following files from the
%NEXJ_PLUGIN% directory to the
%JBOSS_HOME% directory.
File to copy |
Copy to directory |
%NEXJ_PLUGIN%\nexj-boot.jar |
%JBOSS_HOME%\lib |
%NEXJ_PLUGIN%\nexj-jboss.jar |
%JBOSS_HOME%\common\lib |
-
For each node in the cluster, copy the following files from the
%NEXJ_PLUGIN% directory to the
%JBOSS_HOME% directory.
File to copy |
Copy to directory |
%NEXJ_PLUGIN%\core\etc\config\jboss\common\lib\0-nexj-jboss-5.2.0-EAP-fix.jar |
%JBOSS_HOME%\common\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.
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 has been updated for NexJ Contact
version 6.1.