# VM Migration Tool (Add-on)

## Introduction

VM Migration Tool is an add-on stand alone utility provided by Trilio for effective migration of VMs from VMWare to OpenStack. This will assist users in planning the migration, creating any missing artifacts, and providing a holistic view of the migration process at an organizational level.

Current document provides the steps to be followed for deploying respective tool.

## 1] Pre-requisites

A Linux VM *(CentOS OR Ubuntu will do)* with `docker` installed on it.

## 2] Prepare working dir and contents

2.1] Clone public repository triliovault-cfg-scripts on the standalone VM (at any convenient location) created for deploying the VM Migration tool.

```
git clone -b {{ trilio_branch }} https://github.com/trilioData/triliovault-cfg-scripts.git
```

{% hint style="info" %}
For actual value {{ trilio\_branch }}, please refer resources page against respective release.
{% endhint %}

2.2] On the VM, copy nginx, env, docker-compose.yml & vmosmapping.conf from triliovault-cfg-scripts to /opt directory.

```
cp -r triliovault-cfg-scripts/migration-vm2os/nginx /opt
cp triliovault-cfg-scripts/migration-vm2os/env /opt
cp triliovault-cfg-scripts/migration-vm2os/docker-compose.yml /opt
cp triliovault-cfg-scripts/migration-vm2os/vmosmapping.conf /opt
```

2.3] Set values against params in /opt/env file.

| Parameter          | Description                                                                              | Sample/Default Value                |
| ------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------- |
| TRILIO\_IMAGE\_TAG | Tag of the image as provided by Trilio. Refer resources page against respective release. | trilio/trilio-migration-vm2os:5.2.4 |
| NGINX\_PORT        | Port on which nginx should run. Please ensure that the port is free.                     | Default : 5085                      |
| REDIS\_PORT        | Port on which redis should run. Please ensure that the port is free.                     | Default : 6379                      |

2.4] Set values against params in /opt/vmosmapping.conf file.

| Parameter       | Description                                                                                                                                                           |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| host            | vCenter host address from where VMs have to be migration into OpenStack.                                                                                              |
| admin           | Admin user login name for vCenter                                                                                                                                     |
| password        | Admin user password for vCenter                                                                                                                                       |
| ssl\_verify     | To be set to True or False as needed                                                                                                                                  |
| keystone\_url   | Keystoner URL of the OpenStack where VMs from vCenter have to be migrated                                                                                             |
| admin\_user     | Admin user login name for OpenStack                                                                                                                                   |
| admin\_password | Admin user password for OpenStack                                                                                                                                     |
| admin\_project  | Project/Tenant of OpenStack                                                                                                                                           |
| admin\_domain   | Domain of OpenStack                                                                                                                                                   |
| region\_name    | Region of OpenStack                                                                                                                                                   |
| ssl\_verify     | To be set to True or False as needed                                                                                                                                  |
| hypervisor      | To be set as "RHEL 9"                                                                                                                                                 |
| username        | OpenStack user which is having same role as the user *`(having trustee role)`* mentioned in wlm.conf file. This will be used to log into VM Migration Tool Dashboard. |
| email           | Email of the VM Migration Tol user                                                                                                                                    |
| password        | password for logging into VM Migration Tool Dashboard                                                                                                                 |

## 3] Deploy VM Migration Tool

3.1] To deploy the VM Migration Tool on standalone VM, please execute below command in background mode.

```
docker compose -f /opt/docker-compose.yml --env-file /opt/env up &
```

3.2] Deployment checks

* Run `docker ps -a` ; 4 containers should be running, viz redis, nginx, trilio\_vm2os & opt-worker-1.
* Sample output below *(Forwarded port number can be different as per the value provided in `/opt/env` file)*

```
CONTAINER ID   IMAGE                                              COMMAND                  CREATED         STATUS         PORTS                                               NAMES
1ed651c084d4   nginx:latest                                       "/docker-entrypoint.…"   5 seconds ago   Up 3 seconds   80/tcp, 0.0.0.0:5085->5085/tcp, :::5085->5085/tcp   nginx
8ff9f81b9913   trilio/trilio-migration-vm2os:5.2.3-dev-maint3-3   "gunicorn --config g…"   5 seconds ago   Up 4 seconds                                                       trilio_vm2os
1f91f14ad011   trilio/trilio-migration-vm2os:5.2.3-dev-maint3-3   "celery -A run.celer…"   5 seconds ago   Up 4 seconds                                                       opt-worker-1
0bb5574ad56b   redis:latest                                       "docker-entrypoint.s…"   5 seconds ago   Up 4 seconds   0.0.0.0:6379->6379/tcp, :::6379->6379/tcp           redis
```

## 4] Access Tool Dashboard

Respective Migration tool can be accessed with URL : \<VM\_IP>:\<NGINX\_PORT> Example

```
http://192.168.6.25:5085/
```

For logging into dashboard, use the credentials provided under \[user] section in `/opt/vmosmapping.conf` file


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trilio.io/openstack/t4o-5.x/deployment/software-driven-migration-vmware-to-openstack/vm-migration-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.