Documentation Index

Fetch the complete documentation index at: https://docs.matildacloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Migrate Rehost OCI User Guide

  • Updated on May 21, 2026
  • Published on May 20, 2026
  • 7 minute(s) read
Prev

Lift and Shift of Servers

  • Identify and confirm the list of servers needs to be Rehost (Lift and Shift)

  • The Source server should meet the pre-requisites

    • Server OS version

    • Network connectivity between Source Server and MLS Central Server, Target Cloud Providers

Onboard Target Cloud Credentials to perform resource provisioning

  • Login on to MLS Lift & Shift Tool using credentials

  • Navigate to Cloud Profiles in the lefthand side, Click on "+ Add" Button on righthand side to create new profile

  • Choose Desired Target Cloud Platform – OCI and update details which are gathered using this document upper section. Validate and Save the details.

Screenshot of the Cloud Profiles screen showing a left navigation menu (Dashboard, Discover, Migration, Migration Settings, Cloud Profiles), a Cloud Profiles list in the background, and a centered Add Cloud Profile modal with form fields (Cloud Provider, Cloud Profile Name, User, Fingerprint, Tenancy, Key_file, Region, Tags) and action buttons including Validate and Save.

Onboard Target Cloud Credentials to perform resource provisioning

  • Once Network resources or provisioned or Exists, Navigate to Replication Settings in lefthand side, choose “+ Add” Choose to create new Replication Settings as OCI and update the respective details and click on Save button at the bottom

Screenshot of the Matilda Cloud 'Replication Settings' page showing the left-hand navigation (Migration Settings Replication Settings), the main Replication Settings table, and an 'Add Replication Setting' modal dialog open with fields like Cloud Provider (set to OCI), Name, Cloud Profile, Region, Storage Compartment, and Compute Compartment; the '+ Add' button in the top-right of the page is visible

Onboard Target Cloud Credentials to perform resource provisioning

  • Once Network resources or provisioned or Exists, Navigate to Launch Settings in lefthand side, choose “+ Add” Choose to create Launch Settings as OCI and update the respective details and click on Save button at the bottom

Screenshot of a cloud management UI showing a left navigation pane with Migration Settings and Launch Settings selected; a table of Cloud Profiles in the main area; and a centered Add Launch Setting modal dialog with fields for Cloud Provider (set to OCI), Name, Cloud Profile, Is Default toggle, Region, Storage Compartment, and Compute Compartment; top-right shows a + Add button and Refresh button.

Bulk Agent Installation

For Bulk agent installation we need to follow the below steps

  • Update the Bulk agent Import sheet

  • Create an Account Group

  • Import the sheet into MLS UI

Update the On-prem source server details on all the field marked as * (mandatory) in the import sheet like hostname, IP, OS Platform (Windows/Linux), MLS Account group, etc..

Import sheet can be downloaded from Matilda UI portal Discover tab

Screenshot of the top rows of the import spreadsheet showing header columns — Target Cloud Provider *, Application Name, Hostname (FQDN), IP Address * highlighted in yellow, Platform *, OS Name, OS Version, OS Bit *, CPU, RAM in GB, Storage Details in GB.

Screenshot of the import sheet lower section showing a form-style table with header row containing Application Name * in red, and adjacent columns Application Code, Application Tech SMEs, Support Level, Application Owner, Description, Location, Region with green-filled input cells below the headers.

Create an Account Group

  • In the Account Group page click on Add button to create a new account

Add Account

Account Group Name*

Screenshot of the Add Account form left panel showing the Account Group Name field with example link mls-acct-grp, a Linux section header with a yellow Linux/Tux icon, User Name label, radio options Password (selected) and PEM key, and a Password field with red outlined empty input boxes.

  • Provide the account group name and credentials for the source machine which will used by MLS for agent installation

  • Linux : For Linux we can provide the password or .pem key for authentication

  • Windows: For Windows, we have to provide the username and password

  • Click save

Import the sheet in MLS UI

  • Once the import sheet is updated and the account group is created, we can import the sheet in the MLS UI

  • Click on Discovery page and select Template Import

  • Sync from Discovery option will pull all the servers were successful Discovery is completed. User can select the required servers , attach the account group first and then initiate agent installation.

Screenshot of the MLS 'Discover' page — left sidebar with Matilda Cloud logo and menu, central server list with columns (Application Name, Host Name, IP Address, Operating System, Environment, Server Type, Account Group, Created On, Agent Installed On), and top-right action buttons showing an open dropdown with 'Template Import' highlighted in the Actions menu

  • User can download sample template from the Download Sample Template section

  • Template Import: Upload the import sheet.

  • We can select the option to install the agent and click on Submit.

