Overview

This gives the information about the migration and mapping of Auto-Attendant, Devices, Configured Lines or Device Layout (Speed Dial, Shared Line), Call Queue, Hunt Group and Call forwarding 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), Call Queue, Hunt Group, and Call forwarding 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.

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, Call Forwarding, 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

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.

5

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.
6

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

7

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.

  • 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 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.

  • CallForward_Internal.csv/ CallForward_External.csv - Contains the provisioning data for transfer or forwarding of calls to another phone number or directly to voicemail for the user.

  • 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

ColumnDescriptionExample
UsernameThe full name of the UCM user.user@example.com
TypeThe workspace/USERUSER
ExtensionYou must have either a phone number or an extension.3409
Phone NumberThe UCM phone number of the device.+12225553409
Device TypeIP PhonesIP Phone
ModelThe model of the deviceCisco 8865
MAC AddressThe MAC Address of the deviceAABBCCDDEEFF
LocationEnter the location to assign the device.New York
Device PoolThe UCM device pool to which the device belongs. AshwiniOPUS-UP

DeviceBulkError.csv

Column Description Example
UsernameThe full name of the UCM user.user@example.com
TypeThe workspace/USERUSER
ExtensionYou must have either a phone number or an extension.3409
Phone NumberThe UCM phone number of the device.+12225553409
Device TypeIP PhonesIP Phone
ModelThe model of the deviceCisco 8865
MAC AddressAABBCCDDEEFF
LocationEnter the location to assign the device.New York
Calling Plan

FALSE

Device PoolThe UCM device pool to which the device belongs.AshwiniOPUS-UP
ErrorsThe 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 DescriptionExample
User IDThe unique identifier of the UCM user.user@example.com
EmailThe email address of the UCM user.user@example.com
User NameThe full name of the UCM user.user@example.com
Primary ExtensionYou must have either a phone number or an extension.3409
Device PoolThe UCM device pool to which the device belongs.AshwiniOPUS-UP
Device IDThe unique identifier of the UCM device.The UCM device ID

DeviceLineKeyConfigurationBulk.csv

Column DescriptionExample
Device MACThe MAC Address of the deviceAABBCCDDEEFF
Device ModelThe model of the deviceCisco 8865
KEM TypeThe Configuration of the KEM Module keysKEM_14_KEYS|KEM_18_KEYS

 
SHARED_LINE is not supported for 18 Keys KEM module configuration.
KEM ModuleNumber of key extension module being configured1|2|3.
Apply configTo update the configuration on phoneTRUE|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 DescriptionExample
NameName of the Auto-AttendantAuto Attendant-1
Phone NumberThe UCM phone number of the device.+12225553409
ExtensionYou must have either a phone number or an extension.3409
LocationEnter 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 CodeLanguage code for audio announcementsen-us
Caller ID First NameEnter the first name to display for the line ID (CLID). Auto
Caller ID Last NameEnter 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 ScheduleBlank-
Dialing TypeAlways Set to ENTERPRISE-
BusinessHoursMenu Extension EnabledAlways Set to FALSE-
AfterHoursMenu Extension EnabledAlways Set to FALSE-
AutoAttendant EnabledAlways Set to ENABLED-
Alternate Numbers ActionBlank-
Business Hours Greeting TypeThis is the message that your customers hear when they call the Business Hours Auto Attendant. Set to DEFAULT or CUSTOM
Business Hours Announcement NameName of the CUSTOM greeting announcement set for Business Hours Greeting"autoattendantgreeting.wav"
Business Hours Announcement Media TypeMedia type of the CUSTOM greeting announcement set for Business Hours Greeting.wav
After Hours Greeting TypeAlways set to DEFAULT-
After Hours Announcement NameBlank-
After Hours Announcement Media typeBlank-
After Hours Announcement LevelBlank-
Business Hours Press [0-9,*,#] DescriptionBlank-
Business Hours Press [0-9,*,#] ActionAssign 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 DescriptionBlank-
After Hours Press 0 ActionIts a mandatory field and Set always to EXIT. Exit
After Hours Press 0 ValueBlank-
After Hours Press [0-9,*,#] DescriptionBlank-
After Hours Press [1-9,*,#] ActionBlank-
After Hours Press [0-9,*,#] ValueBlank-

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 MACThe MAC Address of the deviceAABBCCDDEEFF
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 1User type whose Id was populated in the previous cell.USER | PLACE | VIRTUAL_PROFILE
Location 1To update the extension with the location. You can set location and extension across user typesRichardson
Extension 1You must have an extension and it can be repeated across locations.0007
Phone Number 1The 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 1Set to TRUE when Hotline is requiredTRUE|FALSE
Hotline Destination 1Destination for Hotline4444
T38 Fax Compression Enabled 1To Enable T38 Fax Compression on ATA devicesTRUE|FALSE
Allow Call Decline 1When set to TRUE, it will allow to decline an incoming call.TRUE|FALSE

CallForward_Internal.csv/CallForward_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 Devices,

  • 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.

2

To import 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 the uploaded .tar file.
  • For Speed Dial, use Import Config to upload the updated file and click Done.
3

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.
4

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.
5

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.
6

To import Call Forwarding,

  • 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.