Cisco Unified Contact Center Express

Revised March 25, 2008

March 29, 2007

NOTICE:

THIS FIELD NOTICE IS PROVIDED ON AN "AS IS" BASIS AND DOES NOT IMPLY ANY KIND OF GUARANTEE OR WARRANTY, INCLUDING THE WARRANTY OF MERCHANTABILITY. YOUR USE OF THE INFORMATION ON THE FIELD NOTICE OR MATERIALS LINKED FROM THE FIELD NOTICE IS AT YOUR OWN RISK. CISCO RESERVES THE RIGHT TO CHANGE OR UPDATE THIS FIELD NOTICE AT ANY TIME.

Revision History

Products Affected

Problem Description

In compliance with the Energy Policy Act of 2005, the switchover dates to and from Daylight Saving Time (DST) will shift in the United States in calendar year 2007. DST will commence Sunday, March 9, 2008 at 2:00 A.M. and will end on Sunday, November 2, 2008 at 2:00 A.M. Because assumptions around the timing of the ongoing DST transition were designed into both the Microsoft Windows operating system and the Cisco Unified Contact Center software, adequate preparation for this event is necessary in order to avoid negative impact to system data reporting context. Further, as the JDK/JRE (Java) runtime facilities are themselves subject to the same update requirements, certain components of the product that utilize the JDK/JRE are required to have the Java Platform JDK US DST Timezone Updater patch tool applied. The tool is available directly from Sun Microsystems' Sun Developer Network.

This notice is intended to both alert you to the specific impact of the DST change and to detail the necessary remedial steps to ensure consistent and seamless product operation. Several Enterprise and Hosted product and product options are affected, and each requires specific consideration. Cisco Unified Contact Center Express (Unified CCX) is discussed in the following section. Customers deploying these product and configuration options should follow the steps outlined in the notice to ensure they avoid encountering problems with the forthcoming March 2008 DST transition.

The Contact Center product/product options affected are:

Cisco Unified Contact Center Express (Unified CCX), (formerly Cisco Customer Response Solution (CRS)), Cisco IP Interactive Voice Response (IP IVR) and Cisco IP Queue Manager (IP QM))

Background

On August 8, 2005, the Energy Policy Act of 2005 (H.R.6.ENR), was signed into law. Section 110 of this Act modified the time change dates for Daylight Saving Time (DST) in the U.S.

Beginning in March of 2008, DST will begin on the second Sunday of March and end the first Sunday of November.

For 2008 and beyond, the daylight saving time period will be:

2:00 A.M. on the second Sunday in March

to

2:00 A.M. on the first Sunday in November.

Problem Symptoms

Failure to update the Cisco Unified Contact Center Express (Unified CCX) servers may result in the following:

1. Historical Reports: Reports are off by one hour (pre-DST time) for the period March 9 - November 2 as HR time is obtained from Unified CCX server.

2. Trace timestamps: Time stamp in some logs will be off by one hour (pre-DST time).

3. Real Time reports: Reports are off by one hour (pre-DST time) for the period March 9 - November 2 as RTR time is obtained from Cisco Unified Contact Center Express (Unified CCX) server.

4. Data written to the Unified CCX database: Data Time stamp will be off by one hour (pre-DST time) for the period March 9 - November 2 as time is obtained from Cisco Unified Contact Center Express (Unified CCX) server.

5. Scripts using the "Time of Day" step: Calls will be routed based on pre-DST time for the period March 9 - November 2 as time is obtained from Cisco Unified Contact Center Express (Unified CCX) server.

Workaround/Solution

Cisco Unified Contact Center Express (Unified CCX)

Includes: Cisco Unified Contact Center Express, (UCCX, formerly IPCC Express) Cisco IP Interactive Voice Response (IP IVR) and Cisco IP Queue Manager (IP QM).

Patching Unified CCX servers is a multi step process as outlined below:

1. Apply the appropriate OS patch on all Unified CCX servers.

2. Depending on the Unified CCX version, apply appropriate Unified CCX/SUN patch to update Java time zone rules on all Unified CCX servers.

3. Apply Microsoft OS patches on all CAD/CSD machines.

Unified CCX uses the same OS build as current CCM Windows OS versions. Therefore, the OS fix for Unified CCX is the same as the OS fix for Cisco CallManager and it is necessary to apply OS patch on all Unified CCX servers.

To obtain the 2008 DST changes required for the operating system, apply either

2000.4.5bSR9 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) or 2003-1-2a-sr8 or 2003-1-1-sr10 or 2003-1-2a-sr3 or 2003-1-1-sr8 (or higher OS release) from the

