| Table of Contents |
|---|
Wrangler Site Suggestion Process
Yarnlab Wrangler is a powerful tool that allows you to efficiently migrate your Unified Communications (UC) systems to a new technology or architecture. In this blog post, we will outline the steps involved in using Regexes to define sites in Wrangler.
As there is no definitive way of identifying sites in a CUCM deployment, Yarnlab have developed a way of creating these in Wrangler, where the following applies:
...
Site Suggestions are Wrangler's automated way of grouping similar objects into sites based on shared attributes. It leverages regular expressions (Regexes) to identify these shared attributes in the names of the UC components (such as Device Pools, Locations, Regions, Route Partitions, and Calling Search Spaces), which are then used to define the Site Suggestions.
Why are Site Suggestions Important?
Site Suggestions in Wrangler is a feature specifically designed to automate the creation of sites based on existing naming conventions in your source cluster. It enables the grouping of source objects into a site that uses an automated identification method and can handle one or more naming conventions. Site Suggestions provide a structured, systematic approach to site creation, taking into account the intricate relationships between different configuration objects.
In the past, many engineers have relied on a "dummy site" method, creating an empty site and lumping all objects in as customer level objects. While this might seem convenient initially, it often results in a cumbersome migration process, where the control over specific objects is lost. Additionally, this approach often leads to a mix of objects from different sites, creating a hotchpotch that's difficult to untangle later in the migration process.
| Note |
|---|
Note that the “dummy site” is only possible for WxC-DI Clone migration - is should not be used for WxC-MT |
Here's why Site Suggestions should be your go-to for Wrangler migrations:
...
Scalability: Whether you're dealing with hundreds or thousands of UC components, Site Suggestions can handle the load, making it a scalable solution for organizations of all sizes.
How Site Suggestions are Created
To create the site suggestions in Wrangler the following components are used.
...
To create a match for the other Device Pools we need to create new mappings or modify existing mappings. Let’s create new ones. To match C01-Sydney-DP, we can create an entry, C01-${siteId}-DP which will generate a site suggestion called Sydney, for the other 4 device pools, we create an entry ${siteId} which will create 4 site suggestions devPoolNorth, devPoolSouth, devPoolSpecial, devPoolWest
These 2 entries will Match the Device Pool naming’s above. Together with the previously defined, we would end up with Site Suggestion names as follows:
...
Now, these are all based on using the default siteId Regex. This regex may be modified as required for different matching. The Regexes can be found in Wrangler under
Mappings -> Mapping Tables->Mapping Regexes
Here we can see that the siteId regex is ([a-ZA-Z0-9]+). This effectively matches any string combination of alphanumeric characters without any separations such as space or – (hyphen) etc.
...
migChicago-DevicePool1, migChicago-DevicePool2, migChicago-DevicePool3, migChicago-DevicePool4 and migDallas-DevicePool1, migDallas-DevicePool2, migDallas-DevicePool3
...
Verify the Site Suggestion Mappings in Wrangler
After initiation of the initial migration Discovery in Wrangler, the mappings can be checked to verify that they have been created correctly and that all site suggestions are there as expected. To check this, we can select menu option Mapping Tables, then Preview Table adjacent to the mapping object that we want to preview – in this instance, Device Pools
...