Upgrading Cisco Unified CallManager Release 4.3(1)
Performing Post-Upgrade Tasks
Downloads: This chapterpdf (PDF - 260.0KB) | Feedback

Performing Post-Upgrade Tasks

Table Of Contents

Performing Post-Upgrade Tasks

Default Recovery Setting

Enabling Third-party Applications, Antivirus Services, or Security Agents

Verifying and Reinitializing Subscriber Connections

Verifying Services, Patches, and Hotfixes

Reassigning Route Lists

Handling Secure Phones

Requirement for Installation of Java Virtual Machine

JRE Installation

Viewing the Component Versions That Are Installed on the Server

Upgrading TAPI, JTAPI, and Cisco Unified CallManager Telephony Service Provider (TSP)

Upgrading the Cisco Unified CallManager TAPI/TSP for Cisco IP SoftPhone

Using the JTAPI Update Utility with CRS

Using the Cisco Unified CallManager Music On Hold Disk or Download


Performing Post-Upgrade Tasks


After you complete the upgrade, perform the appropriate tasks as described below:

 
Post-Upgrade Task
Related Information and Procedures

Step 1 

Cisco Unified CallManager installation sets the default recovery setting for Cisco CallManager services to automatically restart the service when a failure is detected. Verify the default failure response of any services that you have previously changed.

See the"Default Recovery Setting" section.

Step 2 

Verify that the subscriber servers pulled the copy of the database.

See the "Verifying and Reinitializing Subscriber Connections" section.

Step 3 

Verify that all of the appropriate services started.

Verify that you can make internal calls.

Verify that you can place and receive a call across gateways.

See the "Verifying Services, Patches, and Hotfixes" section.

See the "Reassigning Route Lists" section.


Caution If you have third-party software, such as CDR software, integrated with Cisco Unified CallManager and the third-party software does not run as expected after the upgrade, verify that you entered the same SA password on all servers in the cluster.

Step 4 

If your Cisco Unified CallManager cluster uses security and the eTokens that are used to secure the cluster remain valid, update the CTL file, restart the Cisco TFTP and Cisco CallManager services on all the nodes in the cluster, and reset all secure phones.

Refer to the Cisco IP Telephony Backup and Restore System (BARS) Administration Guide, Version 4.0(12) or later for information on restoring a cluster that uses security.

Step 5 

If your Cisco Unified CallManager cluster uses security and you have lost the original Etokens or both Etokens got locked, you must perform the procedure with the new Etokens.

See the "Handling Secure Phones" section.

Step 6 

The system automatically restores the hosts and lmhost files on the publisher server but not on the subscriber servers. If you use hosts and lmhosts files for name resolution, you need to create new hosts and lmhosts files on each subscriber server or copy them from the publisher server. The system stores the files in the c:\winnt\system32\drivers\etc directory.

 

Step 7 

If you have CRS and Cisco Unified CallManager installed on the same server, complete the upgrade by referring to the appropriate documentation.

See the "How does a coresident upgrade work if I have CRS installed with Cisco Unified CallManager?" section on page 1-5.

Step 8 

After you complete the Cisco Unified CallManager upgrade on every server in the cluster, reinstall all Cisco-verified applications and all plug-ins that were previously installed on the server except the Cisco CDR Analysis and Reporting plug-in.

For example, if you have integrated your enterprise directory with Cisco Unified CallManager, you must reinstall the Cisco Customer Directory Configuration Plugin on all servers in the cluster after the upgrade, starting with the publisher database server. Reinstalling the plug-in populates your enterprise directory with any additional schema extensions and data entries that Cisco Unified CallManager needs.

Refer to the appropriate documentation that accompanies the applications.

Step 9 

Upgrade Cisco TAPI, Cisco Unified CallManager JTAPI, Cisco Unified CallManager TSP (for the voice-messaging system), and the Cisco Unified CallManager TSP for Cisco SoftPhone.

See the following sections for more information:

