Migrating an Application Using the VirtaMove Administrative Console

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

Important:

To Migrate an Application

  1. Double-click the Administrative Console desktop shortcut icon on your desktop or click Start>VirtaMove>Administrative Console. Administrative Console opens.

  2. Click Application>Create Empty VAA. In the VAA Name field, enter the full path and name of the container you want to create. Spaces in the pathname are not permitted. For example, C:\appliances\<container>, where <container> is the name of the container. Click OK.

  3. Go to the Tether tab and check the Use Tether checkbox.

  4. In the Source Name field, specify the IP address or name of the source machine you want to connect to. Specify only an Administrator account.

    • Alternatively, click the Query Network button to display a list of machines on your network, and then select a machine and click OK to populate the Source Name field. If a source machine has a VirtaMove Source Agent installed on it, the Remote Discovery window will display Yes in the Source Agent column. You can sort the list by selecting a column heading to sort by.

      If you specified a source machine that has a Source Agent installed on it, the User Name field and the Password field are automatically filled in when you click away from the Source Name field. A green checkmark and "Source Agent" are displayed to the right of the Source Name field. Go to step 7.

      If you did not specify a source machine with a Source Agent, go to step 5.

  5. In the User Name field, type the username of the local administrator account on the source machine you specified in the previous step. The default username is Administrator.

  6. In the Password field, type the password of the local administrator account on the source machine.

  7. Run an Audit of the source and destination machine by clicking the Run Audit button. If credentials fail or pre-requisites have not been met for tethering, an error message is displayed at the bottom of the Administrative Console window. To scroll through messages, click the Back or Forward button on the left or right of the message bar. You can view the Audit Report by going to the Appliance Logs tab to determine what the problem is.

  8. Click the Find Applications button. VirtaMove retrieves all remote applications, services, and user/group account information and displays this information in the tabs in the bottom half of the Tether window.

  9. In the Source Products tab, review the list of source applications. Select the product or products you want to migrate. When you click away from the list, VirtaMove Tether automatically selects all user/group accounts, services, and executables associated with the installed application and displays these in the Source Services and Source Accounts tabs.

  10. Click the Source Services tab and review the remote services that were automatically selected for the container. Select services as appropriate.

  11. Navigate to the Services tab at the top of the Administrative Console. Edit the User Name and Password for a service as appropriate. Note that you are setting a password only; VirtaMove does not validate a password against the original password associated with the source machine. You cannot edit passwords after you click Dock. Service User Names must be in the format domain\uid, where uid is the user identifier. This is a restriction of the Microsoft Win32 functions for working with the Service Control Manager (SCM), which is used by VirtaMove.

    • If you select a service and the service is "Started" on the source machine, tethering will not succeed. Stop the service before tethering by right-clicking the service and then selecting Stop Source Service.

    • If you select a service and the service already exists on the underlying operating system, the Source Status column will display "CONFLICT". Resolve the conflict and then press F5 to refresh the list.

    • If you hover over a service in the list, a tooltip will display which selected service, if any, requires this service.

  12. Optionally, specify a https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311263613/Config-on-the-Fly?search_id=455f9363-b473-4001-8b90-b0716c73ee77 (COTF) file. By default, VirtaMove loads the standard COTF file (C:\appliances\<container name>\COTF\StandardCOTF.xml) and passes to the file the source name you specified in step 3. You can specify a customized COTF file, for example, MyCustomCOTF.xml or ipCOTF.xml.

    VirtaMove supports paths that are relative to the container folder.
    That is, VirtaMove supports:

    .\COTF\StandardCOTF.xml

    or the absolute full path:

    C:\appliance\containerName\COTF\MyCustomCOTF.xml

    You can also specify only the file name of the COTF file if the file is in the COTF folder. For example:

    StandardCOTF.xml

    If you need to correct a NIC mismatch between the destination and source, click Open IP Mapper. In the Map IP Addresses window, map as required and then click Submit.

  13. When you are ready, click the Pre-Populate button. If you have not yet activated your VirtaMove license key, you will now be prompted to do so. See Activating Your VirtaMove License for information. Note that the pre-populate portion process may take some time. A window displays the status of the Pre-Populate process and the amount of data copied. If you hover over the data moved in green, you can see the estimated time remaining for completion of the transfer. You can cancel the process by clicking Cancel.

    At the Migrating application data stage of pre-populate, the Tether Monitor icon in the system tray will spin until the end of the process. If you hover over the spinning icon, a tooltip will show the file size transferred and the rate of transfer.

    Click the Close button in the VirtaMove Pre-Population window to close the window when the process is complete.

  14. Once the pre-population has been completed, you can dock the container by clicking on the Dock button at the top of the Administrative Console window. Once docked, the tethering process will begin copying data across.

  15. Once the container docks, click the Services tab. Only the services you selected for the container are displayed. Right-click each service and click Start to start the service. The status of the service changes to "Starting" and the Tether Monitor icon in the Windows Taskbar spins and blinks to show that data is being copied from the source machine. If a service cannot be started, an error message is displayed at the bottom of the Administrative Console window.

  16. If you need to make changes to the container, undock the container by clicking Undock and then right-click your container and click the Reset button. Click Yes at the prompt. This stops services and removes Tether information from the container and returns the container to the condition it was in before the migration process started. Repeat steps 7 to 14 as required.

  17. You are now ready to launch the application so you can exercise the main components of the application and test it while it is tethered. Click the Launch Application button to select an application associated with a selected remote product or open the VirtaMove command prompt. The Select an Application window opens. Do one of the following:

    • Select an application from the list, and then click Select. To view all applications associated with the selected product in the Start Menu of the source machine, enable View All. The selected application opens when you click Select.
      Note: ODBC Manager is available in the Select an Application window if required for your application.

    • Select VAA Command Prompt. The container command prompt opens.

  18. Exercise the main components of your application. See https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311394496/Running+and+Exercising+Your+Application?search_id=4ad10c13-744a-4eb9-a13e-5830f15c802f for more information. As required, use Tether Monitor to monitor Tether activity and get an idea of when application components have been fully copied from the source machine. For more information, see .

  19. When you are satisfied that the main components of your application have been exercised and migrated, close your application.

  20. Click the Services tab, and then right-click each service and select Stop.

  21. Click the Undock button. This undocks the container.

  22. Optionally, dissolve the container to the underlying OS by clicking the Dissolve button at the top of the Administrative Console window OR run Dissolve from the CLI: