[an error occurred while processing this directive]

Cisco Unified Communications Manager (CallManager)

Using the Cisco IP Telephony Locale Installer with Cisco CallManager 3.3(3)sr1

 Feedback

Table Of Contents

Using the Cisco IP Telephony Locale Installer with Cisco CallManager 3.3(3)sr1

Purpose of the Document

Contents

Introduction

Supported Cisco IP Telephony Products

Integration Considerations

Installing the Cisco IP Telephony Locale Installer

Troubleshooting

Error Messages

Caveats

Obtaining the Release Notes for the Cisco IP Telephony Locale Installer

Obtaining Documentation

Cisco.com

Documentation CD-ROM

Ordering Documentation

Documentation Feedback

Obtaining Technical Assistance

Cisco TAC Website

Opening a TAC Case

TAC Case Priority Definitions

Obtaining Additional Publications and Information


Using the Cisco IP Telephony Locale Installer with Cisco CallManager 3.3(3)sr1


Purpose of the Document

Intended for the system administrator, this document provides installation procedures for the Cisco IP Telephony Locale Installer, which is used with Cisco CallManager and other Cisco IP telephony products that support languages other than English and network tones/cadences for countries other than the United States. This document also provides a descriptionof user and network locales, integration/migration considerations, pre-installation tasks, and an overview of how the locale installer works.

Contents

Introduction

Supported Cisco IP Telephony Products

Integration Considerations

Installing the Cisco IP Telephony Locale Installer

Troubleshooting

Error Messages

Caveats

Obtaining the Release Notes for the Cisco IP Telephony Locale Installer

Introduction

Cisco provides locale-specific versions of the Cisco IP Telephony Locale Installer on www.cisco.com. Installed by the system administrator, the locale installer allows the user to view/receive the chosen translated text or tones, if applicable, when a user works with supported interfaces.

Defining User Locales

User locale files provide translated text and voice prompts, if available, for phone displays, user applications, and user web pages in the locale that the user chooses. User-only locale installers exist on cisco.com.

Defining Network Locales

Network locale files provide country-specific phone tones and gateway tones, if available. Network-only locale installers exist on cisco.com.

Cisco may combine multiple network locales in a single locale installer.

Defining Combined Locales

The Cisco IP Telephony Locale Installer combines user locales and network locales in a single web downloaded file, when applicable.


Note The Cisco Media Convergence Server (MCS) or Cisco-approved, customer-provided server can support multiple locales. Installing multiple locale installers ensures that the user can choose from a multitude of locales.

Changes do not take effect until you reboot every server in the cluster. Cisco strongly recommends that you do not reboot the servers until you have installed all locales on all servers in the cluster. Minimize call-processing interruptions by rebooting the servers after regular business hours.


Supported Cisco IP Telephony Products

Cisco IP Telephony Locale Installers exist for the following Cisco IP telephony products, as indicated in Table 1.

Table 1 Supported Cisco IP Telephony Products 

Product
Type of Locale Installers Supported
Notes

Cisco IP Phone Models 7905, 7912, 7940, 7960

User for the phone LCD

Network for the phone tones

In the Cisco CallManager User Option pages, the user can choose the user locale that will display on the phone.1

To configure the phone tone, the administrator browses to a server that runs Cisco CallManager Administration and chooses the network locale from the Phone Configuration window.

Tip Cisco IP Phone Models 7905G and 7912 support ISO8859-1 and double-byte character sets, that is, Shift-JIS (Japanese), KS C 5700-1995 (Korean), BIG5 (Traditional Chinese), GBK (Simplified Chinese). The Cisco IP Phone Model 7960 supports ISO8859-1 only.

Cisco Quality Reporting Tool

User

In the Cisco CallManager User Option pages, the user chooses the locale that will display on the phone.1

Cisco CallBack

User

In the Cisco CallManager User Option pages, the user chooses the locale that will display on the phone.1

Cisco WebDialer

User

In the Cisco CallManager User Option pages, the user chooses the locale that will display on the phone.1

Cisco CallManager Extension Mobility

User

