You are on page 1of 42

11

Configuring Localization Support
This chapter describes the localization support in Cisco Unified Communications Manager Express
(Cisco Unified CME) for languages other than English and network tones and cadences not specific to
the United States.
Finding Feature Information in This Module

Your Cisco Unified CME version may not support all of the features documented in this module. For a
list of the versions in which each feature is supported, see the “Feature Information for Localization Support”
section on page 426.

Contents

Information About Localization, page 386

SCCP: How to Configure Localization Support, page 391

SIP: How to Configure Localization Support, page 406

Configuration Examples for Localization, page 416

Where to Go Next, page 424

Additional References, page 425

Feature Information for Localization Support, page 426

Cisco Unified Communications Manager Express System Administrator Guide

385

11

Configuring Localization Support

Information About Localization

Information About Localization
To configure localization support, you should understand the following concepts:

Localization Enhancements in Cisco Unified CME, page 386

System-Defined Locales, page 387

Localization Support for Cisco Unified SIP IP Phones, page 387

User-Defined Locales, page 388

Localization Support for Phone Displays, page 389

Multiple Locales, page 389

Locale Installer for Cisco Unified SCCP IP Phones, page 390

Locale Installer for Cisco Unified SIP IP Phones, page 390

Localization Enhancements in Cisco Unified CME
Cisco Unified CME supports the French locale but some phrases in France French and Canadian French
differ. In Cisco Unified CME 9.5, Canadian French is supported as a user-defined locale on Cisco
Unified SIP IP phones and Cisco Unified SCCP IP phones when the correct locale package is installed.

Note

Some abbreviations such as BLF, SNR, and CME are not localized.

Prerequisites

Cisco Unified CME 9.5 or later version

Locale package version 9.5.2.6 is required

Restrictions
All the localization enhancements are supported in Cisco Unified CME only. They are not supported in
Cisco Unified SRST.Table 11-1 shows the language codes used in the filenames of locale files.
Table 11-1

Language Codes for User-Defined Locales

Language

Language Code

Canadian French

fr_CA

For configuration information, see the “Installing User-Defined Locales” section on page 395”.

Cisco Unified Communications Manager Express System Administrator Guide

386

11

Configuring Localization Support
Information About Localization

System-Defined Locales
Cisco Unified CME provides built-in, system-defined localization support for 12 languages including
English and 16 countries including the United States. Network locales specify country-specific tones
and cadences; user locales specify the language to use for text displays.
Configuring system-defined locales depends on the type of IP phone:

Cisco Unified IP Phone 7905, 7912, 7940, and 7960—System-defined network locales and user
locales are preloaded into Cisco IOS software. No external files are required. Use the
network-locale and user-locale commands to set the locales for these phones.

Cisco Unified IP Phone 6921, 6945, 7906, 7911, 7921, 7931, 7941, 7961, 7970, 7971, 8941, 8945,
and Cisco IP Communicator—You must download locale files to support the system-defined locales
and store the files in flash memory, slot 0, or on an external TFTP server. See the “Installing
System-Defined Locales for Cisco Unified IP Phone 6921, 6945, 7906, 7911, 7921, 7931, 7941,
7961, 7970, 7971, and Cisco IP Communicator” section on page 391.

Cisco Unified 3905, 6941, 6945, 8961, 9951, and 9971 SIP IP Phones—You must download locale
files to support the system-defined locales and store the files in flash memory, slot 0, or on an
external TFTP server.

Note

TFTP aliases for localization are not automatically created for Cisco Unified SIP IP phones in a
Cisco Unified CME system. For more information on how to manually create TFTP aliases, see
the “Installing System-Defined Locales for Cisco Unified IP Phone 8961, 9951, and 9971”
section on page 406.

Note

Cisco Unified CME 10.5 Release onwards, the System defined locales are deprecated and
User-defined locales are recommended.

Cisco Unified 3905 SIP IP Phones and Cisco Unified 6945, 8941, and 8945 SCCP IP Phones have
support for all locales up to Cisco Unified CME 8.8.

Localization Support for Cisco Unified SIP IP Phones
Cisco Unified CME 8.6 provides localization support for 12 languages including English and
16 countries including the United States. Network locales specify country-specific tones and cadences;
user locales specify the language to use for text displays. Create additional localization support with
user-defined locales. For more information about user-defined locales, see the “User-Defined Locales”
section on page 388.
In Cisco Unified CME 9.0 and later versions, localization is enhanced to support Cisco Unified 6941 and
6945 SIP IP Phones.
The load command supports both user-defined and system-defined locales.

Note

The locale files must be stored in the same location as the configuration files.

Cisco Unified Communications Manager Express System Administrator Guide

387

11

Configuring Localization Support

Information About Localization

User-Defined Locales
The user-defined locale feature allows you to support network and user locales other than the
system-defined locales that are predefined in Cisco IOS software. For example, if your site has phones
that must use the language and tones for Traditional Chinese, which is not one of the system-defined
choices, you must install the locale files for Traditional Chinese.
In Cisco Unified CME 4.0 and later versions, you can download files to support a particular user and
network locale and store the files in flash memory, slot 0, or an external TFTP server. These files cannot
be stored in the system location. User-defined locales can be assigned to all phones or to individual
phones.
User-defined language codes for user locales are based on ISO 639 codes, which are available at the
Library of Congress website at http://www.loc.gov/standards/iso639-2/. User-defined country codes for
network locales are based on ISO 3166 codes.
For configuration information, see the “Installing User-Defined Locales” section on page 395.

Cisco Unified Communications Manager Express System Administrator Guide

388

