| Table of Contents | ||||
|---|---|---|---|---|
|
...
In a Map Dialplan migration, the Dialplan objects including Device Pools, CSS’s, Partitions* etc must be deployed to the UCMC manually prior to the migration. During the migration, the engineer performing the migration is then required to map the source Dialplan objects to the target Dialplan objects. The Wrangler UCMC tool will then transform device objects to use the target Dialplan objects and load the transformed objects into the target UCMC cloud.
...
In a Template Dialplan migration, Wrangler UCMC tool will deploy a standardised Domain Manager type or a Simplified Dialplan into the target UCMC cloud. Similarly to the Map Dialplan migration, the engineer performing is then required to map the source Dialplan objects to the target objects. The Wrangler UCMC tool will then transform device objects to use the target dialplan objects and load the transformed objects into the target UCMC cloud.
...
Before starting the migration, the source and target CUCM, and if required CUC, interfaces must be defined.
...
The rights required for these interfaces are defined here https://yarnlab.atlassian.net/wiki/spaces/YSP/pages/2918973483/Yarnman+YM-PH+Interfaces#The-following-CUCM-permissions-are-required-for-wrangler_-WxC-DI-migrations
| Info |
|---|
Important Note: For migration to WxC-DI, an account with User Rank 1 is required which will require a special request to Cisco as by default for DI migration an account with Rank 3 will be provided. |
The minimum Required access roles in the CUCM Application User for the AXL interface are
| Info |
|---|
|
The process to define the interfaces can be found in https://yarnlab.atlassian.net/wiki/spaces/YSP/pages/2730393636/Yarnman+Administration#Interfaces
...
Standard AXL Read Only API Access can be applied on the source cluster
...
Important:
Target CUCM Configuration Requirements Pre Migration
...
Call Manager Servers
These are created automatically with each CUCM node being installed
Call Manager Group (CMG)
The call manager groups need to be created to suit the target cluster layout, if the number of subscribers is changing between source and target clusters care must be taken to ensure each subscriber has the approriate number of registrations based on OVA size
Media Resource Group Lists (MRGL)
Media services, Media groups and Media Resource Group Lists need to be configured on the target cluster
Custom SIP Normalization Scripts
IP Phone Services
Such as Extension Mobility
UC Service Profiles
User Profiles
VPN Profiles and VPN Groups
CUCM Native Dialplans loaded other than NANP
Custom Dial Plan Tags
Any User and Network Locales other than default (ENG-US) loaded
Custom Roles and Access Control Groups Note required from v2.5.15
Mobile Smart Client Profiles
...
LDAP Directory configuration
CUCM Rank
Unity Connection target prerequirements
Unity Connection Voice Port Group
Unity Connection Call Handler Templates *
...
LDAP configuration in target cluster configured
LDAP Directory users to be synchronized prior to migration
| Info |
|---|
Wrangler UCMC will update LDAP synchronised user configuration in the UCMC target but cannot add them |
...
Connection Locations
Conversations
Fax Server
Mailbox Store
Phone System
Port Group Template
Port Group
Role
UCXN Server
SMPP Provider
Tenant
User Templates
The following objects are NOT migrated by Wrangler
...
CUCM all migration options
Annunciators
Application Servers
Application Users
Caller Filter Lists
Conference Bridges
Inter Cluster Service Profiles
IVR’s
Media Resorce Groups
MOH
MTP
Transcoders
Voice Mail Ports
Any None Default Network Locales
Any BAT Templates
Mapped and Template Dialplan migrations
...
During a migration, Wrangler UCMC goes through some high level steps that includes validation of the source data, during which issues may be encountered that needs resolving. These high level process steps are
...
| Info |
|---|
Important Considerations: ● Post Migration, Extension Mobility users are logged out from their end devices and must log in. ● Passwords (if not using LDAP) and PIN’s are not migrated by Wrangler UCMC. The recommendation is to use BAT or such to set password and PIN in target cluster post migration.
|
...
Initiate Migration
To initiate a migration, from the Wrangler UCMC main menu, select Migrations, followed by + New Customer Migration
...
Note. The screen shot above depicts migration selections using Clone and Map Dialplan. If selecting the Template Migration option from Dialplan Configuration drop down, an additional drop down will appear to select required Dialplan that will be pushed to target by Wrangler UCMC as per below screen shot.
...
At completion of initial Discovery* process, a summary screen displays any issues and warnings detected during the initial Discovery process*, with the individual tabs providing detailed information of the on these.
...
*From Wrangler UCMC version 2.5.20, CUCM change notifications are supported which means that if a Rediscovery needs to take place at any time after the initial discovery has been successfully completed, Fast Re-Sync All may be selected that will detect all changes in CUCM’s since the previous full discovery was performed. (note that there is a dependency on notification queue depth in CUCM which is found in CUCM under Service Parameters)
...
If an object type is set to map in the source type mappings, as per below screenshot, these objects in the source cluster must be mapped to target, otherwise errors will occur during the migration for objects that have dependencies.
...
If a map object with the same name exists in the target as in the source, Wrangler UCMC will automatically set the mapping
...
For objects that require mapping, Selecting the Blue Button to Manually Resolve Unmapped will show the Target Mappings screen for the object/s. From here , the source object/s are should be mapped to the required pre configured target cluster object.
...
New feature from wrangler- Version 2.5.24 is Rank validation. Rank is a feature that impacts three components in CUCM, LDAP Directory, ACG (Access Control Group) and CUCM User and is used to control user access to ACG’s . This wrangler_ feature is implemented to support WxC-DI
| Note |
|---|
In version 2.6.12 and later, ACG’s (Access Control Groups) default behaviour is changed to map rather than clone. Together with this we are introducing an ACG automap functionality that maps default source ACG’s to corresponding WxC-DI Partner ACG’s |
This wrangler_ feature is implemented to support WxC-DI requirement that Rank value 5 should be used for enterprise users. In most CUCM deployments, Rank would be left at Default, which is 1 (the highest). Now if users have been configured with an ACG such as Standard CCM End Users with Default Rank configured, and is to be given a Rank value of 5 in WxC-Di then they will no longer be able to access the Standard CCM End Users ACG.
...
When all validation issues have been completed , you need to Re-Validate Migration.
Rank ACG Cloning pre version 2.6.12
For WxC-DI migrations using Yarn1man with version earlier than 2.6.12, an ACG clone may be created as per below.
On completion of this next round of validations, there will be an ACG Clone Rule triggered.
Select the Clone ACGs button to clone all the currently used ACG’s with Default Rank to a new ACG with a Rank value of 5. again complete any remaining issues, then Re-Validate Migration
...
As part of the migration all users will be transformed with a Rank Value of 5 and associated with the newly cloned ACG’sACG with a Rank value of 5
...
As part of the migration all users will be transformed with a Rank Value of 5 and associated with the newly cloned ACG’s
Rank ACG behaviour Yarnman/wrangler_ version 2.6.12 and later
For version 2.6.12 and later migrating to WxC-DI only - the above ACG clone process is not performed, instead we have developed a process to Automap default source ACG’s to the WxC-DI Partner ACG’s as per below screenshot, thus now not requiring a Rank 1 account for the API interface credentials. (Note that this may still be required if custom ACG’s are required in the WxC-DI, as Cisco by default does not allow for the creation of these in the WxC-DI environment)
Warnings
The Warnings tab displays items that have triggered the rules but are information warnings only that may be attended to as required in source CUCM. Items that are highlighted under warnings can be missing e164 numbers, Intercom partitions and CSS's, Devices without Lines, Lines without Devices etc. If these require updatingetc. To view the details of these objects, select the blue button which will take you to the item/s in question. If no action is required for the individual item/s, select Acknowledge and Continue (pre version 2.6.12 the Red Button + Disable Rule and Clear Issue) may be selected to clear the issue.
...
Once Warnings are resolved, proceed to next Tab - Site Suggestions which is where we define the sites to be used during the migration
...
| Info |
|---|
More on Mapping Tables here https://yarnlab.atlassian.net/wiki/spaces/YSP/pages/2756444161/Wrangler+UCMC+Administration+Guide#Mapping-Tables.1 |
Site Suggestion Examples
...
Site
...
Creation
To define a site, select the Green Create Site button adjacent to the site suggestion. The site suggestions are defined from the Mapping Tables. If the site suggestions does not meet requirements, the templates and regexes used to create them may be modified under menu item Mapping Tables which also provides a preview function to see outcome of templates before reallocating.
...
Navigate to ‘Issues’ , the select ‘Re-Allocate Migration’
...
Option 3 - if the View link selecisted , the below screen will show, displaying which Device pool is impacted, this in turn has a link View to the Object Browser described in more detail herehttps://yarnlab.atlassian.net/wiki/spaces/YSP/pages/2756444161/Wrangler+UCMC+Administration+Guide#Browse, that shows the detail of this Device Pool. We can here allocate this object to a site as per the screen shot below.
...
We can select the sites individually by selecting the O Waiting from Select column or we can Bulk Select all sites by selecting the Green Bulk Select button
...
Phased migration enables the migration of sites individually or in batches. To assist in determining and understanding interdependencies prior to a phased migration, a new inter-site dependency report has been created where sites are placed in site groups and the report then detemines determines the dependencies between the analysed site group and other site groups.
...
| Tip |
|---|
For phased migration, it is recommended that a number of object types are moved to Before any Sites Loaded (BASL) and some objects also have their siteId set to null. This is best achieved using Bulk Changes. More on this here for version 2.6.14 or later https://yarnlab.atlassian.net/wiki/x/CYAtt/spaces/YSP/pages/edit-v2/3362750471?draftShareId=9dc3877d-7137-4220-aeda-fb8b8d7707cd#Overview |
| Note |
|---|
If you are planning to migrate a subset of regions and location you will need to manually adjust the nested associated Locations and Regions via object browser |
...
If any issues are discovered that prevent cloning of an object, it will be highlighted in red with link to the issue. Select the Target Issues: 1 link which will display the object/s
...
In this sample it is a Line Group Syd1-Sales-LG - select the link which will bring up the issue detail for the LG
...
The issue here is Line group member 25124, to view detail, select link to source Syd1-Sales-LG which will show Object Browser detail for the Line Group
...
if all issues resolved, Target Issues will now show 0, select Release, then Restart Execution Process
...
We will now Re-Validate Migration again to validate prior to load in writing configuration into target CUCM
...
A number of issues will likely need to be resolved before loading relating to dependencies/ sequencing issues
...
Select the Issues & Resolutions Tab
...
The EM profile not allocated to site need to be resolved by selecting View link whcih will bring up Object Browser detail for the EM Profile, where site may be allocated
...
Select Preview Load, Followed by Start Migration to initiate load of objects into Target UC Clusters Cluster
...
The counters Added and Updated within each load step can be used to ensure that objects are added/ updated in into target UC clusterscluster.
We can see that during the ‘Before Any Sites Loaded’ step there were 659 out of 665 objects added and 13 out of 14 objects updated.
We can see that in the ‘During Site Load’ step there were 250 out of 251 objects loaded and 21 out of 21 updated
...
To rollback migrated services in Wrangler UCMC, there are different rollback options. It is possible to rollback individual services or the sites that are migrated.
...
If the migration has been performed up to the Move Sites step, from the Wrangler UCMC tool screen, select the Rollback Tab.
...