Migration of Devices and Features From Cisco unified Communications Manager (UCM) to Webex Calling Multi Tenant

Overview

This gives the information about the migration and mapping of Device, Call Queue, Hunt Group, Speed Dial and Auto-Attendant Migration between UCM and Webex Calling.

Use the Migration Insights to make an informed decision about migrating to Webex Calling. Based on that information, you can confidently migrate to Webex Calling. For more information, see Migration Insights.

You can migrate the Device, Call Queue, Hunt Group, speed dial and Auto-Attendant features.

If you want to migrate through Device, Speed Dial and Auto-Attendant

From the customer view in https://admin.webex.com, go to Management > Devices >Add device. In the Add device pop-up window, select the Multi Cisco IP phone card and click Next.
In the Bulk Add Devices window, click Import data from UCM.

If you want to migrate through Call Queue,

From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the Calling window, select Features and select the Call Queue tab. Then click the Manage drop-down and select Bulk Manage.
In the Manage Call Queue pop-up window, click Import data from UCM.

If you want to migrate through Hunt Group,

From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the Calling window, select Features and select the Hunt Group tab. Then click the Manage drop-down and select Bulk Manage.
In the Manage Hunt Group pop-up window, click Import data from UCM.

Collect Unified CM details, such as the list of users and devices that you plan to import to a cloud calling service. Use the Unified CM Bulk Administration Tool to get the tar files, see Import Users Using the Bulk Administration Tool (BAT) for detailed information and then import the files.

In the Import Data from UCM & Unity and provision into Webex Calling window, drag and drop the .tar file and click Next.

The maximum size of upload is 350 MB.

If you want to cancel or replace the .tar file, click Click to cancel import to start over from the Import Data from UCM & Unity and provision into Webex Calling.

The .tar file takes some time to upload. Once uploaded, the successful window appears.

For Speed Dial, use Import Config to upload the updated file.

For Auto-Attendant, Drag and drop the .zip file in the Drag and drop Unity .zip file (for Auto Attendant) here or browse for files pane.

To create the unity call Handler .zip file. Refer to CallHandlerDataDump.

The maximum size of upload for Unity .zip file is 2GB.

To delete the uploaded .tar file, click three dots on the top right and select Delete.

To download the CSV files from the .zip file, click three dots on the top right and select Export CSV.

After a successful download, you can view the detailed information on the CSV files.

Export ZIP File

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

The CSV files has the same format as the Webex Calling Bulk CSV for its corresponding features and services.

CallQueueBulk.csv - Contains provisioning data which includes errors and notes that requires an Administrator to make correction(s) before it’s ready to upload in Control Hub.
DeviceBulk.csv - Contains the valid provisioning data for firmware migration and needs to delete the extra column before the Administrator uploads it to the Control Hub.
DeviceBulkError.csv - Contains data that are having errors and require an Administrator to make corrections.
HuntGroupBulk.csv - Contains provisioning data which includes errors and notes that requires Administrator to make corrections before it’s ready to upload in Control Hub.
ImportDataBulk.csv - Contains the extracted data from enduser.csv, phone.csv, and device_pool.csv of the imported UCM tar files.
DeviceLineKeyConfiguration.csv – Contains provisioning data to configure Speed Dials on Line Keys and KEM modules.
AutoAttendantBulk.csv – Contains provisioning data which includes errors and notes that requires an Administrator to make correction(s) before it’s ready to upload in Control Hub.
README.txt - Contains detailed information on the CSV files.

View Details on each CSV File

Use this table to see what fields and descriptions on each of the CSV contains.

DeviceBulk.csv

Column	Description	Example
Username	The full name of the UCM user.	user@example.com
Type	The workspace/USER	USER
Extension	You must have either a phone number or an extension.	3409
Phone Number	The UCM phone number of the device.	+12225553409
Device Type	IP Phones	IP Phone
Model	The model of the device	Cisco 8865
MAC Address	The MAC Address of the device	AABBCCDDEEFF
Location	Enter the location to assign the device.	New York
Device Pool	The UCM device pool to which the device belongs.	AshwiniOPUS-UP

DeviceBulkError.csv

Column	Description	Example
Username	The full name of the UCM user.	user@example.com
Type	The workspace/USER	USER
Extension	You must have either a phone number or an extension.	3409
Phone Number	The UCM phone number of the device.	+12225553409
Device Type	IP Phones	IP Phone
Model	The model of the device	Cisco 8865
MAC Address		AABBCCDDEEFF
Location	Enter the location to assign the device.	New York
Calling Plan		FALSE
Device Pool	The UCM device pool to which the device belongs.	AshwiniOPUS-UP
Errors	The errors in exporting the CSV file	Username not found in UCM data

Here are the list of errors:

Eligibility check timeout
Device isn't eligible.
Username not found in CUCM data
The user doesn’t have a Webex Calling Professional License.
User isn’t present in CI.

CallQueueBulk.csv

To view the list of features shared with CSV fields, see Prepare your CSV.

Before uploading the csv file, the Administrator has to see the error count and additional information to resolve all the errors mentioned in the CSV. It’s mentioned for reference only.

Remove the Errors and Notes columns before you upload to the Control Hub.

Here are the lists of errors:

