olsontimezone
To set the Olson Timezone so that the correct local time is displayed on Cisco Unified SCCP IP phones or Cisco Unified SIP IP phones, use the olsontimezone command in telephony-service or voice register global configuration mode, respectively. To return to the default, use the no form of this command.
olsontimezone timezone version number
no olsontimezone
Syntax Description
timezone |
Olson Timezone names, which include the area (name of continent or ocean) and location (name of a specific location within that region, usually cities or small islands). |
||
version number |
Version of the tzupdater.jar or TzDataCSV.csv file. The version indicates whether the file needs to be updated or not.
|
Command Default
No Olson Timezone is set.
Command Modes
Telephony-service configuration (config-telephony)
Voice register global configuration (config-register-global)
Command History
Release |
Modification |
---|---|
15.2(2)T |
This command was introduced. |
Usage Guidelines
Use the olsontimezone command in either telephony-service or voice register global configuration mode, with the current version of Oracle’s Olson Timezone updater tool, tzupdater.jar, to set the correct Olson Timezone.
For Cisco Unified 3911 and 3951 SIP IP phones and Cisco Unified 6921, 6941, 6961, and 6945 SCCP and SIP IP phones, the correct Olson Timezone updater file is TzDataCSV.csv. The TzDataCSV.csv file is created based on the tzupdater.jar file.
To set the correct time zone, you must determine the Olson Timezone area/location where the Cisco Unified CME is located and download the latest tzupdater.jar or TzDataCSV.csv to a TFTP server (such as flash or slot 0) that is accessible to the Cisco Unified CME.
After a complete reboot, the phone checks if the version of its configuration file is earlier or later than 2010o. If it is earlier, the phone loads the latest tzupdater.jar and uses that updater file to calculate the Olson Timezone.
To make the Olson Timezone feature backward compatible, both the time-zone and timezone commands are retained as legacy time zones. Because the olsontimezone command covers approximately 500 time zones (Version 2010o of the tzupdater.jar file supports approximately 453 Olson Timezone IDs.), this command takes precedence when either the time-zone or the timezone command (that covers a total of 90 to100 time zones only) is present at the same time as the olsontimezone command.
Examples
The following example shows 7:29 p.m. as the time set on a Cisco Unified 7961 SCCP IP phone in Buenos Aires on May 13, 2011:
Router(config)# tftp-server flash:tzupdater.jar
Router(config)# tftp-server flash:TzDataCSV.csv
Router(config)# telephony-service
Router(config-telephony)# olsontimezone America/Argentina/Buenos Aires version 2010o
Router(config-telephony)# create cnf-files
Router(config-telephony)# time-zone 21
Router(config-telephony)# exit
Router(config)# clock timezone CST -6
Router(config)# clock summer-time date 12 October 2010 2:00 26 April 2011 2:00
Router(config)# exit
Router# clock set 19:29:00 13 May 2011
Router# configure terminal
Router(config)# telephony-service
Router(config-telephony)# reset
The following example shows 3:25 p.m. as the time set on a Cisco Unified 6921 SIP IP phone in Buenos Aires on November 17, 2011:
Router(config)# tftp-server slot0:tzupdater.jar
Router(config)# tftp-server slot0:TzDataCSV.csv
Router(config)# voice register global
Router(config-register-global)# olsontimezone America/Argentina/Buenos Aires version 2010o
Router(config-register-global)# create profile
Router(config-register-global)# timezone 21
Router(config-register-global)# exit
Router(config)# clock timezone CST -6
Router(config)# clock summer-time date 12 October 2010 2:00 26 April 2011 2:00
Router(config)# exit
Router# clock set 15:25:00 17 November 2011
Router# configure terminal
Router(config)# voice register global
Router(config-register-global)# reset