| Table of Contents |
|---|
Wrangler Global Settings
Below are described the wrangler_ WxC tool global settings. These can generally be left as default but contain some settings that may be useful to change depending on migration requirements, particularly the Mapping Tables that define the Site suggestions for migration
...
...
wSettings
General settings define global performance metrics and other global settings.
| Note |
|---|
These should generally be left as default unless performance issues experienced interfacing with CUCM and/ or UCXN |
...
...
Setting
...
Default Value
...
Description
...
General Settings
...
| Note |
|---|
Note that saving global settings will reset workflow services, so not recommended to perfom in middle of migration task such as Discovery, Allocation, Validation, Prepare, Load |
Setting | Default Value | Description | |||
|---|---|---|---|---|---|
General Settings | |||||
Generate new incremental siteID’s | OFF ON (Default) | Site ID’s number will generate incrementally. If off will leave as Site name | |||
Enable VOSS4UC Hierarchy Move | OFF (Default) ON | Enables VOSS4UC hierarchy move - this should only be enabled for HCS to HCS migrations | |||
Couch Database Settings | |||||
Yarnman CouchDB Simultaneous Request Limit | 50 | Controls how many simultaneous requests to send to Couch. | |||
Yarnman CouchDB Find Page Size | 200 | Controls the page size of find requests in Couch. | |||
Yarnman CouchDB Bulk Get Batch Size | 500 | Controls the batch size of bulk load object requests in Couch. | |||
Yarnman CouchDB Bulk Add/Update Batch Size | 500 | Controls the batch size of bulk add/update object requests in Couch. | |||
CUCM Settings | |||||
CUCM AXL List Page Size | 150 | Controls size of each page when loading lists of items via AXL. | |||
CUCM AXL Simultaneous Request Limit | 15 | Controls how many simultaneous requests to send via AXL. | |||
CUCM AXL Simultaneous Write Limit | 2 | Controls how many simultaneous updates to send via AXL. | |||
Unity CUPI List Page Size | 200 | Controls size of each page when loading lists of items via Unity CUPI | |||
Unity CUPI Simultaneous Request LimitCUCM AXL Sync Backoff Time | 75000 | Controls how long it will take to wait to send the next AXL request. Default is 75 seconds | |||
CUCM AXL Sync Backoff Retry Times | 5 | Sets the amount of objects to be retrieved from Unity/UCXN API calls. | Unity CUPI Request Timeout (ms) | 30000 | Controls how long to wait for Unity to respond to times to retry a sync AXL request after the backoff above. Default is 5 retries |
Enable Fast Sync | OFF ON | Using this switch, you can enable/disable the fast sync function, which uses an AXL listChanges request to collet changes during the Wrangler sync process. Default is true | |||
Unity Settings | |||||
Unity CUPI List Page Size | 200 | Controls size of each page when loading lists of items via Unity CUPI | |||
Unity CUPI Simultaneous Request Limit | 5 | Sets the amount of objects to be retrieved from Unity/UCXN API calls. | |||
Unity CUPI Request Timeout (ms) | 30000 | Controls how long to wait for Unity to respond to an API request before triggering a timeout. | |||
Unity CUPI Sync Backoff Time (ms) | 90000 | Controls how long to wait for Unity to retry a sync request after encountering a problem. Only effects sync/discovery requests. | |||
Unity CUPI Sync Backoff Retry Times | 3 | Sets the amount of times to retry a sync request after the backoff above. | |||
Webex Settings | |||||
Webex List Page Size | 50 | Controls size of each page when loading lists of items via Webex API. | |||
Webex Simultaneous Request Limit | 20 | Controls how many simultaneous requests to send via Webex API. | |||
Webex Simultaneous Write Limit | 4 | Controls how many simultaneous updates to send via Webex API. Default is 4. | |||
Webex Request Timeout (ms) | 45000 | Controls how long to wait for webex to respond to an API request before triggering a timeout. | |||
Webex Sync Backoff Time (ms) | 60000 | Controls how long to wait for webex to retry a sync request after encountering a problem. | |||
Webex Sync Backoff Retry Times | 4 | Sets the amount of times to retry a sync request after the backoff above. | |||
Workflow Settings | |||||
Maximum validation issue item count | 5000 | Controls the number of entries that can be saved in validation issue task | |||
Interstep processing pause | 10000 | Controls pause during clone transform process | |||
UCMC Settings | |||||
CDR Repository Path | /var/lib/couchdb/cdr | Local path that CDR folders and files are deposited in. Default is /var/lib/couchdb/cdr These are required if running migration report CDR Dialing Forest |
...
Customer Prefix defines the prefix for multiple dialplan objects deployed for Template Migration only
Site Prefix defines the prefix for multiple dialplan objects deployed for Template Migration only
...
Others
Clone Access Control Group Suffix This is used for Migrations to On Prem CUCM where Rank Mapping is required
...
Mapping Object Defaults
The Mapping Object Default Matrix defines source data objects mapping to target data objects. These should be left as default
...
The option for each object is either A
Clone (object will be cloned in target)
Map (the object will be mapped to target configured object)
Transform (the object will use transform template to update or add fields on an object)
Skip/Ignore (the object will not be migrated)
...
De-Duplicate and Clone Objects will be de-duplicated using a linked process before cloning.
Tip - If unsure what objects requires mapping (needs preconfiguration in target) the Source Type Action Defaults table will confirm all objects that require mapping for each dialplan migration type
...
Tip - most common object used (default) to create site suggestions are Device Pools
...
| Note |
|---|
The Default schemas should not be altered - if for some reason changes are required, the default schema should be cloned and modifications performed on the clone only |
Wrangler Migration Menu
Note that these menu items are only visible within the migration
Customer
The Customer Screen display enables information regarding the customer to be added and modified as and if required in the Override Value column, then Save Changes
...
The Clusters menu item displays information regarding the Source and Target Cluster interfaces and servers
...
Selecting the MainTargetCluster link displays information re the target cluster.
...
The Ranges Option allows for the creation allocation to site of objects using number ranges to be manually created for addition to in WxC-MT only.
To create add a new range for additionallocation, select Quick Add Range, then under the new window, the DN or E164 range start and end number may be added as required then Save & Close selected
...
Mapping LDAP User Correlator
...
| Note |
|---|
Note that the LDAP correlator feature is only supported for transform object and is not supported for WxC-DI migration using clone, it is supported for
|
From Yarnman Version 2.6.5 there is an additional feature within Migration Mapping Tables allowing for selectable source attribute to use for mapping to target UserID. The use case for this is when the target UC servers CUCM LDAP uses a different AD server than source and a different LDAP attribute as UserID from the source is used in the target - for example if source cluster is LDAP synchronized to MS AD with the userID as samAccountName and target synced to Azure LDAP source and the userID is UPN.
...
Map types are objects that must be mapped from source to target clustter. The types show objects in Unmapped, Mapped, Skipped, Loaded state. During a migration you will be prompted to map the objects that are currently unmapped, all of these are highlighted in Yellow in Map Types (mandatory mappings) section under Source Cluster Objects, Unmapped, Customer headings and cannot progress until all mappings performed.
...
Mappings are objects that must be mapped from source to target. The types show objects in Waiting, Skipped, Issues and Mapped state. During a migration you will be prompted to map the objects that are currently unmapped, all of these are highlighted in Yellow in Mappings section and cannot progress until all mappings performed.
...
Call types specifies all the different Global call types used in the Wrangler UCMC tempalte dial plan.
| Note |
|---|
It is not advisable to modify or add to this unless advised by support |
...
To view a specific object select Edit link corresponding to the specific Object. To modify an object, specify the override value in the Override Value column corresponding to the parameter to be altered, then save
...
The Objects->Configure Actions menu item will display the action taken for a particular object type during the migration being. If performing a change here, it will only be valid for the current migration.
Clone - the object being cloned from source to target
Map - The object is mapped from source to target object
Skip - The object is not being migrated
...
The Ignoring Rules report will show any Rules that have been selected to be ignored (skipped) post initial validation steps. Individual ignored rules may be investigated by selecting the Edit link adjacent to object in question which will show detail view of it in the Object Browser. The report may be Exported using the Export link in top right hand corner above of the table
...
Menu item Objects → Users Missing Email displays any users that are missing Email, Select the link to individual user to bring up Object Browser with more detail and to resolve as required. The report may be Exported using the Export link in top right hand corner above of the table
...
The Number Ranges → DN report shows all discovered DN ranges/ site and size of the range> to Edit a range, select the Edit Range link adjacent to the corresponding DN range.
...
The Number Ranges → E164 report shows all discovered E164 ranges and DN range/ site and size of the range. to Edit a range, select the Edit Range link adjacent to the corresponding DN range
...
All impacted numbers and associated will display. Object types can be unselected if required, also any individual item can be unselected by selecting Transform toggle adjacent to the item. When all adjusted as required, select Apply Renumbering
...
Voicemail - Discontinued Option
Mailboxes
Displays UCXN users with a voicemail box
...
Select Generate Dialplan Connections to generate Dial Plan Connections report. When completed select the link to download the Excel spreadsheet
...
Inter-Site
...
Dependencies
New feature in 2.5.15
Select The Inter -Site Dependancies, press generate and select Site Dependency report option flags dependencies between migration batches. The intended usage for this report is for Phased migration to get an indication of dependant objects that will cause a problem during a phased migration, such as Line Groups with members in different migration batches etc. giving a chance to rectify these in advance of running the prepare step.
Select Inter-Site Dependencies, press generate and select the site group to generate Inter-Site Dependancies Dependencies report. When completed review the results
...
Example report with no inter-site issues
...
...
Duplicates Objects - Discontinued Option
This menu item allows for bulk update of object migration status. Any objects that are flagged as duplicate issues during the migration can be bulk updated here. There are four tabs
...
select required tab with data, then select action for the object groups using check box and if consolidating clusters select the Source Cluster object to use or for duplicates between source and target Ignore Source to keep object in target unchanged or Update Target Object to update target with source configuration, then select the Bulk Update button to perform the change
...
Bulk Changes
Bulk Change
...
Number Mappings
The number mappings option provides an export of all number mappings for numbers associated to object types and their target mappings
To run the report, select Generate Number Mappings Export which will create a spreadsheet ready for download by clicking on the File link under Files header
Sample Downloaded report screenshot belows
...
Bulk Changes
Bulk Change
Bulk changes may be used to bulk change objects in Wrangler or to create a Migration point Change
...
ITL Reset
Reset
The Wrangler UCMC tool includes a tool to reset ITL certificates on phones to enable registration of end devices in target cluster*
...
Phones meeting the criteria will be displayed, individual phones may be unselected by selecting the Selected link adjacent to the phone.
When ready, select Run ITL Reset which will reset the certificates on the selected end devices
...
unselected by selecting the Selected link adjacent to the phone.
When ready, select Run ITL Reset which will reset the certificates on the selected end devices
...
Workbook
The workbook is used for WxC-MT migration to facilitate (bulk) changes to data prior to loading configuration into the Webex Cloud.
To use, select Export Objects, then select the type of objects that should be downloaded for alterations and any filters to narrow export if required
...
Then Select Generate Export Workbook that will generate a spreadsheet with the requested object ready for download, select the link to download
Open the Excel spreadsheet and modify as required, the save + Import the sheet back to Wrangler
To Import, select Import Object Changes, then Choose File to upload and Import Object Changes
ITL Scripts
The ITL Reset → ITL Scripts menu item will display a list of end device types. To view the ITL or CTL reset script for a particular phone model, select the adjacent ‘Eye’
...
Imported data from source clusters are validated against preset validation rules. These rules may be enabled or disabled by selecting Rules from the menu, to disable or enable individual rules, select the relevant check box - YES enables the rule, NO disables the rule
| Info |
|---|
Information of what the rules mean and suggested actions to resolve the same mat be found here https://yarnlab.atlassian.net/wiki/x/D4BWp |
...
Tasks
The Tasks menu item will display all the individual task steps that have been performed by Wrangler UCMC. Additionally, tasks include an option to Delete or Reset current Migration.
The details of each task may be viewed by selecting the corresponding Completed link.
...
From the detail, the Events tab may be selected which will display all the events and errors pertaining to the task
...
To Delete current Migration in Wrangler UCMC, select Delete Migration.
...
| Note |
|---|
Warning - Take care in using these options as it will delete the current migration from Wrangler UCMC database |