Screenshot of the application Template Import page showing a left navigation with Discover, a main panel titled Template Import with an Upload button and text Upload Template File * only .xlsx file, an Install Agent option with Yes/No radio buttons (Yes selected), a highlighted Download Sample Template callout on the right, and a blue Submit button at the bottom.

  • Server details will be imported, and agent installation will begin

  • Once the agent installation is completed, we can see the status as success or failed in the agent installation Status

Screenshot of Matilda Cloud 'Discover' page showing a table of discovered servers. Visible columns include Application Name, Host Name, IP Address, Operating System, Environment, Server Type, Account Group, Created On, Agent Installed On, Status, and Actions. Several rows display statuses such as Agent Install Failed, Action Needed, and Agent Installed. Left navigation bar with items like Dashboard, Discover, Migration, Migration Settings, Logs, Global Settings, and Help is visible.

  • Once the agent installation is successful, we can see the Server details in the Servers page

Screenshot of Matilda Cloud Servers page — left navigation shows Migration Servers highlighted; main panel displays a table of discovered servers with columns such as Server Name, IP Address, Operating System, Environment, Cloud Provider, Snapshot Count, Migration Status, Scheduler, Tags, Created On, Last Updated, and Actions. Several server rows are visible (for example mccd-mlssource2, mccd-mlstest211, mccd-mlstest154) with IPs and OS entries like 172.24.6.150 and Ubuntu 22.04, and status badges reading Replication Completed or Ready for Replication. The top-right shows a Refresh button and a user menu labeled Migration Admin.

  • We can install the agent on specific servers from the Actions drop down.

  • If we want to change the account group on a specific server or delete the server from the Import page, we use the option from the Action drop down.

Screenshot of Matilda Cloud 'Discover' page showing the left navigation, a table of discovered servers with columns like Application Name, Host Name, IP Address, Operating System, Environment, Server Type, Account Group, Created On, Agent Installed On, and Status. The Actions dropdown is open in the top-right of the table with options Install Agent, Attach Account Group, and Delete.

Application

  • In the Application page in the MLS console click on the Add button to create a new Application Group

Screenshot of the MLS console Applications page. Left navigation shows Matilda Cloud logo and Applications highlighted. Main area shows a search bar and a table of applications (examples: QA, LIF-1479, Bulk_Testing_App) with status badges and a No Of Servers column. Top-right contains buttons + Add, Actions, and Refresh, and a Migration Admin user menu.

  • Provide the name of the Application, description, and other details and select the source servers mapped to the application.

  • Click save to create the Application

Screenshot of a cloud migration web UI showing an Add Application modal centered on the page. The modal contains labeled input fields including Name (required), Code, Owner, SME with an Add button, Location, Region, Support Level, a Select Servers dropdown, a Description text area, and Cancel and Save buttons at the bottom. The page background shows a left navigation pane with Applications highlighted and top-right action buttons such as Add, Actions, and Refresh. The modal is white with rounded corners and subtle shadow; the site header and table rows are visible dimmed behind the modal.

  • Once the Application is created we can Attach Migration Settings, Start Replication, Start and Stop the Target Instance, and Cutover from the action menu by selecting the servers .

  • These actions will be performed on all the selected servers in that application.

A screenshot of the Matilda Cloud Applications UI for the application Bulk_Testing_App. The left navigation panel shows icons and labels such as Dashboard, Discover, Migration, Servers, Applications, Waves, Migration Settings, Logs, Global Settings, and Help. The main content area displays a servers table with checkboxes in the first column and columns including Source Server Name, Source Server IP, Operating System, Environment, Migration Status, Cloud Profile, and Replication Setting. Multiple server rows are visible with sample names and IPs, OS icons (Red Hat, Ubuntu, CentOS, Windows), and green Ready for Replication status badges. On the right side of the table an Actions dropdown is open showing menu items: Attach Migration Settings, Start Replication, Start Target Instance, Stop Target Instance, and Cutover. A vertical scrollbar is visible at the far right of the page.

Wave

  • In the Wave page in the MLS console click on the Add button to create a new wave

Screenshot of the Matilda Cloud MLS console Waves page showing the left navigation sidebar with items like Dashboard, Discover, Migration, Servers, Applications and Waves highlighted; the main panel titled Waves with a search box, top-right buttons + Add, Actions, and Refresh; an empty table with column headers Wave Name, No Of Applications, Status, No Of Servers, Actions; and a centered No data available illustration.

  • Provide the name of the wave, description, select Applications, and provide the start and end date for the wave

  • Click save to create the wave