CallManager & Voice Apps Crypto Software (registered customers only) link.

Other Compatible Cisco MCS OS versions:
2000.4.5bSR3 and above are compatible.
2000.4.5a, if upgraded from a previous OS release that had US DST resolved, would still resolve US DST.
2000.4.5a is not DST compatible for new installs.

Note: Please do not apply Tzedit.exe patch provided by Microsoft or other patches provided by any third party vendors on Unified CCX servers.

Click on the associated version for step by step instructions:

Unified CCX 3.1(x)

Unified CCX 3.5(x)

Unified CCX 4.0(1), 4.0(2), 4.0(3), 4.0(4), 4.5(1)

Unified CCX 4.0(5) and 4.0(5a)

Unified CCX 4.1(1)

Unified CCX 4.5(2)

Unified CCX 5.0(1) and 6.0(1)

Other Versions of Unified CCX

Unified CCX 3.1(x)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2000.4.5a or 2000.4.5bSR8 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Apply 3.1(x)ES1, which can be downloaded from the Special File Access (registered customers only) page. Please use the password 4b61e1b8f56e017bbe5d880485612de7 to download the ES.

3. Apply Microsoft OS patches on all CAD/CSD machines.

       

Alternatively, customers could update the JRE used by Unified CCX 3.1(x) by downloading a JRE patch from Sun's website that updates the time zone rules used by JRE. Follow the instructions below to update the JRE. Information regarding the tool that performs the JRE updates is available at the Sun Java SE TZupdater Tool page and in a README.html file with the tool itself.

Steps to Update the JRE

1. Stop the Cisco CRA Engine service on the Unified server. During this time Unified will not function.

2. Visit J2SE 1.3.1 Timezone Updater with your browser of choice and download J2SE 1.3.1 Timezone Updater 1.3.3.

   Note: You will need to log-into a Sun Online Account before downloading the patch. If you do not have a Sun Online Account, you can register for one free-of-charge. A valid email address is required for registration.

3. Download the patch to a folder of your choice on the Unified CCX system. The patch comes in the form a Zip file.

4. Unzip the contents of the patch to the same folder. There should now be a file present named "tzupdater131.jar"

5. Open a command-line window and browse to the path where tzupdater131.jar is located.

6. Issue the following from the command-line - PLEASE INCLUDE THE QUOTES:

   "C:\Program Files\wfavvid\javasoft\JRE\1.3.1\bin\java" -jar tzupdater131.jar -u -v

   where "u" and "v" are both lower-case letters.

   Again, this entire command is issued from a command-line window after browsing to the same folder as where "tzupdater131.jar" is located.

7. Restart Unified CCX server.

If this update needs to be reversed for whatever reason, follow the instructions below:

1. Locate the rt.jar file under the modified JAVAHOME/jre/lib directory. This is the newer data.

2. Locate a rt.jar.TZbackup file in the same JAVAHOME/jre/lib directory. This is the replaced, older data.

3. Copy the rt.jar.TZbackup over the updated rt.jar

4. Restart applications on this JDK/JRE instance as desired.

Unified CCX 3.5(x)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2000.4.5a or 2000.4.5bSR8 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Upgrade to 3.5(4)

   Use the Product Upgrade Tool (PUT) (registered customers only) on cisco.com.

3. Apply 3.5(4)SR2 which can be downloaded from the Contact Center Tools and Resources Downloads (registered customers only) page.

4. After upgrading to 3.5(4)SR2, apply 3.5(4)SR2 ES1 which can be downloaded from the Special File Access (registered customers only) page. This ES addresses the problem described in CSCsh95451. Please use the password b70d6c3fa1ffd3c83206feaba7976b09 to download the ES.

   If you are unable to upgrade to Unified CCX 3.5(4)SR2 ES1, please follow the steps below. Note, we strongly encourage you to upgrade to Unified CCX 3.5(4)SR2 ES1 as soon as possible to avoid problems with future Daylight Saving changes. Do not apply any OS patch on Unified CCX servers if you follow the manual workaround below.

5. Apply Microsoft OS patches on all CAD/CSD machines.

   http://support.microsoft.com/gp/dst_topissues

Unified CCX Manual Workaround 3.5(1), 3.5(2) or 3.5(3):

1. On the new US Daylight Saving Time date, Logon with administrator privileges to all Unified CCX Servers, starting with the engine node.

2. Click Start, Settings, Control Panel, Date and Time.

3. Click on Time Zone tab.

4. Uncheck the Automatically adjust clock for daylight savings changes.

5. Click on Date and Time tab.