Upgrading TAPI, JTAPI, and Cisco Unified CallManager Telephony Service Provider (TSP)

Upgrading the Cisco Unified CallManager TAPI/TSP for Cisco IP SoftPhone

Step 10 

If you have CRS or Cisco Unified CallManager Auto-Attendant installed, you must execute the JTAPI update utility to ensure that the JTAPI plug-in is installed properly.

See "Using the JTAPI Update Utility with CRS" section.

Step 11 

If you are using Cisco Unity as your voice-messaging system, configure the appropriate settings to ensure proper failover.

For more information, refer to the Release Notes for Cisco Unified CallManager. To obtain the most recent version of this document, go to http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/index.htm.

Step 12 

Verify that all Cisco IP telephony applications that are integrated with Cisco Unified CallManager run properly. If you need to do so, upgrade the Cisco IP telephony applications that are integrated with your Cisco Unified CallManager system.

Refer to the Cisco Unified CallManager Software Compatibility Matrix that is found at the following location:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_device_support_tables_list.html

If the application is compatible with this version of Cisco Unified CallManager, refer to the appropriate Cisco IP telephony application documentation.

Step 13 

For your migrated version of Cisco Unified CallManager Attendant Console to work, you must check the Call Park Retrieval Allowed check box for the ac user that you configured in the Global Directory. The attendant console does not initialize if you do not check this check box.

For more information on how to perform this task, refer to the Cisco Unified CallManager Administration Guide.

Step 14 

After you upgrade Cisco Unified CallManager, the database name automatically increments; for example, from CCM0300 to CCM0301. Third-party CDR software may have SQL triggers that are hard coded to the original database name. The triggers may point to the previous database name and cause all CDR flat files to write to the BAD directory on the publisher database server.

If you need technical assistance with this issue, directly contact the third-party software vendor.

Step 15 

If you want to use Norton AntiVirus, install the application and perform post-installation tasks.

Refer to Using Symantec/Norton AntiVirus with Cisco Unified CallManager.

Click the following URLs to obtain more information.

http://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/prod_bulletin0900aecd800f6180.html

http://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/prod_bulletin0900aecd800f8572.html

Step 16 

The locale, English_United_States, installs automatically on the server. To upgrade existing locales or to add additional locales to the server, install the Cisco Unified CallManager Locale Installer.

You can obtain locale specific versions of the Cisco Unified Communications Network Locale installer for Cisco Unified CallManager 4.2 when they become available at

http://www.cisco.com/kobayashi/sw-center/telephony/callmgr/locale-installer.shtml.

Refer to the readme file that is posted next to the Cisco Unified CallManager Locale Installer software for the complete list of supported languages and localized features. For more information on installing the locale installer, refer to Using the Cisco Unified CallManager Locale Installer.

Note The locale installer has version-specific support for Cisco Unified CallManager releases.

Step 17 

You must configure the Network Interface Card (NIC) Speed and Duplex settings of the Cisco Unified CallManager server to match the configuration of the LAN switch port to which the server is connected. Failure to match these settings between the server and switch may cause degraded network performance and unexpected errors to occur. Contact your network administrator or see the Cisco IOS configuration documentation to determine your current settings of the LAN switch port to which the Cisco Unified CallManager NIC is connected.

Some administrators have found that the 100/Full setting works well.

Step 18 

Verify the version of hotfixes and service packs that are installed on the server.

Download the latest hotfixes, service packs, and Cisco Unified CallManager service release that are available on the web.

This task requires a reboot of the server after you install the files.

Tip Perform this task on an ongoing basis to maintain your system.

Verifying Services, Patches, and Hotfixes

Reassigning Route Lists

Tip The service releases may post to the web after the Cisco Unified CallManager upgrade is available.

Step 19 

If you are upgrading from Cisco CallManager Release 3.3(x) and had more than one primary Cisco Unified CallManager server, you must reassign the route lists to Cisco Unified CallManager groups that you configured if you wish to maintain an optimal load balance.

See the "Reassigning Route Lists" section.