see the “Configuring Multiple Locales” section on page 402. Display options configured through Cisco IOS commands are not localized. the default is US (United States). H. and 9971. you must use per-phone configuration files to build individual configuration files for each phone. E. messages. and English for phones G. The following display items are localized by the IP phone (. and C. you can specify French for phones A. If you do not specify a locale for tag 0. 9951. Cisco Unified Communications Manager Express System Administrator Guide 389 . and I. the default user locale for all phones is JP. and F. Redial and CFwdALL) The following display items are localized by the dictionary file for Cisco Unified CME: • Directory Service (Local Directory. Only one user and network locale can be applied to each phone. services. you can specify up to five user and network locales and apply different locales to individual ephones or groups of ephones using ephone templates. German for phones D.jar file): • System menus accessed with feature buttons (for example. To apply alternative locales to different phones. For example. For example. The locale identified by tag 0 is always the default locale. Each of the five user and network locales that you can define in a multilocale system is identified by a locale tag. directories. For example. and information) • Call processing messages • Soft keys (for example.11 Configuring Localization Support Information About Localization Localization Support for Phone Displays On the Cisco Unified IP Phone 8961. B. and Personal Speed Dial) • Status Line Display options configured through Cisco IOS commands are not localized and can only be displayed in English. For configuration information. You can override these defaults for individual phones by configuring alternative locale codes and then creating ephone-templates to assign the locales to individual ephones.jar) or the Cisco Unified CME dictionary file are localized. Local Speed Dial. this includes features such as: • Caller ID • Header Bar • Phone Labels • System Message Multiple Locales In Cisco Unified CME 8. The configuration files automatically use the default user-locale 0 and network-locale 0. although you can define this default to be any supported locale. settings.6 and later versions. menus and prompts that are managed by the locale file for the IP phone type (. if you define user locale 0 to be JP (Japanese).

Cisco Unified Communications Manager Express System Administrator Guide 390 . The command syntax is user-locale [user-locale-tag] {[user-defined-code] country-code} [load TAR-filename]. when you configure the load command for phone firmware versions later than version 8-2-2 for all phone types.0 and Later Versions” section on page 409. For example.1. To use this feature in Cisco Unified CME 7. • Cisco Unified CME parses new firmware-load text files and automatically creates the TFTP aliases for localization.loads Router(config-telephony)# Note In Cisco Unified CME 4.0 and later versions support the following enhancements for installing locales for Cisco Unified SIP IP phones: • Locale installer that supports a single procedure for all Cisco Unified SIP IP phones.8-3-3S. you do not need to perform manual configuration.0(1) and Later Versions” section on page 398.0(1).0(1). the following enhancements for installing locales are supported: • Locale installer that supports a single procedure for all SCCP IP phones.tar With the locale installer. Router(config-register-global)# user-locale 2 DE load CME-locale-de_DE-German-8. For configuration information. Locale Installer for Cisco Unified SIP IP Phones Cisco Unified CME 9.0(1) and later versions. eliminating the requirement for you to manually create up to five aliases for files in the TAR file. • New load keyword that requires you to use the complete filename. For example. Instead. most of which were manual and some of which required filename changes.6. see the “Using the Locale Installer in Cisco Unified CME 9. see the “Using the Locale Installer in Cisco Unified CME 7. For example: Router(config-telephony)# load 7941 SCCP41. you must use the complete filename. you copy the locale file using the copy command in privileged EXEC configuration mode.tar). For example: Router(config-telephony)# load 7941 SCCP41.6.0.3.8-2-2SR2S • Backward compatibility with the configuration method in Cisco Unified CME 7.100/CME-locale-de_DE-German-8.1. including the file suffix.0. In Cisco Unified CME 7. including the file suffix (.0 and earlier versions.3. you do not include the file suffix for any phone type except Cisco ATA and Cisco Unified IP Phone 7905 and 7912.tar flash:/its For configuration information.11 Configuring Localization Support Information About Localization Locale Installer for Cisco Unified SCCP IP Phones Before Cisco Unified CME 7. Router# copy tftp://12. when you configure the user-locale command for all Cisco Unified SIP IP phone types. Note You must copy the locale file into the /its directory (flash:/its or slot0:/its) when you store the locale files on the Cisco Unified CME router. configuring localization required up to 16 steps.3 and earlier versions.

0(1) and later versions. 7970. 7921. • You must have an account on Cisco. 7961. 7961. • Phone firmware. • You must create per-phone configuration files as described in the “SCCP: Defining Per-Phone Configuration Files and Alternate Location” section on page 155. Prerequisites • Cisco Unified CME 4. and locale files must be in the same directory. Restrictions Step 1 Go to http://www. 7971.11 Configuring Localization Support SCCP: How to Configure Localization Support SCCP: How to Configure Localization Support This section contains the following tasks: • Installing System-Defined Locales for Cisco Unified IP Phone 6921. Cisco Unified Communications Manager Express System Administrator Guide 391 . page 391 (required) • Installing User-Defined Locales.cisco. User locale files allow an IP phone to display the menus and prompts in the specified language. 6945. 7971. You must have an account on Cisco. If you do not have an account or if you have forgotten your username or password.0(1) and Later Versions” section on page 398. • Localization is not supported for SIP phones. and Cisco IP Communicator Network locale files allow an IP phone to play the proper network tone for the specified country. perform the following steps. which must be in flash memory. page 395 (optional) • Using the Locale Installer in Cisco Unified CME 7. To use the locale installer in Cisco Unified CME 7. 6945. 7911. configuration files. To download and install locale files for system-defined locales. see the “Using the Locale Installer in Cisco Unified CME 7.pl/CME-Locale.0(1) and Later Versions. You must download and install a tone file for the country you want to support. page 402 (optional) • Verifying Multiple Locales.and user-defined locales in Cisco Unified CME 7.0(1) and later versions. 7941.com to download locale files. except the directory file for Japanese and Russian. click the appropriate button at the login dialog box and follow the instructions that appear. 7931. 7970.com to access the Software Download Center. 7911.com/cgi-bin/tablebuild. page 402 (optional) • Configuring Multiple Locales. 7906. Tip The locale installer simplifies the installation and configuration of system. page 405 (optional) Installing System-Defined Locales for Cisco Unified IP Phone 6921. 7941. page 398 (optional) • Verifying User-Defined Locales. 7931. 7906. 7921.0(2) or a later version. and Cisco IP Communicator. You must download and install JAR files and dictionary files for each language you want to support.

xml for country-specific network tones and cadences.2-2. de-td-sccp.0.1/cme-locale-de_DE-4.2-2. Each TAR file contains locale files for a specific language and country and uses the following naming convention: CME-locale-language_country-CMEversion For example. Each TAR file also includes the file g3-tones.1.1.0.jar is for German on the Cisco Unified IP Phone 7970.0.2-2. Each phone type has a JAR file that uses the following naming convention: language-phone-sccp. Step 4 Download the TAR file to a TFTP server that is accessible to the Cisco Unified CME router.168.jar For example. Router# archive tar /xtract source-url flash:/file-url For example.0. Table 11-2 Phone-Type Codes for Locale JAR Files Phone Type Phone Code 6921 rtl 6945 rtl 7906/7911 tc 7931 gp 7941/7961 mk 7970/7971 td 8941/8945 gh CIPC ipc Table 11-3 System-Defined User and Network Locales Language Language Code User-Locale Directory Name Country Code Network-Locale Directory Name English en English_United_States1 US United_States English_United_Kingdom UK Danish dk Danish_Denmark Cisco Unified Communications Manager Express System Administrator Guide 392 United_Kingdom CA Canada DK Denmark .1 to router flash memory.11 Configuring Localization Support SCCP: How to Configure Localization Support Step 2 Navigate to Downloads Home > Products > Unified Communications > Call Control > Mid-Market Call Control > Cisco Unified Communications Manager Express > Unified Communications Manager Express Individual File Set and select your version of Cisco Unified CME. slot 0. or an external TFTP server.tar flash: Step 6 See Table 11-2 and Table 11-3 for a description of the codes used in the filenames and the list of supported directory names. Each file contains all the firmware required for all phone types supported by that version of Cisco Unified CME.0(2). Step 3 Select the TAR file for the locale you want to install.0 is German for Germany for Cisco Unified CME 4. CME-locale-de_DE-4.0. to extract the contents of CME-locale-de_DE-4.tar from TFTP server 192. Step 5 Use the archive tar command to extract the files to flash memory.168. use this command: Router# archive tar /xtract tftp://192.

the TFTP aliases for German and Germany for the Cisco Unified IP Phone 7970 are: Router(config)# tftp-server flash:/de-td-sccp. Step 7 If you store the locale files in flash memory or slot 0 on the Cisco Unified CME router.jar alias German_Germany/td-sccp. 7912. the TFTP alias for German for the Cisco Unified IP Phone 7970 is: Router# tftp-server flash:/its/de-td-sccp.jar Router(config)# tftp-server flash:/g3-tones. For example. create a TFTP alias for the user locale (text displays) and network locale (tones) using this format: Router(config)# tftp-server flash:/jar_file alias directory_name/td-sccp. 7970. 7961.S.jar alias German_Germany/td-sccp. For example.11 Configuring Localization Support SCCP: How to Configure Localization Support Table 11-3 System-Defined User and Network Locales Language Language Code User-Locale Directory Name Country Code Network-Locale Directory Name Dutch nl Dutch_Netherlands NL Netherlands French fr French_France FR France CA Canada DE Germany AT Austria CH Switzerland German de Italian German_Germany it Italian_Italy IT Italy jp Japanese_Japan JP Japan Norwegian no Norwegian_Norway NO Norway Portuguese pt Portuguese_Portugal PT Portugal Russian ru Russian_Russia RU Russian_Federation Spanish es Spanish_Spain ES Spain Swedish se Swedish_Sweden SE Sweden Japanese 2 1.xml alias directory_name/g3-tones.xml Use the appropriate directory name shown in Table 11-3 and remove the two-letter language code from the JAR file name. 7940. 7941. You do not need to install the JAR file for U.jar Cisco Unified Communications Manager Express System Administrator Guide 393 . Katakana is supported by Cisco Unified IP Phone 7905. English unless you assign a different language to a phone and then want to reassign English. Kanji is supported by Cisco Unified IP Phone 7911. and 7971. English for the United States is the default language.jar Router(config)# tftp-server flash:/g3-tones.xml alias Germany/g3-tones. you must include /its in the directory name (flash:/its or slot0:/its). and 7960. 2.xml Note On Cisco 3800 series routers.

Use the appropriate directory name shown in Table 11-3 and remove the two-letter language code from the JAR file name. • Only flash memory can be used for these locales.11 Configuring Localization Support SCCP: How to Configure Localization Support Step 8 If you store the locale files on an external TFTP server.xml Step 9 For Russian and Japanese. Japanese_tags_utf8_phrases for Japanese. you must copy the UTF8 dictionary file into flash memory to use special phrases. Step 11 To support more than one user or network locale. use the user-locale and network-locale commands in telephony-service configuration mode. Step 10 Assign the locales to phones. • Use the user-locale jp and user-locale ru command to load the UTF8 phrases into Cisco Unified CME.jar TFTP-Root/Germany/g3-tones. see the “Configuring Multiple Locales” section on page 402. create a directory under the TFTP root directory for each user and network locale. To set a default locale for all phones. Cisco Unified Communications Manager Express System Administrator Guide 394 . Step 12 Use the create cnf-files command to rebuild the configuration files. Copy russian_tags_utf8_phrases for Russian. Step 13 Use the reset command to reset the phones and see the localized displays. For example. the user-locale directory for German and the network-locale directory for Germany for the Cisco Unified IP Phone 7970 are: TFTP-Root/German_Germany/td-sccp.

0(3).3-2. • User-defined locales are not supported if the configuration file location is “system:”. Step 3 Select the TAR file for the locale that you want to install. However.” and so forth.0 is Traditional Chinese for China for Cisco Unified CME 4. To install up to five user-defined locale files to use with phones.” “Speed Dial/Fast Dial. • User-defined locales are not supported on the Cisco Unified IP Phone 7920 or 7936. flash memory. the System defined locales are deprecated and User-defined locales are recommended. If you do not have an account or if you have forgotten your username or password. • When you use the setup tool from the telephony-service setup command to provision phones.0. you can only choose a default user locale and network locale and you are limited to selecting a locale code that is supported in the system. Step 5 Use the archive tar command to extract the files to slot 0.pl/CME-Locale You must have an account on Cisco. Step 4 Download the TAR file to a TFTP server that is accessible to the Cisco Unified CME router. the older locale packages can be still used but some phrases may be displayed in English.11 Configuring Localization Support SCCP: How to Configure Localization Support Installing User-Defined Locales You must download XML files for locales that are not predefined in the system.cisco. You cannot use multiple locales or user-defined locales with the setup tool.com to download locale files. the phone normally displays text using the user-defined fonts. CME-locale-zh_CN-4. Step 2 Navigate to Downloads Home > Products > Unified Communications > Call Control > Mid-Market Call Control > Cisco Unified Communications Manager Express > Unified Communications Manager Express Individual File Set and select your version of Cisco Unified CME. Router# archive tar /xtract source-url flash:/file-url Cisco Unified Communications Manager Express System Administrator Guide 395 .5 Release onwards. except for any strings that are interpreted by Cisco Unified CME. • When using a user-defined locale. • You must have an account on Cisco. Prerequisites • Cisco Unified CME 4. click the appropriate button at the login dialog box and follow the instructions that appear. Each file contains all the firmware required for all phone types supported by that version of Cisco Unified CME.0(3) or a later version.com/cgi-bin/tablebuild.com to access the Software Download Center. perform the following steps. Note From Cisco Unified CME 10. • You must create per-phone configuration files as described in the “SCCP: Defining Per-Phone Configuration Files and Alternate Location” section on page 155. Each TAR file contains locale files for a specific language and country and uses the following naming convention: CME-locale-language_country-CMEversion-fileversion For example. Restrictions Step 1 Go to http://www. such as “Cisco/Personal Directory. or an external TFTP server.

168.3-2.jar is Traditional Chinese for the Cisco Unified IP Phone 7970. 7912.0.1 to router flash memory. zh-td-sccp. Table 11-4 Phone-Type Codes for Locale Files Phone Type Code 6921 rtl 6945 rtl 7906/7911 tc 7931 gp 7941/7961 mk 7970/7971 td 8941/8945 gh CIPC ipc Table 11-5 Language Codes for User-Defined Locales Language Language Code Bulgarian bg Chinese zh1 Croation hr Czech Republic cs Finnish fi Greek el Hungarian hu Korean ko Polish pl Portugese (Brazil) pt Romanian ro Serbian sr Slovakian sk Slovenian sl Turkish tr Cisco Unified Communications Manager Express System Administrator Guide 396 .3-2.168.0. Step 7 Each phone type has a JAR file that uses the following naming convention: language-type-sccp. 7970. to extract the contents of CME-locale-zh_CN-4.11 Configuring Localization Support SCCP: How to Configure Localization Support For example. See Table 11-4 and Table 11-5 for a description of the codes used in the filenames. or 7960. For Cisco Unified IP Phone 7911.1. 7961.0. or 7971. 7940. use this command: Router# archive tar /xtract tftp://192.1/cme-locale-zh_CN-4. go to Step 7.jar For example.1.0. go to Step 11.tar flash: Step 6 For Cisco Unified IP Phone 7905. 7941.tar from TFTP server 192.

7905-dictionary. where number is 1 to 5 For example.xml 7905-kate.xml 7960-font.11 Configuring Localization Support SCCP: How to Configure Localization Support 1.jar Step 10 Go to Step 13.jar Step 9 If you store the locale files on an external TFTP server. the TFTP alias for Chinese for the Cisco Unified IP Phone 7970 is: Router(config)# tftp-server flash:/its/zh-td-sccp.xml SCCP-dictionary.xml 7920-dictionary. for Chinese on the Cisco Unified IP Phone 7970. where number is 1 to 5 For example. code for Chinese Simplified is chs.jar alias user_define_1/td-sccp. All required files are included in the JAR file. Step 11 Download one or more of the following XML files depending on your selected locale and phone type. the alias for Chinese on the Cisco Unified IP Phone 7970 is: Router(config)# tftp-server flash:/zh-td-sccp. you must include /its in the directory name (flash:/its or slot0:/its). Remove the two-letter language code from the JAR filename and use one of five supported directory names with the following convention: user_define_number.xml 7960-dictionary.xml 7960-kate.xml SCCP-dictionary.xml 7960-tones. create a directory under the TFTP root directory for each locale.xml 7905-font. For Cisco Unified IP Phone 7931. create a TFTP alias using this format: Router(config)# tftp-server flash:/jar_file alias directory_name/td-sccp.jar Remove the two-letter language code from the JAR filename and use one of five supported directory names with the following convention: user_define_number. For example. Step 8 If you store the locale files in flash memory or slot 0 on the Cisco Unified CME router.jar Note On Cisco 3800 series routers.jar alias user_define_1/td-sccp. remove “zh” from the JAR filename and create the “user_define_1” directory under TFTP-Root on the TFTP server: TFTP-Root/user_define_1/td-sccp.utf-8.xml Cisco Unified Communications Manager Express System Administrator Guide 397 . Chinese Traditional is cht.

xml user_define_1_SCCP-dictionary.com to download locale files. Prerequisites • Cisco Unified CME 7.xml Step 13 Copy the language_tags_file and language_utf8_tags_file to the location of the other locale files (flash memory. 7906. 7931. or TFTP server).0(1) and Later Versions To install and configure locale files to use with SCCP phones in Cisco Unified CME. • You must have an account on Cisco. slot 0.3/7. To use the same procedures as you used with earlier versions of Cisco Unified CME. perform the following steps. see the “Installing System-Defined Locales for Cisco Unified IP Phone 6921.xml user_define_1_7920-dictionary.0(1) or a later version. Using the Locale Installer in Cisco Unified CME 7. 7971.0 and earlier versions.xml user_define_1_7960-tones. Rename the files to user_define_number_tags_file and user_define_number_utf8_tags_file respectively. Step 15 Use the create cnf-files command to rebuild the configuration files. For example. or an external TFTP server. 7921. See the “SCCP: Defining Per-Phone Configuration Files and Alternate Location” section on page 155. slot 0.xml user_define_1_7905-kate. 7970.xml user_define_1_7960-kate. sufficient space must be on the flash file system for extracting the contents of the locale TAR file. you must manually create the user locale folders in the root directory. This is a limitation of the TFTP server.xml user_define_1_SCCP-dictionary. • Locale support is limited to phone firmware versions that are supported by Cisco Unified CME. use the following names if you are setting up the first user-locale: user_define_1_7905-dictionary.xml user_define_1_7905-font. 7961.xml user_define_1_7960-font. • You must configure Cisco Unified CME for per-phone configuration files. and Cisco IP Communicator” section on page 391. 6945. • When the storage location specified by the cnf-file location command is flash memory. Rename the files using the format user_define_number_filename where number is 1 to 5. Step 16 Use the reset command to reset the phones and see the localized displays. • When using an external TFTP server.utf-8. See the “Configuring Multiple Locales” section on page 402. 7911. Tip Cisco Unified CME 7. 7941. Restrictions Cisco Unified Communications Manager Express System Administrator Guide 398 .0(1) provides backward compatibility with the configuration method in Cisco Unified CME 4.xml user_define_1_7960-dictionary. Step 14 Assign the locales to phones.11 Configuring Localization Support SCCP: How to Configure Localization Support Step 12 Rename these files and copy them to flash memory. where number is 1 to 5 and matches the user-defined directory.

11 Configuring Localization Support SCCP: How to Configure Localization Support • User-defined locales are not supported on the Cisco Unified IP Phone 7920 or 7936. • When using a user-defined locale. such as “Cisco/Personal Directory. and you are limited to selecting a locale code that is supported in the system. You cannot use multiple locales or user-defined locales with the setup tool.” and “Speed Dial/Fast Dial.” Cisco Unified Communications Manager Express System Administrator Guide 399 . • User-defined locales are not supported if the configuration file location is system. the phone normally displays text using the user-defined fonts. except for any strings that are interpreted by Cisco Unified CME. • When you use the setup tool from the telephony-service setup command to provision phones. you can only choose a default user locale and network locale.

b. This is a limitation of the IP phone. Step 1 Go to http://www.0 is German for Germany for Cisco Unified CME 7.11 Configuring Localization Support SCCP: How to Configure Localization Support • If you install and configure a user-defined locale using country codes U1-U5 and then you install a new locale using the same label.pl/CME-Locale You must have an account on Cisco. Each TAR file contains locale files for a specific language and country and uses the following naming convention: CME-locale-language_country-CMEversion For example.1. Each file contains all the firmware required for all phone types supported by that version of Cisco Unified CME. use the locale folder name as shown in Table 11-6. the phone retains the original language locale even after the phone is reset. Cisco Unified Communications Manager Express System Administrator Guide 400 .pkg LOCALE ERROR: User Defined Locale U2 already exists on locale index 2.com/cgi-bin/tablebuild.com to access the Software Download Center. create the folder for system-defined German as follows: TFTP-Root/de_DE-7. If you do not have an account or have forgotten your username or password. a. TFTP-Root/TAR-filename For system-defined locales. If the cnf-file location is flash memory: Copy the TAR file to the flash:/its directory.0.0. For example. CME-locale-de_DE-7.0. Step 3 Select the TAR file for the locale you want to install.tar Note For a list of user-defined languages supported in Cisco Unified CME.pkg Router(config-telephony)# user-locale 1 U2 load Chinese. For example. • Each user-defined country code (U1-U5) can be used for only one user-locale-tag at a time. If the cnf-file location is tftp: Create a folder in the root directory of the TFTP server for each locale using the following format and then copy the TAR file to the TFTP-Root folder. For example: Router(config-telephony)# user-locale 2 U2 load Finnish. Step 4 Download the TAR file to the location previously specified by the cnf-file location command. click the appropriate button at the login dialog box and follow the instructions that appear. use the User_Define_n folder name as shown in Table 11-6. To work around this limitation. you must configure the new package using a different country code.0(1). see the Cisco Unified CME Localization Matrix.1.1.0. c.tar For up to five user-defined locales. create the folder for user-defined locale Chinese (User_Define_1) as follows: TFTP-Root/CME-locale-zh_CN-7.0. If the cnf-file location is slot0: Copy the TAR file to the slot0:/its directory. A user-defined locale is a language other than the system-defined locales that are predefined in Cisco IOS software. Step 2 Navigate to Downloads Home > Products > Unified Communications > Call Control > Mid-Market Call Control > Cisco Unified Communications Manager Express > Unified Communications Manager Express Individual File Set and select your version of Cisco Unified CME.cisco.

see Table 11-6. Katakana is supported by Cisco Unified IP Phone 7905. Kanji is supported by Cisco Unified IP Phone 7911.11 Configuring Localization Support SCCP: How to Configure Localization Support Table 11-6 System-Defined and User-Defined Locales Language Locale Folder Name Country Code English English_United_States US English_United_Kingdom UK CA Danish Danish_Denmark DK Dutch Dutch_Netherlands NL French French_France FR CA German German_Germany DE AT CH Italian Italian_Italy IT Japanese_Japan JP Norwegian Norwegian_Norway NO Portuguese Portuguese_Portugal PT Russian Russian_Russia RU Spanish Spanish_Spain ES Swedish Swedish_Sweden Japanese Un 2 1 User_Define_n 2 SE Un2 1. use this command: Router (telephony-service)# user-locale U1 load CME-locale-zh_CN-7. to extract the contents of the CME-locale-zh_CN-7. Where “n” is a number from 1 to 5. 2. 7941.tar file when U1 is the country code for user-defined locale Chinese (User_Define_1). For country codes.0. 7912.0.0. Step 5 Use the user-locale [user-locale-tag] country-code load TAR-filename command in telephony-service configuration mode to extract the contents of the TAR file. See the “Configuring Multiple Locales” section on page 402.1.tar Step 6 Assign the locales to phones. 7940. and 7971. 7961. and 7960. Step 7 Use the create cnf-files command to rebuild the configuration files. For example.1.0. Step 8 Use the reset command to reset the phones and see the localized displays. 7970. Cisco Unified Communications Manager Express System Administrator Guide 401 .

enable 2. configure terminal 3. user-locale [user-locale-tag] {[user-defined-code] country-code} 5. 7910. or the Cisco Unified IP Conference Stations 7935 and 7936. see the “SCCP: Defining Per-Phone Configuration Files and Alternate Location” section on page 155. create cnf-files 7. • You can also use user-defined locale codes as alternative locales after you download the appropriate XML files. network-locale network-locale-tag [user-defined-code] country-code 6. telephony service Cisco Unified Communications Manager Express System Administrator Guide 402 . exit 8. • To specify alternative user and network locales for individual phones in a Cisco Unified CME system. telephony-service 4. ephone-template template-tag 14. or 7920. ephone phone-tag 13. • When you use the setup tool from the telephony-service setup command to provision phones. You cannot use multiple or user-defined locales with the setup tool. ephone-template template-tag 9. Configuring Multiple Locales To define one or more alternatives to the default user and network locales and apply them to individual phones. user-locale user-locale-tag Restrictions SUMMARY STEPS 10. • Multiple user and network locales are not supported on the Cisco Unified IP Phone 7902G. 1. exit 15. you can only choose a default user locale and network locale and you must select a locale code that is predefined in the system. perform the following steps. 7910G. exit 12. you must use per-phone configuration files. See the “Installing User-Defined Locales” section on page 395. For more information.11 Configuring Localization Support SCCP: How to Configure Localization Support Verifying User-Defined Locales See the “Verifying Multiple Locales” section on page 405. Prerequisites • Cisco Unified CME 4.0 or a later version. network-locale network-locale-tag 11.

U4. and U5. telephony-service Example: Router(config)# telephony-service Step 4 Specifies a language for phone displays. U4. • country-code—Type ? to display a list of system-defined codes. This argument is required when defining some locale other than the default (0). Default: US (United States). Valid codes are U1. create cnf-files Example: Router(config-telephony)# create cnf-files Cisco Unified Communications Manager Express System Administrator Guide 403 . • user-defined-code—(Optional) Assigns one of the user-defined codes to the specified country code. Default: US (United States). • Enter your password if prompted. Range is 0 to 4. Use this command after you update configuration file parameters such as the user locale or network locale. You can assign any valid ISO 3166 code to a user-defined code (U1 to U5). Example: Router(config-telephony)# user-locale 1 U1 ZH Step 5 Specifies a country for tones and cadences. Example: Router> enable Step 2 Enters global configuration mode. U2. Example: Router(config-telephony)# network-locale 1 FR Step 6 Builds the required XML configuration files for IP phones. network-locale network-locale-tag [user-defined-code] country-code • network-locale-tag—Assigns a locale identifier to the country code. end DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. U2. reset {all [time-interval] | cancel | mac-address mac-address | sequence-all} 17. Default: 0. This argument is required when defining some locale other than the default (0). user-locale [user-locale-tag] {[user-defined-code] country-code} • user-locale-tag—Assigns a locale identifier to the locale. and U5. U3. configure terminal Example: Router# configure terminal Step 3 Enters telephony-service configuration mode. • user-defined-code—(Optional) Assigns one of the user-defined codes to the specified country code. U3.11 Configuring Localization Support SCCP: How to Configure Localization Support 16. Valid codes are U1. Range is 0 to 4. Default: 0. You can assign any valid ISO 639 code to a user-defined code (U1 to U5). • country-code—Type ? to display a list of system-defined codes.

Example: Router(config-ephone)# exit Step 15 telephony-service Enters telephony-service configuration mode. Example: Router(config-telephony)# exit Step 8 ephone-template template-tag Enters ephone-template configuration mode. Router(config)# ephone template 1 Step 9 user-locale user-locale-tag Assigns a user locale to this ephone template. • Example: template-tag—Number of the template to apply to this ephone. • Example: user-locale-tag—A locale tag that was created in Step 4. Example: Router(config)# telephony-service Cisco Unified Communications Manager Express System Administrator Guide 404 . • Example: phone-tag—Unique sequence number that identifies this ephone during configuration tasks. Router(config-ephone-template)# user-locale 2 Step 10 network-locale network-locale-tag Assigns a network locale to this ephone template. Range is 0 to 4. Router(config-ephone-template)# network-locale 2 Step 11 exit Exits ephone-template configuration mode. Router(config)# ephone 36 Step 13 ephone-template template-tag Applies an ephone template to an ephone. Example: Router(config-ephone-template)# exit Step 12 ephone phone-tag Enters ephone configuration mode. Router(config-ephone)# ephone-template 1 Step 14 exit Exits ephone configuration mode. • Example: template-tag—Unique sequence number that identifies this template during configuration tasks. Range is 0 to 4.11 Configuring Localization Support SCCP: How to Configure Localization Support Step 7 Command or Action Purpose exit Exits telephony-service configuration mode. • Example: network-locale-tag—A locale tag that was created in Step 5.

in seconds.xml alias German_Germany/7960-font.xml alias Germany/7960-tones.xml alias German_Germany/7960-dictionary.xml tftp-server system:/its/ATADefault.xml tftp-server system:/its/germany/7960-kate. and tone configuration files. Step 4 Use the show telephony-service ephone command to check that the correct templates are applied to phones. • mac-address mac-address—A specific phone. end Example: Router(config-telephony)# end Verifying Multiple Locales Step 1 Use the show telephony-service tftp-bindings command to display a list of configuration files that are accessible to IP phones using TFTP. including the dictionary. including contacting the DHCP and TFTP servers for the latest configuration information.xml alias German_Germany/7960-kate.” and “finished x file”).xml tftp-server system:/its/germany/7960-dictionary. The file is found when all three states are displayed. Default is 15.cnf tftp-server system:/its/XMLDefault. use the debug tftp events command to see which files Cisco Unified CME is looking for and whether the files are found and opened correctly. • time-interval—(Optional) Time interval. Step 3 Use the show telephony-service ephone-template command to check the user locale and network locale settings in each ephone template.xml tftp-server system:/its/germany/7960-tones. There are usually three states (“looking for x file. Range is 0 to 60.xml tftp-server system:/its/germany/SCCP-dictionary.xml tftp-server system:/its/germany/7960-font.11 Configuring Localization Support SCCP: How to Configure Localization Support Step 16 Command or Action Purpose reset {all [time-interval] | cancel | mac-address mac-address | sequence-all} Performs a complete reboot of all phones or the specified phone. For an external TFTP server you can use the logs from the TFTP server. between each phone reset.cnf.” “opened x file.cnf. Example: • all—All phones in the Cisco Unified CME system. Step 5 If the configuration file location is not TFTP. Cisco Unified Communications Manager Express System Administrator Guide 405 . • cancel—Interrupts a sequential reset cycle that was started with a reset sequence-all command.cnf.xml alias SEP00036B54BB15.xml Step 2 Ensure that per-phone configuration files are defined with the cnf-file perphone command.cnf. Router(config)# show telephony-service tftp-bindings tftp-server system:/its/SEPDEFAULT. Router(config-telephony)# reset all Step 17 Returns to privileged EXEC mode.cnf alias SEPDefault.xml alias XMLDefault.xml alias German_Germany/SCCP-dictionary. • sequence-all—Resets all phones in strict one-at-a-time order by waiting for one phone to reregister before starting the reset for the next phone.cnf tftp-server system:/its/SEPDEFAULT. language.cnf.xml tftp-server system:/its/XMLDefault7960.

User locale files allow an IP phone to display the menus and prompts in the specified language. You must download and install a tone file for the country you want to support. If you do not have an account or if you have forgotten your username or password.com/cgi-bin/tablebuild. click the appropriate button at the login dialog box and follow the instructions that appear.6 or a later version. 9951. Each file contains all the firmware required for all phone types supported by that version of Cisco Unified CME.cisco. You must have an account on Cisco. Cisco Unified CME 8. 9951. Each TAR file contains locale files for a specific language and country and uses the following naming convention: CME-locale-language_country-CMEversion For example.pl/CME-Locale. and locale files must be in the same directory. For Cisco Unified IP Phone 9971.6 is German for Germany for Cisco Unified CME 8. Step 3 Select the TAR file for the locale you want to install. Step 4 Download the TAR file to a TFTP server that is accessible to the Cisco Unified CME router. page 406 (required) • Using the Locale Installer in Cisco Unified CME 9. You must download and install JAR files and dictionary files for each language you want to support. perform the following steps.com to download locale files. Cisco Unified Communications Manager Express System Administrator Guide 406 . • You must have an account on Cisco. configuration files. CME-locale-de_DE-8. page 413 (optional) • Verifying Multiple Locales. Step 2 Navigate to Downloads Home > Products > Unified Communications > Call Control > Mid-Market Call Control > Cisco Unified Communications Manager Express > Unified Communications Manager Express Individual File Set and select your version of Cisco Unified CME.6. and 9971 Network locale files allow an IP phone to play the proper network tone for the specified country. Step 1 Go to http://www. Prerequisites • Cisco Unified CME 8.0 and Later Versions. page 409 (optional) • Configuring Multiple Locales. Restrictions Phone firmware.8 or a later version.com to access the Software Download Center. follow these configuration steps: • Installing System-Defined Locales for Cisco Unified IP Phone 8961. and 9971.11 Configuring Localization Support SIP: How to Configure Localization Support SIP: How to Configure Localization Support To configure localization support for SIP IP phones. To download and install locale files for system-defined locales. page 416 (optional) Installing System-Defined Locales for Cisco Unified IP Phone 8961.

1. Each TAR file also includes the file g4-tones.1.6. Table 11-7 Phone-Type Codes for Locale JAR Files Phone Type Phone Code 3905 cin 6941 rtl 6945 rtl 8961 gh 9951 gd 9971 gd Table 11-8 System-Defined User and Network Locales Language Language Code User-Locale Directory Name Country Code Network-Locale Directory Name English en English_United_States1 US United_States English_United_Kingdom UK United_Kingdom GB United_Kingdom CA Canada AU Australia Danish dk Danish_Denmark DK Denmark Dutch nl Dutch_Netherlands NL Netherlands French fr French_France FR France CA Canada DE Germany AT Austria CH Switzerland German de German_Germany Italian it Italian_Italy IT Italy Japanese jp Japanese_Japan JP Japan Cisco Unified Communications Manager Express System Administrator Guide 407 . Router# archive tar /xtract source-url flash:/file-url For example.jar is for German on the Cisco Unified IP Phone 8961.jar For example. de-gh-sip. use this command: Router# archive tar /xtract tftp://192.168.6.tar flash: Step 6 See Table 11-7 and Table 11-8 for a description of the codes used in the filenames and the list of supported directory names. slot 0.tar from TFTP server 192.11 Configuring Localization Support SIP: How to Configure Localization Support Step 5 Use the archive tar command to extract the files to flash memory. or an external TFTP server.1 to router flash memory. Each phone type has a JAR file that uses the following naming convention: language-phone-sip.1/cme-locale-de_DE-8. to extract the contents of CME-locale-de_DE-8.168.xml for country-specific network tones and cadences.

xml Use the appropriate directory name shown in Table 11-7 and remove the two-letter language code from the JAR file name.S.xml Step 9 Assign the locales to the phones. Step 11 Use the create profile command to rebuild the configuration files. For example. For example. create a directory under the TFTP root directory for each user and network locale.xml alias Germany/g4-tones.jar alias German_Germany/ Router(config)# tftp-server flash:/g4-tones.jar TFTP-Root/Germany/g4-tones. create a TFTP alias for the user locale (text displays) and network locale (tones) using this format: Router(config)# tftp-server flash:/jar_file alias directory_name/gh-sip. the TFTP aliases for German and Germany for the Cisco Unified IP Phone 8961 are: Router(config)# tftp-server flash:/de-gh-sip. use the user-locale and network-locale commands in voice register global configuration mode. the user-locale directory for German and the network-locale directory for Germany for the Cisco Unified IP Phone 8961 are: TFTP-Root/German_Germany/gh-sip.xml Step 8 If you store the locale files on an external TFTP server. Step 10 To support more than one user or network locale. English for the United States is the default language. English unless you assign a different language to a phone and then want to reassign English.11 Configuring Localization Support SIP: How to Configure Localization Support Table 11-8 System-Defined User and Network Locales (continued) Language Language Code User-Locale Directory Name Country Code Network-Locale Directory Name Norwegian no Norwegian_Norway NO Norway Portuguese pt Portuguese_Portugal PT Portugal Russian ru Russian_Russia RU Russian_Federation Spanish es Spanish_Spain ES Spain Swedish se Swedish_Sweden SE Sweden 1. Step 12 Use the reset command to reset the phones and see the localized displays. To set a default locale for all phones. Use the appropriate directory name shown in Table 11-7 and remove the two-letter language code from the JAR file name.jar Router(config)# tftp-server flash:/g4-tones. Cisco Unified Communications Manager Express System Administrator Guide 408 . see the “Verifying Multiple Locales” section on page 416. You do not need to install the JAR file for U.xml alias directory_name/g4-tones. Step 7 If you store the locale files in flash memory or slot 0 on the Cisco Unified CME router.

Cisco Unified Communications Manager Express System Administrator Guide 409 . • Each user-defined country code (U1-U5) can be used for only one user-locale-tag at a time. • When using an external TFTP server. To work around this limitation. perform the following steps. you must manually create the user locale folders in the root directory. This is a limitation of the IP phone. • If you install and configure a user-defined locale using country codes U1-U5 and then you install a new locale using the same label.com to download locale files. • You must have an account on Cisco.pkg LOCALE ERROR: User Defined Locale U2 already exists on locale index 2.0 and Later Versions To install and configure locale files for Cisco Unified SIP IP phones in Cisco Unified CME. • When the storage location specified by the cnf-file location command is flash memory. you must configure the new package using a different country code. the phone retains the original language locale even after the phone is reset. • Locale support is limited to phone firmware versions that are supported by Cisco Unified CME. sufficient space must be on the flash file system for extracting the contents of the locale TAR file.11 Configuring Localization Support SIP: How to Configure Localization Support Using the Locale Installer in Cisco Unified CME 9. This is a limitation of the TFTP server. • User-defined locales are not supported if the configuration file location is “system:”.0(1) or a later version. Prerequisites • Cisco Unified CME 9.pkg Router(config-register-global)# user-locale 1 U2 load Chinese. For example: Restrictions Router(config-register-global)# user-locale 2 U2 load Finnish.

8. TFTP-Root/TAR-filename Cisco Unified Communications Manager Express System Administrator Guide 410 . Download the TAR file to the location previously specified by the cnf-file location command.3.3. Instead. With the locale installer.11 Configuring Localization Support SIP: How to Configure Localization Support SUMMARY STEPS 1. Go to the Software Download site. 7. Note You must copy the locale file into the /its directory (flash:/its or slot0:/its) when you store the locale files on the Cisco Unified CME router.com to access the Software Download Center.100/CME-locale-de_DE-German-8. Use the user-locale [user-locale-tag] {[user-defined-code] country-code} [load TAR-filename] command in voice register global configuration mode to extract the contents of the TAR file.tar is German for Germany for Cisco Unified CME 9. Each file contains all the firmware required for all phone types supported by that version of Cisco Unified CME. 2. 3. For example.1. a. Each TAR file contains locale files for a specific language and country and uses the following naming convention: CME-locale-language_country-CMEversion. 5. Router# copy tftp://12. 4. Use the create profile command in voice register global configuration mode to generate the configuration profile files required for Cisco Unified SIP IP phones. c.tar For example. Select the TAR file for the locale you want to install.tar flash:/its b. Select your version of Cisco Unified CME.0. If you do not have an account or have forgotten your username or password. CME-locale-de_DE-German-8. If the cnf-file location is slot0: Copy the TAR file to the slot0:/its directory.6.0. you do not need to perform manual configuration. Assign the locales to the phones.1.6.com/cgi-bin/tablebuild. Step 3 Select the TAR file for the locale you want to install. If the cnf-file location is tftp: Create a folder in the root directory of the TFTP server for each locale using the following format and then copy the TAR file to the TFTP-Root folder. Step 4 Download the TAR file to the location previously specified by the cnf-file location command. 6.cisco. Use the reset command to reset the phones and see the localized displays. Step 2 Navigate to Downloads Home > Products > Unified Communications > Call Control > Mid-Market Call Control > Cisco Unified Communications Manager Express > Unified Communications Manager Express Individual File Set and select your version of Cisco Unified CME. click the appropriate button at the login dialog box and follow the instructions that appear.0.pl/CME-Locale You must have an account on Cisco. DETAILED STEPS Step 1 Go to http://www. If the cnf-file location is flash memory: Copy the TAR file to the flash:/its directory. you copy the locale file using the copy command in privileged EXEC configuration mode.

11 Configuring Localization Support SIP: How to Configure Localization Support For system-defined locales. create the folder for user-defined locale Chinese (User_Define_1) as follows: TFTP-Root/CME-locale-zh_CN-Chinese-8. use the locale folder name as shown in Table 11-9. A user-defined locale is a language other than the system-defined locales that are predefined in Cisco IOS software.6.3.6.0.3. create the folder for system-defined German as follows: TFTP-Root/de_DE-8.0. use the User_Define_n folder name as shown in Table 11-9. Cisco Unified Communications Manager Express System Administrator Guide 411 . For example. Where “n” is a number from 1 to 5. see the Cisco Unified CME Localization Matrix. For example. Table 11-9 System-Defined and User-Defined Locales Language Locale Folder Name Country Code English English_United_States US English_United_Kingdom UK CA Danish Danish_Denmark DK Dutch Dutch_Netherlands NL French French_France FR CA German German_Germany DE AT CH Italian Italian_Italy IT Japanese Japanese_Japan JP Norwegian Norwegian_Norway NO Portuguese Portuguese_Portugal PT Russian Russian_Russia RU Spanish Spanish_Spain ES Swedish Swedish_Sweden Un 1 User_Define_n 1 SE Un1 1.tar For up to five user-defined locales.tar Note For a list of user-defined languages supported in Cisco Unified CME.

11 Configuring Localization Support SIP: How to Configure Localization Support Step 5 Use the user-locale [user-locale-tag] {[user-defined-code] country-code} [load TAR-filename] command in voice register global configuration mode to extract the contents of the TAR file.tar Step 6 Assign the locales to the phones. see Table 11-9.tar file when U1 is the country code for user-defined locale Chinese (User_Define_1).tar). when you configure the user-locale command for all Cisco Unified SIP IP phone types.0.6. Cisco Unified Communications Manager Express System Administrator Guide 412 . Note Use the complete filename.6.0.3. use this command: Router(config-register-global)# user-locale U1 load CME-locale-zh_CN-Chinese-8. including the file suffix (. For example. Step 7 Use the create profile command in voice register global configuration mode to generate the configuration profile files required for Cisco Unified SIP IP phones. For country codes. See the “Configuring Multiple Locales” section on page 413. Step 8 Use the reset command to reset the phones and see the localized displays. to extract the contents of the CME-locale-zh_CN-Chinese-8.3.