The call Queue number from UCM is assigned to another user in Webex Calling. Update the available number, Location, Language, and Timezone columns manually.
A derived extension from the Call Queue number from UCM is assigned to another User in Webex Calling. Update this column manually.
The call Queue number from UCM is assigned to another user in Webex Calling. Update the Phone number, Extension, Location, Language, and Timezone columns manually.
Location can’t be derived based on the Call Queue number from UCM, update it manually.
Language can’t be derived based on the Call Queue number from UCM, update it manually.
Timezone can’t be derived based on the Call Queue number from UCM, update it manually.

HuntGroupBulk.csv

To view the list of features shared with CSV fields, see Prepare your CSV.

Before uploading the csv file, the Administrator has to see the error count and additional information to resolve all the errors mentioned in the CSV. It’s mentioned for reference only.

Remove the Errors and Notes columns before you upload to the Control Hub

Here are the list of errors:

Hunt Pilot number from UCM is assigned to another user in Webex Calling. Update the available number, Location, Language, and Timezone columns manually.
A derived extension from Hunt pilot number from UCM is assigned to another User in Webex Calling. Update this column manually.
Hunt Pilot number from UCM is assigned to another user in Webex Calling. Update the Phone number, Extension, Location, Language, and Timezone columns manually.
Location can’t be derived based on Hunt Pilot number from UCM, update it manually.
Language can’t be derived based on the Hunt Pilot number from UCM, update it manually.
Timezone can’t be derived based on the Hunt Pilot number from UCM, update it manually.

ImportedDataBulk.csv

Column	Description	Example
User ID	The unique identifier of the UCM user.	user@example.com
Email	The email address of the UCM user.	user@example.com
User Name	The full name of the UCM user.	user@example.com
Primary Extension	You must have either a phone number or an extension.	3409
Device Pool	The UCM device pool to which the device belongs.	AshwiniOPUS-UP
Device ID	The unique identifier of the UCM device.	The UCM device ID

DeviceLineKeyConfigurationBulk.csv

Column	Description	Example
Device MAC	The MAC Address of the device	AABBCCDDEEFF
Device Model	The model of the device	Cisco 8865
KEM Type	The Configuration of the KEM Module keys	KEM_14_KEYS\|KEM_18_KEYS
KEM Module	Number of key extension module being configured	1\|2\|3.
Apply config	To update the configuration on phone	TRUE\|FALSE
Line Key Assignment Line SpeedDial Label Line SpeedDial Destination	Line 1 Key acts as a primary key Configure other keys as required.	Assignment -> SPEED_DIAL Label -> Reception Destination -> +12225554444

AutoAttendantBulk.csv

Column	Description	Example
Name	Name of the Auto-Attendant	Auto Attendant-1
Phone Number	The UCM phone number of the device.	+12225553409
Extension	You must have either a phone number or an extension.	3409
Location	Enter the location to assign the device.	New York
Time Zone	Enter the time zone key. This time zone applies to the schedules applied to Auto-Attendant.	Americas/Chicago
Language Code	Language code for audio announcements	en-us
Caller ID First Name	Enter the first name to display for the line ID (CLID).	Auto
Caller ID Last Name	Enter the last name to display the calling line ID (CLID).	Attendant 1
Business Schedule	Hours during which your Business Hours Auto Attendant operates	All Hours
Holiday Schedule	Blank	-
Dialing Type	Always Set to ENTERPRISE	-
BusinessHoursMenu Extension Enabled	Always Set to FALSE	-
AfterHoursMenu Extension Enabled	Always Set to FALSE	-
AutoAttendant Enabled	Always Set to ENABLED	-
Alternate Numbers Action	Blank	-
Business Hours Greeting Type	This is the message that your customers hear when they call the Business Hours Auto Attendant.	Set to DEFAULT or CUSTOM
Business Hours Announcement Name	Name of the CUSTOM greeting announcement set for Business Hours Greeting	"autoattendantgreeting.wav"
Business Hours Announcement Media Type	Media type of the CUSTOM greeting announcement set for Business Hours Greeting.	wav
After Hours Greeting Type	Always set to DEFAULT	-
After Hours Announcement Name	Blank	-
After Hours Announcement Media type	Blank	-
After Hours Announcement Level	Blank	-
Business Hours Press [0-9,*,#] Description	Blank	-
Business Hours Press [0-9,*,#] Action	Assign different functions to each keypad number. These settings direct your customers where they need to go when they enter a specific number on their phone.	TRANSFER_WITH_PROMT
Business Hours Press [0-9,*,#] Value	A phone number or extension to transfer the call to when action is set to TRANSFER_WITH_PROMPT Business hours key value needed if action is "TRANSFER_WITH_PROMPT" else will be blank	+12225554444
After Hours Press 0 Description	Blank	-
After Hours Press 0 Action	Its a mandatory field and Set always to EXIT.	Exit
After Hours Press 0 Value	Blank	-
After Hours Press [0-9,*,#] Description	Blank	-
After Hours Press [1-9,*,#] Action	Blank	-
After Hours Press [0-9,*,#] Value	Blank	-
Alternate Number[1-10]	Blank	-
Alternate Number[1-10] Ring Pattern	Blank	-

Here are the list of errors for Auto-Attendant:

Auto Attendant number from UNITY cannot be determined in Webex Calling. Update Phone number, Extension, Location, Language and Timezone columns manually.
Auto Attendant number from UNITY is assigned to another user in Webex Calling. Update available number, Location, Language and Timezone columns manually.
Location cannot be derived based on Auto Attendant number from UNITY, you have to update it manually.
Extension column empty from source data.
The business schedule does not exist in the location/org.
Name cannot be null.
The greetings file cannot be found in WxC.
Cannot be migrated as there is no equivalent feature in WxC.