Migration of Devices and Features from Unified CM to Webex Calling

Overview

This gives the information about the migration and mapping of Auto-Attendant, Devices, Configured Lines or Device Layout (Speed Dial, Shared Line, Virtual Line ), Call Queue, Hunt Group, Call Park and User Calling data (Call forwarding and Call Monitoring) Migration from UCM to 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.

Migration of Data

Migration for Auto-Attendant, Devices, Configured Lines or Device Layout (Speed Dial, Shared Line, Virtual Line), Call Queue, Hunt Group, Call Park and User Calling data (Call forwarding and call monitoring) feature leverages pre-existing device migration processes, but adds significant usability improvements to reduce migration times and reduce human error. Use the export data and import Data option to revtrieve and provision the fields for migration.

Export Data - You can use Import data from UCM to get the data for all the mentioned features.

Import Data - You can use Import option to provision the updated CSV fields for the migration features.

Export Data
Import Data

You can use Import data from UCM to get the data for all the mentioned features

1	If you want to migrate Auto-Attendant, Devices, User Calling data (Call forwarding and Call Monitoring), Virtual Lines, Configured Lines, and Device Layout (Speed Dial, Shared Line). 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.
2	If you want to migrate Call Queue, From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the 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.
3	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 Export UCM data using the Bulk Administration Tool for detailed information and then import the files.
4	If you want to migrate Call Park, From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the window, Select Features and select the Call Park Extension tab. Then click the Manage drop-down and select Bulk Manage. In the Manage Call Park Extension pop-up window, click Import data from UCM.
5	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.
6	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.
7	To delete the uploaded .tar file, click three dots on the top right and select Delete.
8	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 have 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 require an Administrator to make corrections before it’s ready to upload in the Control Hub.
CallQueueBulkCsvFromUCMHuntGroup.csv - This is an optional file to help transform UCM hunt groups to be provisioned as call queues in bulk. It includes errors that require an admin to make corrections before it’s ready to be uploaded to 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.
CallParkExtensionBulk.csv - Contains provisioning data to configure the call park extensions.
HuntGroupBulk.csv - Contains provisioning data which includes errors and notes that require Administrator to make corrections before it’s ready to upload in the 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 require an Administrator to make corrections before it’s ready to upload in the Control Hub.
ConfiguredLineBulk.csv - Contains provisioning data to configure the configured lines.
VirtualLineBulk.csv - Contains provisioning data to configure the virtual lines.
VirtualLineBulkFromUCMHuntPilot.csv - This is an optional file to help transform UCM hunt Pilots to be provisioned as VirtualLines in bulk. It includes errors that require an admin to make corrections before it’s ready to be uploaded to Control Hub.
UserFeatures_Internal.csv/UserFeatures_External.csv - Contains the provisioning data for corresponding Internal/External call forward i.e. transfer or forwarding of calls to another phone number or directly to voicemail for the user. They also contain monitored lines data.
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	The MAC Address of the device	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/CallQueueBulkCsvFromUCMHuntGroup.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 SHARED_LINE is not supported for 18 Keys KEM module configuration.
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, SHARED_LINE 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.

ConfiguredLineBulk.csv

Column	Description	Example
Device MAC	The MAC Address of the device	AABBCCDDEEFF
Device Model	The model of the device Note: It is an optional field	Cisco 8865
ACTION	Set ACTION = ADD, To add the secondary lines to a device, ACTION = MODIFY, To edit the primary or secondary line's attributes ACTION=REMOVE, To try to remove a secondary line.	ADD MODIFY REMOVE
Username 1	User - The e-mail id of the UCM user. Workspace or Virtual Line – The name of the UCM user.	user@example.com 87807bdd-e1f8-4dca-9908-26e6730f72d8
Type 1	User type whose Id was populated in the previous cell.	USER \| PLACE \| VIRTUAL_PROFILE
Location 1	To update the extension with the location. You can set location and extension across user types	Richardson
Extension 1	You must have an extension and it can be repeated across locations.	0007
Phone Number 1	The UCM phone number of the device.	+12225553409
Line Label 1	Shared line description To clear a line's attribute, set ACTION = MODIFY and attribute cell value as REMOVE Note: It is an optional field	Default
Line Weight 1	Can only be set >1 for the device owner (line 1) During ADD operation, if line weight is not populated, it will be set to default value of 1 Note: It is an optional field	1
Hotline Enabled 1	Set to TRUE when Hotline is required	TRUE\|FALSE
Hotline Destination 1	Destination for Hotline	4444
T38 Fax Compression Enabled 1	To Enable T38 Fax Compression on ATA devices	TRUE\|FALSE
Allow Call Decline 1	When set to TRUE, it will allow to decline an incoming call.	TRUE\|FALSE