configure terminal 3. • Multiple user and network locales are supported only on Cisco Unified IP Phone 8961. voice register pool pool-tag 13. 6945. Cisco Unified CME 8. 7931. create profile 7. perform the following steps. voice register template template-tag 9. exit 12. user-locale [user-locale-tag] {[user-defined-code] country-code} 5. voice register template template-tag 14. voice register global 16. reset 17. Prerequisites • Cisco Unified CME 8. For Cisco Unified IP Phone 9971. you must use per-phone configuration files. 7961. 1. 7921. 9951. 7970. • To specify alternative user and network locales for individual phones in a Cisco Unified CME system.11 Configuring Localization Support SIP: How to Configure Localization Support Configuring Multiple Locales To define one or more alternatives to the default user and network locales and apply them to individual phones.6 or a later version. 7941. 7971. user-locale user-locale-tag Restriction SUMMARY STEPS 10. network-locale network-locale-tag [user-defined-code] country-code 6. see the “Installing System-Defined Locales for Cisco Unified IP Phone 6921. For more information. 7906.8 or a later version. end Cisco Unified Communications Manager Express System Administrator Guide 413 . and Cisco IP Communicator” section on page 391. 7911. and 9971. network-locale network-locale-tag 11. exit 8. exit 15. enable 2. voice register global 4.

