Wrangler WxC Validation Rules and Solutions

Validation Rule

Description

Suggested Solution

Validation Rule

Description

Suggested Solution

Migration to WxC-DI requires at least one target cluster.

A Target WxC-DI cluster has not been defined

Delete migration from Tasks menu item. Then reinitiate migration ensuring that Source and target interfaces selected.

Target cluster must have equal or greater CUCM version that source cluster(s).

Source cluster/s have a later version than target cluster

Not a supported migration

Source interfaces (clusters) need to be mapped to a default target cluster.

Source cluster have not been mapped to target cluster

Rectify and restart migration

Site(s) country must be added to the migration.

Required country not added

Using the drop down adjacent to validation issue to add country

Configuration Warning - Some CISCO device models are deprecated in some versions.

 

Some device models configured in source clusters have been deprecated and not supported in target cluster

Select Skip Deprecated Devices For Migration button adjacent to issue.

If required, configure phone device manually in target with supported end device

Configuration Warning - Some CISCO device models are not available in the target system.

Missing device pack for device in target

Device pack to be loaded in target or device skipped in migration + rediscover migration

Configuration Warning - Some CISCO phone security profiles models are not available in the target system.

Phone security profile for a migrating phone not available in the target

Device pack to be loaded in target + rediscover migration

or select ‘Skip Security Profile for Migration’ button if not required in migration

Verify directory URI Alias partition between source and target clusters.

 

Directory URI Alias Partition in Enterprise Parameter different in source and target

 

Create a Route Partition in the target with the same name as the one used in the source ‘Enterprise Directory URI Alias Partition’ parameter and add this Route Partition to target CUCM Enterprise parameter 'Directory URI Alias Partition + rediscover migration

 

The security license is required on the target cluster.

 

phone security profiles and/ or SIP trunk security profile have security mode set to authenticated or encrypted which is not licensed in target cluster

The security license is required on the target cluster. Load in target CUCM + rediscover migration

Check source and target cluster. Clusters UUID must be different

Same cluster has been selected for both source and target

Change Target cluster

Target cluster supported version is 12.5 and above

Target cluster version is not supported < 12.5

Upgrade Target cluster to version 12.5 or higher

Check if CRS is enabled in source and target cluster. If IPCC extension are populated

 

Discovered IPCC extension in source and no CRS configured in target

Disable validation rule if UCCX not to be migrated or ensure it is integrated to target

Site must have a target cluster selected.

Target cluster not defined for site

From Sites menu select site/s without target cluster - select the target cluster from drop down, save + revalidate

Site must have at least one source CUCM

Source cluster not defined for site

From Sites menu select site/s without target cluster - select source CUCM’s from drop down , save + revalidate

Site must have a country selected.

Country not defined for site

Select site country from drop down adjacent to issue or for multiple sites, bulk change. Alternatively, country can be allocated to site from Sites menu

Site must have a time zone selected.

TZ not defined for site

Select site TZ from drop down adjacent to issue or for multiple sites, bulk change. Alternatively, TZ can be allocated to site from Sites menu

Site must have a user-locale for WxC-MT

 

Select correct User Locale from drop down

Site must have correct address fields for WxC-MT

Required address details for WxC-MT location not complete

Select from drop down to enter address details manually or can be made in bulk from Menu items Sites, by export site CSV, complete details and Import

 

Configuration warning - Users without email are present in this migration.

 

Warning that some users are missing email address

Select Blue button ‘Resolve Invalid Users' to display the users that don’t have email allocated, then rectify users in source CUCM as required, followed by Fast Sync or Rediscover.

Note that this is a warning only and will not impede migration, thus if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Source and target mapped object must equal site allocations.

One or more source objects flagged as not mapped to site

Map using the 'Manually Resolve Unmapped’ button next to issue or from menu item Target Mappings

Source objects template mapping is orphaned or invalid.

Objects have changed since mapping was originally executed

Remap the object

Map types must be mapped to a target object or skipped.

 

Map type object (object requiring mapping) must be mapped or if not required skipped

Map the source object to target Using ‘Manually Resolve Unmapped’ button next to issue or from menu item Target Mappings. There must be a target object to map to, if no object to map to in the target and the object is required, configure the missing object in Target and Re Discover Migration

