Migrate Unified CM to Webex

Overview

Migrate users, devices, numbers, and locations from Unified CM to the Webex Calling platform for a better user experience and also to use the enterprise-wide Cisco Webex cloud Calling, mobility, and Messaging services.

The steps outlined here is applicable to Dedicated Instance also.

Migration readiness assessment

Use Migration Insights (Control Hub → Services → Upgrades & Migrations → Migration Insights) to make an informed decision about migrating to Webex Calling. Based on that information, you can confidently migrate to Webex Calling.

It is not required to have an existing customer organization to run the migration assessment using migration insight tool. You can use any organization to upload the Unified CM .tar file and get the report.

For more information on how to generate the migration insights report, see Migration Insights.

Once you export and download the .zip file, you get the list of output CSV files included in this zip file.

To get the full list of the export zip file, see Export ZIP file.

SharedlineGroupMigrationReport.csv and HuntGroup_CallQueue_CallPark_CallPickUpGroups.csv should be used to identify which users are in relationship with each other for group features and should migrate together.

Migrate Unified CM to Webex Calling

Before you begin

Before you start your migration, make sure that you meet the following requirements:

Make sure that you have an active subscription with Webex Calling as a cloud deployment option.

When selecting Webex Calling, you receive an entitlement PID A-FLEX-P-CALL on your subscription. The PID A-FLEX-P-CALL allows entitlement to temporary licensing obtained from GLO for up to 18 months while making the transition from on-premises UC Manager to Webex Calling in the cloud. This entitlement gives basic level support on both Calling environments for up to 18 months while customers transition to Webex Calling.

To open a case with GLO, see Licensing Support, under the Licensing Administration Portal section.
Access Control Hub as an organization administrator. For more information, see Assign Organizational Account Roles in Cisco Webex Control Hub.
Obtain the BAT/CSV files for the Unified CM users and devices. For more information, see Cisco Unified Communications Manager Bulk Administration Tool (BAT) .
Ensure phones on Unified CM that you're migrating are using Phone Load version 14.1 or later. For more information, see Install or Upgrade Cisco IP Phone Firmware.
Ensure all your end users from Unified CM are provisioned as Webex Users through Cisco Directory Connector or other means. For more information, see Install Cisco Directory Connector.
(Webex for Government only) Its mandate to complete the phone firmware migration steps. For more information, see Migrate your phone to Webex Calling.

Login to Control Hub, go to Services → Upgrades & Migrations.
Click Get started on the Migrate Unified CM to Webex Calling tile.

To move any or all of your users, workspaces, and devices from on-premises calling to Webex Calling, follow:

Step 1: Review the prerequisites
Step 2: Import data
Step 3: Migrate to Webex Calling

steps to Migrate Unified CM to Webex Calling

Step 1: Review the prerequisites

Click the Step 1 drop-down to view the list of prerequisites. Make sure to read and complete all prerequisite tasks before you proceed to Step 2: Import data.

Step1: Review prerequisites for migration

Step 2: Import Data

To import Data, collect the Unified CM details, such as the list of users and devices that you plan to import to the cloud calling service. Use the Unified CM Bulk Admin Tool to get the tar files. and, see Import Users Using the Bulk Administration Tool (BAT) for detailed information. Step 2: Import data

Click Step2: Import data drop-down → Action → Import user list.

To upload the .tar file, drag and drop the .tar file or click Choose a file to browse to the location of the tar file, select the file, and then click Open.

After the upload is successful and complete, the Create a New Task button in Step 3: Migrate to Webex Calling is enabled.

On the Action button, you can see the following options:

View—To view the data table with all imported data, such as User ID, Name, Mail ID, Directory Number, Device pool, and Device name. In the Import Data page, you can choose Actions to Export all or Import new.
Delete—To remove all the imported and uploaded data.

Import users list— you can use this option to migrate the list of devices or users. The steps for import users list is given below:

Click Import User List, to get the upload pane.

Use the sample template .csv file to enter the details.

In the sample template, you can see the following details,

Column	Description	Example
CUCM USER ID	The User ID from UCM end user.	user
EMAIL ID	The mail ID of UCM end user.	user@example.com
DEVICE MAC	The MAC Address of the device.	AABBCCDDEEFF NOTE: you can enter any one of the field for migration. If you enter all three fields, we will use the UCM email id followed by user id and then Device MAC.
CUSTOM DEVICE POOL	The tag is given for the set of devices or users.	Location-NY
USER AREA CODE

Drag and drop the .csv file or click Browse to browse to the location, select the file, and then click Open to upload the file.

Step 3: Migrate to Webex Calling

After you import the .tar file, click Step 3: Migrate to Webex Calling → Start New Task.

Create a new task

Create a migration task to migrate your Unified CM settings.

New task screen

1	In the New Migration Task window, enter the unique name of the task in the Enter task name field. The task name should contain a minimum of 8 characters. You can migrate a maximum of 1000 users and 1000 devices in a single task. You must create multiple migration tasks to migrate over 1000 users or devices.
2	Click Next.