Step 20 

If you are administering Cisco Unified CallManager servers from a PC that does not have Microsoft Java Machine, you will need to install and configure Sun Microsystems Java Virtual Machine (JVM) on the PC to ensure that Cisco Unified CallManager Administration displays correctly.

MSJVM installed by default in all client workstation versions of the current Windows operating systems, except for the following versions:

Windows XP Professional with SP1 slipstreamed into the installation

Windows 2000 Server/Professional with SP4 slipstreamed into the installation

Windows 2003 Server

See the "Requirement for Installation of Java Virtual Machine" section.

Step 21 

If you have created trace directories in addition to the default directories before the upgrade, you need to create them again.

Refer to the Cisco Unified CallManager Serviceability Administration Guide.

Step 22 

Perform basic connectivity and functional testing of any current Cisco Partner/Affiliate products/applications in your current (post-upgrade) environment. If you find any issues, compare your post-upgrade test results with your documented pre-upgrade test results.

See the "Before You Begin" section on page 2-1

Default Recovery Setting

Cisco Unified CallManager installation sets the default recovery setting on the following services to automatically restart the service when a failure is detected:

Cisco Serviceability Reporter

Cisco Unified CallManager

Cisco CTIManager

Cisco TFTP

Cisco Telephone Call Dispatcher

Cisco Tomcat

Cisco RIS Data Collector

Cisco Messaging Interface

Cisco does not recommend changing the recovery setting on a live production system. If you want to change the default failure response of a service, you can set the recovery setting by choosing Start > Settings > Control Panel > Service.

Enabling Third-party Applications, Antivirus Services, or Security Agents

After you log in to the server, enable all third-party applications, antivirus services, or security agents through the Control Panel by completing the following procedure:

Procedure


Step 1 Choose Start > Programs > Administrative Tools > Services.

Step 2 Locate the third-party application, antivirus service, or security agent that you want to start, right-click the service, and choose Properties.

Step 3 In the Properties window, click the General tab.

Step 4 From the Startup type drop-down list box, choose Automatic.

Step 5 Click OK.

Step 6 In the Services window, right-click the application or service and click Start.


Verifying and Reinitializing Subscriber Connections

If the connections between the publisher database server and the subscribers within a cluster are broken for any reason, you cannot copy the database to the subscribers.

Verifying the Status of the Subscription

To determine whether the connections between the publisher database server and the subscribers within a cluster are broken, wait 35 minutes after you have installed the last subscriber in the cluster. Then, open SQL Server Enterprise Manager. If a red X icon appears next to the subscription, the subscription is broken.

Reinitializing the Subscription/Starting the Replication Snapshot Agent

If you determine that one or more subscription connections are broken, as indicated by the red X icon next to the subscriptions, reinitialize the subscriptions and start the replication snapshot agent on the publisher database server.

Procedure


Step 1 Open SQL Server Enterprise Manager by choosing Start > Programs > Microsoft SQL Server > Enterprise Manager.

Step 2 In the following path, choose the name of the publisher database that you are configuring: Microsoft SQL Servers/SQL Server Group/<this server's hostname>/Databases/<the publisher database name>Publications.

Step 3 In the main window, right-click the subscription name and choose Reinitialize all Subscriptions. Click Yes to confirm.

Step 4 In the following path, choose the Snapshot Agents folder: Microsoft SQL Servers/SQL Server Group/<this server's hostname>/Replication Monitor/Agents.

Step 5 Right-click the publication name that matches the database name that you are configuring; then, click Start.


In rare cases, the reinitialization of the subscriptions may not work. If you determine that the previous procedure did not work as expected, contact the team that provides technical assistance for this product; for example, your Cisco Partner or the Cisco Technical Assistance Center (TAC).

Verifying Services, Patches, and Hotfixes

Perform the following tasks:

Verify that the appropriate services run on each server in the cluster (About Services)

Verify that you have installed the latest Microsoft patches and hotfixes (About Microsoft Patches and Hotfixes)

