Sybase Business Intelligence Solutions - Database Management, Data Warehousing Software, Mobile Enterprise Applications and Messaging
Sybase Brand Color Bar
delete

Search for    in all of Sybase.com
view all search results right arrow
  blank
 
 
 
 
 
 
 
 
 
 
Support > Technical Documents > Document Types > Technote > Updating the JRE in a UO 5.1 installation.  
RSS Feed
 
 
 

Updating the Java Software Development Kit (JDK) in an Unwired Orchestrator (UO) 5.1 installation

This document provides the instructions for how to download, install, and update to the latest JDK 1.4.2 version for an Unwired Orchestrator (UO) 5.1 installation. This information covers patching the JDK for the 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 (JRE) code. The JRE has been updated to reflect the changes to the effective dates for Daylight Saving Time. The JRE is a subset of the JDK. To address this change in UO 5.1, replace the old JDK with the newly updated version.

UO 5.1 was delivered with JDK 1.4.2_06, and Sun has provided an upgraded version (1.4.2_13). No functionality was deprecated between the versions, allowing for a less invasive migration.

Note

  1. The location where Unwired Orchestrator has been installed is referred to as the UO home directory (%UO_HOME%) in this document. (For example: UO home directory could be C:\Sybase\Orch-5_1 on Windows, or /opt/Sybase/Orch-5_1 on Solaris).
  2. Make sure you backup your current files before applying the JDK patch. Copy the folder: %UO_HOME%\jdk1.4.2_06 to another location.
  3. On Windows, you will need approximately 65MB to 70MB in order to save a backup of the jdk1.4.2_06 files, and approximately 75MB to 85MB for each copy of the new jdk1.4.2_13. The complete upgrade may require from 100MB to 150MB of available disk space (75MB to 85MB for the temporary installation directory, plus an additional 10MB to 20MB for every copy of the JDK that is being upgraded – e.g. one for UO, and possibly others for other products).
  4. On Solaris, you will need approximately 100MB to save a backup of the jdk1.4.2_06 files, approximately 133MB (135772 bytes) of disk space for the self-extracting installer and files that it extracts. The new version of the JDK 1.4.2_13 is very close to the same size as the old version of the JDK 1.4.2_06, so a nominal amount of additional disk space will be required to update the JDK within the product directory. So the complete upgrade may require from 233MB to 250MB of available disk space on Solaris.

Installation Instructions

