Updating the Java Runtime Environment (JRE) in an Unwired Orchestrator (UO) 4.3 installation

This document provides the instructions for how to download, install, and update to JRE version 1.4.2 for an Unwired Orchestrator (UO) 4.3 installation. This information covers patching the JRE for following issue:

• U.S. Daylight Saving Time Changes in 2007 in Java

Sun has identified an issue that must be addressed in their Java Runtime Environment code. The JRE has been updated to reflect the changes to the effective dates for Daylight Saving Time. To address these changes in UO 4.3, replace the old JRE with the newly updated version.

UO 4.3 was delivered with JRE 1.4.1, and Sun has provided an upgraded 1.4.2 JRE. No functionality was deprecated between the versions creating a less invasive migration.

Note

1. Make sure you backup your current files before applying the JRE patch.
2. The location where Unwired Orchestrator has been installed is referred to as NNSY_ROOT in this document. (For example: NNSY_ROOT could be C:\Sybase\Orch-4_3).

Follow these instructions to install the upgrade:

1. Stop all UO 4.3 processes
2. Install the JRE patch into NNSY_ROOT on the UO 4.3 server. Use the directions for your platform in these links:
   • Windows: http://java.sun.com/j2se/1.4.2/download.html (J2SE v 1.4.2_13 JRE )
   • AIX: http://www-128.ibm.com/developerworks/java/jdk/aix/service.html (Java 1.4.2 32-bit)
   • Keep the original JRE in place – do not delete.
3. Follow these steps to update the path to the new JRE for each file listed below:
   
   NNSY_ROOT/bin/AgentLauncher
   NNSY_ROOT/bin/NNGetmsg
   NNSY_ROOT/bin/NNPutmsg
   NNSY_ROOT/bin/bt58daemon
   NNSY_ROOT/bin/clagent
   NNSY_ROOT/bin/ioutil
   NNSY_ROOT/bin/psget
   NNSY_ROOT/bin/psmigrate
   NNSY_ROOT/bin/psput
   NNSY_ROOT/bin/psutil
   
   
   1. Replace the reference to the old JRE library with a reference to the new JRE library
      
      
      • Windows example: AgentLauncher.cmd
      • From PATH=%NNSY_ROOT%\bin;%NNSY_ROOT%\bin\.bin;%NNSY_ROOT%\asa;%NNSY_ROOT%\j2re1.4.1_01\bin\client;%PATH%
      • To PATH=%NNSY_ROOT%\bin;%NNSY_ROOT%\bin\.bin;%NNSY_ROOT%\asa;%NNSY_ROOT%\j2re1.4.2_13\bin\client;%PATH%
      
      
   2. Add the following line to all the files listed above
      
      LDR_CNTRL=MAXDATA=0x40000000@USERREGS
      
      
      • For Windows before the first "set" statement.
      • For UNIX before the first “export” statement.
      
      
4. Restart the UO 4.3 processes