Usage Guidelines
This command sets the language for displays on supported phone types.
The
show
telephony-service
tftp-bindings
command displays the locale that is set using this command.
This locale is associated with the dictionary and language files.
Follow this command with a complete phone reboot using the
reset command.
User-locale 0 always holds the default language that is used for all
SCCP phones that are not assigned alternative user locales or user-defined user
locales. The system default is US (United States) unless you use this command
to designate a different locale for user-locale 0.
Alternative User Locales
In Cisco Unified CME 4.0 or a later version, the
user-locale-tag argument allows you to
specify up to five alternative user locales. For example, a company can specify
French for phones A, B, and C; German for phones D, E, and F; and United States
for phones G, H, and I.
Each of the five user locales that you can use in a multi locale
system is identified with the
user-locale-tag argument. The identifier 0
always holds the default locale, although you can define this default to be any
language code that is supported in the system and is listed in CLI help for the
command. For example, if you define locale-tag 0 to be JP (Japanese), the
default user locale for the router is JP. If you do not specify a locale for
identifier 0, the default is US (United States). If you are using this command
to configure a default locale for all SCCP phones in your system, you are not
required to include
user-locale-tag
0 in the command.
To apply alternative user locales to different phones, you must use
the
cnf-files command to specify per-phone
configuration files. When you use per-phone configuration files, a phone's
configuration file automatically uses the default locales in user locale 0 and
network locale 0. You can override this default for individual ephones by
assigning locale tags to the alternative language codes that you want to use.
Use ephone templates to assign the locale tag to individual ephones. For
example, you can assign user-locale-tag 2 to the language code RU (Russian).
Use the
user-locale command in ephone-template mode
to apply a locale tag to an ephone template. Use the
ephone-template command in ephone
configuration mode to apply the template a phones that should use the
alternative language.
User-Defined User Locales
In Cisco Unified CME 4.0 and later versions, you can install XML
files to support up to five user and network locales that are not standard in
your system. These files cannot be installed in the system storage location. To
support user-defined locales, you must use the
cnf-files
perphone
and
cnf-file
location
commands and copy the appropriate XML language files into slot
0, flash, or TFTP memory. The user locales and network locales that are stored
in this way can then be used as default or alternative entries for all or some
phones.
For example, if you have a site at which the phones should use the
displays and tones for Traditional Chinese, which is not one of the standard
languages, you must download the XML files for Traditional Chinese to use this
user-defined locale on a phone.
Locale Installer
In Cisco Unified CME 7.0(1) and later versions, this command with the
load
keyword is a locale installer that extracts the contents of the
locale TAR file to the location specified by the
cnf-file
location
command. Before Cisco Unified CME 7.0(1), you had to manually
extract the files to flash, slot 0, or an external TFTP server.
Before using this command as a locale installer, you must manually
create the required locale folders in the root directory of the external TFTP
server.
Examples
The following example defines three alternative locales: JP (Japan),
FR (France), and ES (Spain). The default is US for all phones that do not have
the alternatives applied using ephone templates. In this example, ephone 11
uses JP for its locales, ephone 12 uses FR, ephone 13 uses ES, and ephone 14
uses the default, US.
telephony-service
cnf-file location flash:
cnf-file perphone
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
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
Examples
The following example applies locale tag 4 to the user-defined code
U1, which is defined as ZH. ZH is the code that represents Traditional Chinese
in ISO 639, the
Language Code Reference . Because the code for Traditional
Chinese is not one of those that is provided in the system, the user must
download the appropriate XML files to support this language.
In addition to the user-defined code, the example defines three
alternative locales: JP (Japan), FR (France), and ES (Spain). The default is US
for all phones that do not have the alternatives applied using ephone
templates. In this example, ephone 11 uses JP for its locales; ephone 12 uses
FR; ephone 13 uses ES; ephone 14 uses the default, US; and ephone 15 uses the
user-defined language, ZH (Traditional Chinese).
telephony-service
cnf-file location flash:
cnf-file perphone
user-locale 1 JP
user-locale 2 FR
user-locale 3 ES
user-locale 4 U1 ZH
network-locale 1 JP
network-locale 2 FR
network-locale 3 ES
network-locale 4 U1 ZH
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-template 4
user-locale 4
network-locale 4
ephone 11
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
ephone 15
button 1:29
ephone-template 4