• user-locale-tag—Assigns a locale identifier to the locale. Router(config-register-global)# create profile Step 7 exit Exits voice register global configuration mode. Example: Router(config-register-global)# user-locale 1 DE Step 5 network-locale network-locale-tag [user-defined-code] country-code Specifies a country for tones and cadences. Default: 0. Router(config)#voice register global Step 4 user-locale [user-locale-tag] {[user-defined-code]country-code} Specifies a language for phone displays. Cisco Unified Communications Manager Express System Administrator Guide 414 . • Range: 1 to 10. • network-locale-tag—Assigns a locale identifier to the country code. Example: Router(config-register-global)# network-locale 1 FR Step 6 create profile Example: Generates provisioning files required for SIP phones and writes the file to the location specified with the tftp-path command. Default: US (United States). Range is 0 to 4. This argument is required when defining some locale other than the default (0). You can assign any valid ISO 3166 code to a user-defined code (U1 to U5). This argument is required when defining some locale other than the default (0). Default: US (United States).11 Configuring Localization Support SIP: How to Configure Localization Support DETAILED STEPS Step 1 Command or Action Purpose enable Enables privileged EXEC mode. Example: Router(config-telephony)# exit Step 8 voice register template template-tag Example: Router(config)voice register template 10 Enters voice register template configuration mode to define a template of common parameters for SIP phones in Cisco Unified CME. Default: 0. • country-code—Type ? to display a list of system-defined codes. • country-code—Type ? to display a list of system-defined codes. Example: Router> enable Step 2 configure terminal Enters global configuration mode. Range is 0 to 4. • Enter your password if prompted. Example: Router# configure terminal Step 3 voice register global Example: Enters voice register global configuration mode to set parameters for all supported SIP phones in Cisco Unified CME.

