The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter provides recommendations for administrators to manage migrations from traditional PBX systems to IP telephony as well as from previous Cisco Collaboration System Releases (9. x, 10. x, and 11. x) to the latest Cisco Collaboration System Release (CSR) 12. x.
For more information on minimum hardware and software requirements for Open Virtualization Archive (OVA) templates, VMware, ESXi Hypervisor, and Collaboration applications, refer to the following documentation:
https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_system/virtualization/virtualization-software-requirements.html
https://www.vmware.com/resources/compatibility
For Cisco Collaboration System Release 12. x, most Cisco Collaboration applications require virtualization deployments and may not be installed directly on a server without a hypervisor. VMware vSphere ESXi is currently the only supported hypervisor, and it is mandatory for all virtualized deployments of Cisco Collaboration Systems. Cisco Collaboration System Releases do not support VMware vSphere ESX or any other VMware server virtualization products besides ESXi.
This chapter discusses the following types of migrations:
In order to ensure a successful migration, Cisco recommends using the following resources to validate that all requirements have been met prior to migration:
https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/uc_system/unified/communications/system/Compatibility/CSR-Compatibility-Matrix.html
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-device-support-tables-list.html
The validation will ensure a successful migration using supported upgrade paths. For example, some early application software versions might require a multi-step upgrade in order to migrate successfully. Similarly, server hardware along with software compatibility might require a combination of multi-step hardware and software upgrades.
For details on Cisco Collaboration System products, refer to the documentation available at
https://www.cisco.com/c/en/us/solutions/collaboration/collaboration-systems-release/index.html
For a list of all supported system hardware, refer to the Unified Computing Products documentation available at
https://www.cisco.com/c/en/us/products/servers-unified-computing/product-listing.html
Table 26-1 lists the topics that are new in this chapter or that have changed significantly from previous releases of this document.
This is an important choice that must be made. Coexistence typically means two or more systems coexisting for an extended period of time (for example anything greater than six months.) Under this scenario feature transparency, whether for PBX, voicemail, or other features, becomes a more significant consideration. Investment and/or upgrades to existing systems might be necessary in order to deliver the level of feature transparency required. Migration typically occurs over a shorter period of time (for example, less than six months). Under this scenario users are more likely to tolerate a subset of existing features, knowing that the migration will be complete in a "short" time. Often existing system capabilities are sufficient for this short time, therefore migration is often less costly when compared to coexistence.
Before implementing any collaboration migration steps, all administrators should ensure their IP infrastructure is "collaboration ready," including redundancy, high availability, power consumption, Quality of Service (QoS), in-line power, ethernet ports, and so forth. For further details, refer to the chapter on Network Infrastructure.
If this is a first deployment of Cisco Unified Communications on Cisco Unified Computing System (UCS), follow the guidance provided in the Cisco UCS Site Preparation Guide, available at
https://www.cisco.com/c/en/us/td/docs/unified_computing/ucs/hw/site-prep-guide/ucs_site_prep.html
Business needs of the users play an important role in identifying key system requirements to ensure that the features and functionality are reserved or translated during migration to provide equivalent behavior. A list of features and the versions of various devices and software helps in understanding what is supported. Typically some kind of survey of the site and users should be performed to ensure that all requirements (for example, fax/modems, environmental control systems, and so forth) are appropriately identified and accounted for.
There are two main methods for migrating to a virtualized Cisco Collaboration System: phased migration and parallel cutover. Cisco Prime Collaboration Deployment can be used to manage and simplify the migration process.
This method typically starts with a small trial focused around Cisco Unified Communications Manager (Unified CM). Once the customer is familiar with Unified CM, the system administrator can initiate the steps to migrate and move groups of users at a time to the production system, with the new Unified CM release.
This method begins similar to the phased approach; however, once the customer is satisfied with the progress of the trial, then a time and date are chosen for cutting-over all the users at once to the new Cisco Collaboration System.
A parallel cutover has the following advantages over a phased migration:
One disadvantage of the parallel cutover is that it requires the collaboration services, including the supporting infrastructure, to be fully funded from the beginning because the entire system must be deployed prior to bringing it into service. With a phased migration, on the other hand, you can purchase individual components of the system as and when they are needed, and this approach does not prevent you from starting with a small trial system prior to moving to full deployment. Neither method is right or wrong, and both depend upon individual customer circumstances and preferences to determine which option is most suitable.
The following examples illustrate a phased migration and a parallel cutover from a PBX system to a Cisco Collaboration System.
Example 26-1 Phased Migration to Cisco Collaboration System
This approach typically entails a small Cisco Collaboration System trial that is connected to the main corporate PBX. The choice of which signaling protocol to use is determined by the required features and functionality as well as by the cost of implementation. Cisco Unified Communications Manager (Unified CM) can support either regular PSTN-type PRI or QSIG PRI as well as H.323 and SIP. Of these options, QSIG PRI typically provides the highest level of feature transparency between any two systems.
PSTN-type PRI provides for basic call connectivity as well as Automatic Number Identification (ANI). In some instances, the protocol also supports calling name information. This level of connectivity is available to all PBXs and therefore is considered to be the least costly option; that is, if the PBX can connect to the public network through PRI, then it can connect to Unified CM because Unified CM can be configured as the "network" side of the connection.
With either PSTN-type PRI or QSIG, the process for a phased migration is similar: move users from the PBX to Unified CM in groups, one group at a time, until the migration is complete.
The Cisco San Jose campus, consisting of some 23,000 users housed in approximately 60 buildings, was migrated to a Cisco Collaboration System in this manner and took just over one year from start to finish at the rate of one building per weekend. All users in the selected building were identified, and their extensions were deleted from the PBX on a Friday evening. At the same time, additions were made to the PBX routing tables so that anyone dialing those extension numbers would then be routed over the correct PRI trunk for delivery to Unified CM. During the weekend, new extensions were created in Unified CM for the users, and new IP phones were delivered to their appropriate office locations, ready for use by Monday morning. This process was repeated for each building until all users had been migrated.
Example 26-2 Parallel Cutover to Cisco Collaboration System
For this approach, all IP phones and gateways are fully configured and deployed so that users have two phones on their desk simultaneously, an IP phone as well as a PBX phone. This approach provides the opportunity not only to test the system but also to familiarize users with their new IP phones. Outbound-only trunks can also be connected to the Cisco Collaboration System, giving users the opportunity to use their new IP phones to place external as well as internal calls.
Once the Cisco Collaboration System is fully deployed, you can select a time and date for bringing the new system into full service by transferring the inbound PSTN trunks from the PBX to the Cisco Collaboration System gateways. You can also leave the PBX in place until such time as you are confident in the operation of the Cisco Collaboration System, at which point the PBX can then be decommissioned.
The Cisco San Jose campus voicemail service was originally provided by four Octel 350 systems serving some 23,000 users. Cisco Unity servers were installed and users' mailboxes were configured. Users had access to the their Cisco Unity mailbox by dialing the new access number, in order to allow them to record their name and greeting(s) as well as to familiarize themselves with the new Telephony User Interface (TUI). Approximately two weeks later, a Unified CM Bulk Administration Tool (BAT) update was carried out on a Friday evening to change the Call-Forward Busy and No-Answer (CFB/CFNA) numbers as well as the Messages button destination number for all users to the Unity system. Upon returning to work on Monday morning, users were serviced by Cisco Unity. The Octel 350 systems were left in place for one month to allow users to respond to any messages residing on those systems before they were decommissioned.
Although both methods of Cisco Collaboration System migration work well and neither method is right or wrong, the parallel cutover method usually works best in most cases. Cisco has a lab facility dedicated to testing interoperability between Unified CM and PBX systems, which might or might not include your current system architecture and applications. Cisco documents these test systems and their interoperability and end-user features, which should help greatly with the installation and migration process. The results of that testing are made available as application notes, which are posted at
https://www.cisco.com/c/en/us/solutions/enterprise/interoperability-portal/index.html
The notes are updated frequently, and new documents are continuously added to this website. Check the website often to obtain the latest information.
Cisco Prime Collaboration Deployment is the primary tool for migration from a Cisco Collaboration System running on MCS servers to a Cisco system running with virtualization, or migration from a previous system version to Cisco Collaboration System Release 12. x.
In the case of an enterprise that has chosen a centralized deployment model for its Cisco Collaboration System, two options exist:
The majority of customers choose the first option because it has the following advantages:
The remote sites should be migrated by the parallel cutover approach, whereas the central site can be migrated using either the parallel or phased approach.
This choice depends mainly on the customer's particular business needs, and Cisco Collaboration solutions allows for most of the individual services to be deployed independently of the others. For example, IP telephony and voice messaging can be deployed independently from each others.
This capability provides the customer with great flexibility. Consider a customer who is faced with a voicemail system that has since gone end-of-support and is suffering various issues leading to customer dissatisfaction. Cisco Unity Connection can often be deployed and integrated with the current PBX, thereby solving this issue. Once the new voicemail system is operating appropriately, then attention can turn to the next collaboration service, namely IP telephony.
Video endpoints controlled by Cisco Unified Communications Manager (Unified CM) might support only a subset of the features that are available with a video-centric Cisco Video Communications Server (VCS). However, migration to Cisco Unified CM can provide advantages such as a unified dial plan and consolidation of other features under a single call control agent. The following guidelines apply for migrating video endpoints to Unified CM:
– Phased migration is the most commonly used method for this purpose because it enables users to become familiar with the new devices while still having their existing phones as backup for some time.
– Provide adequate network capacity to ensure a good experience for users. As the video resolution increases, higher bandwidth is needed when compared with audio-only calls.
– Migrate the dial plan and associated gateways (for example, ISDN H.320 gateways) and application servers (for example, conferencing servers and bridges).
– System management tools can be a big help when there is a large number of endpoints or if the endpoints need more back-end administration and support.
Organizations can then assess the types of devices, the feasibility, and the scope of the tasks needed so that the migration of video devices to Unified CM is as efficient and effective as possible.
Cisco Collaboration System Release 12. x provides centralized license management through Cisco Smart Software licensing. The licensing model for 12. x releases is under the management of the Cisco Smart Software Manager (SSM) instead of Prime License Manager as with previous system releases.
Customers who have already deployed Cisco Unified Communications or Collaboration solutions can use the Cisco Global Licensing Operations (GLO) process to migrate existing licenses to Cisco Smart Software licensing.
A self-serve option is available for those experienced with the Cisco software licensing process and functions. This self-serve option is available through the Product License Registration tool at
https://tools.cisco.com/SWIFT/LicensingUI/migrateDisplayProducts
Note You must have a valid Cisco.com login ID and password in order to access the Product License Registration tool at the above link.
You may also get assistance from the Cisco Global Licensing Operations (GLO) team by opening a case using the Support Case Manager https://tools.cisco.com/ServiceRequestTool/scm/mgmt/case.
For all license migrations, follow the guidelines presented in this section.
The license migration process has been simplified to make the migration to Cisco Smart Software License Manager much easier. Customers wanting to upgrade to Cisco Collaboration System Release 12. x may contact the Cisco Global Licensing Operations (GLO) team directly for all migration needs. GLO processes the request and transfers the licenses to the organization's Cisco Smart Account. Cisco adjusts the current software service contract product records to reflect the number of Release 12. x users that have been licensed.
Make sure you register any unused Product Activation Keys (PAKs) for the system being migrated. If the customer had planned for growth in the previous license model, take that into consideration for the current migration. As an example, if there is a need to have some clusters on a pre-12. x release while upgrading the rest to 12. x, then the license migration request to the GLO team must clearly state exactly how many users need to be migrated and how many will remain in the old format when the request is made.
Ensure that you have analyzed all licensing needs in detail, and clearly state the needs in the request. If migration is from a pre-9. x release with DLUs, once those DLUs are migrated there is no way to revert back to the old schema because all migrated DLUs will be in the "revoked" state.
Note The licensing process is subject to change with each new release. Always confirm the process with Cisco GLO before submitting your license request to license@cisco.com.
You can contact GLO for license migration during the following stages:
You will need to provide GLO with the following information:
You will need to provide GLO with the following information:
Note For all pre-9.x systems moving to Collaboration System Release 12.x, customers must decide if they want to use their unused DLUs or drop them at the time of migration. There are no refunds for dropped DLUs; however, customers will save on future service charges. Note the differences between current Cisco Unified Communications Software Subscription (UCSS) users on contract and estimate the change, if any, in their UCSS and Essential Operate Services (ESW) costs at renewal.
At the time of migration, customers may choose how to use their existing licenses. The options are:
After the upgrade process is complete, the information is locked in and becomes the customer entitlement record moving forward. There are no further modifications to the license migration information.
For more information, refer to the following documentation:
https://www.cisco.com/go/smartlicensing
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.html
Cisco Smart Software Manager (Cisco SSM) currently supports the following Cisco Collaboration applications:
For more information on Cisco Smart Software Manager, refer to the documentation available at
https://www.cisco.com/c/en/us/buy/smart-accounts/software-manager.html
Cisco Prime Collaboration Deployment is a management application that enables administrators to perform migration from legacy Cisco Unified CM and Cisco IM and Presence services to a virtualized environment in Cisco Collaboration System Release 12. x. Cisco Prime Collaboration Deployment can migrate the cluster(s), handle data migration, and install the 12. x release on all the new VMware ESXi hosts with very little impact to the production (source) cluster. Cisco Prime Collaboration Deployment does a direct migration, whereas previous migration methods involved more steps with a "server recovery" Disaster Recovery System relying on an initial upgrade followed by a restore from backup.
Cisco Prime Collaboration Deployment can also be used to:
Cisco Prime Collaboration Deployment supports two types of migrations:
In a simple migration, each node in the cluster keeps its original hostname and IP address as well as all other network configurations.
In a network migration, one or more nodes in the cluster have a change in hostname, IP address, and/or any other network configuration needed for Collaboration Applications.
With this type of migration, the IP addresses and hostnames are not changed during the migration. The following procedure describes the recommended steps for migration task configuration within Cisco Prime Collaboration Deployment to ensure a highly available migration.
Cisco Prime Collaboration Deployment first exports the data of all the existing nodes. Then it powers down the existing publisher, installs the new publisher running as a virtual machine, and imports the publisher’s data.
After the publisher migration is done, Cisco Prime Collaboration Deployment migrates the TFTP and backup call processing nodes of the cluster. First the existing TFTP and backup call processing nodes are powered down. Then Prime Collaboration Deployment installs the new TFTP and backup call processing nodes, and imports the backup data.
Once the backup call processing nodes are migrated, the Cisco Prime Collaboration Deployment migration task pauses and the administrator should configure all phones to re-register to the backup call processing nodes by changing the order in the Unified Communications Manager group, or by using device pools.
Finally, Cisco Prime Collaboration Deployment migrates the primary call processing nodes. Once this is done, phones can be re-registered to their primary call processing server.
For more details, refer to the latest version of the Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, available at
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-guides-list.html
Cisco Prime Collaboration Deployment can also be utilized for a migration requiring network configuration changes for parameters such as server IP address and hostname. If the source Unified CM cluster is running release 8. x or later, the phone Initial Trust List (ITL) file should be updated during the migration by using the Bulk Certificate Management export, consolidate, and import functions in order to avoid having to delete the ITL file manually on each phone.
For more information, refer to the latest version of the Cisco Prime Collaboration Deployment Administration Guide, available at
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html
Video endpoints migrated from the Cisco TelePresence Video Communication Server (VCS) to Cisco Unified CM might support only a subset of the features that were available in the video-centric VCS environment. However, migration to Cisco Unified CM can provide advantages such as a unified dial plan and consolidation of other features under a single call control agent. Migration of video endpoints to Cisco Unified CM supports both SIP and SCCP endpoints, but Cisco recommends that all customers move to SIP endpoints. Although SCCP is supported, SIP has grown in popularity among both Unified Communications vendors and customers, and SIP features and functionality have grown, making SIP the new standard and recommended choice for Unified Communications.
Consider the following recommendations when migrating video endpoints to Unified CM as SIP endpoints:
H.323 was designed with a good understanding of the requirements for multimedia communications over IP networks, including audio, video, and data conferencing. It defines an entire unified system for performing these functions. Although SIP adoption is on the rise, H.323 is still the most widely deployed protocol for videoconferencing endpoints due to its longevity in the field. Organizations have spent a lot of effort and money deploying H.323, so they understand how it fits into their environment.
SIP is easier to implement and has begun to gain popularity in the video marketplace. As organizations struggle with the idea of changing signaling protocols, the industry has continued to evolve, and SIP has become popular for its ease of use and ability to integrate with other vendors’ products. Cisco Collaboration Systems support both H.323 and SIP, but Cisco strongly recommends utilizing SIP because it provides a set of services similar to H.323 with far less complexity, rich extensibility, and better scalability.
Cisco Unified CM supports both SIP and H.323 intercluster trunks, and in many cases the decision to use SIP or H.323 is driven by the unique feature(s) offered by each of the protocols. A number of factors can dictate the choice customers make, such as experience, ease of interoperability, features, and functionality with various other products. While Cisco Collaboration Systems support both H.323 and SIP trunks, Cisco recommends using SIP trunks for all deployments because SIP trunks provide ease of interoperability as well as additional features and functionality not available with H.323 trunks.
For detailed information on H.323 and SIP trunk capabilities and operation, see the chapter on Cisco Unified CM Trunks.
Cisco Unified Communications Manager (Unified CM) supports both SIP and H.323 protocols for gateways. Cisco gateways provide a number of methods for connecting Cisco Collaboration Systems to the Public Switched Telephone Network (PSTN), a legacy PBX, or third-party external deployment solution. Cisco provides both voice and video gateways, from entry-level to high-end, that fully support both protocols, but Cisco highly recommends SIP as the choice for all call signaling because it interoperates better with the entire portfolio of Cisco Collaboration voice and video products.
For detailed information on H.323 and SIP gateway capabilities and operation, see the chapter on Gateways.
Given Cisco's general recommendation for Session Initiation Protocol (SIP) standard signaling, administrators should consider migrating their existing SCCP IP endpoints to SIP IP endpoints to provide feature parity and standards compliance. If existing SCCP IP phone models support SIP loads, administrators can use the Cisco Unified CM Bulk Administration Tool (BAT) to perform this migration.
Unified CM BAT is the recommended tool to migrate SCCP phones to SIP phones. SIP is a universal protocol standard in the industry. Within Unified CM BAT, there is an option for SCCP-to-SIP phone migration workflow (Bulk Administration > Phones > Migrate Phones > SCCP to SIP), which generates a report of existing SCCP phones. After selecting the SCCP phones to be migrated, the job to migrate these devices to SIP can be run immediately or scheduled for later. During the SCCP-to-SIP migration, only SIP specific default values in the phone report get migrated; other values in the template are not migrated. Migrating a phone from SCCP to SIP does not require a manual reset because the migration itself handles the reset of the phones.
For more information and detailed migration steps, refer to the latest version of the Bulk Administration Guide for Cisco Unified Communications Manager, available at
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html
SIP uniform resource identifiers (URIs) are an addressing schema for directing calls to users. A URI is essentially an alias for a user's assigned directory number. A SIP URI resembles an email address and is written in the following format:
where x =username and y =host (domain or IP)
username@cisco.com or users-directorynumber@cisco.com
URIs are alphanumeric strings consisting of a user name and a host address separated by the @ symbol. Cisco Unified CM supports the following formats for directory URIs:
If the SIP request carries a user=phone tag, the SIP URI is interpreted as a numeric SIP URI and Unified CM assumes that the user portion of the SIP URI is a directory number. If no user=phone is present, the decision is based on the dial string interpretation setting in the calling device's (endpoint or trunk) SIP profile. This setting either defines a set of characters that Unified CM will accept as part of numeric SIP URIs (0-9, *, #, +, and optionally A-D) or it enforces the interpretation as a directory URI.
Note If you do not specify a port, the default SIP port (5060) is assumed. If you have changed the default SIP port to something else, then you must specify it in the SIP URI.
The following URI and directory number (DN) considerations apply to Unified CM and supported endpoints:
For more information, see the section on Implementing Endpoint SIP URIs.
Music on hold (MoH) from an audio source file (using unicast or multicast) is supported; however, fixed or live audio source connections to Unified CM are not supported due to lack of USB audio support with virtualized servers. The following guidelines apply to live audio source MoH with virtualized Unified CM server nodes:
While the Cisco UCS B-Series Blade Servers and C-Series Rack-Mount Servers do support a local keyboard, video, and mouse (KVM) cable connection that provides a serial port, a Video Graphics Array (VGA) monitor port, and two Universal Serial Bus (USB) ports, the Unified CM VMware virtual application has no access to these USB and serial ports. Therefore, Unified CM no longer supports the Cisco Messaging Interface (CMI) service for Simplified Message Desk Interface (SMDI) integrations, fixed MoH audio source integration for live MoH audio feeds using the audio cards, or flash drives to these servers.
For existing Cisco IM and Presence deployments running on a Cisco MCS physical server, upgrading to release 12. x would require a migration to virtualization. Use Cisco Prime Collaboration Deployment to facilitate this migration.