00 · Header
T6 · Migrations
Migration Tools
Cisco documents three ways onto multi-tenant Webex Calling: Control Hub tools, certified migration providers, and Webex Setup Assist. The Control Hub user tool moves at most 1,000 users and 1,000 devices in one task. The feature tool does not currently build call park or call pickup. A Python script does.
01 · Executive summary
Five lines, then why it matters
- Migration Insights can run from any organization. You do not need the destination customer org to upload a Unified CM tar. [cite:2]
- Use SharedlineGroupMigrationReport.csv and HuntGroup_CallQueue_CallPark_CallPickUpGroups.csv to see who must move together. [cite:2]
- A-FLEX-P-CALL is the entitlement the user-migration article names for temporary licensing from GLO, up to 18 months. [cite:2]
- Feature-tool upload limits: Unified CM tar 350 MB, Unity call-handler zip 2 GB. [cite:3]
- The Dedicated Instance pre-migration assistant is a different tile. It does not perform that migration. T5-R06. [cite:5]
02 · Architecture map
Three tool families
Mermaid source (not rendered)
flowchart LR TAR[UCM tar] --> INS[Insights] TAR --> USR[User task] TAR --> FEAT[Feature task] USR --> BAT[CUCM BAT]
03 · Core concepts
Which tile does which job
The December 2025 deployment guide names Webex Migration Tools as self-service tools in Control Hub, Certified Migration Providers as validated software for complex and large migrations, and Webex Setup Assist as a Cisco-led service. [cite:1]
Users migrated with the Unified CM user tool can only be assigned Calling professional or CX Essentials. To assign a Webex Standard license, do not use this tool. Use a user CSV, then the feature tool for the rest. Workspaces can be Workspace or Professional Workspace. [cite:2]
The feature article lists Call Park among mapped data, and the script section says the feature tool does not currently support CallPark.csv and CallPickupgroup.csv. The script UserBasedUCMFeatureMigration creates those files from CDR. Keep both sentences. [cite:3]
The user-migration article and the firmware article each say the steps apply to Dedicated Instance. The pre-migration assistant is still a different tile and does not perform the Dedicated Instance migration. [cite:2] [cite:4] [cite:5]
Control Hub tools
| Tool | Path the article prints | What you bring | Cite |
|---|---|---|---|
| Migration Insights | Services → Upgrades and Migrations → Migration Insights | Unified CM tar. CDR if you want feature-usage reports. Any org can host the assessment. | [cite:2] |
| Migrate Unified CM to Webex Calling | Services → Upgrades and Migrations → that tile | Tar from BAT, or a user CSV. Phones on load 14.1 or later. Users already in Webex. | [cite:2] |
| Migrate features from UCM | Services → Updates and Migrations → Migrate features from UCM. A later step in the same article says Migrate features from Unified CM. | Tar, optional Unity call-handler zip. | [cite:3] |
| Phone firmware | The firmware article. The implement article also names “Migrate your phone to Webex Calling” for 7800 and 8800 Enterprise to MPP. | Webex Calling. Steps apply to Dedicated Instance. | [cite:4] [cite:6] |
What the feature article says it maps
| Mapped in the overview | Separate script note | Cite |
|---|---|---|
| Auto attendant, devices, configured lines, device layout (speed dial and shared line), virtual line, call queue, hunt group, call park, user calling data (call forwarding and call monitoring) | UserBasedUCMFeatureMigration filters output by a user list, can override location, and creates CallPark.csv and CallPickupgroup.csv because the feature tool does not currently support them. | [cite:3] |
Task rules on the user tool
| Rule | Value | Cite |
|---|---|---|
| Users and devices per task | Maximum 1,000 of each. More than that means another task. | [cite:2] |
| Task name | At least 8 characters | [cite:2] |
| Temporary licensing PID | A-FLEX-P-CALL, up to 18 months, opened with GLO | [cite:2] |
| Phone load before migration | 14.1 or later | [cite:2] |
| Feature tar / Unity zip | 350 MB and 2 GB | [cite:3] |
| Import identity order | If user id, email, and MAC are all filled, the article says it uses UCM email, then user id, then device MAC. | [cite:2] |
| Cloud-Connected UC | If it is enabled, it takes up the device migration after you complete the task. | [cite:2] |
04 · Ecosystem & sister technologies
Glossary, map, sisters, edges
Glossary
- Migration Insights
- The Control Hub assessment that reads a Unified CM tar. Group CSVs show who should migrate together. [cite:2]
- A-FLEX-P-CALL
- The entitlement PID the user-migration article says you receive when Webex Calling is the cloud deployment option, used for temporary licensing up to 18 months. [cite:2]
- Manifest zip
- What Complete migration downloads. It contains a CSV of phone MAC addresses to upload on Unified CM. [cite:2]
- UserBasedUCMFeatureMigration
- The Python script that processes CDR and writes park and pickup files the feature tool does not currently support. [cite:3]
- MPP migration
- Enterprise firmware to MPP. 8821 and 8831 are not eligible. 8832NR can migrate with limitations. V15 and later hardware needs at least 11.3.3 MPP and cannot downgrade. [cite:4]
Mind map
Mermaid source (not rendered)
mindmap
root((Migration tools))
Insights
User task
Feature task
Firmware
Setup Assist
Sister-technology matrix
| Sister | What it is | Why it matters here | Config touchpoint | Typical failure | Cite |
|---|---|---|---|---|---|
| Directory / identity | Webex users must exist before the user tool runs. | The article names Directory Connector or other means. | Provision users first. | A tar of people Control Hub does not know. | [cite:2] |
| Licensing | A-FLEX-P-CALL and the professional or CX Essentials choice. | Standard is a different path. | GLO for the temporary entitlement. CSV for Standard. | Expecting the task to emit Standard. | [cite:2] |
| Cloud-Connected UC | Optional device-migration taker. | If enabled, it takes the device migration after the task completes. | Do not also hand-run a conflicting phone load. | Two actors updating the same phone. | [cite:2] |
| Unity Connection | Optional zip for auto attendant. | 2 GB cap. CallHandlerDataDump is the article’s pointer for building the zip. | Feature tool, not the user task. | A zip larger than 2 GB. | [cite:3] |
| Hunt, queue, park, pickup | Group features the insights CSVs flag. | The implement article says you cannot split them across the local gateway. T6-R07. | Migrate the set together. Park and pickup files may need the script. | A pickup group half-migrated because the feature tool skipped the CSV. | [cite:2] [cite:3] |
| Firmware | Enterprise to MPP. | 8821 and 8831 are ineligible. V15 hardware has a floor of 11.3.3 and no downgrade. | Firmware article. Applies to Dedicated Instance. | Scheduling an 8821 conversion. | [cite:4] |
| Setup Assist / DI assistant | Cisco-led, and a Dedicated Instance readiness tile. | The DI assistant does not perform the migration. | T5-R06. Do not paste this user-task limit onto that scheduler. | A 1,000-user cap invented for the DI assistant. That cap is the user-task article. | [cite:5] [cite:1] |
| FedRAMP device check | Optional commercial license check. | The MAC address is sent to the Cisco corporate network if you select it. | The article offers another FedRAMP device process if you do not want that send. | Assuming the MAC stays inside the customer org. | [cite:2] |
Integration map
| From | To | Mechanism | What moves | Cite |
|---|---|---|---|---|
| Unified CM BAT | Insights or a task | Tar upload | Users, devices, numbers, locations. | [cite:2] |
| Insights | Migration plan | CSV reports | Shared line and hunt, queue, park, pickup relationships. | [cite:2] |
| User task | Unified CM | Manifest CSV | Phone update. Target Phone. Transaction Update Phone - Custom File. | [cite:2] |
| CDR | Feature CSVs | UserBasedUCMFeatureMigration | Park and pickup files, plus a filtered user list. | [cite:3] |
| Feature tool | Webex Calling | Tar and optional Unity zip | The mapped feature list, within 350 MB and 2 GB. | [cite:3] |
| GLO | Subscription | A-FLEX-P-CALL | Temporary licensing up to 18 months. | [cite:2] |
| Firmware tool | Phone | Enterprise to MPP | Eligible 7800 and 8800 models. Not 8821 or 8831. | [cite:4] |
| Certified provider | Customer | Partner tool | The guide’s path for complex and large migrations. The DI assistant names the same class of tool. | [cite:1] [cite:5] |
Cross-platform bridges
| This room | Legacy | Peer orientation | Cite |
|---|---|---|---|
| Unified CM tar | BAT export is the input these tools document. | A third-party PBX export is not this tar. T6-R05. TODO-verify a Control Hub tile that ingests Avaya or Genesys. | [cite:2] |
| Dedicated Instance assistant | Assesses Unified CM for Dedicated Instance. It is not the 1,000-user task. | Do not equate Setup Assist with the self-service user tool. The guide lists them separately. | [cite:1] [cite:5] |
| BroadWorks migration | T6-R02 cites a separate Control Hub migration. This room does not reuse Unified CM task fields for it. | Read that article before you copy a column name. TODO-verify any field this pass did not re-read there. | [cite:1] |
Future-integration hooks
- Canon plan: T6-R02 remains the PPDIO narrative. This room is only the tools that article points at.
- Canon plan: when the feature tool starts accepting CallPark.csv itself, delete the “does not currently support” sentence only after d2lemv says so. [cite:3]
- Phone-load 14.1 and MPP 11.3.3 were retrieved 2026-10-14. Firmware header is May 06, 2026. re-check the user-tool phone-load sentence if that article’s header is older. The retrieved user-tool markdown did not print a header date. [cite:2] [cite:4]
Ecosystem troubleshooting
| Symptom | Likely sister-system cause | Check | Fix | Cite |
|---|---|---|---|---|
| Standard licenses never appear on the task | The user tool cannot assign them. | Call settings radio buttons. | CSV the users, then the feature tool. | [cite:2] |
| Pickup group is empty after feature migration | The feature tool does not currently support that CSV. | Whether UserBasedUCMFeatureMigration was run on CDR. | Generate CallPickupgroup.csv from the script. | [cite:3] |
| FedRAMP eligibility sent MACs unexpectedly | The commercial check option sends the MAC to the Cisco corporate network. | Which option was selected. | Use the FedRAMP device process the article names if that send is not wanted. | [cite:2] |
| An 8832NR lost a feature after MPP | The firmware article says some features may not be supported on 8832NR. | The eligibility table. | Do not treat 8832NR as a full 8832 conversion. 8821 and 8831 do not convert. | [cite:4] |
05 · Flow
From a tar to a phone job
| Step | From | To | Mechanism | Notes | Cite |
|---|---|---|---|---|---|
| 1 | Unified CM | Tar | BAT | Users and devices. Phone load 14.1 or later. | [cite:2] |
| 2 | Tar | Insights | Upload | Any org. Read the shared-line and group CSVs. | [cite:2] |
| 3 | Admin | New task | Start New Task | Name of at least 8 characters. At most 1,000 users and 1,000 devices. | [cite:2] |
| 4 | Device pool | Location | Map | Leave a pool undefined to skip it in this task. | [cite:2] |
| 5 | Numbers | Users or workspaces | Assign | Auto-assign is for cloud PSTN locations. Add numbers to location is for premises PSTN. A mix greys both out. | [cite:2] |
| 6 | Task | License | Call settings | Professional or CX Essentials for users. Not Standard. | [cite:2] |
| 7 | Complete migration | Unified CM | Manifest CSV | Bulk Administration → Upload/Download Files. Phone. Update Phone - Custom File. | [cite:2] |
| 8 | CDR | Feature tool | Python script | Park and pickup files, then the feature migration tile. | [cite:3] |
06 · Config
Clicks the articles name
- Open Services → Upgrades and Migrations. Run Migration Insights on the tar before you build batches. [cite:2]
- On Migrate Unified CM to Webex Calling, finish prerequisites, import the tar, and start a task only after the tar upload enables the button. [cite:2]
- Map each device pool to a location or leave it undefined. Resolve a device that is tied to more than one location. Other warnings, including extension length, are informational. [cite:2]
- Choose numbers by PSTN type. Do not expect Auto assign on an all-local-gateway task, or Add numbers on an all-cloud-PSTN task. [cite:2]
- Set professional or CX Essentials. Stop if the requirement is Standard. [cite:2]
- Prepare to migrate, then Complete migration. On Unified CM, upload the CSV as Phone / Update Phone - Custom File, and run or schedule the job. [cite:2]
- For features, open Services → Updates and Migrations → Migrate features from UCM. Stay under 350 MB for the tar and 2 GB for the Unity zip. [cite:3]
- Run UserBasedUCMFeatureMigration when you need park or pickup files. Keep 8821 and 8831 out of the firmware tool. [cite:3] [cite:4]
Tool card (deployment guide Dec 2025 / x974bd / d2lemv / n19c71). No customer secrets. families: Control Hub tools | certified providers | Setup Assist per task: 1000 users and 1000 devices task name: at least 8 characters user license: professional or CX Essentials not this tool: Webex Standard temp PID: A-FLEX-P-CALL, up to 18 months feature tar: 350 MB unity zip: 2 GB script: UserBasedUCMFeatureMigration ineligible MPP: 8821, 8831 V15 MPP floor: 11.3.3, no downgrade
07 · Limits
What is quantified
| Item | Value | Source | Verified? |
|---|---|---|---|
| Users per user-migration task | 1,000 | [cite:2] | Quoted. Header date not in the retrieved markdown. re-check |
| Devices per user-migration task | 1,000 | [cite:2] | Quoted. re-check |
| Task name | Minimum 8 characters | [cite:2] | Quoted. re-check |
| A-FLEX-P-CALL window | Up to 18 months | [cite:2] | Quoted. re-check |
| Phone load | 14.1 or later | [cite:2] | Quoted. re-check |
| Feature tar | 350 MB | [cite:3] | Quoted. Header date not in the retrieved markdown. re-check |
| Unity zip | 2 GB | [cite:3] | Quoted. re-check |
| MPP floor on V15 and later | 11.3.3, and no downgrade | [cite:4] | Quoted. Header May 06, 2026. |
| Ineligible 8800 models | 8821 and 8831 | [cite:4] | Quoted |
| Deployment guide date | December 2025 | [cite:1] | Printed on the guide |
08 · Troubleshooting
Ten tool failures
| Symptom | Likely cause | Evidence | Fix | Cite |
|---|---|---|---|---|
| Start New Task stays disabled | The tar upload has not completed. | Step 2 of the user tool. | Wait until the upload enables the button. | [cite:2] |
| The task rejects user 1001 | The cap is 1,000 users and 1,000 devices. | Create-task text. | Open another task. | [cite:2] |
| A 7-character task name fails | Minimum 8 characters. | New Migration Task window. | Lengthen the name. | [cite:2] |
| Standard is required and the tool is already open | This tool will not assign Standard. | Call settings. | Leave the tool. Use a user CSV, then features. | [cite:2] |
| Auto assign is grey and every location is a local gateway | That is scenario 1. Add numbers to location is the enabled action. | Manage numbers. | Add numbers. Do not wait for auto assign. | [cite:2] |
| Both number actions are grey | The locations mix premises PSTN and cloud PSTN. | Scenario 3. | Do not expect either button. Split the task by PSTN type. | [cite:2] |
| Complete migration is disabled | Status is in progress, draft, or review errors. Ready with errors still allows it. Ready for migration allows it. | Task status table. | Clear review errors, or proceed only from a status the table enables. | [cite:2] |
| BAT job updates nothing | Target or transaction type is wrong. | Upload page. | Phone, and Update Phone - Custom File. | [cite:2] |
| Feature migration has no pickup | The tool does not currently support that file. | Script section. | Run the Python script on CDR. | [cite:3] |
| 8821 is in the firmware batch | 8821 and 8831 are not eligible. | Firmware article list. | Remove them. Treat 8832NR as limited. | [cite:4] |
09 · Self-question ladder
Twelve rungs
L0What are the three migration families in the December 2025 guide?
Control Hub tools, certified migration providers, and Webex Setup Assist. [cite:1]
L1Why run Insights before a task?
The group CSVs show shared lines and hunt, queue, park, and pickup relationships that should move together. [cite:2]
L2What is the user-task cap?
1,000 users and 1,000 devices, and a task name of at least 8 characters. [cite:2]
L2Which licenses can that task assign to a user?
Calling professional or CX Essentials. Not Standard. [cite:2]
L3How do you prove the phone job was aimed correctly?
Unified CM target is Phone and the transaction is Update Phone - Custom File. [cite:2]
L3Why would pickup be missing after a successful feature import?
The feature tool does not currently support CallPickupgroup.csv. The Python script creates it. [cite:3]
L4How is this different from the Dedicated Instance assistant?
That assistant assesses and schedules. It does not migrate. These tiles import a tar into multi-tenant Webex Calling, and two of the articles also say their steps apply to Dedicated Instance. [cite:5] [cite:2]
L4Which phones never become MPP in the firmware article?
8821 and 8831. 8832NR can, with limitations. V15 and later need 11.3.3 and cannot downgrade. [cite:4]
L5Why keep the call-park sentences from contradicting each other?
The overview lists call park as mapped. The script section says the tool does not currently support the park and pickup CSVs and that the script creates them. Quote both. [cite:3]
L5What will you not claim about a third-party PBX?
That these tar tools ingest it. That crosswalk is TODO-verify and lives in T6-R05. [cite:2]
L1What does A-FLEX-P-CALL buy you, in that article?
Temporary licensing for up to 18 months while both calling environments are in use. [cite:2]
L2When are both number buttons grey?
When the task mixes premises PSTN locations with cloud or Cisco PSTN locations. [cite:2]
10 · Lab
A paper lab. Do not upload a customer tar to an org you do not administer.
11 · Quiz
Twelve questions
Which three families does the December 2025 guide name?
Answer
Control Hub migration tools, certified migration providers, and Webex Setup Assist. [cite:1]
What is the user-task maximum?
Answer
1,000 users and 1,000 devices. [cite:2]
Shortest task name?
Answer
8 characters. [cite:2]
Which user license does that tool refuse?
Answer
Webex Standard. It assigns professional or CX Essentials. [cite:2]
Do you need the destination org to run Insights?
Answer
No. Any organization can upload the tar. [cite:2]
What are the feature-tool upload caps?
Answer
350 MB for the Unified CM tar and 2 GB for the Unity zip. [cite:3]
Call pickup did not appear. Which file does the script create because the tool does not currently support it?
Answer
CallPickupgroup.csv, and CallPark.csv. [cite:3]
BAT transaction after Complete migration?
Answer
Update Phone - Custom File, target Phone. [cite:2]
Which 8800 models are not eligible for MPP?
Answer
8821 and 8831. [cite:4]
V15 and later hardware, after conversion?
Answer
Minimum 11.3.3 MPP, and it cannot downgrade. [cite:4]
All locations in the task are local-gateway PSTN. Which number action is enabled?
Answer
Add numbers to location. Auto assign is grey. [cite:2]
What does the Dedicated Instance pre-migration assistant not do?
Answer
It does not perform the migration. [cite:5]
12 · Audio
Slots for Studio
Transcript slot
Studio fills this. The prompt is the spoken outline, not a second article.
Transcript slot
Studio fills this. The prompt is the spoken outline, not a second article.
Transcript slot
Studio fills this. The prompt is the spoken outline, not a second article.
13 · Interview
Oral answers
30 seconds. The December 2025 guide gives you Control Hub tools, certified providers, and Setup Assist. The self-service user task takes a Unified CM tar, 1,000 users and 1,000 devices at a time, and it will not assign a Standard license.
2 minutes. Insights can run in any org and tells you who shares lines and group features. The user task maps device pools to locations, then returns a manifest you load with Update Phone - Custom File. If Cloud-Connected UC is on, it takes the device migration. The feature tool maps queues, hunts, auto attendants, and the rest of its list, with a 350 MB tar and a 2 GB Unity zip. It does not currently emit park and pickup CSVs. The Python script UserBasedUCMFeatureMigration does, from CDR. Quote the overview’s “call park” mapping and that script sentence together.
30 seconds, phones. 8821 and 8831 do not migrate to MPP. 8832NR can, with limitations. V15 and later hardware needs 11.3.3 MPP and cannot downgrade. Those firmware steps also apply to Dedicated Instance.
2 minutes, the other tile. Dedicated Instance has its own pre-migration assistant. It does not perform the migration. Do not paste the 1,000-user cap onto that scheduler. A-FLEX-P-CALL is the temporary entitlement the user-migration article names, for up to 18 months, through GLO. A third-party PBX is not this tar.
What you will not say. You will not say the feature tool builds pickup by itself. You will not put an 8821 on the MPP list. You will not invent an Avaya import button.
14 · Citations
- Calling: Transitioning from Unified CM to Webex Calling — Cisco deployment guide — December 2025 — cisco.com DEPLOYMENT_CALLING_Unified_CM_to_Webex_Calling.pdf — retrieved 2026-10-14. Three families: Webex Migration Tools, Certified Migration Providers, and Webex Setup Assist. PPDIO.
- Migrate Unified CM data to Webex Calling — help.webex — article x974bd — help.webex.com article x974bd — retrieved 2026-10-14. Header date not in the retrieved markdown. re-check 1,000 users and devices. Task name minimum 8 characters. A-FLEX-P-CALL up to 18 months. Phone load 14.1 or later. Professional or CX Essentials. Insights CSV names. BAT manifest. Steps apply to Dedicated Instance. FedRAMP MAC check.
- Migrate devices and features from Unified CM to Webex Calling — help.webex — article d2lemv — help.webex.com article d2lemv — retrieved 2026-10-14. Header date not in the retrieved markdown. re-check Mapped feature list. Tar 350 MB. Unity zip 2 GB. UserBasedUCMFeatureMigration. Call park and call pickup CSVs are not currently supported by the feature tool.
- Migrate enterprise phone to Webex Calling phone firmware — help.webex — article n19c71 — help.webex.com article n19c71 — header May 06, 2026, retrieved 2026-10-14. Steps apply to Dedicated Instance. 8821 and 8831 are not eligible. 8832NR limitations. V15 and later require 11.3.3 MPP and cannot downgrade.
- Pre-migration assistant for Dedicated Instance using Setup Assist — help.webex — article r1ueuw — help.webex.com article r1ueuw — header October 22, 2025, retrieved 2026-10-14. The assistant does not perform the migration.
- Implement the migration from Unified CM to Webex Calling — help.webex — article q0pgpb — help.webex.com article q0pgpb — retrieved 2026-10-14. Names “Migrate your phone to Webex Calling” for 7800 and 8800 Enterprise to MPP. Third-party phones: work with the vendor.
15 · Re-engineer later
- Open questions: x974bd and d2lemv header dates. Whether the feature tool has started accepting park and pickup CSVs since this retrieval.
- Facts still marked TODO-verify: a Control Hub ingest for Avaya or Genesys; BroadWorks column names this pass did not re-read.
- Facts still marked re-check: user-task and feature-tool numbers whose articles did not print a header date.
- Assets missing: task screenshot, tool-family SVG export, audio.
- Next review: re-check the 1,000 cap and the “does not currently support” pickup sentence together.
Sources and go deeper
Checked links were opened this month. A confirm row has no address because that page was not opened.
- Wikipedia Webex (Wikipedia) last checked 2026-10
- Vendor doc Webex Help Center last checked 2026-10
- DevDocs Webex developer documentation last checked 2026-10
- DevDocs Webex developer getting started last checked 2026-10
- Community Webex community last checked 2026-10
- SRND Cisco Collaboration design zone last checked 2026-10
- RFC RFC 3261 SIP: Session Initiation Protocol last checked 2026-10
- Port table IANA service name and port number registry last checked 2026-10
- Port table Port reference for Webex Calling last checked 2026-10
- RFC RFC 3263 Locating SIP Servers last checked 2026-10
- RFC RFC 3264 An Offer/Answer Model with SDP last checked 2026-10
- Wikipedia Session Initiation Protocol (Wikipedia) last checked 2026-10
- RFC RFC 3550 RTP last checked 2026-10
- RFC RFC 3711 SRTP last checked 2026-10
- RFC RFC 4566 SDP last checked 2026-10
- RFC RFC 4733 RTP payload for DTMF last checked 2026-10
- Wikipedia Real-time Transport Protocol (Wikipedia) last checked 2026-10
- Release notes What's new in Webex Calling last checked 2026-10
- Vendor doc cisco.com DEPLOYMENT_CALLING_Unified_CM_to_Webex_Calling.pdf last checked 2026-10
- Vendor doc help.webex.com article x974bd last checked 2026-10
- Vendor doc help.webex.com article d2lemv last checked 2026-10
- Vendor doc help.webex.com article n19c71 last checked 2026-10
- Vendor doc help.webex.com article r1ueuw last checked 2026-10
- Vendor doc help.webex.com article q0pgpb last checked 2026-10
sources.json for this page.