Migration

Start Your Migration

This document provides a step-by-step walkthrough of running the Opsole Migrate application on the device, from launching the tool to completing the migration process. It applies to both Hybrid-to-Entra and Tenant-to-Tenant migration scenarios.

How to Install Opsole Migrate and Start Your Migration

1. Obtain the Installation Files

To begin, access the Opsole Customer Portal and navigate to the Settings > Downloads.
From there, download the latest Opsole Migrate setup file (MSI).

Launch Opsole Migrate

Proceed to the next section to deploy or install the application.

2: Deploy or Install the MSI File

Opsole Migrate is distributed as an MSI file that must be deployed to the target computer selected for migration.

Deployment Options

You can deploy the MSI file using any of the following methods:

  • Microsoft Intune
  • Group Policy Object (GPO)
  • Third-party MDM solutions or Remote Installation
  • Manual Installation

Important Requirements

Administrative Privileges: MSI deployment or installation requires an administrative privilege account on the target computer.


3: Launch Opsole Migrate

Once the MSI installation is complete on the target computer, you can access the application:

  • Open the Start Menu on the target computer
  • Type “opsole” in the search box

Launch Opsole Migrate

Click on Opsole Migrate from the search results
The application will launch with a Preparation Window

Launch Opsole Migrate


4: Start the Migration Process

Once the Opsole Migrate application opens:

  • Click the Start Prepare button in the Preparation Window
  • The application will initiate the preparation phase for device migration

Start the Preparation Process

The Opsole Migration Application Window will open
You will be greeted with a Welcome Wizard that guides you through the Pre-Requisite Check process

Start the Preparation Process

Step 2: Pre-Requisite Check

Click “Pre-Requisite Check” to begin validation.
The app checks system readiness, licensing, and device state.

Pre-Requisite Check

Step 3: Pre-Req Check Success

If all requirements are met, a “Check Passed” message appears.
Click Next to proceed.

Pre-Req Check Success

Step 4: Start Migration

Click Start Migration to begin.

Start Migration

Step 5: Initial Migration Phase

The application executes the initial migration steps.

If the Migration Configuration is Hybrid-to-Entra

  • The migration continues automatically without requiring any additional user input.

Initial Migration Phase

If the Migration Configuration is Tenant-to-Tenant

  • A prompt will appear requesting the target tenant user email address.

The migration user must have a valid user account in the destination (target) Microsoft Entra tenant.

Initial Migration Phase

Step 6: Initial Migration Phase Complete

Once complete, click Close to finish this phase.
The system automatically reboots to apply changes.
Note : This is expected and part of the migration workflow.

Initial Migration Phase Complete

Step 7: Migration Banner

Upon reboot, a banner will appear stating:
“Migration in progress. Do not log in. Please wait.”

After 2–3 minutes, The system will automatically reboot again to complete background migration steps..

Migration Banner

Note : At this stage, the user must not attempt to log in. Doing so may interrupt or break the migration process.

Step 8: Entra Login Prompt

After the second reboot, users are prompted to log in using Microsoft Entra ID credentials.

Based on the migration configuration, sign in using the appropriate Microsoft Entra ID account:

Enter the user email address and password.

Entra Login Prompt

Step 9: Resume Migration

Once logged in, the “Continue Migration” window appears.
Click Continue Migration to proceed.

Resume Migration

Step 10: Final Migration Phase

The application will process the remaining steps required to finalize the migration.

Final Migration Phase

Step 11: Migration Complete

A confirmation message appears:

“Migration Completed Successfully”

Click Close to finish.

Migration Complete


Step 12: Post-Migration Validation

Open the Microsoft Entra Admin Portal and verify:

  • The device appears under Devices
  • The status is listed as Entra Joined
  • Confirm the user profile and local data are intact.

The migration is now fully complete. The user can continue working without data loss or device reconfiguration.

How is this guide?