rvtools2azmigrate

Convert an RVTools export to an Azure Migrate CSV inventory file.

• Free software: MIT license

Features

• Convert an RVTools export to an Azure Migrate CSV inventory file
• Anonymize the VM data by replacing the hostname with UUIDs
• Filter powered-off VMs

Installation

Using PIP

pip install rvtools2azmigrate

From sources

The sources for rvtools2azmigrate can be downloaded from the Github repo.

You can either clone the public repository:

git clone git://github.com/lrivallain/rvtools2azmigrate

Or download the tarball:

curl -OJL https://github.com/lrivallain/rvtools2azmigrate/tarball/master

Once you have a copy of the source, you can install it with:

python setup.py install

or

pip install .

Usage

rvtools2azmigrate --help
# Output
Usage: rvtools2azmigrate [OPTIONS] COMMAND[ARGS]...

Options:
  --debug
  --help   Show this message and exit.

Commands:
  convert  Convert RVTools file to Azure Migrate format

Convert RVTools file to Azure Migrate format

rvtools2azmigrate convert --help
# Output
Usage: rvtools2azmigrate convert [OPTIONS]

Convert RVTools file to Azure Migrate format

Options:
  -i, --rvtools PATH  RVTools input file  [required]
  -o, --output PATH   Ouptut file  [required]
  --anonymized        Anonymize the output file by replacing VM names with UUIDs
  --filter-off-vms    Filter the powered-off VMs
  --filter-out TEXT   Filter out VMs based on the provided patterns (contains + case-insensitive)
  --help              Show this message and exit.

Examples

Anonymized

rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --anonymized

This will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs names will be replaced by their UUID to anonymize the content of the exported file.

Filter off VMs

rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv --filter-off-vms

This will provide a CSV file to be imported in Azure Migrate manual discovery section. Powered-Off VMs will not be exported to the CSV file.

Filter out VMs based on naming

It is possible to specify a list of patterns to filter out VMs based on their name.

rvtools2azmigrate convert -i rvtools.xlsx -o azuremigrate.csv \
  --filter-out pattern1 \
  --filter-out pattern2 \
  --filter-out pattern3

This will provide a CSV file to be imported in Azure Migrate manual discovery section. VMs with one of the pattern in their name will be filtered out and not part of the exported file.

History

0.2.0 (2024-05-21)

• Feat: Use python-slugify to generate VM names
• Feat: Filter out VMs based on name with --filter-out pattern1 --filter-out pattern2

0.1.3 (2023-10-11)

• Fix #2: Incorrect output if RV Tools input has a VM name with spaces in it

0.1.2 (2023-02-16)

• Fix import issue when used as installed module

0.1.1 (2023-02-03)

• Filter Powered-off VMs
• Automatic MiB/MB detection
• Intermediate RvToolsVM and AzMigrateVM objects

0.1.0 (2022-12-22)

• First release on GitHub.