voice register pool pool-tag Example: Router(config)#voice register pool 5 Step 13 Enters voice register template configuration mode to define a template of common parameters for SIP phones in Cisco Unified CME. exit Example: Router(config-ephone-template)# exit Step 12 Enters voice register pool configuration mode to set phone-specific parameters for a SIP phone. • Example: user-locale-tag—A locale tag that was created in Step 4. voice register template template-tag Example: Router(config)voice register template 10 Step 14 • Range: 1 to 10. Exits voice register template configuration mode. Router(config-ephone-template)# user-locale 2 Step 10 Assigns a network locale to this ephone template. network-locale network-locale-tag • Example: network-locale-tag—A locale tag that was created in Step 5. Range is 0 to 4. reset Example: Router(config-register-global)# reset Step 17 end Returns to privileged EXEC mode.11 Configuring Localization Support SIP: How to Configure Localization Support Step 9 Command or Action Purpose user-locale user-locale-tag Assigns a user locale to this ephone template. Range is 0 to 4. Example: Router(config-register-global)# end Cisco Unified Communications Manager Express System Administrator Guide 415 . Router(config-ephone-template)# network-locale 2 Step 11 Exits voice register template configuration mode. exit Example: Router(config-ephone)# exit Step 15 Enters voice register global configuration mode to set parameters for all supported SIP phones in Cisco Unified CME. including contacting the DHCP and TFTP servers for the latest configuration information. voice register global Example: Router(config)#voice register global Step 16 Performs a complete reboot of all phones or the specified phone.

