Installing VirtaMove Software

Owned by Thomas Farley (Deactivated)
Last updated: Mar 25, 2022
6 min read

Table of Contents

Installation Log File

The log file is created in the directory defined by your %temp% Windows Environment Variable. The log name is:

VirtaMove-64 Installation.log

Installation Location

By default, VirtaMove is installed in the system drive under:

Program Files\VirtaMove

VirtaMove cannot guarantee that the system root directory is "C:\".

Installing VirtaMove

Important:

Notes:

  • Review the requirements listed in https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/310542472.

  • To install and have full access to the VirtaMove solution, you must be logged in as the local "built-in" System Administrator (user with SID 500) or as an account with administrator privileges (for example, a member of an Administrator Group with SID 1001). For information about how to elevate permissions, see http://kb.macrium.com/KnowledgebaseArticle50132.aspx .

  • VirtaMove requires Microsoft .NET Framework 4. If Microsoft .NET Framework 4 is not installed on your destination machine, you will not be able to install VirtaMove software; the installer will stop.

  • The Source Agent installers (x86 and x64) are part of the main installation package (VirtaMove_x64.msi) of V-Migrate.

  1. Run VirtaMove_x64.msi.

  2. Click Next.

  3. Do any of the following:

    1. Click I accept the terms in the license agreement, and then click Next.

    2. Click I do not accept the terms in the license agreement to cancel the installation, and then click Cancel.

    3. Click Print to print the license agreement, and then save the file.

  4.  If you accept the terms, do any of the following:

    1. Click Next to install to the default folders.

    2. To select a different installation folder for VirtaMove software, click Browse, then specify a folder, click OK, and then click Next.

    3. To select a different folder for containers, click Change, then specify a folder, click OK, and then click Next.

  5. Generate a new security key for the VirtaMove Source Agent or select an existing security key file, and then click Next.

  6. Choose one of the following:

    • No Maestro connection - Does not make V-Maestro the CA.

    • Maestro connection certificates - Makes V-Maestro the CA, which generates the VirtaMove Micro SSL certificates and pushes them to the destination machine.

      If you select Maestro connection certificates, click Browse to select a Key, select a certificate, and select a CA Root Certificate. Click Next.

  7. Click Install to begin the installation.

  8. Click Finish to complete the installation.

The installer places three shortcut icons on your desktop:

  • VirtaMove CLI

  • Administrative Console

  • VirtaMove Web Documents

Installing VirtaMove on a Windows Server 2012 Destination Machine

When you run VirtaMove_x64.msi on a Windows Server 2012 machine that is not current with Windows updates, the following error may occur:

Running the universal C runtime update (KB2999226) by itself may not work.

To resolve this issue:

  1. Verify that the downloaded update is for the machine in question (for the same OS version and platform). Note that the update for Windows Server 2012 64-bit (Windows8.1-KB2999226-x64) may reference Windows 8.1, which is fine because Windows 8 and Windows Server 2012 may share the same update.

  2. Verify that Windows Update>Installed Updates does not indicate that KB2999226 is already installed.

  3. If both conditions above are confirmed, VirtaMove recommends that you first install pre-requisite updates on the machine:

    1. Go to Windows Update>Check for updates.

    2. Select all the Important Updates and install them.

  4. Restart the machine.

  5. Repeat steps 1, 2, and 3 until KB2919355 is installed.

  6. Install the Universal C runtime update (KB2999226).

  7. Run the VirtaMove destination installer again.

Installing VirtaMove Using the Silent Option

The executable program that interprets packages and installs products is Msiexec.exe.

Using the Quiet display option, the installer runs an installation without displaying prompts, messages, or dialog boxes to the user.

You must manually remove an existing older version of VirtaMove software using Windows Add/Remove Programs before you perform a silent installation.

You can also install VirtaMove Source Agent on a source machine using the silent installation option.

To Perform a Silent Installation

Note: The command prompt must be run as Administrator.

  • In a command prompt window, run one of the following commands:

  • msiexec /qn /i <PathToInstaller.msi>

  • msiexec /i <PathToInstaller.msi> /quiet