In the Cisco CallManager User Option pages, the user chooses the locale that will display on the phone.1

Gateway Tones

Network

Network locales do not exist for some gateway
devices.2

Gateways tones in the locale installer override versions that exist in the database.

To configure the gateway tone, the administrator browses to a server that runs Cisco CallManager Administration and chooses the Network Locale from the Gateway Configuration window.

Cisco Tool for Auto-Registered Phones Support (TAPS)

User locales that provide localized voice prompts

After you install the locales on the server, you do not need to reboot the Cisco Customer Response Solutions (CRS) server.

If voice prompts appear in English_United_States after the installation of the locale installer, see the "Troubleshooting" section.

Cisco CallManager User Option pages

User

From these pages, the user can choose the locale that displays on the web pages.

Cisco CallManager Administration User pages

User

See the "Troubleshooting" section for caveats about these pages.

Cisco CallManager Attendant Console 1.2(1)

User

The attendant chooses the locale from the attendant console login window. An error message displays if the locale does not exist on the Cisco CallManager server. The attendant console defaults to English if the locale does not exist.

After you upgrade the servers to Cisco CallManager 3.3(3)sr1, you must reinstall the attendant console plugin on the attendant console PC. Only Cisco CallManager Attendant Console 1.2(1) and later releases work with the locale installer.

Cisco IP Manager Assistant (console GUI)

User

Be aware that the Manager may want to use a different locale than the Assistant uses.

You choose the locale in the Cisco CallManager Administration User pages.

For more information on how to set the locale on these pages, refer to the Cisco CallManager Administration Guide.

Cisco CDR Analysis and Reporting (CAR)

User locales provide localized versions of end-user reports and the end-user graphical user interface (GUI).

CAR only supports the English character set, also known as ISO-Latin1 or ISO-8859-1; for example, United States and Western European languages.

To configure the user locale for the CAR user, the administrator browses into a server that runs Cisco CallManager Administration and chooses the User Locale from the User Configuration window.

If the administrator does not configure the user locale for the CAR user, the CAR user can choose the locale in the Cisco IP User Option pages. The CAR user clicks the link, Change the Locale for the device profile(s) and these web pages, and then chooses the locale.

When the user browses into the server to view reports and the GUI in locales other than English_United_States, the user must enter a user name and password that has the appropriate privileges (not administrative privileges).

Cisco ATA 186 Analog Telephone Adaptor

Network

To configure the tone, the administrator browses to a server that runs Cisco CallManager Administration and chooses the network locale from the phone configuration window.

1 The administrator may choose the user locale in the Phone Configuration window of Cisco CallManager Administration. When the phone resets, the most recent selection by the administrator or user determines which locale displays on the phone; no order of precedence exists for the selection.

2 Network locales exist for the following gateways: Cisco Catalyst 4224 Access Gateway Switch, Cisco Catalyst 4000 Series, Cisco Catalyst 6000 8 Port Voice E1 and Services Module, Cisco Catalyst 6000 8 Port Voice T1 and Services Module, Cisco Catalyst 6000 24 Port FXS Analog Interface Module, Cisco Catalyst 6000 24 Port FXO Analog Interface Module, Cisco Voice Gateway 200, Cisco 2610, Cisco 2611, Cisco 2612, Cisco 2620, Cisco 2613, Cisco 2621, Cisco 2650, Cisco 2651, Cisco 2620XM, Cisco 2621XM, Cisco 2650XM, Cisco 2651XM, Cisco 2610XM, Cisco 2611XM, Cisco 2691, Cisco 3640, Cisco 3640A, Cisco 3620, Cisco 3660, Cisco 3725, Cisco 3745, Cisco 1700, Cisco 1760, and Cisco 1751.


About Cisco Java Telephony Application Programming Interface (JTAPI) and Cisco Telephony Service Provider (TSP)

Cisco JTAPI and Cisco TSP do not require that you download the locale installer to obtain locales. The locales automatically exist in the application. When you install the application, you choose the locale in which you want to view the installation. If you want to use additional locales or upgrade current locales, you must obtain an updated version of the application and install the application again.

Integration Considerations