If the mapped object is not required it may be skipped under Target Mappings

Transform types must be mapped to a template or skipped.

 

Transform type object (object requiring mapping) must be mapped or if not required skipped

Map the source object to target Using ‘Manually Resolve Unmapped’ button next to issue or from menu item Target Mappings. There must be a target object to map to, if no object to map to in the target and the object is required, configure the missing object in Target and Re Discover Migration

If the mapped object is not required it may be skipped under Target Mappings

Object can only be executed (add,update,clone) after its dependencies have.

 

Object tries execute before dependencies

Use the Button adjacent to the flagged object issue to either change the object to move ‘Change At’ to same change point as dependent object/s Change Point or alternatively use the button for the dependent object/s to move ‘Change At’ to same Change Point as the flagged object

Configuration Warning - Users without Lines are present in this migration.

 

Warning only that there are users without lines in migration

Select Blue button ‘Resolve Invalid Users' to display the users that don’t have line allocated and rectify as required

Or if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Configuration Warning - Users without Devices are present in this migration.

 

Warning only that there are users without devices in migration

Select Blue button ‘Resolve Invalid Users' to display the users that don’t have device allocated and rectify as required

Or if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Configuration Warning - User with primary line defined but no associated devices or device profiles

CUCM-USER with prilary line configured but no associated devices

This will stop user from migrating - select the bulk fix button to remove primary line from the user

Configuration Warning - Detected local users with same MailId or Directory URI as LDAP users in target cluster

A local user in target have same mailId as a CUCM-USER in the source

Select the bulk change fix button to remove the mailId from the user to allow it o load into target cluster

Configuration Warning - Phones and Devices without Lines are present in this migration.

 

Warning only that there are Phones or other devices without lines in migration. As it is not possible to have 2 users in target system with same mailId, this will stop user from migrating

Select Blue button ‘Resolve Invalid Phones' to display the Phones/Devices that don’t have line allocated and rectify as required

Or if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Configuration Warning - Phones and Devices without External Number Mask - E164 are present in this migration.

 

Warning only that there are Phones or other devices without E164 mask

Select Blue button ‘Resolve Invalid Phones' to display the Phones/Devices that don’t have E164 mask allocated on line and rectify as required

Or if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Configuration Warning - There are devices to be added that have Pending Certificate Operation that needs to be updated to allow device to be added.

Warning that there are devices that have pending certificate update - the device may never have been plugged in or not plugged in since certificate update performed

Select the Blue button 'Set to “No Pending Operation” adjacent to the issue

Configuration Warning - CUCM-PHONE has a self reference for primary phone that needs to be removed to allow loading

A device has primary device configured referencing itself in source CUCM. This is incorrect configuration and will stop the phone device from loading to target

Select the Bulk fix button to remove the configuration in Wrangler to allow loading of the object

CUCM-PONE has line with intercom line (Only available in Clone Migration)

An Intercom line exist with incorrect ring setting exist that will stop the device from loading in target cluster

Select Bulk fix button to clear the ring setting and allow phone device to migrate

Configuration Warning - EM Profile need to be allocated to sites.

There are EM Device Profiles that have not been allocated to a site

If this is the first validation warning for the migration, prior to Site suggestions have been completed, then first complete Site Suggestions and reallocation before solving.

If Validation rule trips post Site allocation, select the View link nect to the object which will open page displaying the EM/s. From there open link to Object Browse for the individual EM/s then allocate CUCM-EM to site in Override Column and Save

Configuration Warning - Lines without Phones are present in this migration.

Warning only that there are lines without phones in migration

Select Blue button ‘Resolve Invalid Lines' to display the orphan lines and rectify as required

Or if not an issue select Red Button - ‘Disable Rule and Clear Issue’

Configuration Warning - CTI Route Points are present in this migration.

Warning only that there are CTI Route Points part of migration

Select ‘Disable Rule and Clear Issue’ noting that any associated third party system must be configured manually (the CTI Route Point config in CUCM is migrated)

Configuration Warning - CTI Ports are present in this migration.

Warning only that there are CTI Ports part of migration

Select ‘Disable Rule and Clear Issue’ noting that any associated third party system must be configured manually (the CTI Port config in CUCM is migrated)

