Post-Upgrade Tasks for All Nodes
This section describes post-upgrade tasks that you must perform for both Unified Communications Manager nodes and IM and Presence Service nodes.
Version Switching
If you did not switch versions immediately after completing the upgrade, do so now. You must switch versions so that the upgrade is complete and all nodes in the cluster are updated. Do not perform a backup until you have switched to the new software version.
Remove the Serial Port
During the pre-upgrade tasks, you added a serial port to the virtual machine to capture the upgrade logs. After you have successfully upgraded the system, you must remove the serial port so that it does not impact the performance of the virtual machine.
Ensure that you power off the VM before you edit the settings to remove the serial port. For information about how to edit the settings, see the VMWare documentation.
Reset High and Low Watermarks
Use this procedure to restore the high and low watermarks to their original values in order to avoid premature purging of traces.
Procedure
Step 1 |
In the Real Time Monitoring Tool (RTMT) interface, double-click Alert Central in the left navigation pane. |
Step 2 |
On the System tab, right-click LogPartitionLowWaterMarkExceeded and select Set Alert/Properties. |
Step 3 |
Select Next. |
Step 4 |
Adjust the slider value to 80. |
Step 5 |
On the System tab, right-click LogPartitionHighWaterMarkExceeded and select Set Alert/Properties. |
Step 6 |
Select Next. |
Step 7 |
Adjust the slider value to 85. |
Update VMWare Tools
You must update the VMWare Tools after you complete and upgrade. There are two options for updating the VMWare Tools:
- configure the tool to use the Automatic Tools Upgrade option
- configure the tool to automatically check the tools version during a VM power-on and upgrade the tools
For information about how to configure these options, see the VMWare documentation.
Locale Installation
You can configure Cisco Unified Communications Manager and IM and Presence Service to support multiple languages. There is no limit to the number of supported languages you can install.
Cisco provides locale-specific versions of the Cisco Unified Communications Manager Locale Installer and the IM and Presence Service 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.
After you upgrade Cisco Unified Communications Manager or the IM & Presence Service, you must reinstall all the locales. Install the latest version of the locales that match the major.minor version number of your Cisco Unified Communications Manager node or IM and Presence Service node.
Install locales after you have installed Cisco Unified Communications Manager on every node in the cluster and have set up the database. If you want to install specific locales on IM and Presence Service nodes, you must first install the Cisco Unified Communications Manager locale file for the same country on the Cisco Unified Communications Manager cluster.
Use the information in the following sections to install locales on Cisco Unified Communications Manager nodes and on IM and Presence Service nodes after you complete the software upgrade.
User Locales
User locale files contain language information for a specific language and country. They provide translated text and voice prompts, if available, for phone displays, user applications, and user web pages in the locale that the user chooses. These files use the following naming convention:.
-
cm-locale-language-country-version.cop (Cisco Unified Communications Manager)
-
ps-locale-language_country-version.cop (IM and Presence Service)
If your system requires user locales only, install them after you have installed the CUCM locale.
Network Locales
Network locale files provide country-specific files for various network items, including phone tones, annunciators, and gateway tones. The combined network locale file uses the following naming convention:
-
cm-locale-combinednetworklocale-version.cop (Cisco Unified Communications Manager)
Cisco may combine multiple network locales in a single locale installer.
Note |
Virtualized deployments of Cisco Unified Communications Manager on Cisco-approved, customer-provided servers can support multiple locales. Installing multiple locale installers ensures that the user can choose from a multitude of locales. You can install locale files from either a local or a remote source by using the same process for installing software upgrades. You can install more than one locale file on each node in the cluster. Changes do not take effect until you reboot every node in the cluster. Cisco strongly recommends that you do not reboot the nodes until you have installed all locales on all nodes in the cluster. Minimize call-processing interruptions by rebooting the nodes after regular business hours. |
Install Locale Installer on Cisco Unified Communications Manager
User locale files provide translated text for user applications and user web pages in the locale that the user chooses. User locales are country-specific. Use the following procedure to install locales on the node. Optionally, you can follow the software upgrade procedure to install locale files from either a local or a remote source.
Before you begin
- Install Cisco Unified Communications Manager on every node in the cluster before you install the Cisco Unified Communications Manager Locale Installer.
- If you want to use a locale other than English, you must install the appropriate language installers on both Cisco Unified Communications Manager and on IM and Presence. Ensure the locale installer is installed on every node in the cluster (install on the Cisco Unified Communications Manager database publisher node before the subscriber nodes).
- User locales should not be set until all appropriate locale installers are loaded on both systems. Users may experience problems if they inadvertently set their user locale after the locale installer is loaded on Cisco Unified Communications Manager but before the locale installer is loaded on IM and Presence. If issues are reported, we recommend that you notify each user to sign into Cisco Unified Communications Manager user options pages and change their locale from the current setting to English and then back again to the appropriate language. You can also use the BAT tool to synchronize user locales to the appropriate language.
- You must restart the nodes for the changes to take effect. After you complete all locale installation procedures, restart each node in the cluster. Updates do not occur in the system until you restart all nodes in the cluster; services restart after the node reboots.
Procedure
Step 1 |
Download the locale installer from www.cisco.com. |
Step 2 |
Click the version of the Cisco Unified Communications Manager Locale Installer. |
Step 3 |
Click Download to download the installer file to the node. |
Step 4 |
After downloading the file, save the file to the hard drive and note the location of the saved file. |
Step 5 |
Double-click the file to begin the installation. |
Step 6 |
Perform these actions to complete the installation: |
Step 7 |
When the installation is complete, a new dialog requests confirmation of a restart. Should you wish to apply another locale installer, repeat this procedure before restarting the node in order to reduce downtime. |
Step 8 |
Click Finish. The Setup dialog box displays. Do not click any buttons or press any keys. |
Step 9 |
When the Setup dialog box automatically closes, you have completed the installation on the node. Install the Cisco Unified Communications Manager Locale Installer on every node in the cluster. |
Step 10 |
After you complete all locale installation procedures, restart each node in the cluster. |
Step 11 |
Verify that your users can select the locale(s) for supported products. Troubleshooting Tip Make sure that you install the same components on every node in the cluster. |
What to do next
Install Locale Installer on IM and Presence Service
Before you begin
- Install the Locale Installer on Cisco Unified Communications Manager. If you want to use a locale other than English, you must install the appropriate language installers on both Cisco Unified Communications Manager and on IM and Presence Service.
- If your IM and Presence Service cluster has more than one node, make sure that the locale installer is installed on every node in the cluster (install on the IM and Presence database publisher node before the subscriber nodes).
- User locales should not be set until all appropriate locale installers are loaded on both systems. Users may experience problems if they inadvertently set their user locale after the locale installer is loaded on Cisco Unified Communications Manager but before the locale installer is loaded on IM and Presence Service. If issues are reported, we recommend that you notify each user to sign into the Cisco Unified Communications Self Care Portal and change their locale from the current setting to English and then back again to the appropriate language. You can also use the BAT tool to synchronize user locales to the appropriate language.
- You must restart 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.
Procedure
Step 1 |
Navigate to cisco.com and choose the locale installer for your version of IM and Presence Service. http://software.cisco.com/download/navigator.html?mdfid=285971059 |
||
Step 2 |
Click the version of the IM and Presence Locale Installer that is appropriate for your working environment. |
||
Step 3 |
After downloading the file, save the file to the hard drive and note the location of the saved file. |
||
Step 4 |
Copy this file to a server that supports SFTP. |
||
Step 5 |
Sign into Cisco Unified IM and Presence Operating System Administration using the administrator account and password. |
||
Step 6 |
Choose . |
||
Step 7 |
Choose Remote File System as the software location source. |
||
Step 8 |
Enter the file location, for example /tmp, in the Directory field. |
||
Step 9 |
Enter the IM and Presence Service server name in the Server field. |
||
Step 10 |
Enter your username and password credentials in the User Name and User Password fields. |
||
Step 11 |
Choose SFTP for the Transfer Protocol. |
||
Step 12 |
Click Next. |
||
Step 13 |
Choose the IM and Presence Service locale installer from the list of search results. |
||
Step 14 |
Click Next to load the installer file and validate it. |
||
Step 15 |
After you complete the locale installation, restart each server in the cluster. |
||
Step 16 |
The default setting for installed locales is "English, United States”. While your IM and Presence Service node is restarting, change the language of your browser, if necessary, to match the locale of the installer that you have downloaded. |
||
Step 17 |
Verify that your users can choose the locales for supported products.
|
Error Messages
See the following table for a description of the messages that can occur during Locale Installer activation. If an error occurs, you can view the messages in the installation log.
Message |
Description |
---|---|
[LOCALE] File not found: <language>_<country>_user_locale.csv, the user locale has not been added to the database. |
This error occurs when the system cannot locate the CSV file, which contains user locale information to add to the database. This indicates an error with the build process. |
[LOCALE] File not found: <country>_network_locale.csv, the network locale has not been added to the database. |
This error occurs when the system cannot locate the CSV file, which contains network locale information to add to the database. This indicates an error with the build process. |
[LOCALE] Communications Manager CSV file installer installdb is not present or not executable. |
This error occurs because a Unified Communications Manager application called installdb must be present; it reads information that is contained in a CSV file and applies it correctly to the Unified Communications Manager database. If this application is not found, it either was not installed with Unified Communications Manager (very unlikely), has been deleted (more likely), or the node does not have Unified Communications Manager installed (most likely). Installation of the locale terminates because locales do not work without the correct records that are held in the database. |
[LOCALE] Could not create /usr/local/cm/application_locale [LOCALE] Could not create /usr/local/cm/application_locale/cmservices/ipma/com/cisco/ ipma/client/locales/maMessages_<ll>_<CC>.properties.Checksum. [LOCALE] Could not create /usr/local/cm/ application_locale/cmservices/ipma/com/cisco/ ipma/client/locales/maGlobalUI_<ll>_<CC>.properties.Checksum. [LOCALE] Could not create /usr/local/cm/ application_locale/cmservices/ipma/ LocaleMasterVersion.txt.Checksum. |
These errors could occur when the system fails to create a checksum file; causes can include an absent Java executable, /usr/local/thirdparty/java/j2sdk/ jre/bin/java, an absent or damaged Java archive file, /usr/local/cm/jar/cmutil.jar, or an absent or damaged Java class, com.cisco.ccm.util.Zipper. Even if these errors occur, the locale will continue to work correctly, with the exception of Unified Communications Manager Assistant, which cannot detect a change in localized Unified Communications Manager Assistant files. |
[LOCALE] Could not find /usr/local/cm/application_locale/cmservices/ipma/LocaleMaster Version.txt in order to update Unified CM Assistant locale information. |
This error occurs when the file does not get found in the correct location, which is most likely due to an error in the build process. |
[LOCALE] Addition of <RPM-file-name> to the Unified Communications Manager database has failed! |
This error occurs because of the collective result of any failure that occurs when a locale is being installed; it indicates a terminal condition. |
Supported Products
For a list of products that Cisco Unified Communications Manager Locale Installers support, see the Cisco IP Telephony Locale Installer for Cisco Unified Communications Manager, which is available at this URL:
http://www.cisco.com/cgi-bin/tablebuild.pl/callmgr-locale-51