6. Adjust (if needed) the time to the actual time.

7. Click Apply or Ok.

8. Repeat steps for all other servers.

Important Steps To Perform:

1. On or before Sunday March 9, uncheck Automatically adjust clock for Daylight Saving changes.

2. On March 9, 2008, on or after 2:01 A.M., move the clock ahead one hour and check Automatically adjust clock for Daylight Saving changes.

   Please note, however, that manually adjusting the clock on the Unified CCX servers could result in a conflict in time which may produce time synchronization issues. For instance, adjusting the clock during any active call would result in incorrect historical records for that call. Therefore, adjusting the clock is best to be done when fewest active calls are present or the Unified CCX engine is stopped.

Applying DST patches after applying manual workaround

1. On or after March 9, 2008, logon with administrator privileges to all Unified CCX Servers, starting with the engine node.

2. Click Start, Settings, Control Panel, Date and Time.

3. Click on Time Zone tab.

4. Check the Automatically adjust clock for daylight savings changes.

5. Click Apply or OK.

6. Apply OS patch on all Unified CCX servers.

7. Upgrade to 3.5(4)SR2ES1 or update the JRE used by 3.5(x) by following the procedure after this section.

8. Repeat steps for all other servers (RDB, VoIP).

Alternatively, customers could update the JRE used by Unified CCX 3.5(x) by downloading a JRE patch from Sun's website that updates the time zone rules used by JRE. Follow the instructions below to update the JRE. Information regarding the tool that performs the JRE updates is available at the Sun Java SE TZupdater Tool page and in a README.html file with the tool itself.

Steps to Update the JRE

1. Stop the Cisco CRA Engine service on the Unified CCX server. During this time Unified CCX will not function.

2. Visit J2SE 1.3.1 Timezone Updater with your browser of choice and download J2SE 1.3.1 Timezone Updater 1.3.3.

3. Note: You will need to log-into a Sun Online Account before downloading the patch. If you do not have a Sun Online Account, you can register for one free-of-charge. A valid email address is required for registration.

4. Download the patch to a folder of your choice on the Unified CCX system. The patch comes in the form a Zip file.

5. Unzip the contents of the patch to the same folder. There should now be a file present named "tzupdater131.jar"

6. Open a command-line window and browse to the path where tzupdater131.jar is located.

7. Issue the following from the command-line - PLEASE INCLUDE THE QUOTES:

8. "C:\Program Files\wfavvid\javasoft\JRE\1.3.1\bin\java" -jar tzupdater131.jar -u -v

   where "u" and "v" are both lower-case letters.

9. Again, this entire command is issued from a command-line window after browsing to the same folder as where "tzupdater131.jar" is located.

10. Restart Unified CCX server.

If this update needs to be reversed for whatever reason, follow the instructions below:

1. Locate the rt.jar file under the modified JAVAHOME/jre/lib directory. This is the newer data.

2. Locate a rt.jar.TZbackup file in the same JAVAHOME/jre/lib directory. This is the replaced, older data.

3. Copy the rt.jar.TZbackup over the updated rt.jar

4. Restart applications on this JDK/JRE instance as desired.

Unified CCX 4.0(1), 4.0(2), 4.0(3), 4.0(4), 4.5(1)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2000.4.5a or 2000.4.5bSR8 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Apply the appropriate Unified CCX/SUN patch, TZUpdater Version 1.3.3, to update Java time zone rules on all Unified CCX servers.

   The Unified CCX installation copies the 1.4.2_08 version private Java Runtime Engine (JRE) to path C:\Program Files\wfavvid\java\current\bin\java directory. Sun Microsystems has made available a tool to update the time zone database of current installations. To update the database used by Unified CCX's JRE, follow the steps listed below exactly. Because the JRE installed is onsidered "private" - it is not listed in the registry at HKLM\Software\JavaSoft or placed in the System Path - failure to specify the path to the java.exe used by Unified CCX can result in the update being applied to the incorrect JRE should other JREs be present on the machine.

   Information regarding the tool that performs the JRE updates is available at the Sun Java SE TZupdater Tool page and in a README.html file with the tool itself.

Steps to Update the JRE

1. Stop the Node Manager service on the Unified CCX server. During this time Unified CCX will not function.

2. Visit Java SE Downloads with your browser of choice.

3. Select the Download button to the right of the choice "JDK US DST Timezone Update Tool - 1.3.3"

   Note: You will need to log-into a Sun Online Account before downloading the patch. If you do not have a Sun Online Account, you can register for one free-of-charge. A valid email address is required for registration.

4. Download the patch to a folder of your choice on the Unified CCX system. The patch comes in the form a Zip file.

5. Unzip the contents of the patch to the same folder. There should now be a file present named "tzupdater.jar"

6. Open a command-line window and browse to the path where tzupdater.jar is located.

7. Issue the following from the command-line - PLEASE INCLUDE THE QUOTES:

   "C:\Program Files\wfavvid\java\current\bin\java" -jar tzupdater.jar -u -v

   where "u" and "v" are both lower-case letters.

   Again, this entire command is issued from a command-line window after browsing to the same folder as where "tzupdater.jar" is located.

8. The output from the above command should be similar to:

   java.home: C:\Program Files\wfavvid\java\current 
   java.vendor: Sun Microsystems Inc. 
   java.version: 1.5.1_11 
   JRE time zone data version: tzdata2007k 
   Embedded time zone data version: tzdata2007k 
   Extracting files... done. 
   Renaming directories... done. 
   Validating the new time zone data... done. 
   Time zone data update is complete. 
   

9. To verify the update was successful, issue this command:

   "C:\Program Files\wfavvid\java\current\bin\java" -jar tzupdater.jar -u and verify the returned text is

   You have the same version as the embedded one .

   Note the lack of a "-v" in the above command.

10. Restart Unified CCX server.

    Note: There is a conflict between certain three-letter time zone IDs in JDK version 1.1 and the time zone database IDs used in Olson tzdata2005r or greater. The conflicting time zone IDs are "EST", "MST" and "HST". To resolve this issue, you must run TZupdater again with the -f -bc options specified. See Sun Alert 102836 for Java.

    If this update needs to be reversed for whatever reason, steps are provided in the README.html file mentioned earlier.

11. Apply Microsoft OS patches on all CAD/CSD machines.

    http://support.microsoft.com/gp/dst_topissues

Unified CCX 4.0(5) and 4.0(5a)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2000.4.5a or 2000.4.5bSR8 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Apply Microsoft OS patches on all CAD/CSD machines.

   http://support.microsoft.com/gp/dst_topissues

Unified CCX 4.1(1)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2003-1-2a-sr8 or 2003-1-1-sr10 or 2003-1-2a-sr3 or 2003-1-1-sr8 (or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Apply Microsoft OS patches on all CAD/CSD machines.

   http://support.microsoft.com/gp/dst_topissues

Unified CCX 4.5(2)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2000.4.5a or 2000.4.5bSR8 or OS 2000.4.4a(sr5) or OS 2000.4.3aSR9 or 2000.4.2sr16 or 2000.4.4aSR10 or 2000.4.5bSR3(or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. In order to obtain the DST fixes for Unified CCX 4.5(2), apply 4.5(2)SR1 (or any greater SR) on 4.5(2) systems which can be downloaded from the Contact Center Tools and Resources Downloads (registered customers only) page.

3. Apply Microsoft OS patches on all CAD/CSD machines.

   http://support.microsoft.com/gp/dst_topissues

Unified CCX 5.0(1) and 6.0(1)

1. Apply the appropriate Cisco MCS OS patch on all Unified CCX servers.

   To obtain the 2008 DST changes required for the operating system, apply either OS 2003-1-2a-sr8 or 2003-1-1-sr10 or 2003-1-2a-sr3 or 2003-1-1-sr8 (or higher OS release) from the

   Unified CallManager & Voice Apps Crypto Software (registered customers only) link.

2. Apply Microsoft OS patches on all CAD/CSD machines.

   http://support.microsoft.com/gp/dst_topissues

Other Versions of Unified CCX

Upgrade to either 3.5(4)SR2 ES1, 4.0(5a) or 4.5(2)SR2 to obtain the DST fix and apply the necessary Win2K OS patch.

References:

Microsoft - Preparing for daylight saving time changes in 2008

Sun DST FAQ

Sun Download Archive

Sun TZupdater 1.3.3 ReadMe

* Testing Disposition

I - In Progress (indicating that testing is in progress and will be updated when complete)

Y - Yes (tested)

NA - Not Applicable (none of the security updates are being tested because of a "Not Applicable" or "Deferred" assessment.)

DDTS

To follow the bug ID link below and see detailed bug information, you must be a registered user and you must be logged in.

For More Information

If you require further assistance, or if you have any further questions regarding this field notice, please contact the Cisco Systems Technical Assistance Center (TAC) by one of the following methods:

• Open a service request on Cisco.com
• By email
• By telephone

Receive Email Notification For New Field Notices

Product Alert Tool - Set up a profile to receive email updates about reliability, safety, network security, and end-of-sale issues for the Cisco products you specify.