Configuration Warning - Recording Profile are present in this migration.

Warning only that there are Recording Profiles part of migration

Select ‘Disable Rule and Clear Issue’ noting that any associated recording third party system must be configured manually (the recording profile config in CUCM is migrated)

Configuration Warning - Transcoders are present in this migration.

Warning only that there are Transcoders part of migration

Select ‘Disable Rule and Clear Issue’ noting that Wrangler UCMC does not migrate transcoder config

Configuration Warning - MTP IOS media type is present in this migration.

Warning only that there are MTP IOS part of migration

Select ‘Disable Rule and Clear Issue’ noting that Wrangler UCMC does not migrate MTP IOS config

Configuration Warning - Conference Bridges are present in this migration.

Warning only that there are Conference Bridges part of migration

Select ‘Disable Rule and Clear Issue’ noting that Wrangler UCMC does not migrate Conference Bridge Config

Configuration Warning - Unsupported Voicemail Ports are present in this migration.

Warning only that there are Voice Mail Ports part of migration

Select ‘Disable Rule and Clear Issue’ noting that Wrangler UCMC does not migrate Voice Mail Ports

Configuration Warning - Device Pools with Elin Group are present in this migration.

Warning that there are ELIN groups part of source configuration

Select ‘Disable Rule and Clear Issue’

noting that Wrangler UCMC does not migrate ELIN groups

Configuration Warning - Jabber mobile devices must have correct MaxNumCalls value set for the version.

Jabber device in source have MaxNumCalls for line set to unsupprted value (max 2 in CUCM >=12)

Select the 'Resolve with Bulk Change' button

Configuration Warning - Jabber mobile devices must have correct DND configuration set

Incorrect DND setting for target cluster stopping Jabber device from loading in target cluster

Select Bulk Fix button to clear the incorrect setting

Configuration Warning - User and Network locales has to be present in the target system as well.

Detected that User or Network Locales used in source system not present in target

Install required Locales in target

the Rediscover migration

Source template objects need to be allocated to sites when match is set to mandatory.

The object has not been associated with a site

If this is the first validation warning for the migration, prior to Site suggestions have been completed, then first complete Site Suggestions and reallocation before solving.

If Validation rule trips post Site allocation, select the View link nect to the object which will open page displaying the Objects. From there open link to Object Browser for the individual Object/s then allocate to site in Override Column and Save

Configuration Warning - Unity User/Mailbox must have a user template in order to match to a target.

One or more User/ Mailbox in source UCXN config does not match a template in source

Create template in source that match the config of user mailbox, then rediscover

or skip and configure user mailbox manually in target UCXN

Configuration Warning - UCXN Tenants are not supported yet.

Warning that Wrangler UCMC does not support Tenants

Not Supported - manual config required in target UCXN

CUCM-USER objects which are LDAP integrated have a diffrent LDAP directory than target object.

Warning that LDAP directory config is different in source from target

Map required if name different in target from source

CUCM-USER objects which are LDAP integrated should have a target object that is also LDAP integrated.

Warning that LDAP user objects are different in target from source

Resync CUCM source + target and Rediscover migration

CUCM-ROUTE-PATTERN have a destination field that can be either routelist or gateway, but never both.

TBD

 

CUCM-SOFTKEY-TEMPLATE self reference.

Wrangler UCMC have detected that there is SKT template/s that refernces a base template in the source that does not exist in the target cluster

Select the View button to go to Object Browser for the SKT/s in question. There change the Base Template to one that exist in target cluster using the Override drop down

Source cluster CUCM-ACCESS-CONTROL-GROUP has custom ranks, these must be copied manually to the target cluster

User Ranks other than default >1 configured in source cluster

Ensure corresponding User Ranks configured in target - after completed, run rediscovery or disable validation rule

Orphaned CUCM-REMOTE-DESTINATION exists in source and cannot be migrated

Orphaned RD’s in source

Select Bulk change to clear

Orphaned CUCM-REMOTE-DEST-PROFILE exists in target and cannot be migrated

Orphaned RDP’s in source

Select Bulk change to clear

Orphaned CUCM-TOD-ACCESS exists in source and cannot be migrated

Orphaned TOD’s in source