The Cisco IP Telephony Locale Installer supports Cisco CallManager Release 3.3 or later. For more integration and migration information, review Table 2.

Table 2 Integration Considerations 

Version of Cisco IP Telephony Application
Considerations
Cisco CallManager

Upgrade from 3.2 to 3.3

All existing locales in Cisco CallManager Release 3.2 migrate when you upgrade to Cisco CallManager Release 3.3. However, new phrases and voice prompts display only in English_United_States until you install the Cisco IP Telephony Locale Installer(s) on every server in the cluster.

The end-user graphical user interface (GUI) for new Cisco IP telephony products displays in English_United_States until you download the locale installer on every server in the cluster and choose the locale through Cisco CallManager Administration, if necessary. To determine whether you choose the locale through Cisco CallManager Administration, refer to the product documentation.

New installation of 3.3

When you install Cisco CallManager, only the English_United_States user and the network locale install on the servers in the cluster.

To obtain locales other than English_United_States, you must install the Cisco IP Telephony Locale Installer on every server in the cluster.

See the "Troubleshooting" section when phrases and voice prompts display in English_United_States after the installation of the locale installer.

Upgrades from 3.3(2) to 3.3(3)sr1

Each installation of the locale installer overwrites the existing installation as though you installed it for the first time.

Cisco Customer Response Solutions (CRS)

Installation/Upgrade of any version of CRS 2.0 or 3.0

These versions serve as minimum requirements for installing the Cisco IP Telephony Locale Installer on the CRS server.


Installing the Cisco IP Telephony Locale Installer


Caution You must install Cisco CallManager 3.3(3)sr1 on every server in the cluster before you install the Cisco IP Telephony Locale Installer.


Caution You must reboot the server for the changes to take effect. After you complete all locale installation procedures, restart each server in the cluster. Updates do not occur in the system until you restart all servers in the cluster; services restart after the server reboots.

To minimize call-processing interruptions, do not reboot the servers during regular business hours.


Tip If you want to do so, you can install the Cisco IP Telephony Locale Installer via Virtual Network Computing (VNC).


Procedure


Step 1 Verify that you installed Cisco CallManager 3.3(3)sr1 on every server in the cluster.

Step 2 Perform one of the following procedures:

Insert the Cisco IP Telephony Locale Installer CD-ROM in the CD-ROM drive as soon as you are able to do so. Go to Step 8.

Click http://www.cisco.com/kobayashi/sw-center/telephony/callmgr/locale-installer and go to
Step 3.

Choose Start > Programs > Cisco CallManager > Cisco CallManager Administration.

Log in to Cisco CallManager Administration by using the administrator account and password.

Choose Application > Install Plugins.

Click the icon that represents the Cisco IP Telephony Locale Installer.

The Voice Products software page on the web displays.

Step 3 Click the version for Cisco IP Telephony Locale Installer.

The locale installer page displays.

Step 4 To download the executable to the server, click the executable.

Step 5 After downloading the file, save the file to the hard drive.

Step 6 Note the location of the saved file.

Step 7 Double-click the file to begin the installation.

Step 8 The Setup dialog box displays. This dialog box shows the date that the installer was last updated. Click Setup.

File extraction begins, as noted by the status bar in the Setup dialog box.

The Install Wizard window states that the program guides you through the installation. If you click Cancel, you exit the program.

Step 9 The Welcome window shows the components and versions that you can install on the server. Click Next.

If the application cannot access the configuration files, a prompt states that the setup process stops.

Step 10 When the License Agreement window displays, read the information in the pane carefully; click Yes to accept all terms of the agreement.

Step 11 All components that are available for installation display in the Component Selection window. The installation automatically checks all check boxes in the window. If you do not want to install a component, uncheck the component check box. Click Next.

Step 12 In the Start Copying Files window, review the components that you want to install. Click Next.


Note If you intended to install other files besides the files that are listed in the pane, click Back and choose the correct components.


The Setup Status window displays and shows the status of the installation. The installation process takes 1 to 3 minutes, depending on the requested operations.