CallParkExtensionBulk.csv

Column	Description	Example
Location	Enter the location to assign the device.	New York
Call Park Extension Name	Enter the monitoring line or call park extension option.	Call Park 3
Extension	You must have either a phone number or an extension.	10006

VirtualLineBulk.csv

Column	Description	Example
First Name	End user First Name	Timothy
Last Name	End user Last Name	Robinson
Display Name	End user Display Name	Robinson, Timothy
Location	Enter the location of assigned device.	New York
Phone Number	The UCM phone number of the device.	+12225553409
Extension	The UCM Huntpilot extension of the device.	3409

VirtualLineBulkFromUCMHuntPilot.csv

Column	Description	Example
First Name	It is the Ascii Alerting Name given to huntpilot in UCM. If there is space in name then first name is first part else if no space then full value is first name.	Ascii Alerting Name : firstName lastName, firstName : firstName
Last Name	If Ascii Alerting Name given to huntpilot in UCM has space then it is second part , if no space then it is '.' Dot	Ascii Alerting Name : firstName lastName, lastName : lastName
Display Name	It is full ascii alerting name given to huntpilot in UCM.	Ascii Alerting Name : firstName lastName, DisplayName : firstName lastName
Location	Enter the location of the assigned device.	New York
Phone Number	The UCM Huntpilot phone number of the device.	+12225553409
Extension	The UCM Huntpilot extension of the device.	3409

UserFeatures_Internal.csv/UserFeatures_External.csv

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

You can use Import option to provision the updated CSV fields for the below features.

1	To import all the mentioned features like Auto-Attendant, Devices, Configured Lines or Device Layout (Speed Dial, Shared Line, Virtual Line ), Call Queue, Hunt Group, Call Park and User Calling data (Call forwarding and Call Monitoring). From the customer view in Control Hub, navigate to Services > Updates & Migrations. In the Updates & Migrations window select the Import into Webex Calling card or click on the Get Start in Import into Webex Callingcard. In PBX type, choose UCM and upload the tar file for provisioning under Import data to provision into Webex Calling. (OR)
2	To Import Devices, From the customer view in Control Hub, navigate to Services > Updates & Migrations. In the Updates & Migrations window, select the Import into Webex Calling card or click on the Get Start in Import into Webex Callingcard. In PBX type, choose UCM and upload the .tar file for provisioning under Import data to provision into Webex Calling. 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, Drag and drop a updated file in the Upload CSV data pane and then click Submit.
3	To import Configured Lines, Virtual Line, and Device Layout (Speed Dial, Shared Line), 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 the uploaded .tar file. For Speed Dial, use Import Config to upload the updated file and click Done.
4	To import Auto-Attendant, From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the window, Select Features and select the Auto-Attendant tab. Then click the Manage drop-down and select Bulk manage. In the Manage Auto Attendant window, Drag and drop a updated file in the Upload CSV data pane and then click Submit.
5	To import Call Queue, From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the window, Select Features and select the Call Queue tab. Then click the Manage drop-down and select Bulk Manage. In the Manage Call Queue window, Drag and drop a updated file in the Upload CSV data pane and then click Submit.
6	To import 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 Call Queue window, Drag and drop a updated file in the Upload CSV data pane and then click Submit.
7	To import Call Park, From the customer view in https://admin.webex.com, go to SERVICES > Calling. In the window, Select Features and select the Call Park Extension tab. Then click the Manage drop-down and select Bulk Manage. In the Manage Call Park window, Drag and drop a updated file in the Upload CSV data pane and then click Submit.
8	To import User Calling data (Call forwarding and Call Monitoring), From the customer view in https://admin.webex.com, go to Services > Calling. In the Calling Window, go to Service Settings > Manage User Calling Data In the Manage User Calling Data, Drag and drop a updated file in the Upload CSV data pane and then click Submit.