Verify that you have installed the latest Cisco Unified CallManager service release (About Cisco Unified CallManager Service Releases)

About Services

Open Cisco Unified CallManager Serviceability and verify that all migrated services are running. To review service activation procedures and service recommendations, refer to the Cisco Unified CallManager Serviceability Administration Guide and the Cisco Unified CallManager Serviceability System Guide.


Caution Do not start and stop services through the Microsoft Computer Management window. Starting and stopping services through the window causes problems with the Cisco Unified CallManager database.

About Microsoft Patches and Hotfixes

Refer to the file-specific readme document, Cisco Unified Communications Operating System, SQL Server, Security Updates, and Installing the Operating System on the Cisco Unified Communications Applications Server. To obtain the most recent version of these documents, go to http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.

About Cisco Unified CallManager Service Releases

After you install this version of Cisco Unified CallManager on all servers in the cluster, Cisco strongly recommends that you install the latest Cisco Unified CallManager service release on all servers in the cluster. These service releases provide bug fixes for your system.

Be aware that Cisco Unified CallManager service releases are cumulative. Cisco rolls these bug fixes into the next Cisco Unified CallManager release.


Tip Make sure that you install the same version of the service release on every server in the cluster.


To obtain the latest Cisco Unified CallManager service release, perform the following procedure:


Step 1 Click http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.

Step 2 Click Cisco Unified CallManager Version 4.3.

The Cisco Unified CallManager 4.3 software page displays.

Step 3 Locate and download the readme file for the service release.

The readme file provides procedures, caveats, and descriptive information for installing the files.

Step 4 Using the readme file as a reference, install the Cisco Unified CallManager service release on every server in the cluster where Cisco Unified CallManager is installed.


Reassigning Route Lists

If you had more than one primary Cisco Unified CallManager server in a cluster and you are upgrading from Cisco CallManager Release 3.3(x), to Cisco Unified CallManager 4.3(1), you will need to reassign the route list to the Cisco Unified CallManager group that you configured in Cisco Unified CallManager Administration to maintain optimal load balance. To ensure call processing redundancy, the upgrade program created a Cisco Unified CallManager group containing a primary server and a backup server for every primary Cisco Unified CallManager server in the cluster and then assigned route lists to each Cisco Unified CallManager group using a round robin algorithm. The name format for the created Cisco Unified CallManager group is RLCMG_<primary Cisco Unified CallManager name>.

Procedure


Step 1 Evaluate the Cisco Unified CallManager group and route list configuration for load balancing and redundancy, as described in the Cisco Unified CallManager System Guide and the Cisco Unified CallManager Network Solutions Design Guide.

Step 2 Assign the route list(s) to the Cisco Unified CallManager group(s) that you have configured in Cisco Unified CallManager Administration.

Step 3 Delete the migrated CCM group, RLCMG_<primary CM-server-name>.


Handling Secure Phones

Perform the following procedure if your Cisco Unified CallManager cluster uses security and you have lost the original Etokens or both Etokens got locked.

Procedure


Step 1 Browse to C:\Program Files\Cisco\TFTPPath and rename the CTLFile.tlv to a filename that you can remember.

Step 2 Run the CTL Client.

The system displays a message that indicates that no CTL file exists.

Step 3 Click OK.

Step 4 If the cluster exists in mixed mode, choose the Set Cisco Unified CallManager Cluster to Mixed Mode option if the option is not grayed out. Otherwise, choose the Update CTL File option.

Step 5 Click Next, and follow the wizard to complete the update.

Step 6 After you exit the wizard, restart the Cisco TFTP and Cisco CallManager services on all the nodes in the cluster.

Step 7 On each secure phone, choose the Settings menu and the Security Setting submenu, choose the CTL File option, press **#, and press the Unlock softkey.

Step 8 To erase the CTL file on the phone, press the Erase soft key.

Step 9 Reset the phones.


Requirement for Installation of Java Virtual Machine