Step 13 The Installation Completion window displays. Perform the following procedure, depending on the desired result:

a. If you do not plan to install additional locales, or if you have finished installing a single locale on all the servers, click Yes, I want to restart my computer now; then, go to Step 14.

Cisco recommends that you choose this selection only after you complete all locale installation procedures on every server in the cluster.

b. If you plan to install additional locales, or if you have not installed a single locale on all servers, click No, I do not want to restart my computer now; then, go to Step 14.

To minimize call-processing interruptions, do not restart the servers during regular business hours.

Step 14 Click Finish.

Step 15 The Setup dialog box displays. Do not click any buttons or press any keys.

When the dialog box automatically closes, you have completed the installation on the server.

Step 16 Install the Cisco IP Telephony Locale Installer on every server in the cluster.


Tip Make sure that you install the same components on every server in the cluster.


Step 17 If you want to install other locales, perform Step 2 through Step 16 on every server in the cluster.

Step 18 After you complete all locale installation procedures, restart each server in the cluster.

Updates do not occur in the system until you restart all servers in the cluster; services restart after the server reboots.

Step 19 Verify that your users can choose the locale(s) for supported products.


Troubleshooting

Review the following troubleshooting tips in the "Error Messages" and "Caveats" sections.

Error Messages

See the following error messages that may display during the installation process.

This machine is neither a TAPS server nor a Cisco CallManager server.

Locate the proper server for the installation.

The locale installer cannot install a component; for example, error updating CAR image file, cannot find/create directory, cannot install component files.

If the installation fails, the installation removes all installed files and entries from the Cisco CallManager database.

The Locale Installer will not run on Cisco CallManager versions lower than 3.3.

You cannot install the locale installer on any version before Cisco CallManager Release 3.3. The locale installer installation stops.

Caveats

See the following caveats and refer to the corresponding version of the Cisco IP Telephony Locale Installer release notes for caveats that are specific to the Cisco IP Telephony Locale Installer. To obtain the release notes, click the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/locinst/index.htm


Caution Using non-English character sets with DC Directory, Netscape Directory, or Active Directory may cause directory database errors. Cisco CallManager Release 3.3 only supports the English character set, also known as ISO-Latin1 or ISO-8859-1, and Windows 1251-Cyrillic with any directory.

English_United_States phrases and voice prompts display after the installation completes.

This situation causes no problems in your cluster. You may not have the latest locale installer that is available on cisco.com. Furthermore, Cisco may choose to update the Cisco CallManager database and not immediately update the Cisco IP Telephony Locale Installer.

Attempt to install the locale installer on all servers again. If English_United_States phrases or voice prompts display, wait until an updated version of the locale installer displays on cisco.com. Download and install the updated version of the locale installer.


Note Cisco TAPS voice prompts and Cisco Non-IOS gateway network tones do not fall back to English_United_States.


Cisco CallManager only supports the English character set in the User area of Cisco CallManager Administration.

After you download the locale installer, you can display field names in the User area of Cisco CallManager Administration in your chosen language. However, Cisco CallManager only supports the English character set, also known as ISO-Latin1 or ISO-8859-1, in the fields and in all user accounts and passwords that are needed to access these windows. If a user enters data that is not in the English character set, a dialog box displays and states that the user must enter data from the English character set.

You can choose different phone and gateway tones for the system.

If you choose to use different network locales, make sure that you choose a network locale in the parameters or the device pool that is supported by all gateway and phone device types that use the locale installer.

A new locale installer exists.

You can install the new locale installer with any version of Cisco CallManager Release 3.3(3)sr1 or later, unless otherwise indicated in this document, the readme document, or the Cisco CallManager Compatibility Matrix.

Be aware that all phrases may not display in the desired locale if you install with Cisco CallManager 3.3(4) or later.

You cannot uninstall a locale or the Cisco IP Telephony Locale Installer.

No option exists to modify, repair, or remove the locale or the locale installer. Running the locale installer multiple times results in a reinstallation of the locale, as if it is not already installed on the server.

You must reinstall the locale installer after you perform restoration procedures.