Map device pool to locations

You can choose how your Unified CM device pools map to a Webex Calling location. Assign a Webex Calling Location to a Unified CM Device pool or leave it Undefined to do it later. Unified CM DNs that are mapped to a single device pool can be migrated. This page also lists the device pools that are migrated or pending for migration to a particular location.

If you do not want to include a location in this task, you can leave it undefined. For more information, see Configure Cisco Webex Calling for Your Organization.

1	You can view the following details in the Map Unified CM device pool to a Webex Calling location page: Device pool—Name of the device pool. Phones migrated—The total number of IP phones that are configured in Webex. Total devices—The total number of devices that are yet to be migrated. Webex Calling Location—The device pools that are assigned to a location. Country—The name of the country where the location belongs to.
2	Click the Search field and type the device pool or location to filter and view the respective data.
3	Click the Webex Calling location drop-down list to choose a location and click Next.

Assign a location

Make sure that the phone numbers and extensions are assigned to the correct location, and then choose the places that you want to include in the migration task.

1	Click Webex Calling Locations drop-down list to choose a location. You can see the records of the selected locations. The record field are common prefix (E.164), Unified DN range of phone numbers and extensions, UCM partition, Webex location, warning/errors, and total UCM number. If there are same device associated with multiple location, you should resolve the mandatory warning. Any other warning messages such as unsupported or conflicting length of the phone number extension are for information only. You can also click the All (Warnings) drop-down list to view the list of all warnings.
2	To move the total UCM line count between locations, click the ellipsis icon and select the desired destination from the list.
3	Click Next.

Manage numbers in location

Make sure the correct Webex phone numbers and internal extensions are assigned to all records. You can edit each number individually or auto assign numbers from the Actions menu. Manage Numbers in Location screen

1	On the Manage numbers in selected Webex Calling locations page, the following details appear: Total Webex calling location—The total number of locations. Phone numbers already in use—The total number of Webex phone numbers already assigned to users or workspaces in Control Hub. Phone numbers not allocated—The total number of Webex Numbers not in your Webex Calling org. Extensions already in use— The total number of Webex extensions already assigned to users or workspaces in Control Hub.
2	To assign a Webex phone number to a workspace, click the row and select Edit icon, Enter the number to assign for the user id.
3	You can see the following tasks in the Action icon. Export All: Use to modify the records Import New: Use to upload the modified records Clear all extensions: Use to clear extensions from all the users/workspaces being migrated as part of this task. Auto assign numbers: It randomly pulls any available number from this location of Webex Calling and assigns it to the user Add numbers to location: you can add numbers to this location on clearing the extensions Scenarios for Auto Assign numbers and Add numbers to location Scenario 1: In the migration flow, if all the Webex location is local gateway, you can see the option of Add numbers to location enabled, Auto assign numbers greyed out. Click Add numbers to location. This action will configure derived Webex phone numbers for premises-based PSTN into Webex Calling location. To continue with auto-configuration of phone numbers click Accept and continue. Enable the Activate numbers to activate the number now, else it can be activated through the Numbers page. Scenario 2: In the migration flow, if all the Webex locations are Cloud connected PSTN or Cisco PSTN, you can see the option Auto-assign numbers enabled, Add numbers to location is greyed out. If you do not want to use the existing UCM number and extensions, use the Auto-assign numbers option to pick any available number from this location and assign it. Enable the Generate Extensions to generate the extensions and click Accept and Continue. Scenario 3: In the migration flow, if the Webex location is a mix of premises-based PSTN and Cloud connected PSTN or Cisco PSTN. Add numbers to location and Auto assign numbers are greyed out.

Assign numbers to a user or a workspace

Webex users or workspaces are required to be assigned to all records. Webex identifies users by the Unified CM email ID. Workspaces must be manually toggled. Edit the record to either look up a user or toggle the Webex number as a workspace. Assign Numbers to a User or a Workspace

To assign a workspace, hover over the end of the desired row to click Edit icon, and enable the Workspaces toggle.

To remove a record from migration process, click - icon and click Cancel or Remove on the confirmation pop-up window.

You can see he following tasks in the Action icon,

Export all - Use to modify the records.

Import new - Use to upload the modified records.

Column	Description
USERID	The User ID from UCM end user.
CALLERID	The name to display for the line ID
DEVICEID	The unique identifier of the UCM device.
LOCATION ID	The unique identifier of the location.
LOCATION	The location to assign the device.
WEBEXNUMBER	The Webex number assigned to the endpoints.
WEBEXEXTENSION	The extension assigned to the endpoints.
WORKSPACE	The common workspace
USER/WORKSPACE	The common user/workspace

Click Next.

The Call Settings page appears.

Call settings

Set options for users and workspaces where applicable.

You can choose the calling license and calling permissions for user and workspace based on the subscription id's.