Modal dialog titled Add Wave centered on a Waves page. The modal shows fields labeled Wave Name, Description, an Applications dropdown labeled Select Applications, Wave Planned Start Date and Wave Planned End Date with mm/dd/yyyy placeholders, and Cancel and Save buttons. The background shows a left navigation menu with items like Dashboard, Discover, Migration, Servers, Applications, Waves, and page header with Add/Actions/Refresh buttons.

  • Once the wave is created we can Attach Migration Settings, Delete from the action menu by selecting the wave

  • These actions will be performed on all the application server inside that wave.

Screenshot of Matilda Cloud Waves page showing the Waves list with a selected wave named Test, an Actions dropdown menu expanded with options Attach Migration Settings and Delete, the Add and Refresh buttons on the top right, and the left navigation panel with Dashboard, Discover, Migration, Servers, Applications, Waves, and other items.

  • Once we start the replication from the wave or Application page, replication will be started on all the assets in the application. Wave and Application status will be changed to in progress.

Dashboard screenshot of Matilda Cloud Applications page. Left sidebar menu shows Applications selected under Migration. Main panel displays application header fksg with server count and a red Agent Install Failed status badge at top-right. Below is a servers table with columns including Source Server Name, Source Server IP, Operating System, Environment, Migration Status, Cloud Profile, Replication Setting, Launch Setting, Scheduler, Target Instance Name, Target Instance IP, and Last Synced. Several rows show servers like mccd-milstest3 (172.24.8.74) with Windows Server 2022 Standard and green Replication Completed badges, mccd-milstest55 (172.24.8.165) with Redhat 8.10 and a Replication Completed badge, and others showing Cutover Completed. Action buttons Actions and Refresh appear at the top-right of the table area.

Manual Agent Installation

  • If User wish to Install Matilda Agent manually on the Source server, need to follow below manual steps

  • After manual Agent Installation, User can perform Attaching Migration Settings, Replication, Virtualization and Cutover from Server Page or If the Server is associated with any Application user can perform all Migration Activities from Application page as well

Linux Manual Agent Installation: Login into the source server to install the MLS agent

  • Login into the source server through putty/mobaxterm using IP address or host FQDN Name with key/password

Terminal screenshot showing a mobaxterm/ssh session with the prompt, last login line and an ssh command using a .ppk key; dark terminal background with colored prompt elements

  • Download and install the agent

  • Run the below command to download the agent

  • curl -k https://<Matilda Server IP>/agents/matildacloudagent -o matildacloudagent; chmod +x matildacloudagent; md5sum matildacloudagent

Red-bordered terminal screenshot showing the curl command execution, transfer progress and md5sum output for matildacloudagent on a root@ prompt

Install the MLS Agent & Register to Matilda Server

  • After download run the below command to install the agent.

  • ./matildacloudagent -i -s <Matilda Server IP> -a <License Key> -p <Source Server IP>

[IMAGE PLACEHOLDER: Terminal screenshot showing the command './matildacloudagent -i -s <Matilda Server IP> -a <License Key> -p <Source Server IP>' executed as root, followed by installation logs including 'Pre Checks Start', a partitions table, service creation messages like 'Service matildacloud has been created and enabled', instructions for starting/stopping the agent with systemctl, and the message 'Agent installation completed successfully'.]

Review the registered source server details

  • Review the source server details and click on the server to register for target cloud

Screenshot of a cloud migration Servers page. Left navigation shows matilda cloud logo and menu items including Dashboard, Discover, Migration, and Servers (Servers is highlighted). Main content displays a Servers table with columns such as Server Name, IP Address, Operating System, Environment, Cloud Provider, Snapshot Count, Migration Status (green Ready for Replication badges), Scheduler, Tags, Created On, Last Updated, and Actions. A server entry mccd-mlstest154 in the list is emphasized with red outline. Top-right shows a Refresh button and a Migration Admin avatar; bottom shows pagination controls.

Register the server to be replicated to Target Cloud OCI

  • Goto the Settings Tab, under Cloud Configuration select Cloud Profile, Replication Settings, Launch Settings with Target Cloud as OCI

  • Click on Save Configuration button to save settings

  • After saving click on “Sync” Button at right corner to initiate the replication job

Screenshot of Matilda Cloud server page showing the selected server header and left navigation. The Settings tab is highlighted, and the Cloud Configuration panel is outlined showing Cloud Profile, Replication Settings, and Launch Settings fields. A blue Save Configuration button is highlighted, and the Sync button at the top-right is boxed in red.