Follow these instructions to install the upgrade:

  1. Stop UO5.1 Server and all UO 5.1 processes
  2. Download JDK 1.4.2_13 from Sun at http://java.sun.com/j2se/1.4.2/download.html
    (use the directions below for your platform):
    • Windows
      1. From Sun's web-site (link above), find the section labeled: "J2SE v1.4.2_13 SDK (includes the JVM technology)"
      2. Select the link "Download J2SE SDK" within this section
      3. On the next page that is displayed, accept Sun's License Agreement
      4. If you are updating a single UO installation on Windows, select "Windows Installation, Multi-language" (If you are going to perform updates to multiple installations on Windows, you might consider downloading "Windows Offline Installation" once, and re-use this installation on multiple servers)
      5. Select "Save" when prompted whether to Save or Run this executable file
      6. After downloading this executable file, run it
      7. Windows XP may report a Security Warning, with the text: "The publisher could not be verified. Are you sure you want to run this software?" Select "Run"
      8. InstallShield will begin, and display "Sun Microsystems, Inc. – Binary Code License Agreement". Select "I accept the terms …" and click on "Next"
      9. Optionally, at the "Custom Setup" screen, you have the option of installing the JDK1.4.2_13 in a non-default area (possibly on another disk, if space is limited). To choose another installation area, Select "Change…", browse to or enter an alternate destination directory, and click "OK"
      10. Click "Next" from the Custom Setup screen
      11. At the "Browser Registration" screen, select "Install"
      12. A window entitled "Preparing to install" will appear briefly, followed by a second window entitled "Windows Installer". Eventually, the JDK Installer window will appear, initially entitled "Java 2 SDK SE v 1.4.2_13 Progress". During the JDK installation, a sub-window will appear, entitled "Java 2 Runtime Environment SE v 1.4.2_13 Progress" (this is the JRE sub-installation). Finally, the JDK Installer window title will change to: "Java 2 SDK SE v1.4.2_13 Complete", and there will be a message: "Install Shield Wizard Completed". Click "Finish"
      13. The new JDK 1.4.2_13 has now been installed in the selected installation location (default: C:\j2sdk1.4.2_13)
      14. Copy the contents of j2sdk1.4.2_13 to the JDK directory under %UO_HOME% (example: copy all files and folders underneath C:\j2sdk1.4.2_13 to C:\Sybase\Orch-5_1\JDK1.4.2_06). Windows will ask you to "Confirm Folder Replace". Select "Yes to All"
      15. Keep the name of the JDK folder the same as the old one (example: C:\Sybase\Orch-5_1\JDK1.4.2_06)
      16. Optionally, create a text file in this directory, to indicate that the files in this directory have actually been updated to the new version. For example, create a file called "ACTUAL_JDK_VERSION_IS_1.4.2_13.TXT", and include installation details (date/timestamp, etc.) within the text file
      17. Since the contents of the new JDK are copied to the old JDK folder, there is no need to change any scripts to point to the new JDK
    • Solaris
      1. From Sun's web-site (link above), find the section labeled: "J2SE v1.4.2_13 SDK (includes the JVM technology)"
      2. Select the link "Download J2SE SDK" within this section
      3. On the next page that is displayed, accept Sun's License Agreement
      4. Find the section entitled "Solaris SPARC Platform - Java(TM) 2 SDK, Standard Edition 1.4.2_13"
      5. Click on "32-bit self-extracting file" to download the file j2sdk-1_4_2_13-solaris-sparc.sh
      6. Select "Save" when prompted whether to Save or Run this executable file, and save it to a temporary directory on the Solaris machine (e.g. /tmp)
      7. After downloading this executable file, run it from a shell or xterm window
      8. The Solaris installer shell script will display the first page of the "Sun Microsystems, Inc. – Binary Code License Agreement". Read the agreement, hitting the space bar to see subsequent pages
      9. At the end of the license agreement, the installer will prompt: "Do you agree to the above license terms? [yes or no]". If you agree to the terms of the license, type 'yes' and hit Enter
      10. The Installer will report that it is "Unpacking…", then "Checksumming…" and finally "Extracting…", and will echo the files that it is creating, inflating or extracting to your disk. It will then create several jar files, and finally report "Done"
      11. The new JDK 1.4.2_13 has now been installed in the j2sdk1.4.2_13 sub-directory of the directory where the self-extracting file was stored
      12. Copy the contents of this j2sdk1.4.2_13 sub-directory to the JDK directory under UO 5.1 (example: copy all files and folders underneath /tmp/j2sdk1.4.2_13 to /opt/Sybase/Orch-5_1/JDK1.4.2_06)
      13. Keep the name of the JDK folder the same as the old one – (example: /opt/Sybase/Orch-5_1/JDK1.4.2_06)
      14. Optionally, create a text file in this directory, to indicate that the files in this directory have actually been updated to the new version. For example, create a file called "ACTUAL_JDK_VERSION_IS_1.4.2_13", and if desired, include installation details (date/timestamp, etc.) within the text file (e.g. "touch ACTUAL_JDK_VERSION_IS_1.4.2_13")
      15. Since the contents of the new JDK are copied to the old JDK folder, there is no need to change any scripts to point to the new JDK
  3. Restart UO 5.1 Server and UO 5.1 processes
    • On Windows, from the Start menu, select "Programs -> Sybase -> Unwired Orchestrator 5.1 -> Start UO 5.1 Runtime"
    • On Solaris, change the working directory to %UO_HOME%/bin (e.g. "cd /opt/Sybase/Orch-5_1/bin"), and run the UO startup script (e.g. "or51rtimeEAS_start.sh")

 

Related Links

 
 
 

© Copyright 2014, Sybase Inc. - v 7.6 Home / Contact Us / Help / Jobs / Legal / Privacy / Code of Ethics