Migrating VMs to a Red Hat OpenStack Platform deployment

Procedure

1. Check VMware Tools status:

   1. On the vSphere Client, select the VM and click the Summary tab.
   2. Verify if the status of VMware Tools is Running or OK.
   3. (Optional) If the status of VMware Tools is Not installed or Not running, right click the VM, select Guest OS, Install VMware Tools, and follow the VMware Tools installation process for the guest OS.
2. Power off the VM.

3. Edit the VM settings and set the stkEnabled parameter to TRUE:

   ctkEnabled = TRUE

4. Set ctkEnabled = TRUE for each disk on the VM:

   scsi0:0.ctkEnabled = TRUE
   scsi0:1.ctkEnabled = TRUE
   scsi0:2.ctkEnabled = TRUE
   ...
   ...

5. Power on the VM.

Procedure

1. Create a conversion host instance by following the instructions in Creating an instance in the Creating and managing instances guide.
2. Attach a floating IP to the conversion host instance following the instructions in Assigning a specific floating IP in the Managing networking resources guide.
3. Log in to the conversion host as a cloud-user with the SSH key you created when you created the conversion host.

4. Register your system either with the Red Hat Content Delivery Network (CDN) or with Red Hat Satellite. To register with CDN:

   [cloud-user@conversion_host ~]$ sudo subscription-manager register

5. Install the VMware SDK library and ensure that you have root ownership.

Procedure

1. Create the main execution environment configuration file:

   $ cat <<EOF> execution-environment.yml
   ---
   version: 3
   
   images:
     base_image:
       name: registry.redhat.io/ansible-automation-platform-25/ee-minimal-rhel9:latest
   
   options:
     package_manager_path: /usr/bin/microdnf
   
   dependencies:
     ansible_runner:
       package_pip: ansible-runner
     ansible_core:
       package_pip: ansible-core
     python: requirements.txt
     system: binddep.txt
     galaxy: requirements.yml
     python_interpreter:
       package_system: "python3.11"
       python_path: "/usr/bin/python3.11"
   additional_build_files:
     - src: ansible.cfg
       dest: .
   additional_build_steps:
     prepend_base:
       - "RUN mkdir -p /etc/sudoers.d"
       - "RUN echo 'cloud-user ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/cloud-user"
   EOF

2. Create the Python dependencies file:

   $  cat << EOF > requirements.txt
   requests
   pyVim
   pyVmomi
   EOF

3. Create the Ansible collections requirements file:

   $ cat << EOF > requirements.yml
   collections:
     - name: vmware.vmware
       version: 2.4.0
     - name: vmware.vmware_rest
       version: 4.9.0
     - name: os_migrate.vmware_migration_kit
       version: <collection-version>
   EOF

   where:

   <collection-version>

   Specifies the version number that you want to use, such as "2.2.3".

4. Create the system package dependencies file:

   $ cat << EOF > binddep.txt
   openssh-clients
   sshpass
   python3
   python3-pip
   python3-dnf
   rsync
   gcc
   python3-devel
   git
   EOF

5. Create the ansible.cfg configuration file using your offline token file:

   $ cat << EOF > ansible.cfg
   [galaxy]
   server_list = automation_hub
   
   [galaxy_server.automation_hub]
   url=https://console.redhat.com/api/automation-hub/content/published/
   auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
   token=<your_console_redhat_com_token>
   EOF

6. Log in to podman to authenticate:

   $ podman login registry.redhat.io

7. Build the AEE image:

   $ ansible-builder build --tag vmware-migration-kit:latest

8. Publish your execution environment to Ansible Automation Platform or any other registry by following the instructions in Publishing an automation execution environment in the Creating and using execution environments Red Hat Ansible Automation Platform guide.

Procedure

1. From the navigation panel, select Automation Execution, Infrastructure, Credentials.
2. Click Create Credentials.

3. Set the following parameters:

   Name: Bastion key
   Credential Type: Machine
   Username: cloud-user
   SSH Private Key: key image

4. Click Create Credential.

Procedure

1. From the navigation panel, select Automation Execution, Infrastructure, Inventories.
2. Click Create Inventory, Create Inventory.

3. Set the following parameters:

   Name: Conversion Host Inventory
   Organization: Default

4. Click Create Inventory.

Procedure

1. Create the conversion host:

   1. From the navigation panel, select Automation Execution, Infrastructure, Hosts.
   2. Click Create Host.

   3. Set the following parameters:

      Name: conversion_host
      Inventory: Conversion Host Inventory
      Variables:
      ansible_ssh_user: cloud-user
      ansible_host: <IP_or_hostname> 

      1

      1

      Replace <IP_or_hostname> with the IP address or hostname of your Ansible host.

   4. Click Create Host.

2. Create the migrator host.

   1. From the navigation panel, select Automation Execution, Infrastructure, Hosts.
   2. Click Create Host.

   3. Set the following parameters:

      Name: migrator
      Inventory: Conversion Host Inventory
      Variables:
      ansible_connection: local
      ansible_python_interpreter: '{{ ansible_playbook_python }}'

   4. Click Create Host.

Procedure

1. From the navigation panel, select Automation Execution, Infrastructure, Execution Environments.
2. Click Create Execution Environment.

3. Set the following parameters:

   Name: VMware migration toolkit Execution Environment
   Image: <insert the image that pushed to a repository when you built automation execution environment image>

   • Click Create Execution Environment.

Procedure

1. From the navigation panel, select Automation Execution, Projects.
2. Click Create Project

3. Set the following parameters:

   Name: VMware migration toolkit project
   Organization: Default
   Execution Environment: VMware migration toolkit Execution Environment Environment
   Source Control Type: Git
   Source Control URL: https://github.com/os-migrate/vmware-migration-kit
   tag:"v2.1.0"

4. Click Create Project.

Procedure

1. From the navigation panel, select Automation Execution, Templates.
2. Click Create Template, Create Job Template

3. Set the following parameters:

   Name: Migration
   Inventory: Conversion Host Inventory
   Project: VMware migration toolkit project
   Playbook: playbooks/migration.yml
   Execution Environment: vmware migration toolkit Execution Environment
   Credentials: Bastion key
   Extra Variables: <Add your extra variables here, such as myvars.yml and secrets.yml>

4. Click Create Job Template.

Procedure

1. From the navigation panel, select Automation Execution, Templates.
2. Locate the Migration Job template.
3. Click the rocket icon to launch the migration.