Monitor the Replication Job

  • Monitor the replication status from the Jobs section until successfully completes 100%

Screenshot of the Matilda Cloud Servers page showing the Jobs tab selected; a replication job row is visible with the Completion(%) column highlighted in red

  • Once Replication completes, Go to Snapshots Tab, under Available Snapshots section snapshot will get created

Screenshot of the Matilda Cloud Snapshots tab with the Available Snapshots section highlighted and a snapshot entry shown in the table

Initiate the Target Cloud Server

  • Once the Replication got completed Snapshots will be created in this section as Recovery Points

  • Go to Settings Tab and Choose the desired configuration Values as per organization standards from Virtualization section

Wide screenshot of a cloud management UI (Matilda Cloud) showing the Servers page. Left navigation shows Servers and Migration items. The top tab Settings is highlighted and the Virtualization subsection is outlined. The right-side panel displays virtualization settings form with a large red rectangle highlighting the VM shape/instance selection and other fields (CPU Count, Memory, Availability Domain, Network Security Groups). A second red rectangle highlights a Save Settings button near the bottom. The UI shows a Public IP toggle and a Storage Volumes section/table with volume fields visible near the lower portion of the screenshot.

Public IP

Storage Volumes

Volume Name

Target Volume Name

Source Size (GB)

Target Size (GB)

Save Settings

Initiate the Target Cloud Server

  • When we click on Start Button Target Server will get create from the snapshot

  • Wait until the process completes and provides the status of the Server with IP Details

A cloud management console screenshot showing the Matilda Cloud Servers page. The Launch Instance Details panel is visible with fields like Target Instance Name, Target Instance Type/Shape, Region, and a red-outlined box highlighting the Target Instance Public IP and Target Instance Private IP. Lower in the screenshot a snapshots table is visible with a row showing a blurred Target Instance IP, along with a Stop button, status badge Ready For Cutover, and action icons. Left sidebar shows navigation items such as Dashboard, Discover, Migration, Servers, Applications, Waves, Migration Settings, Logs.

Complete the Migration

  • Manage the Cloud Server using the IP provided in Snapshot Section.

  • Validate the server functionality

  • Click on “Cutover” Button to complete the migration (no further backups allowed or RPO allowed)

Matilda Cloud server UI screenshot showing left navigation and Server: mccd-mlstest154 header; the Cutover button is outlined in a red box on the top-right of the server details panel, with lifecycle/replication/test indicators and IP address visible

  • When we click on Cutover Button new window will popup, Cut Over can be performed with or with out stopping source server.

Cutover Confirmation modal screenshot over the server UI showing a yellow warning box listing actions performed on confirm, a Shutdown the Source VM toggle, and the Confirm button highlighted in a red box

Manage the Cloud Server

  • Once cutover is done, the server can be managed from OCI portal

  • Note down the IP from MLS tool or from OCI portal and access the server.

  • Post Migration Server will be moved from Discovered tab to Migrated tab

A Matilda Cloud portal screenshot showing the Servers page with the Migrated tab selected (highlighted in red). The server list row visible shows Server Name mccd-mlstest154, IP Address 172.24.7.85, Operating System Redhat 8.10, Environment and Cloud Provider icons, Snapshot Count 1, Migration Status badge Cutover Completed, a Refresh button on the right, Created On 5/6/2026, 5:13:43 PM, and Last Updated 5/14/2026, 12:13:14 PM.

Windows Agent Installation:
Login into the source server to install Drivers & Agent

  • Login into the source server through RDP using IP address with password

  • For OCI Target first download and install the Oracle Virtio Drivers.

  • curl https://<Matilda Server IP>/agents/OracleVirtIO-Driver.zip -o OracleVirtIO-Driver.zip (OR)

  • Open browser and use https://<Matilda Server IP>/agents/OracleVirtIO-Driver.zip url to download

  • Extract and install Driver.

PowerShell window showing curl commands to download Oracle VirtIO driver and Matilda cloud agent; blue background with highlighted command text inside a red rectangle

Oracle Windows VirtIO Drivers installer screenshot showing Install button and installer graphics

InstallShield Wizard Complete screenshot showing option No, I will restart my computer later. and Finish button highlighted

Install Agent:

  • Run below commands to download & install the agent

  • curl https://<Matilda Server IP>/agents/matildacloudagent.exe -o matildacloudagent.exe (OR)

  • Open browser and use https://<Matilda Server IP>/agents/matildacloudagent.exe url to download

  • .\matildacloudagent.exe -i -s <Matilda Server IP> -a <License Key> -p <Source Server IP>

PowerShell console screenshot showing execution of the MatildaCloud agent installer. The top command highlighted in a red box reads .\matildacloudagent.exe -i -s mlsdev.matildacloud.com -a cd50cdd1e7a08c5e30ec41137010518c87c7467d4cc4144c. The console shows pre-checks, validated authentication, an ASCII partition table (columns: NAME | FILESYSTEM | PARTITIONSIZE | FREESIZE | MOUNTPOINT | ISLVM | DISK), and messages indicating Agent Installation Start and successful registration to mlsdev.matildacloud.com.

Register the server to be replicated to Target Cloud OCI

  • Go to the Settings Tab, under Cloud Configuration select Cloud Profile, Replication Settings, Launch Settings with Target Cloud as OCI

  • Click on Save Configuration button to save settings

  • After saving click on "Sync" Button at right corner to initiate the replication job

Screenshot of Matilda Cloud Servers view. Left navigation shows Servers highlighted; top server list displays server name mccd-mlstest174 highlighted with IP address 172.24.7.105, Operating System Windows Server 2019 Standard Evaluation, Cloud Provider OCI, Migration Status showing Replication Completed, and the Sync button highlighted in the top-right actions area.

Screenshot of Matilda Cloud Settings for a server. The Settings tab is selected with Cloud Configuration section expanded and a red outline around the Cloud Profile, Replication Settings, and Launch Settings fields. A Save Configuration button is visible and highlighted at the bottom of the configuration panel.

Monitor the Replication Job

  • Monitor the replication jobs until successfully completes 100%

Matilda Cloud web console screenshot showing a Server details page. The top navigation shows Servers and the Jobs tab is highlighted with a red box. In the jobs table the Completion(%) column is highlighted and shows a value of 100. The left sidebar menu with Dashboard, Discover, Migration and Servers is visible.

  • Once Replication completes, Go to Snapshots Tab, under Available Snapshots section snapshot will get created

Matilda Cloud Snapshots tab screenshot showing the Snapshots tab highlighted and the Available Snapshots section boxed in red. The snapshots table is visible with a snapshot entry and an Operation column showing a blue Start button highlighted. The left sidebar and top server details header are visible.

Initiate the Target Cloud Server

  • Once the Replication got completed Snapshots will be created in this section as Recovery Points

  • Go to Settings Tab and Choose the desired configuration Values as per organization standards from Virtualization section

Screenshot of Matilda Cloud Servers Settings page. The left navigation and the Settings tab are visible, with the Virtualization section highlighted. A virtualization settings panel is shown on the right with a red outlined box around shape/CPU/memory/availability domain and network security groups selection. Below, the Storage Volumes table is visible and a blue Save Settings button is highlighted.

Intiate the Target Cloud Server

  • When we click on Start Button Target Server will get create from the snapshot

  • Wait until the process completes and provides the status of the Server with IP Details

Screenshot of Matilda Cloud Servers page showing the Launch Instance Details panel. Visible fields include Target Instance Name mccd-mlstest174, Target Instance Type/Shape VM.Standard.E3.Flex, and Region US-ASHBURN. A red highlighted box emphasizes the Target Instance Public IP, Target Instance Private IP, and Target Instance ID. The lower portion of the screenshot shows the Available Snapshots table with a snapshot row and the Target Instance IP column highlighted and masked, plus UI controls such as a Refresh button and a search field.

Complete the Migration

  • Manage the Cloud Server using the IP provided in Snapshot Section.

  • Validate the server functionality

  • Click on “Cutover” Button to complete the migration (no further backups allowed or RPO allowed)

Screenshot of Matilda Cloud server details page showing server name mccd-mlstest174 with the Cutover button highlighted in a red box

  • When we click on Cutover Button new window will popup, Cut Over can be performed with or with out stopping source server.

Cutover Confirmation popup over the Matilda Cloud UI showing options including Shutdown the Source VM toggle and a Confirm button highlighted

Manage the Cloud Server

  • Once Cutover is done, the server can be managed from OCI portal

  • Note down the IP from MLS tool or from OCI portal and access the server.

  • Post Migration Server will be moved from Discovered tab to Migrated tab

Screenshot of a cloud management UI (Matilda Cloud) showing the Servers page with the Migrated tab highlighted in a red box; left sidebar with Dashboard, Discover, Migration and Servers; a search field; a server row visible with server name mccd-mlstest154, IP address 172.24.7.85, Operating System Redhat 8.10, Snapshot Count 1, Migration Status labeled Cutover Completed, and columns for Environment, Cloud Provider, Scheduler, Created On and Last Updated.

Related articles