Migrating users in bulk

Last Updated : Oct 28, 2025 |

About this task

You can migrate users to Avaya Aura® Private Cloud.

During the migration process, you can make changes to the on-premises system. Cloud Migration Tool regularly synchronizes the on-premises and Avaya Aura® Private Cloud systems.

Note:

  • Cloud Migration Tool can migrate one or more Communication Manager server at a time and can also migrates the extension as is. If an extension is already available, Cloud Migration Tool marks it as a duplicate extension.

  • Cloud Migration Tool moves a group together. For example, you have to move all the members of a coverage answer group together. Cloud Migration Tool does not move just one member of the coverage answer group.

  • The migration workflow for the station does the conversion of the H.323 station to SIP station.

  • Cloud Migration Tool migrates the phone button from the source station as is.

  • The CM Template linked to the supplied Org Unit is applied to the Agent Login ID.

    If an override template is submitted for that user in the input file, that template is used.

    If COR is part of the template, that COR is assigned to the migrated Agent Login ID.

Before you begin

  • Make the setup ready. For information, see Planning checklist.

  • Ensure that the user profile login and handle are the same on Avaya Aura® Private Cloud and on-premises System Manager system.

  • Update the firmware of the endpoint. If you have the H.323 endpoint, upgrade to the latest SIP endpoint.

  • Cloud Migration Tool cannot assign CC bundles to stations who do not have user assignment. Therefore, assign a CC station with an Agent-login ID button to include CC bundle.

  • Download the CloudMigrationToolSample.csv file on your computer and fill in the user details.

    For more information, see Downloading the Cloud Migration Tool sample worksheet.

Procedure

  1. On Cloud Migration Tool, click Migration > User.
  2. On the Bulk User Migration page, in the Name field, type the name of the bulk user migration request.

    By default, Name displays as the following: BulkMigration_<MMDDYYYY>_<cloud migration server name>

    For example, BulkMigration_7162024_cloudmigrationservername

  3. In the Select File field, click Choose File to locate and select the cloud migration worksheet from your computer.
  4. From Source CM, select an on-premises Communication Manager server to migrate.
  5. From SMGR Template, select a System Manager template to create a new System Manager user for each user.
  6. From IXM Template, select an IX Messaging template to create a mailbox for each user, if not already exist.
  7. Click Input Validation.
  8. On the Review page, review the details.

    The Review page displays the total number of entries, pending, valid, and invalid entries.

  9. Click Submit.

    Cloud Migration Tool displays the Confirmation dialog box with the following message:

    All database checks completed. Proceed to migrate/move all records in spreadsheet.
  10. Click Yes.

    Cloud Migration Tool modifies each user’s Avaya Aura® Private Cloud communication resources and updates the routing tables to direct calls properly to the migrated users to the Avaya Aura® Private Cloud system. In the on-premises system, the users, stations, and agent resources are renamed to Migrated and the System Manager profile is deleted.

    Cloud Migration Tool displays the processed entries data on the Result page.

  11. On the Result page, view the records.

    The Result page displays the total number of entries, processed, pending, successful, and failed entries.

Result

When a user is migrated from the on-premises system to the Avaya Aura® Private Cloud system, the user still exists on the on-premises system, but the name of that user is changed to Migrated.

Related information
Migrating resources in bulk
Bulk User Migration field descriptions