cnf url system:/cme/sipphone/SIPDefault. page 419 • Swedish as the System-Defined Locale: Example.” “opened x file.xml tftp-server SIPDefault. For an external TFTP server. page 424 Cisco Unified Communications Manager Express System Administrator Guide 416 . use the debug tftp events command to see which files Cisco Unified CME is looking for and whether the files are found and opened correctly.xml url system:/cme/sipphone/softkeyDefault. page 423 • SIP: Locale Installer: Example. Step 4 If the configuration file location is not TFTP. Step 3 Use the show voice register pool all command to check that the correct templates are applied to phones.xml url system:/cme/sipphone/syncinfo.cnf tftp-server softkeyDefault_kpml. page 417 • User-Defined Locales: Example. Router#sh voice register tftp-bind tftp-server syncinfo.xml url system:/cme/sipphone/featurePolicyDefau lt.xml tftp-server SEPACA016FDC1BD.xml url system:/cme/sipphone/SEPACA016FDC1BD. There are usually three states (“looking for x file. page 420 • SIP: Multiple User and Network Locales: Example.xml tftp-server featurePolicyDefault.xml tftp-server softkeyDefault.” and “finished x file”). page 418 • Chinese as the User-Defined Locale: Example.xml tftp-server softkey2_kpml.xml url system:/cme/sipphone/featurePolicy2. you can use the logs from the TFTP server.cnf. Configuration Examples for Localization This section contains the following examples: • Multiple User and Network Locales: Example. including the dictionary. language.xml url system:/cme/sipphone/softkey2_kpml.xml Step 2 Use the show voice register template all command to check the user locale and network locale settings in each ephone template.xml tftp-server featurePolicy2. page 419 • SCCP: Locale Installer: Examples. The file is found when all three states are displayed.xml url system:/cme/sipphone/softkey2.xml tftp-server softkey2. and tone configuration files.11 Configuring Localization Support Configuration Examples for Localization Verifying Multiple Locales Step 1 Use the show voice register tftp-bind command to display a list of configuration files that are accessible to IP phones using TFTP.xml url system:/cme/sipphone/softkeyDefault_kpml .cnf .

