Alerts

MCLG 4.6: Getting Collage ready for the new USA 2007 Daylight Saving Time rules



ID:    A17
Published:    09 February 2007
Updated:    24 April 2008

Operating System(s)

  • All Windows
  • Linux
  • Solaris
  • Unix
  • Windows 2000
  • Windows 2003
  • Windows 98
  • Windows NT
  • Windows XP

Product(s)

  • Collage
 

Description

Beginning in 2007, the start and end date of Daylight Savings Time (DST) will change in the United States (see http://aa.usno.navy.mil/faq/docs/daylight_time.html). Daylight Savings Time will begin March 11, 2007 (the second Sunday in March) instead of April 1 (the first Sunday of April). Daylight Savings Time will end November 4, 2007 (the first Sunday of November) instead of October 28 (the last Sunday in October).

Collage uses Java technology on the server as well as on the clients. To successfully support the 2007 DST changes, the Java software will need to be upgraded (see http://java.sun.com/developer/technicalArticles/Intl/USDST/) on the client machines and the Collage server. For complete details on how Collage will be affected without these changes, see KB #A15

IMPORTANT: There may also be operating system patches that need to be applied to both the client and the server. Check with the appropriate vendors for details. Also, a large number of the dates in Collage are retrieved using function calls to the database. Because of this, make sure the appropriate operating system patches are also applied to the server hosting the Collage database.


****************************************************************************************************************
IMPORTANT: The instructions in this document only apply to Collage 4.6.x. Instructions for Collage 5.1.0.x and 5.1.1.x are available in KB A12.
****************************************************************************************************************

Client-side Changes

Collage uses client-side JRE to run the Collage applet. The JRE must be upgraded to include the DST fixes. Although Collage 4.6 supports the Microsoft JVM, Microsoft is not releasing an updated JVM with the DST changes. Because of this, all client machines must run the Sun JRE. All Collage client machines should be upgraded to either:

JRE 1.4.2_11 or 1.4.2_12+

Windows:

To upgrade to the latest version of JRE 1.4.2x do the following:

  1. Select the "Download J2SE JRE".
  2. Select "Windows Offline Installation, Multi-language". This will download a file called "j2re-1_4_2_13-windows-i586-p.exe".
  3. Run the downloaded file.
  4. Choose to do a "Typical" installation.
  5. When the installation is complete, restart the machine.

MAC:

The lastest JRE 1.4.2x for MAC is available from Apple at http://www.apple.com/downloads/macosx/apple/macosx_updates/java131and142release2.html

Server-side Changes

The server-side changes vary, depending on the application server being used. Refer to the appropriate section below:

Tomcat:

If Collage is running through Tomcat, Tomcat will need to be patched as described here. 

Windows:

  1. Stop Collage.
  2. Uninstall the Tomcat service. For detailed steps, see S123943.
  3. Rename the <Install_Directory>\Serena\Collage\JDK1.3.1 directory to be JDK1.3.1_OLD.
  4. Go to http://java.sun.com/products/archive/j2se/1.3.1_18/index.html
  5. Click "Download J2SE v 1.3.1_18", and choose the SDK. NOTE: Do not download the JRE; Collage needs the entire SDK to run.
  6. Download the "Windows (all languages, including English)" file. This will download a file called "j2sdk-1_3_1_18-windows-i586.exe".
  7. Run the downloaded file.
  8. Accept the license agreement.
  9. Be sure to click the "Change" button to change the "Destination Folder" location. This location should be <Install_Directory>\Serena\Collage\JDK1.3.1_18.
  10. Click "Next" and then "Install", accepting the remaining default options.
  11. Go to http://java.sun.com/products/java-media/jai/downloads/download-1_1_1_01.html.
  12. Under the section "Download Java Advanced Imaging 1.1.1_01 Implementation and Samples", select the "JDK" download.
  13. At the top, choose to accept the license agreement.
  14. Select "Windows JDK Install". This will download a file called "jai-1_1_1_01-lib-windows-i586-jdk.exe".
  15. Run the downloaded file.
  16. Accept the license agreement.
  17. Be sure to click the "Browse" button to change the change the "Destination Folder" to be <Install_Directory>\Serena\Collage\JDK1.3.1_18.
  18. Click Next to start the install.
  19. Edit the <Install_Directory>\Serena\Collage\options.bat file.
  20. About 15 lines from the top, you will see the following lines:
            SET JAVA_HOME=C:/Program Files/Serena/Collage/JDK1.3.1
            SET JAVA_HOME_WIN=C:\Program Files\Serena\Collage\JDK1.3.1
    Change these to be:
            SET JAVA_HOME=C:/Program Files/Serena/Collage/JDK1.3.1_18
            SET JAVA_HOME_WIN=C:\Program Files\Serena\Collage\JDK1.3.1_18
  21. Re-install the Tomcat service. For detailed steps, see S123943.
  22. Start Collage.

Solaris and Linux:

  1. Stop Collage.
  2. Rename the <Install_Directory>/collage/jdk1.3.1 to jdk1.3.1_OLD.
  3. Go to http://java.sun.com/products/archive/j2se/1.3.1_18/index.html
  4. Click "Download J2SE v 1.3.1_18" and choose the SDK. NOTE: Do not download the JRE; Collage needs the entire SDK to run.
  5. At the top, choose to accept the license agreement.
  6. Download the installation file.
    Solaris: From the "Solaris SPARC Platform - Java(TM) 2 SDK, Standard Edition 1.3.1_18 FCS" section, download j2sdk-1_3_1_18-solaris-sparc.sh.
    Linux: From the "Linux Platform - Java(TM) 2 SDK, Standard Edition 1.3.1_18 FCS" section, download j2sdk-1_3_1_18-linux-i586.bin.
  7. Move the downloaded file to <Install_Directory>/collage/.
  8. Run the downloaded file.
  9. Enter "yes" to accept the license agreement.
  10. When the installation is complete, the directory <Install_Directory>/collage/jdk1.3.1_18/ will be created.
  11. Go to http://java.sun.com/products/java-media/jai/downloads/download-1_1_1_01.html.
  12. Under the section "Download Java Advanced Imaging 1.1.1_01 Implementation and Samples", select the "JDK" download.
  13. At the top, choose to accept the license agreement.
  14. Download the installation file.
    Solaris: From the "Solaris SPARC Platform - Java Advanced Imaging 1.1.1_01" section, download jai-1_1_1_01-lib-solaris-sparc-jdk.bin.
    Linux: From the "Linux Platform - Java Advanced Imaging API 1.1.1_01 " section, download jai-1_1_1_01-lib-linux-i586-jdk.bin.
  15. Copy the downloaded file to <Install_Directory>/collage/jdk1.3.1_18/.
  16. Run the downloaded file.
  17. Accept the license agreement, and allow the install to complete.
  18. Edit the <Install_Directory>/collage/options.sh file.
  19. About 10 lines from the top, you will see the following line:
            JAVA_HOME=<Collage Installation Dir>/collage/jdk1.3.1
    Change these to be:
            JAVA_HOME=<Collage Installation Dir>/collage/jdk1.3.1_18
  20. Start Collage.

WebSphere:

If Collage is running through WebSphere, WebSphere will need to be patched as described in the following article.

http://www-1.ibm.com/support/docview.wss?rs=404&context=SS7K4U&dc=D600&uid=swg21219396&loc=en_US&cs=UTF-8&lang=en

WebLogic:

If Collage is running through WebLogic, WebLogic will need to be patched as described in the following article.

http://support.bea.com//support_news/Patch_for_2007_Daylight_Savings_Time_Changes.jsp

 

Migration ID

5005485

Find Answers

Type a question or describe what you are looking for below

My Recent Searches

Welcome kb sso

Additional Assistance

  • Submit a Case Online
  • FAQs