Using the virtacomplus.exe command-line utility, you can list COM+ applications installed on both the source and destination machine, and export COM+ applications as .MSI files to the destination machine independent of a container, or packaged in a container so you can deploy the container with COM+ applications to a new destination. You can export COM+ components to an existing, undocked container.

To Migrate COM+ and DCOM Applications

Important:

Notes:

  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 path name are not permitted. For example: C:\appliances\container, where container is the name of the container. Click OK.

  3. Navigate 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.

  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 applications.

  10. Select the product or products you want to migrate. When you click away from the list, 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.

  11. Click the Source Services tab and review the services that were automatically selected for the container.

  12. Select services as appropriate.

  13. Go 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.

  14. Click the Source COM tab, and then scroll through the lists to select COM, DCOM, or COM+ components.

  15. If you need to add or modify credentials for COM, COM+ or DCOM components, click the Credentials tab and add or change passwords as required.

  16. Optionally, specify a https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311263613/Config-on-the-Fly?search_id=b487b778-d98b-46df-91b3-98ed837641b7 (COTF) file.

  17. 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 https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311033861/Activating+Your+VirtaMove+License?search_id=430eda44-8e05-4562-b0c3-56915868b8e7 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. 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, the rate of transfer, and the time of the last update.

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

  18. Once the pre-population has completed you can dock the container by clicking on the Dock button. Once docked, the tether process will begin copying data across.

  19. 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.

  20. 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 13 as required.

  21. 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.

  22. 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. Note that ODBC Manager is available in the Select an Application window if required for your application. The selected application opens when you click Select.

  23. Exercise the main components of your application. See https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311394496/Running+and+Exercising+Your+Application?search_id=b86601af-ab27-4f6c-b4f1-f46fc0c6663a 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 https://virtamove.atlassian.net/wiki/spaces/VDOC/pages/311230847/Monitoring+Migration?search_id=9c6bcf3a-2e32-410e-b1ca-ee6100fd5fd2. When you are satisfied that the main components of your application have been exercised and migrated, do the following:

To Remove COM+ and DCOM Applications from Your Destination Machine

You can remove COM+ and DCOM applications that you exported to your destination machine. Remove migrated applications by using the Add or Remove Programs administrative tool on the destination machine.

Alternatively, remove these applications using the Component Services administrative tool. For more information, go to: http://msdn.microsoft.com/en-us/library/windows/desktop/ms681729%28v=vs.85%29.aspx