Select Bulk change to clear

 

Orphaned CUCM-TIME-SCHEDULE exists in target and cannot be migrated

Orphaned TS in source

Select Bulk change to clear

Orphaned CUCM-HUNT-PILOT with invalid configuration, CUCM-HUNT-LIST missing and cannot be migrated

Hunt Pilot without Hunt List

Select Skip

CUCM-SERVICE-PROFILE directory password contains special characters that causes AXL error (CSCvz61706).

Invalid characters in password

Map Service Profile- disable rule

Rank mapping requirements for WxC-DI requires that LDAP users are synchronised to rank >=5

In WxC-DI there is a requirement that all Enterprise users imported through an LDAP sync agreement are given a User Rank of 5. This validation rule detects if the LDAP directory agreement in target has default rank value set to 5 or higher

Set value of LDAP directory Rank in WxC-DI to 5 and rediscover migration

Note that User Rank 5 have to be configured in the target first

System default CUCM-ACCESS-CONTROL-GROUPs have dependent users and must be cloned due to rank mapping requirement for WxC-DI (end users and ACGs User Rank must be >= 5)

This is displayed if in consecutive validation post mapping of User Rank in Wrangler, Target Mapping, have been mapped from existing to 5

Select the Red button to create cloned ACG groups with mapped user Rank values (5) for support in WxC-DI

CUCM -USERS with userRank too low for WxC-DI

 

user rank value for CUCM users have a value that is lower than 5 - user rank 5 is the value in WxC Di for Enterprise Users

This is flagged during initial validation -

Ensure User Rank values supported by users in target WxC-DI (3-5) are configured or if not configured ensure to do this, then rediscover migration

If the users should be changed to 5, in Target mapping, map existing USER-RANK currently used by ACG’s and users, normally Default 1, to new value in target which would normally be 5 in target

if the user rank should remain as is - might not be supported in WxC-DI, disable rule.

Source UCXN-CALL-HANDLER-TEMPLATES must match recipient type of the target they are mapped too

UCXN call handler templates with User Mailbox not existing in target

Create UCXN Call handler template with User Mailbox in Target

Cluster Consolidation - Sites must have different names.

In cluster consolidation, there are 2 of more source sites with the same name

Rename duplicate site name in Wrangler UCMC

Cluster Consolidation - Different length of Directory Numbers has been detected.

Warning only in cluster consolidation migration where two or more of source clusters have different length DN’s

Change number ranges as required using Transformation Renumbering option (not in MA)

or ‘Disable rule and clear issue' if it is not an issue

Cluster Consolidation - Directory Numbers duplicates has been detected.

Duplicate DN’s detected in Cluster Consolidation migration

Open Duplicate in Object Browse and change DN - Save

Cluster Consolidation - duplicates on primary key

Duplicate object with same configuration detected in source clusters

Select the object to be used for migration. If other object also needs migration, modify primary key in source + rediscovery

Cluster Consolidation - duplicates with unique configuration

Duplicate object with unique configuration detected in source clusters

Select the object to be used for migration. If other object also needs migration, modify primary key in source + rediscovery

Cluster Consolidation - target duplicates on primary key

Duplicate object with same configuration detected in target cluster

Select Ignore Source

Cluster Consolidation - target duplicates with unique configuration

Duplicate object with unique configuration detected in target cluster

Select Update Target if the target object should be updated with configuration from source, always for ldap users and generally would be the selection for all objects, or select ignore source if the target object shall remain as is (If in doubt select Update Target)

Flags all the customer level objects that are not allocated to a site

 

Validation rule to display objects that are at customer level - ie not allocated to a site

No action required after initial validation but if objects are flagged post site allocation step:

Verify that site mapping completed for all sites as required then reallocate

or use bulk change to allocate objects to site as required

or if objects flagged should remain at customer level - Disable rule and clear issue

Configuration Warning - Migration Plan should have at lease one person license in the list

A default license must exist in the WxC-MT

Select required default licenses from drop down

WXC-PERSON and WXC-WORKSPACE must have numbers that are present in site number-ranges

Detected that WXC-PERSON or WXC-WORKSPACE that have numbers that are not present for site allocated

Select Bulk Change button to add the range to site, or alternatively if incorrect open object and change number as required