use the following commands to return the default value of 0 to US: telephony service no user-locale 0 DE no network-locale 0 DE Another way to define Germany as the default user and network locale is to use the following commands: telephony service cnf-file location flash: cnf-file perphone user-locale DE network-locale DE After using the previous commands. telephony service cnf-file location flash: cnf-file perphone user-locale 0 DE network-locale 0 DE After using the previous commands to define Germany as the default user and network locale. ephone 11 uses JP for its locales. In this example. and ephone 14 uses the default. Germany is used for all phones unless you apply a different locale to individual phones using ephone templates. and ES (Spain).11 Configuring Localization Support Configuration Examples for Localization Multiple User and Network Locales: Example The following example sets the default locale of 0 to Germany. ephone 13 uses ES. US. use the following commands to return the default to US: telephony service no user-locale DE no network-locale DE The following example defines three alternative locales: JP (Japan). ephone 12 uses FR. telephony-service cnf-file location flash: cnf-file perphone create cnf-files user-locale 1 JP user-locale 2 FR user-locale 3 ES network-locale 1 JP network-locale 2 FR network-locale 3 ES create cnf-files ephone-template 1 user-locale 1 network-locale 1 ephone-template 2 user-locale 2 network-locale 2 ephone-template 3 user-locale 3 network-locale 3 ephone 11 Cisco Unified Communications Manager Express System Administrator Guide 417 . FR (France). which defines Germany as the default user and network locale. The default is US for all phones that do not have an alternative applied using ephone templates.

Traditional Chinese is not predefined in the system so you must download the appropriate XML files to support this language. telephony-service cnf-file location flash: cnf-file perphone user-locale 1 U1 ZH network-locale 1 U1 CN ephone-template 2 user-locale 1 network-locale 1 ephone 11 button 1:25 ephone-template 2 ephone 12 button 1:26 Cisco Unified Communications Manager Express System Administrator Guide 418 . US English. The default is US English for all phones that do not have an alternative applied using ephone templates. In this example. which is defined as ZH for Traditional Chinese. ephone 11 uses Traditional Chinese (ZH) and ephone 12 uses the default.11 Configuring Localization Support Configuration Examples for Localization button 1:25 ephone-template 1 ephone 12 button 1:26 ephone-template 2 ephone 13 button 1:27 ephone-template 3 ephone 14 button 1:28 User-Defined Locales: Example The following example shows user-locale tag 1 assigned to code U1.

xml Filename: SCCP-dictionary.jar Filename: td-sccp. retaining old versionStamps CNF files updating complete Swedish as the System-Defined Locale: Example The following is a sample output from the user-locale command when you configure the Swedish language as the system-defined locale in Cisco Unified CME: Router(config-register-global)# user-locale SE load swedish.jar Filename: td-sccp.11 Configuring Localization Support Configuration Examples for Localization Chinese as the User-Defined Locale: Example The following is a sample output from the user-locale command when you configure the Chinese language as the user-defined locale in Cisco Unified CME: Router(config-register-global)# user-locale U1 load chinese.jar New Locale configured CNF-FILES: Clock is not set or synchronized.xml Filename: utf8_tags_file Filename: tags_file New Locale configured Processing file:flash:/its/user_define_1_tags_file Processing file:flash:/its/user_define_1_utf8_tags_file CNF-FILES: Clock is not set or synchronized.xml Filename: SCCP-dictionary-ext.xml Filename: 7960-tones.xml Filename: 7905-font.xml Filename: g3-tones.jar Filename: tc-sccp.pkg Updating CNF files LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: VER:1 Langcode:zh Language:Chinese Filename: 7905-dictionary.utf-8.jar Filename: 7921-font.utf-8.xml Filename: gp-sccp.xml Filename: 7921-kate.xml Filename: 7905-kate.dat Filename: 7921-kate. retaining old versionStamps CNF files updating complete Cisco Unified Communications Manager Express System Administrator Guide 419 .jar Filename: mk-sccp.pkg Updating CNF files LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: VER:1 Langcode:se Language:swedish Filename: g3-tones.xml Filename: SCCP-dictionary.xml Filename: mk-sccp.xml Filename: 7921-dictionary.jar Filename: tc-sccp.jar Filename: ipc-sccp.

xml Filename: gp-sccp. The user-locale-tag argument is required only when using multiple locales. page 422 System-Defined Locale is the Default Applied to All Phones The following example is the output from the user-locale command when you configure a system-defined locale for Cisco Unified CME and the locale is on the default locale index (user-locale-tag 0).1a.jar Filename: mk-sccp.11 Configuring Localization Support Configuration Examples for Localization SCCP: Locale Installer: Examples This section contains the following examples: • System-Defined Locale is the Default Applied to All Phones. retaining old versionStamps CNF files updating complete Router(config-telephony)# create cnf-files Router(config-telephony)# ephone 3 Router(config-ephone)# reset Cisco Unified Communications Manager Express System Administrator Guide 420 .tar Updating CNF files LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: VER:1 Langcode:se Language:swedish Filename: g3-tones.1. Router(config-telephony)# user-locale SE load CME-locale-sv_SV-7. the specified language is the default applied to all SCCP phones.0.jar New Locale configured CNF-FILES: Clock is not set or synchronized. page 421 • Configuring a Locale on a Non-default Locale Index.jar Filename: ipc-sccp. otherwise.jar Filename: tc-sccp. page 420 • User-Defined Locale is Default Language to be Applied to All Phones.jar Filename: td-sccp.

