User Migration


In a large organization, a User may be placed in one Group, and highly customized with services, settings, greetings, devices, and memberships in group services. But later the User needs to be moved to a different Group. Example 1: The User's original Group may have grown impractically large, so that provisioning and management tools are inefficient. Example 2: Another reason to move a user between groups may be Call Pickup Groups (CPG): if a user needs to be in the same CPG with another, they must be in the same group.

In these cases, deleting the User from one Group, then adding them back to the other, is a disruptive operation. A human operator needs to collect details on every setting, and on the user's device. To minimize the effect on users moved, even their passwords must be migrated to their new group.

This feature, User Migration, provides a function that allows BroadWorks users to be moved from one Group to another group with no loss of information, settings, passwords, greetings, or attached files.


User Migration performs a sequence of information retrieval prior to migration to ensure that the user meets the set of requirements that will allow the User to successfully migrate to the Destination Group. There are two types of restrictions that would prevent a valid migration - Requirements and Encumbrances. If either one of the restrictions contains errors then the migration will not be allowed to procede.

  • Check Migration Validity
  • Migrate Access Device
  • Remove User
  • Migrate Phone Number
  • Create New User
  • Set BLF entries on monitoring Users
  • Set Non-Service User settings
  • Add and Assign Services and Service Packs
  • Add Custom Announcements
  • Migrate Service specific settings
  • Migrate Credentials
  • Rebuild Access Device Configuration


Requirements are restrictions that are determined by inspecting the desired Destination Group to determine if the User can be moved into the Destination Group successfully.

  • Intra-Enterprise Inter-Group
    • The source and destination group must exist within the same Enterprise.
  • Domains
    • The Domain (e.g., "") that is applied to the User (at the Profile), and to the User's Identity/Device Profile Line/Port, must exist in the target group.
  • Service and Service Pack Authorization
    • Services and Service Packs that the User is currently assigned must be available within the Destination Group.
  • Group Schedules
    • The schedules contained within the User’s Source Group must also be contained within the User’s Destination Group.
  • Group User Limit
    • The Destination Group must have sufficient user availability to perform the move.
  • Group Extension Length
    • The Destination Group must have a valid extension length for the User.
  • Group Extension Availbility
    • The Destination Group must have a the current User extension available.


Encumbrances are restrictions that are contained within the User’s settings and the User’s Access Device’s settings. These restrictions do not require a Destination Group to be determined and can be checked in advance for potential migration targets.

  • Shared Call Appearance
    • If the User has a Shared Call Appearance assignment on a Identity/Device Profile, and the Identity/Device Profile is a Group-Level resource, and if the Identity/Device Profile has any other User or Shared Call Appearance assigned to it, the User is not moved.
  • Call Pickup Group
    • If the User is a member of a Call Pickup Group, the User is not moved.
  • Charge Number
    • If the User is using a Charge Number, the User is not moved. The selection of the proper Charge Number phone number in the New group is not possible automatically.
  • Attendant Console
    • If the User is monitoring any users, then the User will not be moved.
  • Meet-Me Conferencing Bridge
    • If the User has a Meet-Me Conferencing Bridge assigned, the User will not be moved.
  • Single-User Device
    • If the User is assigned to an Identity/Device Profile, and this is a group-level resource, then the Identity/Device Profile must have only this one user assigned to it. That is, the Group-level Identity/Device Profile cannot have multiple users assigned to it.
  • Hunt Group
    • If the User is a member of a Hunt Group they cannot be moved.