Script_Prerequisites.md

VAMT Requirements

Table of Contents

• Prerequisites
  • PowerShell
  • Operating Systems
  • Platform
  • Access
  • Connectivity
• Setup
  • vCenter Tags
  • PowerCLI
  • Source Code

Prerequisites

In order to execute the VAMT, there are several prerequisite requirements. These requirements are outlined in the sections below.

PowerShell

This project has been built leveraging the following components:

• Windows PowerShell 5.1
• PowerCLI 12.6+

Operating Systems

• Microsoft Windows Server 2019
• Microsoft Windows 10

Note

The aforementioned operating systems have been confirmed, but any OS with Windows PowerShell 5.1 should suffice.

Platform

• VMware vSphere 7.0+

Note

The aforementioned version(s) have been confirmed, but earlier versions may also be compatible.

Access

• It is required to have Administrator access on the Windows OS where the script will be executed.
• It is recommended to have Administrator access in the vCenter(s) where the target VMs live.

Connectivity

• Ability to connect to your vCenter Server from your Windows OS using PowerCLI.
  • See: Connect to a vCenter Server System
• Ability to connect to your SMTP server from your Windows OS using PowerShell*
  • See: Send-MailMessage
• Ability to send syslog traffic to your syslog collector from your Windows OS*

Note

*Only required if using these features.

Setup

In order to execute the VAMT, there are configuration steps required in vCenter as outlined below.

vCenter Tags

• A Tag Category named VAMT must exist on each vCenter where target VMs live.
  • Single Cardinality required for the Category.
  • Scope on the Category should be VirtualMachine.
• The following tags must exist in the VAMT category on each vCenter:
  • complete
  • completeWithErrors
  • readyToMigrate
  • readyToRollback
  • inProgress
  • failed
  • rolledBack

PowerCLI

• PowerCLI should be installed and configured according to the documentation here: PowerCLI Installation Guide

Source Code

• Pull the VMwareArchitectureMigrationTool.ps1 script down to a location where you have read/write access on your Windows OS.
• Pull the VAMT.psm1 module down to the same directory where VMwareArchitectureMigrationTool.ps1 sits.