WXC-PERSON and WXC-WORKSPACE must have uniq numbers

Detected WXC-PERSON or WXC-WORKSPACE with conflicting numbers

Allocate numbers as required to ensure unique

WXC-PERSON and WXC-WORKSPACE extension can’t be longer than 6 digits

Detected WXC-PERSON or WXC-WORKSPACE with extension number longer than 6 digits

Change numbers to comply

WXC-PERSON must have at least 1 item in phoneNumbers

 

 

WXC-PERSON must have valid emails

 

Add email details as required to object WXC-PERSON

WXC-LOCATION must have address line and city populated before adding or updating

 

Select the manually resolve in Site to add address details manually or can be made in bulk from Menu items Sites, by export site CSV, complete details and Import

WXC-LOCATION must have a valid postcode before adding or updating

 

Select the manually resolve in Site to add address details manually or can be made in bulk from Menu items Sites, by export site CSV, complete details and Import

WXC-LOCATION must have a valid ISO 1366-2 state before adding or updating

 

Select the manually resolve in Site to add address details manually or can be made in bulk from Menu items Sites, by export site CSV, complete details and Import

WXC-LOCATION must have a valid 1366-1 2-digit country code before adding or updating

 

Select the manually resolve in Site to add address details manually or can be made in bulk from Menu items Sites, by export site CSV, complete details and Import

Number Ranges E164 numbers must have the same countryCode as their Site country

 

Edit in numbers as required

WXC-LOCATION must have a valid timezone that matches its country

 

Select valid TZ from drop down

Rank mapping requirements for WxC-MT requires that users are synchronized to rank >= to 5

 

 

WXC Multi-Tenant Transform objects must be allocated to a site

 

Allocate to site as required in Object Browse

CUCM Pickup Group that is being transformed has nested pickup groups

 

Remove nested pick up group from Object

NUMBER from object has an invalid DN and/or E164 that needs manual intervention

Number is invalid for deployment to WxC-MT

Select:
Skip Target to skip this number for migration; or

Select Target number to link to existing number in the target WxC-MT; or

Force Target to force deployment of the number into WxC-MT (may not work)

Note that if Full National Number (FNN) normalisation is used (added in 2.6.7) allocation must be run again after sites are created and country set

CUCM-PHONE is missing owner but has a single user association.

Detected 5 CUCM-PHONEs missing owner with a SINGLE user association, correction of "ownerUser" might be required.

Added in 2.6.7 for WxC-MT

This rule flags any CUCM-PHONE that does not have the ownerId set which may be caused by missing data and have found that there are links/edges to a single user

The results of this view require manual verification and correction

On the CUCM-PHONE object there is a new section Discovered User Associations

Note that not all object flagged will require correction

If this CUCM-PHONE should be associated to a user update the Owner User field in the CUCM-PHONE object - this will change the transformation from WXC-WORKSPACE to WXC-PERSON

The validation rule will need to be disabled if false postives are flagged

CUCM-PHONE is missing owner but has multiple user associations.

Detected 1 CUCM-PHONEs missing owner with MULTIPLE user associations, correction of "ownerUser" might be required.

Added in 2.6.7 for WxC-MT

This rule flags any CUCM-PHONE that does not have the ownerId set which may be caused by missing data and have found that there are links/edges to multiple users

The results of this view require manual verification and correction

On the CUCM-PHONE object there is a new section Discovered User Associations

If this CUCM-PHONE should be associated to a user update the Owner User field in the CUCM-PHONE object - this will change the transformation from WXC-WORKSPACE to WXC-PERSON

Line-like (pattern/partition) object has pattern with overlapping partitions with other objects.

Detected 24 line-like objects that have overlapping partitions with other objects.

Added in 2.6.7 for WxC-MT

This rule flags any overlapping dialplan objects including the null partition

This rul will flag any overlapping objects that are line-line (DN+PT)

Detected 9 unallocated system call-handlers.

Added in 2.6.7 for WxC-MT

This rule flags any system call handlers that are not allocated

Either manually allocate or use allocate by ranges

Detected X CUCM-USER with lines (LAAP) duplicates

Duplicate LAAP detected for user that prevents loading of user

Select link, to open detail of issue, then select the Resolve button