xml Filename: 7960-font.xml Filename: mk-sccp. Router(config-telephone)# Updating CNF files LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: LOCALE INSTALLER MESSAGE: user-locale U1 load CME-locale-xh_CN-7. The user-locale-tag argument is required when using multiple locales. otherwise the specified language is the default applied to all SCCP phones.jar Filename: tags_file Filename: utf8_tags_file Filename: g3-tones.0.tar VER:1 Langcode:fi Language:Finnish Filename: 7905-dictionary.xml Filename: 7960-dictionary.1.xml Filename: ipc-sccp. retaining old versionStamps CNF files updating complete Router(config-telephony)# create cnf-files Router(config-telephony)# ephone 3 Router(config-ephone)# reset Cisco Unified Communications Manager Express System Administrator Guide 421 .1.jar Filename: gp-sccp.xml Filename: 7920-dictionary.xml Filename: 7960-tones.xml Filename: 7905-kate.utf-8.jar New Locale configured Processing file:flash:/its/user_define_2_tags_file Processing file:flash:/its/user_define_2_utf8_tags_file CNF-FILES: Clock is not set or synchronized.jar Filename: tc-sccp.jar Filename: td-sccp.xml Filename: 7960-kate.xml Filename: SCCP-dictionary.xml Filename: SCCP-dictionary.11 Configuring Localization Support Configuration Examples for Localization User-Defined Locale is Default Language to be Applied to All Phones The following example is the output from the user-locale command when you configure a user-defined locale for Cisco Unified CME and the locale is on the default locale index (user-locale-tag 0).

xml Filename: 7960-dictionary. Router(config-telephony)# user-locale 2 U2 load CME-locale-fi_FI-7.xml Filename: 7905-kate. The user-locale-tag argument is required only when using multiple locales.xml Filename: 7920-dictionary.jar Filename: tags_file Filename: utf8_tags_file Filename: g3-tones.xml Filename: mk-sccp. In this configuration.jar Filename: td-sccp.xml Filename: ipc-sccp.jar Filename: gp-sccp. please restart or reset ephone to take effect.xml Filename: SCCP-dictionary.0.11 Configuring Localization Support Configuration Examples for Localization Configuring a Locale on a Non-default Locale Index The following example is the output from the user-locale command if you configure a user-defined locale as an alternate locale for a particular SCCP phone (ephone 1) in Cisco Unified CME. Router(config-ephone)# telephony-service Router(config-telephony)# create cnf-files Router(config-telephony)# ephone 1 Router(config-ephone)# reset Cisco Unified Communications Manager Express System Administrator Guide 422 .jar New Locale configured Processing file:flash:/its/user_define_2_tags_file Processing file:flash:/its/user_define_2_utf8_tags_file CNF-FILES: Clock is not set or synchronized.xml Filename: 7960-kate.1.xml Filename: 7960-font.utf-8.jar Filename: tc-sccp.xml Filename: 7960-tones.1. the locale is user-defined Finnish (U2) on user-locale index 2. retaining old versionStamps CNF files updating complete Router(config-telephony)# ephone-template 1 Router(config-ephone-template)# user-locale 2 Router(config-ephone-template)# ephone 1 Router(config-ephone)# ephone-template 1 The ephone template tag has been changed under this ephone.xml Filename: SCCP-dictionary.tar Updating CNF files LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE LOCALE INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER INSTALLER MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: MESSAGE: VER:1 Langcode:fi Language:Finnish Filename: 7905-dictionary.

and ephone 14 uses the default.11 Configuring Localization Support Configuration Examples for Localization SIP: Multiple User and Network Locales: Example The following example sets the default locale of 0 to Germany. voice register global user-locale 0 DE network-locale 0 DE After using the previous commands to define Germany as the default user and network locale. and ES (Spain). ephone 12 uses FR. use the following commands to return the default to US: voice register global no user-locale DE no network-locale DE SIP: Alernative Locales The following example defines three alternative locales: JP (Japan). voice register global create profile user-locale 1 JP user-locale 2 FR user-locale 3 ES network-locale 1 JP network-locale 2 FR network-locale 3 ES create profile voice register template 1 user-locale 1 network-locale 1 voice register template 2 user-locale 2 network-locale 2 voice register pool 1 number 1 dn 1 template 1 user-locale 3 network-locale 3 voice register pool 2 Cisco Unified Communications Manager Express System Administrator Guide 423 . ephone 11 uses JP for its locales. which defines Germany as the default user and network locale. In this example. use the following commands to return the default value of 0 to US: voice register global no user-locale 0 DE no network-locale 0 DE Another way to define Germany as the default user and network locale is to use the following commands: voice register global user-locale DE network-locale DE After using the previous commands. FR (France). ephone 13 uses ES. Germany is used for all phones unless you apply a different locale to individual phones using ephone templates. The default is US for all phones that do not have an alternative applied using ephone templates. US.

jar LOCALE INSTALLER MESSAGE: Filename: gh-sip. one per line.6.1.0.tar LOCALE INSTALLER MESSAGE (SIP):Loading Locale Package.11 Configuring Localization Support Where to Go Next number 2 dn 2 template 2 voice register pool 6 number 3 dn 3 template 3 SIP: Locale Installer: Example The following example shows how the locale installer only requires you to copy the locale file using the copy command in privileged EXEC configuration mode to configure a locale on a Cisco Unified SIP IP phone.xml LOCALE INSTALLER MESSAGE: Filename: tags_file LOCALE INSTALLER MESSAGE: Filename: utf8_tags_file LOCALE INSTALLER MESSAGE: Filename: gd-sip. Cisco Unified Communications Manager Express System Administrator Guide 424 .3. End with CNTL/Z.xml LOCALE INSTALLER MESSAGE: New Locale configured Router(config-register-global)# Where to Go Next Ephone Templates For more information about ephone templates.jar LOCALE INSTALLER MESSAGE: Filename: g4-tones.0.3. see the “Creating Templates” section on page 1447. Router# copy tftp://100.1/CME-locale-de_DE-German-8.6. Router(config)# voice register global Router(config-register-global)# user-locale DE load CME-locale-de_DE-German-8..1.. The example also shows that the locale file has been copied in the /its directory.tar flash:/its Destination filename [/its/CME-locale-de_DE-German-8.tar]? Router# configure terminal Enter configuration commands.0.6. LOCALE INSTALLER MESSAGE: VER:3 LOCALE INSTALLER MESSAGE: Langcode:de_DE LOCALE INSTALLER MESSAGE: Language:German LOCALE INSTALLER MESSAGE: Filename: g3-tones.3.

4T Command References • Cisco IOS Voice Configuration Library • Cisco IOS Software Releases 12. Related Documents Related Topic Document Title Cisco Unified CME configuration Cisco IOS commands Cisco IOS configuration Phone documentation for Cisco Unified CME • Cisco Unified CME Command Reference • Cisco Unified CME Documentation Roadmap • Cisco IOS Voice Command Reference • Cisco IOS Software Releases 12. Cisco Unified Communications Manager Express System Administrator Guide 425 . the Cisco Technical Services Newsletter. and Really Simple Syndication (RSS) Feeds. Access to most tools on the Cisco Support website requires a Cisco.com/techsupport To receive security and technical information about your products. http://www. including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.com user ID and password. you can subscribe to various services.4T Configuration Guides • User Documentation for Cisco Unified IP Phones Technical Assistance Description Link The Cisco Support website provides extensive online resources. such as the Product Alert Tool (accessed from Field Notices).11 Configuring Localization Support Additional References Additional References The following sections provide references related to Cisco Unified CME features.cisco.

0 Multiple user and network locales were introduced.5 provides support for additional languages.8 Adds localization support for Cisco Unified 3905 SIP and Cisco Unified 6945. • Parses firmware-load text files and automatically creates the required TFTP aliases for localization.5 Cisco Unified CME 10. Note Table 11-10 Table 11-10 lists the Cisco Unified CME version that introduced support for a given feature. Cisco Unified Communications Manager Express System Administrator Guide 426 . Cisco Feature Navigator enables you to determine which Cisco IOS software images support a specific software release.htm. 8941.com is not required. Unless noted otherwise.0(1) • Locale installer that supports a single procedure for all SCCP IP phones. or platform. Multiple Locales 4. Localization Enhancement 8.cisco. To determine the correct Cisco IOS release to support a specific Cisco Unified CME version.11 Configuring Localization Support Feature Information for Localization Support Feature Information for Localization Support Table 11-10 lists the features in this module and enhancements to the features by version.com/en/US/docs/voice_ip_comm/cucme/requirements/guide/33matrix. go to http://www. Localization Enhancements for Cisco Unified SIP IP Phones 9. Feature Information for Localization Support Feature Name Cisco Unified CME Version Feature Information Localization Enhancements for Cisco Unified SIP IP Phones 10. feature set. • Backward compatibility with the configuration method in Cisco Unified CME 7.0 and earlier versions. To access Cisco Feature Navigator. An account on Cisco.6 Adds localization support for SIP IP Phones. Cisco Unified CME Usability Enhancement 7.com/go/cfn. and 8945 SCCP IP Phones. Use Cisco Feature Navigator to find information about platform support and software image support. Usability Enhancement 8. subsequent versions of Cisco Unified CME software also support that feature.cisco.0 Provides the following enhanced localization support for Cisco Unified SIP IP phones: • Localization support for Cisco Unified 6941 and 6945 SIP IP Phones. • Locale installer that supports a single procedure for all Cisco Unified SIP IP phones. User-Defined Locales 4. see the Cisco Unified CME and Cisco IOS Software Version Compatibility Matrix at http://www.0 User-defined locales were introduced.