Updating the Java Software Development Kit (JDK) in a WorkSpace 1.6 installation
This document provides the instructions for how to download, install, and update to the latest JDK 1.4.2 version for a WorkSpace 1.6 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 WorkSpace 1.6, replace the old JDK with the newly updated version.
WorkSpace 1.6 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.
The location where Sybase WorkSpace has been installed is referred to as the WorkSpace home directory (%WORKSPACE_HOME%) in this document. (For example: WorkSpace home directory could be c:\Sybase\WorkSpace).
Make sure you backup your current files before applying the JRE patch. For example, copy the folder: %WORKSPACE_HOME%\jdk1.4.2_06 to another location.
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 WorkSpace, and possibly others for other products).
Follow these instructions to install the upgrade to WorkSpace Tooling and WorkSpace DE Servers: (if you have installed DEServers from WorkSpace)
Shut down WorkSpace Tooling, if it is running
If you have installed DEServers from WorkSpace, then shut down all Development Runtime Server applications
From Sun's web-site (link above), find the section labeled: "J2SE v1.4.2_13 SDK (includes the JVM technology)"
Select the link "Download J2SE SDK" within this section
On the next page that is displayed, accept Sun’s License Agreement
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)
Select "Save" when prompted whether to Save or Run this executable file
After downloading this executable file, run it
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"
InstallShield will begin, and display "Sun Microsystems, Inc. – Binary Code License Agreement". Select "I accept the terms …" and click on "Next"
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"
Click "Next" from the Custom Setup screen
At the "Browser Registration" screen, select "Install"
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"
The new JDK 1.4.2_13 has now been installed in the selected installation location (default: C:\j2sdk1.4.2_13)
Copy the contents of j2sdk14.2_13 to the JDK directory under %WORKSPACE_HOME% (example: copy all files and folders underneath C:\j2sdk14.2_13\ to C:\Sybase\WorkSpace\JDK1.4.2_06\)
Keep the name of the JDK folder the same as the old one – (example: C:\Sybase\WorkSpace\JDK1.4.2_06)
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
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
Start Sybase WorkSpace Tooling using one of the following methods:
Using the Windows shortcuts: Start->Programs->Sybase->Sybase WorkSpace-> Sybase WorkSpace 1.6
- OR -
Using the Sybase WorkSpace icon referencing the batch file %WORKSPACE_HOME%\Eclipse\SybaseWorkSpace.bat
If you have installed DEServers from WorkSpace: Start Development Runtime servers using Windows shortcuts or by issuing commands from a command prompt window. For example:
Start UO Development Edition Server using the Windows shortcuts: Start->Programs->Sybase->Sybase WorkSpace->UO 5.1->Start UO
- OR -
Start UO Development Edition Server by issuing commands from a command prompt window: