Guest

Cisco Unity

Field Notice: FN - 62868 - New Zealand Daylight Savings Time Policy Changes Effective September 2007 For Cisco Unity


Revised August 29, 2007

August 27, 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.


Products Affected

Product

Products Affected

UNITY -

 

Problem Description

The operating systems of most Cisco products that support Daylight Savings Time (DST) have built in mechanisms to automatically change the times, based on current user-selected rules. Once the new DST is implemented, the time on devices that maintain time zone information will continue to change according to the old method, unless changes are made.

This issue will affect your Cisco Unity deployment if:

  1. The Cisco Unity server is running under Windows 2000 or Windows 2003.

  2. A subscriber has been assigned Auckland, Wellington as their time zone in the Unity System Admin.

or,

  1. At least one back-end mailstore hosting a subscriber's mailbox is running under Windows 2000 or Windows 2003.

  2. The Windows operating system is set to the Auckland, Wellington time zone for the partner mail server or a mail server hosting at least one subscriber mailbox.

or,

The Windows operating system is set to the Auckland, Wellington time zone for a Cisco Unity Bridge server.

Background

On 30 April 2007, Hon Rick Barker, Minister of Internal Affairs, announced a three week extension to the period of daylight saving.

Daylight saving now runs from the last Sunday in September until the first Sunday in April.

Event

Prior to 2007

Year 2007 and After

Start

First Sunday in October

2am on 30 September 2007 (Last Sunday in September)

End

Third Sunday in March

3am on 6 April 2008 (First Sunday in April)

 

Problem Symptom

The potential problem is that Unity voicemail timestamps can be off by one hour during the periods where the new DST begins and ends. This applies to time stamps presented over the telephone and through the Unity Inbox application.

This can have an impact on any event correlation activities that are performed as part of normal operations, troubleshooting, and monitoring.

For example, in various applications, where logs may be captured, correlated, and stored for future reference, could be rendered incorrect for situations where they need to be recalled to rebuild a sequence of events. The incorrect timestamps may not be an issue for events that get immediate action, but future reference back to these events would reference incorrect times.

In addition, any device with time based controls and activities, such as authentication servers, synchronization activities, and scheduled events such as batch jobs, timed backups or automated scripts would be impacted.

Workaround/Solution

Workaround:

If the patches to Windows and Unity are not applied, time may be adjusted manually through the Windows Operating System. This will correct timestamps presented through a user's Cisco Unified IP Phone.

In order to correct Unity Inbox for the upcoming New Zealand time changes, the file TimeZoneData.properties may be modified. Use a text editor like Windows Notepad to update the file.

The row that starts with the text string TZ_Auckland_Wellington= needs to be modified to read:

TZ_Auckland_Wellington= 290,-720,-60,8,0,5,2,3,0,0,3

Solution:

Cisco recommends applying the three following fixes and patches. They may be applied in any order. The three fixes include:

  • Microsoft Windows 2003 Server Operating System updates.

  • Java Virtual Machine (JVM) updates

  • Cisco Unity updates

Installation of updates for all three fixes are explained below.

Microsoft Windows 2003 Server Updates Procedure:

Microsoft Updates can be obtained from the Microsoft TechNet support web site.

This includes Microsoft's Knowledge Base document links as well as links to downloadable files. Using Microsoft's reference pages assures that the latest updates are available.

Applying the appropriate Windows patch will resolve virtually all problems related to changes to time zones and in particular a change to DST for all telephone access. Additional patches are needed for the Unity Inbox and Cisco Personal Communications Assistant applications if those are used. Please see CSCsj81527 (registered customers only) and CSCsj81671 (registered customers only) for additional information.

All versions of Unity and Unity Bridge run on the Windows operating system. To resolve any possible issues, apply the relevant Windows patch (Windows 2003 SP1 or Windows 2000 SP4) to the following machines:

  1. Each Cisco Unity Server

  2. Each Cisco Unity Bridge

  3. All servers hosting Microsoft Exchange or Lotus Domino that contain a mailbox of a Cisco Unity subscriber

  4. The Cisco Unity partner mail server

  5. Each Exchange servers with the Internet Voice Connector (IVC) installed

  6. Each domain controller (DC) in an Active Directory domain with a Cisco Unity server

  7. Each global catalog (GC) server within the Active Directory forest where Cisco Unity is present

Note: If at any time you have manually adjusted the system clock on any of the above machines, for example when testing this patch or to enable a workaround prior to applying the patch, you are advised to reboot the server and validate that the system clock on all machines is reading the true and accurate time for the time zone selected in the operating system. This will be true if the Windows feature Automatically adjust clock for daylight savings changes has been disabled and the system clock manually adjusted. Cisco Systems recommends enabling the Automatically adjust clock for daylight savings changes feature.

The Windows 2003 SP1 patch may be obtained directly from Microsft under Knowledge Base (KB) article 933360.

The patch for Windows 2000 SP4 is available only to customers with a Microsoft Extended Hotfix Service Agreement (EHSA) for Windows 2000. Cisco Systems has such an agreement. The Windows 2000 SP4 patch, New_Zealand_2007_DST_Change.zip may be obtained at Other Cisco Unity Components (registered customers only) software download page.

Java Virtual Machine Update Procedure:

To update the JVM time zone database, follow the steps listed below exactly. Since the installed JVM is considered private it is not listed in the registry at HKLM\Software\JavaSoft or in the System Path. Due to this, failure to specify the path to the java.exe used by Unity can result in the update being applied to the incorrect JVM, if other JVM's are present on the machine. This would only occur if you had chosen to install an additional JVM at some time in the past.

The following describes the steps to update the time zone database:

  1. Stop the Tomcat service on the Unity server. During this time Cisco Personal Communications Assistant, Unity Inbox, and Concerto will not function.

  2. Download the tzupdater 1.2.1 to a folder of your choice on the Unity system. The patch comes in the form a Zip file. The tool is listed under the heading of JDK US DST Timezone Update Tool - 1.2.1

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

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

  5. Type the following and press return/enter:

    %JAVA_HOME%\j6re\bin\java -jar tzupdater.jar -u -v -bc
    

    where u, v, and bc are all lower-case letters.

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

    java.home: E:\CommServer\cscoserv\Java2SDK\jre 
    java.vendor: Sun Microsystems Inc. 
    java.version: 1.4.2_13 
    JRE time zone data version: tzdata2006g 
    Embedded time zone data version: tzdata2007f 
    Extracting files... done. 
    Making changes for JDK 1.1 compatibiltiy... done. 
    Renaming directories... done. 
    Validating the new time zone data... done. 
    Time zone data update is complete.
    

    If the JVM is using the same time zone database version as the tool attempts to install, the following will likely appear and you can skip Step 7 below:

    You have the same version as the embedded one.
    
  7. To verify the update was successful, issue the same command:

    %JAVA_HOME%\jre\bin\java -jar tzupdater.jar -u -v -bc
    

    and verify the returned text contains this statement:

    You have the same version as the embedded one.
    

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

Cisco Unity Update Procedure:

To resolve this issue fully, it requires two separate patches, one from Cisco Systems and one from Microsoft. The patch from Microsoft is for the Windows operating system and would be applied to the machine(s) hosting Exchange or Lotus Domino as well as other machines. The need for that patch and where it should be applied is described in CSCsj81705 (registered customers only) and in this Field Notice, above.

The patch from Cisco Systems, known as an Engineering Special, is described below.

If using Unity version 4.2(1) or 5.0(1), you can obtain the relevant Engineering Special listed below by opening a Service Request with Cisco Technical Assistance Center (TAC):

  • Cisco Unity version 5.0(1): CU5.0(1) ES 9

  • Cisco Unity version 4.2(1): CU4.2(1) ES 118

For Cisco Unity versions 4.0(5) and 4.1(1) a manual update can be easily performed and takes about 5 minutes. This can also be done for versions 4.2(1) and 5.0(1) if you do not wish to obtain and install the available Engineering Special.

It is possible to manually edit the file containing the time zone information the Cisco Unity Inbox uses to determine when daylight savings time begins and ends for each time zone observed. The following describes the steps:

  1. Open the file TimeZoneData.properties found at in path \CommServer\cscoserv\ciscopca\WEB-INF\classes

  2. Locate the single entry for New Zealand by searching the file for the text TZ_Auckland_Wellington

  3. Once found, replace the current entry for TZ_Auckland_Wellington with the following:

    TZ_Auckland_Wellington= 290,-720,-60,8,0,5,2,3,0,0,3
    
  4. Save the changes to the file

  5. Stop and then start the Tomcat service

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.

DDTS

Description

CSCsj81527 (registered customers only)

Unity Inbox: time stamp adjustment not valid for DST change in 2007 NZ

CSCsj81671 (registered customers only)

JVM version installed is not compliant with 2007 DST changes NewZealand

CSCsj81705 (registered customers only)

Unity will have Incorrect time stamps during (NZ)DST w/o Windows Patch

 

Revision History

Revision

Date

Comment

1.0

27-AUG-2007

Initial Public Release

1.1

29-AUG-2007

Maintenance Update

 

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:

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.