Upgrading Cisco CallManager Release 4.0(2)
Performing Post-Upgrade Tasks

Table Of Contents

Performing Post-Upgrade Tasks

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

Verifying and Reinitializing Subscriber Connections

Verifying Services, Patches, and Hotfixes

Enabling RIS Data Collector

Reassigning Route Lists

Viewing the Component Versions That Are Installed on the Server

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

Upgrading the Cisco TAPI/TSP for Cisco SoftPhone

Using the Cisco 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 

Enable all Cisco-verified and Cisco-provided coresident applications, antivirus service or security agent that you previously disabled on the server.

Refer to the following information:

The documentation that accompanies your application

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

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 "Enabling RIS Data Collector" section.

Caution If you have third-party software, such as CDR software, integrated with Cisco 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 you have CRS and Cisco 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 CallManager?" section.

Step 5 

After you complete the Cisco 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 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 CallManager needs.

Refer to the appropriate documentation that accompanies the applications.

Step 6 

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

See the following sections for more information:

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

Upgrading the Cisco TAPI/TSP for Cisco SoftPhone

Step 7 

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 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 8 

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

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


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

Step 9 

For your migrated version of Cisco 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 CallManager Administration Guide.

Step 10 

After you upgrade Cisco 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 11 

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

Refer to Using Symantec/Norton AntiVirus with Cisco CallManager.

Step 12 

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 IP Telephony Locale Installer.

You can obtain locale-specific versions of the Cisco IP Telephony Network Locale installer for Cisco CallManager 4.0 when they become available at


Refer to the readme file that is posted next to the Cisco IP Telephony 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 IP Telephony Locale Installer.

Note The locale installer has version-specific support for Cisco CallManager releases. Cisco IP Telephony Locale Installer, Version 4.0(1) supports Cisco CallManager Version 4.0(1) or later.

Step 13 

You must configure the Network Interface Card (NIC) Speed and Duplex settings of the Cisco 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 CallManager NIC is connected.

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

Step 14 

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

Download the latest hotfixes, service packs, and Cisco 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.

See Verifying Services, Patches, and Hotfixes

See Enabling RIS Data Collector

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

Step 15 

Set Data Collection Enable to true in Cisco RIS Data Collector service

Enabling RIS Data Collector

Step 16 

To ensure optimal load balance, reassign the route lists to Cisco CallManager groups that you configured if you had more than one primary Cisco CallManager server configured.

Reassigning Route Lists

Step 17 

Back up the Cisco CallManager server.

Tip Perform this task daily to ensure that you have a recent backup of your system.

Refer to Cisco IP Telephony Backup and Restore System (BARS) Administration Guide, Version 4.0(1) (or later). To obtain the most recent version of this document, go to http://www.cisco.com/univercd/cc/td/doc/product/voice/backup/index.htm.

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:

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

Step 2 Locate the third-party application, antivirus service or security agent that you wish 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 subscriber servers within a cluster are broken for any reason, you cannot copy the database to the subscriber servers.

Verifying the Status of the Subscription

To determine whether the connections between the publisher database server and the subscriber servers within a cluster are broken, wait 35 minutes after you have installed the last subscriber server 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.


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 AVVID 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 CallManager service release (About Cisco CallManager Service Releases)

About Services

Open Cisco CallManager Serviceability and verify that all migrated services are running. To review service activation procedures and service recommendations, refer to the Cisco CallManager Serviceability Administration Guide and the Cisco 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 CallManager database.

About Microsoft Patches and Hotfixes

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

About Cisco CallManager Service Releases

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

Be aware that Cisco CallManager service releases are cumulative. Cisco rolls these bug fixes into the next Cisco 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 CallManager service release, perform the following procedure:

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

Step 2 Click Cisco CallManager Version 4.0.

The Cisco CallManager 4.0 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 CallManager service release on every server in the cluster where Cisco CallManager is installed.

Enabling RIS Data Collector


Step 1 From Cisco CallManager Administration, choose Service > Service Parameters.

The Service Parameters Configuration window displays.

Step 2 From the Server pull-down menu, choose any server.

Step 3 From the Service pull-down menu, choose RIS Data Collector.

Step 4 In the Data Collection Enabled field, choose True.

Step 5 Click Update.

Reassigning Route Lists

If you more than one primary Cisco CallManager server in a cluster was configured prior to upgrading to Cisco CallManager 4.0(2), you will need to reassign the route list to the Cisco CallManager group that you configured in Cisco CallManager Administration to maintain optimal load balance. To ensure call-processing redundancy, the upgrade program created a Cisco CallManager group that contains a primary server and a backup server for every primary Cisco CallManager server in the cluster and then assigned route lists to each Cisco CallManager group by using a round-robin algorithm. The following name format applies for the created Cisco CallManager group: RLCMG_<primary Cisco Callmanager name>.


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

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

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

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 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 IP Telephony 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 IP Telephony 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:


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


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

Upgrading TAPI, JTAPI, and Cisco 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 CallManager. TSP makes the voice-mail ports available to Cisco Unity. To ensure that Cisco Unity integrates properly with Cisco 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 CallManager Compatibility Matrix.

Upgrading the Cisco TAPI/TSP for Cisco SoftPhone

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


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

Tip To browse into the server, enter http://<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 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 SoftPhone.

Using the Cisco CallManager Music On Hold Disk or Download

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

When you initially install Cisco 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 provide 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 CallManager Administration Guide and the latest version of the Cisco CallManager System Guide.

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