Alerts

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



ID:    A12
Published:    27 October 2006
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 Alert 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: Instructions in this document only apply to Collage 5.1.0.x and 5.1.1.x. Instructions for Collage 4.6.x are available in Alert A17. Collage 5.1.2 and later don't need updates.
********************************************************************************************************************************************

Client-side Changes

Collage uses client-side JRE to run the Collage applet. The JRE must be upgraded to include the DST fixes. All Collage client machines should be upgraded to either:

JRE 1.4.2_11 or 1.4.2_12+

J2SE 1.5.0_06+

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.

To upgrade to the latest version of J2SE 5.0, do the following:

  1. Go to http://java.sun.com/javase/downloads/index_jdk5.jsp.
  2. Click the Download button next to "Java Runtime Environment (JRE) 5.0 Update 11".
  3. Select "Windows Offline Installation, Multi-language" installation. This will download a file called "jre-1_5_0_10-windows-i586-p.exe".
  4. Run the downloaded file.
  5. When the installation is complete, restart the machine.

MAC:

The J2SE 1.5.0_06 for MAC is available from Apple at http://www.apple.com/support/downloads/j2se50release4intel.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. Rename the <Install_Directory>\Serena\Collage\common\JDK1.4.2_07 directory to be JDK1.4.2_07_OLD.
  3. Go to http://java.sun.com/products/archive/j2se/1.4.2_12/index.html
  4. Click "Download J2SDK". NOTE: Do not download the JRE; Collage needs the entire JDK to run.
  5. Download the "Windows Offline Installation". This will download a file called "j2sdk-1_4_2_12-windows-i586-p.exe".
  6. Run the downloaded file.
  7. Accept the license agreement.
  8. Be sure to click the "Change" button to change the "Install To" location. This location should be <Install_Directory>\Serena\Collage\common\JDK1.4.2_12.
  9. Click "Next" and then "Install", accepting the remaining default options.
  10. Go to http://java.sun.com/products/java-media/jai/downloads/download-1_1_2_01.html.
  11. Under the section "Download Java Advanced Imaging 1.1.2_01", select the "JDK" download.
  12. At the top, choose to accept the license agreement.
  13. Select "Windows JDK Install". This will download a file called "jai-1_1_2_01-lib-windows-i586-jdk.exe".
  14. Run the downloaded file.
  15. Accept the license agreement.
  16. Be sure to click the "Browse" button to change the change the "Destination Folder" to be <Install_Directory>\Serena\Collage\common\JDK1.4.2_12.
  17. Click Next to start the install.
  18. Edit the <Install_Directory>\Serena\Collage\options.bat file.
  19. About 15 lines from the top, you will see the following lines:
            SET JAVA_HOME=C:/Program Files/Serena/Collage/common/JDK1.4.2_07
            SET JAVA_HOME_WIN=C:\Program Files\Serena\Collage\common\JDK1.4.2_07
    Change these to be:
            SET JAVA_HOME=C:/Program Files/Serena/Collage/common/JDK1.4.2_12
            SET JAVA_HOME_WIN=C:\Program Files\Serena\Collage\common\JDK1.4.2_12
  20. Open the folder <Install_Directory>\common\Tomcat\bin
  21. Double click Tomcat5w.exe to run it.
  22. Click on the Java tab.
  23. Change the Java Virtual Machine path to reflect the new JDK folder created above.
    Change the path from: JDK1.4.2_07 to the new value of JDK1.4.2_12 
  24. Change the Java Classpath to reflect the new JDK folder created above.
    Change the path from: JDK1.4.2_07 to the new value of JDK1.4.2_12
  25. Click OK to save your changes.        
  26. Start Collage.

Solaris and Linux:

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

5004300

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