In User Calling license: when users migrate from Unified CM to Webex Calling using the migration tool, they can only be assigned Calling professional or CX Essentials licenses. When you need to assign a Webex Standard license during migration then don't use this tool. To assign the standard license, use a user CSV file and then use the Migrate features from the Unified CM tool to migrate the rest of the data from Unified CM to Webex.

In Workspace Calling License: when workspace migrates from Unified CM to Webex using a migration tool, they can be assigned Workspace or Professional Workspace licenses.

The radio buttons are enabled or disabled based on the subscription id's.

Check Device Eligibility

Migrate a Unified CM device that is supported by both Webex Calling and the migration tool, also ensure that the device is mapped to the correct Webex location. All devices that you're planning to migrate are listed in this page. You can migrate the eligible or compatible devices and devices with unknown status. Based on the hardware version of the device, you can verify if the device is eligible for migration. You can qualify a device from unknown to eligible by providing the correct MAC address and Model of a device. Device report

1	On the Manage devices to be migrated to Webex Calling page, the following details appear: Webex Calling location—The total number of locations. Webex App—The total number of users with access to Webex calling from the Webex App. Eligible phones—The total number of IP phones devices that are compatible for Webex Calling. Ineligible phones—The total number of IP phones devices that are not compatible for Webex Calling. Unknown phone eligibility—The eligibility status of the device is unknown. However, you can migrate these devices.
2	To update the MAC address of the device or modify the device model, click the device row, click the edit icon and then modify the MAC address on the Device MAC text box.
3	Click Actions to use the Export and Import functions and modify the records.
4	Click Next, the Review page appears.

Review

On the Review page, you can view the summary of your migration task, such as the list of items that are included or excluded in the migration, or any action that you must perform before you proceed to stage your migration. Migration review page

Click Show list next to the excluded or included items to expand and view the details about the reason for inclusion or exclusion.

Choose one of the following options:

Click Download reports to download the reports in bulk.
Click the ellipsis⋮ icon next to each included or excluded item and then click Download report to download the individual report the item.

Click Prepare to Migrate.

The Ready for migration page appears. The migration tool does these premigration activities:

Profile creation for each device in the Webex App
License generation for each device
BAT file generation
Associate a Calling behavior for all users rather than softphones.

Click Close.

The Migrate Unified CM to Webex Calling page appears with a list of tasks that are in different status.

The following table lists the task status and description:

Task Status	Description
Ready for migration	The pre-migration activities are complete. You can start your migration from Unified CM. The Complete migration button is enabled.
In-progress	The pre-migration activities are still in progress. The Complete migration button is disabled.
Draft	The pre-migration activity is yet to start. The Complete migration button is disabled.
Review Errors	The pre-migration activities are complete and there are errors to be resolved. The Complete migration button is disabled.
Ready with Errors	The pre-migration activities are complete with errors. The Complete migration button is enabled.

Click Complete migration to download the manifest file in .zip format which contains the MAC address of phones in a .csv format. You must upload this CSV file on Unified CM and start the migration.

If Cloud-Connected UC is enabled, it takes up the device migration.

Start Migration

You need to log into Cisco Unified CM and upload the CSV file with the device details to start the migration. Make sure that you’ve the CSV file that contains the user and phone details that you want to import from Unified CM to Webex Cloud calling service.

Upload files to start migration

1	Log in to Cisco Unified CM.
2	From Cisco Unified CM Administration, go to Bulk Administration > Upload/Download Files.
3	Click Add New. The File Upload Configuration window appears.
4	In the File text box, enter the full path of the file to upload from the downloaded manifest file or click Browse and locate the file.
5	From the Select the Target drop-down list, choose the target as Phone.
6	From the Transaction Type drop-down list, choose the transaction type as Update Phone - Custom File.
7	Check the Overwrite File if it Exists check box, if you want to overwrite an existing file with the same name.
8	Click Save. The upload status appears.
9	Repeat steps 4 to 8 for all the generated files.

Update phones using custom files

Use this procedure to migrate users and devices without an Enterprise license. The migration tool automatically converts the license of these users and devices.

1	From Cisco Unified CM Administration, choose Bulk Administration > Phones > Update Phones > Custom File. The Update Phones Custom Configuration page appears.
2	From the Update Bulk Phone Template where drop-down list, choose Device Name.
3	Click Find. The phones that are listed in the files, if available, appear on this page.
4	Click Next.
5	Check the required parameters check boxes and update the details such as description, phone load name, load server, and so on, in the respective fields.
6	From the Job Information section, choose one of the following options. Run Immediately—Click this button to start the job immediately. Run Later—Click this button to schedule the job sometime later.
7	Click Submit.
8	Repeat steps 1 to 7 for all the generated files.
9	To view the status of the submitted job, go to Cisco Unified CM Administration → Bulk Administration → Job Scheduler.
10	Select your job to view the job status.

Thanks for your feedback.