The Microsoft Java Virtual Machine (MSJVM) technology allows Java applications to run on Microsoft Windows-based computers. Some versions of Microsoft Internet Explorer (a component of the Windows operating systems) included MSJVM, but Microsoft has discontinued distribution of MSJVM in its software and announced end-of-life support for the product.

MSJVM installed by default in all client workstation versions of the current Windows operating systems, except for the following ones:

Windows XP Professional with SP1 slipstreamed into the installation

Windows 2000 Server/Professional with SP4 slipstreamed into the installation

Windows 2003 Server


Note Because the Cisco Unified CallManager Administration windows depend on remote scripts, which depend on the JVM for web interaction, Cisco Unified CallManager requires the use of JVM on the client machine to ensure that the Cisco Unified CallManager Administration display correctly.


If your client machine runs MSJVM, you can continue to use the existing configuration to browse into the Cisco Unified CallManager Administration windows and perform administration tasks.

If you do not have MSJVM installed on your client machine (or if you receive a message stating that Cisco Unified CallManager cannot detect JVM on the client machine), and you need to perform Cisco Unified CallManager Administration tasks, you must install and configure the Sun Microsystems' Java Virtual Machine (JVM) on the client machine. (The Sun JVM represents part of the Java 2 Runtime Environment—JRE.) In addition, you must configure the browser security to be Java-enabled. See the "JRE Installation" section for information about installing JRE on the client machine.

If you are not sure whether MSJVM is installed on the client machine, you can install the Sun J2RE anyway. You would then have two Java Runtime Environments installed and running on your machine.


Tip If you run two separate JVM products (MSJVM and Sun J2RE) on your client machine, be sure to download and install patches and security updates for each JVM from the appropriate software vendor (Microsoft and Sun).


JRE Installation

As part of the Cisco Unified CallManager installation, the system provides the Sun JRE client software in a zip file that is installed on the Cisco Unified CallManager server.


Note Windows XP/XP Professional includes a built-in tool that handles zip files. If you use Windows 2000 as your operating system, you must obtain a separate compression utility (such as WinZip) to store and access zip files.


To install the JRE software for the client PC, follow these steps:

Procedure


Step 1 From the Cisco Unified CallManager server, navigate to the C:\utils\JRE directory and search for the J2RE_Client_<jre version>.zip file.

The following example shows the zip file name:

J2RE_Client_1.4.2_11.zip


Note Only the Cisco Unified CallManager Administrator can access the JRE software on the Cisco Unified CallManager server; to enable access to other users, copy the J2RE_Client_<jre version>.zip file to a server that all users can share.


Step 2 Right-click the J2RE_Client_<jre version>.zip file and click Copy to copy the file to your client PC.

Step 3 Double-click the J2RE_Client_<jre version>.zip file to unzip the Sun J2RE installation executable.

Step 4 Double-click the installation executable file on the client PC.

The following example shows the installation executable file name:

j2re-1_4_2_11-windows-i586-p.exe


Note The exact file name of the installation executable file changes with each version as the new version number is incorporated into the name.


The JRE software installs in the C:\Program Files\Cisco\Java\JRE directory.


Viewing the Component Versions That Are Installed on the Server

The mcsver.exe program reports the current version of all installation components, including the operating system. Be aware that Cisco does not report the actual Cisco Unified CallManager version through this program. Recognize that most of these components, which run from the installation disks during the initial installation, no longer exist on the system.

The version for OS Image equals your operating system disk version number. The version of OS Image will change only if you do a new installation with the Cisco Unified Communications Server Operating System Hardware Detection disk.

The version for stiOSUpg.exe equals the version of the operating system upgrade that you last ran either via disk or via the web. When Cisco updates and releases the Cisco Unified Communications Server Operating System OS Upgrade disk (Disk 2), the version of stiOSUpg changes.

Perform the following procedure to view the component versions that are installed on the server:

Procedure


Step 1 Use Windows Explorer to browse to the following folder:

C:\utils\mcsver

Step 2 View the versions of the components that are running on your server.


