Upgrading the WebSphere application server for version 8.8

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.
Important: Before starting this task, back up your application server.
To upgrade the WebSphere application server for NexJ CRM version 8.8:
  1. Optional: If the current JDK installed on your application server is not supported by NexJ, or if you are running additional NexJ applications, such as push redirector or the Eclipse information center, then you need to install a supported version of the JDK. Update the JAVA_HOME system variable to reflect the location of the JDK.
    Note: A standard WebSphere environment only running NexJ CRM can use the pre-installed JDK and the JAVA_HOME system variable does not need to be set.
  2. Install the correct version of the WebSphere application server.
  3. Copy the correct version of the JDBC driver to the following directories. You must specify the path in your environment file, for example, as path="jtds-1.2.2-7.jar".
    File to copy Copy to directory
    jtds-1.2.2-7.jar or ojdbc6-11.2.0.3.jar

    %JAVA_HOME%\jre\lib\ext

    jtds-1.2.2-7.jar or ojdbc6-11.2.0.3.jar

    %WAS_ROOT%\lib\ext

    jtds-1.2.2-7.jar or ojdbc6-11.2.0.3.jar

    %WAS_ROOT%\nexj\lib

    Note: When you update the server or environment file for your deployment using NexJ Studio, update the location settings to reflect the correct driver path.
  4. For each node in the cluster, copy the following files from the %NEXJ_PLUGIN% directory to the %WAS_ROOT% directory.
    File to copy Copy to directory
    %NEXJ_PLUGIN%\nexj-websphere.jar

    %WAS_ROOT%\lib\ext

    %NEXJ_PLUGIN%\nexj-boot.jar

    %WAS_ROOT%\nexj\lib

    Note: If you are configuring nexj-websphere.jar in WebSphere as a shared library instead of copying it to the WAS_ROOT\lib\ext folder, you should configure WebSphere as follows:
    1. In WebSphere, configure the shared library settings by expanding Environment and selecting Shared Libraries.
    2. Associate the shared library with the server by expanding Servers and selecting Application Servers. Select Server Infrastructure > Java and Process Management > Class loader. If a class loader does not exist, create one and under Additional Properties click on Shared library references.
    3. Configure the Resource Adapter settings by selecting Applications > All applications > NexJ Dynamic Resource Adapter > Additional Properties > Resource Adapter. Configure the jar files in Shared Libraries under Class path.
    4. Clean all of the transaction logs for the server used to run your application.
    5. Start the server.
The WebSphere application server is updated for NexJ CRM version 8.8.