For more information about Msiexec.exe, see:

For Windows Installer 2.0 - https://msdn.microsoft.com/en-us/library/aa367988(v=vs.85).aspx
For Windows Installer 3.0 or higher - https://msdn.microsoft.com/en-us/library/aa372024(v=vs.85).aspx

For information about how to uninstall VirtaMove using the silent option, see https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/310706854.

Installing VirtaMove Source Agent and Source Monitor

Installing VirtaMove Source Agent

VirtaMove Source Agent is a high performance server that you install on a source machine. Source Agent is enabled by default; if you do not want to use a Source Agent, do not install it on the source machine. For more information, see https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311099405. The Source Agent installers (x86 and x64) are part of the main installation package (VirtaMove_x64.msi) of V-Migrate.

The Source Agent installers are located the VirtaMove installation location under the extras folder:

C:\Program files\Virtamove\Extras\sourceAgentResources\AgentInstallers\

Security Key

A security key is required for VirtaMove Source Agent. You can pass the security key file via command line while running the Source Agent Installer, or you can specify one when you run the VirtaMove Source Agent installer. If you don't already have a security key, generate one when you install VirtaMove software on the destination machine. The key file will be exported to:

C:\Program Files\Extras\SourceAgentResources\

The trusted storage files are located in the folder:

Note that the key storage technology in Windows Server 2003 machines is different than with Windows Server 2008. Windows Server 2003 machines use LSA secrets to store the encrypted version of the key. Windows Server 2008 and later machines decrypt the key and store the key in the key store. When storing the key on a Windows Server 2003 machine, the format of the key will not be verified. The format will be verified on Windows Server 2008 machines (and later) and the correct format will be successfully stored in the key store.

Pre-Requisites

  • Port 9665 needs to be open in order to establish a connection to the VirtaMove Source Agent on the source machine.

  • Install VirtaMove software on the destination machine. You will be prompted to generate a new security key for VirtaMove Source Agent when you do so.

MSI Log

MSI logging is handled by the Microsoft Windows operating system. By default, an MSI .log file will be created in the operating system's Temp folder when you install the VirtaMove Source Agent. For example:

Install VirtaMove Source Agent Using the Command Line

  1. Install VirtaMove software on the destination machine. The installer will prompt you to generate a security key for VirtaMove Source Agent or select an existing security file.

  2. Copy the security key locally or to a shared folder on the network or UNC path.

  3. In a command prompt window on the source machine, execute the following:

    where keyfile is a shared path to the key file (VirtaMove_Agent_Security_Key) generated on the destination machine. For example:

  4. Click Next.

  5. Click the I accept the terms in the license agreement radio button and then click Next.

  6. Click Next to accept the default installation folder or click Change to select a different folder.

  7. Click Install to begin the installation.

  8. Click Finish to exit the wizard.

Install VirtaMove Source Agent Using the Installer

The Source Agent installers (x86 and x64) are part of the main installation package (VirtaMove_x64.msi) of V-Migrate. They are located in the VirtaMove installation location under the extras folder:

c:\Program files\Virtamove\Extras\sourceAgentResources\AgentInstallers\

  1. Run VirtaMoveSourceAgent_x64.msi or VirtaMoveSourceAgent_x86.msi, as appropriate, on your source machine. Click Next.

  2. Accept the terms of the license agreement and then click Next.

  3. Accept the default installation folder or click Change to select a different folder, and then click Next.

  4. Click Browse to select a security key file for VirtaMove Source Agent. Select a file and click Open, and then click Next.

  5. Click Install. If a VirtaMove Source Agent security key already exists, it will be overwritten. Click OK to confirm that you want to overwrite it.

  6. Click Finish.

Installing VirtaMove Source Monitor

VirtaMove Source Monitor is part of VirtaMove Source Agent and is installed along with Source Agent when you run VirtaMoveSourceAgent_x64.msi or VirtaMoveSourceAgent_x86.msi.