Upgrading TAPI, JTAPI, and Cisco Unified CallManager Telephony Service Provider (TSP)

You must upgrade the Telephony Application Programming Interface and Java Telephony Application Programming Interface (TAPI/JTAPI) client software on any application server or client workstation on which TAPI/JTAPI applications are installed. If you do not upgrade the TAPI/JTAPI client, your application will fail to initialize.

The following information applies if you have integrated a Cisco Unity system with Cisco Unified CallManager. TSP makes the voice-mail ports available to Cisco Unity. To ensure that Cisco Unity integrates properly with Cisco Unified CallManager, you may need to upgrade the TSP that is integrated with the voice-messaging system. To ensure that you upgrade to the appropriate TSP release, refer to the Cisco Unified CallManager Compatibility Matrix.

Upgrading the Cisco Unified CallManager TAPI/TSP for Cisco IP SoftPhone

Perform the following procedure to upgrade the Cisco IP SoftPhone TAPI/TSP to the version that is stated in the Cisco Unified CallManager Compatibility Matrix.

Procedure


Step 1 From each Cisco IP Softphone client, browse into server that is running Cisco Unified CallManager Administration and log in with administrative privileges.


Tip To browse into the server, enter https://<CM-server-name>/CCMAdmin/main.asp, where <CM-server-name> equals the name of the server, in the Address bar in the web browser.


Step 2 From the Application menu, choose Install Plugins.

Step 3 Click the Cisco Unified CallManager Telephony Service Provider icon that is associated with the plug-in.

Step 4 To complete the upgrade, follow the prompts in the window.

Step 5 Verify that a basic call works as expected for Cisco IP SoftPhone.


Using the JTAPI Update Utility with CRS

Cisco Customer Response Solutions (CRS) servers include a JTAPI Update Utility that performs synchronization of the Cisco Unified CallManager Plugin with the CRS server and the Cisco Agent Desktop (CAD). You must run this update tool to ensure successful operation of your CRS server.

If you have CRS or Cisco Unified CallManager Auto-Attendant installed (either coresident with the Cisco Unified CallManager server or on a separate server) and you upgrade and/or install Cisco Unified CallManager, you must take additional action to ensure plug-in synchronization.

Because an upgrade to a Cisco Unified CallManager server may include an updated JTAPI Plugin component, make sure that you run the JTAPI Update Utility on the CRS server to upgrade the JTAPI client. Running the JTAPI Update Utility on your CRS server, after you upgrade Cisco Unified CallManager, ensures that the JTAPI Plugin gets properly installed.


Note Simply executing the plug-in installer to install the JTAPI Plugin on the CRS server (in lieu of running the JTAPI Update Utility) does not copy the jtapi.jar file to the CRS share folder, which leaves the update in an unfinished state.


For detailed information about the JTAPI Update Utility, refer to the Cisco Customer Response Applications Administrator Guide at http://www.cisco.com/univercd/cc/td/doc/product/voice/sw_ap_to/apps_3_5/english/admn_app/apadm35.pdf.

Using the Cisco Unified CallManager Music On Hold Disk or Download


Note This section applies if you have never downloaded the Cisco Unified CallManager Music On Hold files from the web or used the Cisco Unified CallManager Music On Hold disk.


When you initially install Cisco Unified CallManager on your server, a default music on hold audio file sample automatically installs for customer use. To increase your music on hold (MOH) selection, you may download one of the following two files via the web:

ciscocm-MusicOnHold, which is a set of wav files that provides the entire music selection from the disk

ciscocm-MusicOnHoldSampler, which is a small set of files that offers a sample of music that is available on the disk

For information on the MOH feature, refer to the latest version of the Cisco Unified CallManager Administration Guide and the latest version of the Cisco Unified CallManager System Guide.

As a Cisco Unified CallManager user, you can use any disk/file with music on hold. Because of licensing restrictions, you must not distribute the Cisco Unified CallManager Music on Hold disk/files to anyone else, and you must not use the files for any other purpose.