The Cisco IP Telephony Applications Server Restore Utility does not restore the locale installer. You must reinstall the locale installer after you restore Cisco CallManager data.

Cisco does not support the localization of fast-dial code/service or the Personal Address Book on the Cisco IP Phone.

Speed Dial and Personal Address Book text displays in English only.

Obtaining the Release Notes for the Cisco IP Telephony Locale Installer

To obtain the release notes for the Cisco IP Telephony Locale Installer, click the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/locinst/index.htm

Obtaining Documentation

Cisco provides several ways to obtain documentation, technical assistance, and other technical resources. These sections explain how to obtain technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation on the World Wide Web at this URL:

http://www.cisco.com/univercd/home/home.htm

You can access the Cisco website at this URL:

http://www.cisco.com

International Cisco websites can be accessed from this URL:

http://www.cisco.com/public/countries_languages.shtml

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which may have shipped with your product. The Documentation CD-ROM is updated regularly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual or quarterly subscription.

Registered Cisco.com users can order a single Documentation CD-ROM (product number DOC-CONDOCCD=) through the Cisco Ordering tool:

http://www.cisco.com/en/US/partner/ordering/ordering_place_order_ordering_tool_launch.html

All users can order annual or quarterly subscriptions through the online Subscription Store:

http://www.cisco.com/go/subscription

Ordering Documentation

You can find instructions for ordering documentation at this URL:

http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm

You can order Cisco documentation in these ways:

Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Networking Products MarketPlace:

http://www.cisco.com/en/US/partner/ordering/index.shtml

Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA.) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).

Documentation Feedback

You can submit comments electronically on Cisco.com. On the Cisco Documentation home page, click Feedback at the top of the page.

You can send your comments in e-mail to bug-doc@cisco.com.

You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:

Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco Technical Assistance Center (TAC) provides 24-hour, award-winning technical support services, online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for technical assistance.

Cisco TAC Website

The Cisco TAC website (http://www.cisco.com/tac) provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365 days a year.

Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL:

http://tools.cisco.com/RPF/register/register.do

Opening a TAC Case

The online TAC Case Open Tool (http://www.cisco.com/tac/caseopen) is the fastest way to open P3 and P4 cases. (Your network is minimally impaired or you require product information). After you describe your situation, the TAC Case Open Tool automatically recommends resources for an immediate solution. If your issue is not resolved using these recommendations, your case will be assigned to a Cisco TAC engineer.

For P1 or P2 cases (your production network is down or severely degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.

To open a case by telephone, use one of the following numbers:

Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447

For a complete listing of Cisco TAC contacts, go to this URL:

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml

TAC Case Priority Definitions

To ensure that all cases are reported in a standard format, Cisco has established case priority definitions.

Priority 1 (P1)—Your network is "down" or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.

Priority 2 (P2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Priority 3 (P3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.

Priority 4 (P4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:

http://www.cisco.com/en/US/products/products_catalog_links_launch.html

Cisco Press publishes a wide range of networking publications. Cisco suggests these titles for new and experienced users: Internetworking Terms and Acronyms Dictionary, Internetworking Technology Handbook, Internetworking Troubleshooting Guide, and the Internetworking Design Guide. For current Cisco Press titles and other information, go to Cisco Press online at this URL:

http://www.ciscopress.com

Packet magazine is the Cisco quarterly publication that provides the latest networking trends, technology breakthroughs, and Cisco products and solutions to help industry professionals get the most from their networking investment. Included are networking deployment and troubleshooting tips, configuration examples, customer case studies, tutorials and training, certification information, and links to numerous in-depth online resources. You can access Packet magazine at this URL:

http://www.cisco.com/go/packet

iQ Magazine is the Cisco bimonthly publication that delivers the latest information about Internet business strategies for executives. You can access iQ Magazine at this URL:

http://www.cisco.com/go/iqmagazine

Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/en/US/about/ac123/ac147/about_cisco_the_internet_protocol_journal.html

Training—Cisco offers world-class networking training. Current offerings in network training are listed at this URL:

http://www.cisco.com/en/US/learning/index.html


[an error occurred while processing this directive]