IBM Cloud Docs
IBM Cloud classic bare metal to classic bare metal migration

IBM Cloud classic bare metal to classic bare metal migration

RackWare Management Module (RMM) solution simplifies the overall migration process of moving the operating system, applications, and data from one bare metal server to another in the IBM Cloud® classic environment. The migration can occur either over the public or private interface of the compute resource. The only requirement is that RMM must be able to access both source and target server over SSH.

Objectives

  • Prepare the source and target servers
  • Learn what is needed for the supported network topology
  • Learn how to use the RMM solution

Limitations

  1. Encrypted volumes are not supported.
  2. Do not modify the target. If anything is modified out of control of RMM after the first migration, it can be wiped out and the result can be unexpected.
  3. The RMM solution handles only the OS, application, and data movement, so anything else needs to be set up by you (for example, security groups, subnets, and so on).
  4. For data migration, File Storage for Classic is not supported. You can use third-party tools such as rsync for data migration on block and file.

Supported operating systems

  • CentOS 7.8, 7.9

  • RHEL 7.2, 7.3, 7.4, 8.1

  • Ubuntu 18.04, 20.04

  • Debian 9.x, 10.x

  • Windows 2012, 2012R2, 2016, 2019

Supported topology

Migration can be done either over the public or the private interface. While RMM uses SSH to communicate with the servers, migrate by using the private address. In addition, you get to use IBM's network during migration over the private interface.

Because RMM is deployed in IBM Cloud VPC, it requires a transit gateway for the RMM to communicate with the source and the target server over the private interface. The source and target server also need to be able to communicate with one another.

If the source and target server do not have direct communication, then use the pass-through method of data transfer. The RMM server acts as a proxy, and the migration flows through the RMM server. RMM does not store a copy of the used data from source hosts.

To create an IBM Cloud Transit Gateway and establish a connection between classic and VPC, review the following information:

For transit gateway and classic, you need to follow two steps:

  1. Enable VLAN spanning to allow communication between subnets and data centers in classic. For more information, see VLAN spanning.

  2. To allow communication between VPC and classic, both transit gateway and enabling VRF in classic are necessary. For more information, see Planning for IBM Cloud Transit Gateway.

Topology
Figure 1. Network topology of RMM and bare metal migration

This architecture diagram is applicable for bare metal to virtual server and virtual server to virtual server scenarios.

Before you begin

  1. For each volume on the source server, 20 percent of the unused space must be available to store the snapshot that is created by RMM.

  2. Copy the RMM SSH public key to both the source and target.

    a. This process can require modifying the servers' host route table or security rules.

    b. Update the name server or DNS.

  3. The order of the target server, the CPU, and memory does not need to match, but the volumes must be equal or greater than the source.

  4. Make sure to have /etc/fstab entry for automatic mounting of any file system on the target server.

Order RMM

The RMM tool is available in the IBM Cloud catalog. After you order, a virtual server with RMM software is installed into your VPC of choice. The RMM server has a public IP address for reachability and a default login.

If public IP address is not attached to RMM server, then its 'Reserved IP' address can be used to access RMM server with bastion host.

  1. Order the RMM server from the IBM Cloud catalog.

  2. After you order, log in to the RMM server.

  3. In the RMM server, change the default password, create users, and create an SSH key.

  4. Upload the SSH key to IBM Cloud VPC.

Order a license

The license required for migration to IBM Cloud is Bring Your Own License (BYOL). You need to purchase the license directly from RackWare.

Follow these steps to get a license:

  1. Order your license from RackWare.

  2. Run the following command on the RMM CLI to generate a preinstall file:

    rwadm relicense
    
  3. After the preinstall file is generated, send a license generation request to the RackWare licensing team with the following information:

    a. RMM license (subject line)

    b. Company name

    c. License count

    d. Preinstall file (attached)

    e. Purchase order (attached)

  4. Install the license.

    a. After the valid license is received, download the license file and place it in /etc/rackware. Restart the services to apply the license by running the following command:

    rwadm restart
    

    b. Verify the license by running the following command:

    rw rmm show
    

Prepare source and target servers

Before you can begin, you need to do a few things on the source and target device for the migration:

  1. The RMM server needs to connect with servers that use SSH; thus the RMM public SSH keys need to be copied on both the source and target servers.

  2. If the source device has both public and private interfaces, host routes need to be added to ensure the communication between the source and target servers. The routing is done over the transit gateway path. Complete the following steps to prepare your relevant servers:

Linux systems

Copy RMM SSH public key to both the source and target servers.

Windows systems

  1. Copy the RMM SSH public key to both the source and target servers.
  2. You need to download the SSH key utility. You can download it from the RMM server: https://<RMM IP>/windows/RWSSHDService_x64.msi
  3. You are SYSTEM, and you need to key in the RMM SSH key to authenticate for both the source and target servers.

Set up RMM waves

You can migrate servers over one-by-one or perform simultaneous migrations. If you are performing multiple, simultaneous migrations, download the CSV template from the RMM server and complete the appropriate fields.

  1. Log in to the RMM server.
  2. Create a Wave and define the Wave name.
  3. If you have multiple hosts, download the template, complete the appropriate fields, and then upload the template.
  4. Select the Wave name to enter source and target information.
  5. Select the "+" sign.
  6. Add source IP address or FQDN and add source username.
  7. Target Type = Existing system
  8. Sync Type = Direct sync
  9. Add a target IP address or FQDN.
  10. Add a target-friendly name, and add a target username.
  11. Start the migration.

The username field for Linux environments is root. The username field for Windows environments is SYSTEM.

Migrate

  1. After the source and target host are added in the wave and replication record, click the Sync Options tab. Select the No Transfer option, and click Modify. Then, click the play icon Play icon to start replication. This action performs a dry run by checking the connection between the RMM, the source, and the target servers. This action doesn't migrate data. If the operation is successful, then remove the No Transfer option that uses the same process.

  2. Whenever you are ready, go ahead and click start replication (the play icon Play icon). This action starts the actual migration. If you expand the replication record, it displays the actual steps as they are run in summary with necessary information.

  3. Whether the operation is successful or not, you can see the job history in the replication record.

  4. If the operation failed, you can retrieve the log and review detailed information.

To improve data transfer rate, adjust bandwidth allocation of RMM server. To know how to change bandwidth allocation, see Adjusting bandwidth allocation by using the UI.

Validate your migration

After your migration, validate the target server. The following list is not exhaustive, but suggests some of the items to validate:

  1. Access the target server.
  2. Check partitions and volumes.
  3. Check applications.
  4. Install any test application in the target server.
  5. Check networking routes.
  6. Check or update application or operating system licenses.
  7. Remove RMM SSH key.

Help and support