You can import an unmanaged virtual machine to vRealize Automation so that it can be managed by vRealize Automation.

Before you begin

  • If you are using vRealize Automation 7.0, verify that you have applied the patch described in Knowledge Base 2144526. This patch prevents data loss if you experience a problem during the import procedure.

  • Log in to the vRealize Automation console as a fabric administrator and as a business group manager.

  • If you are importing virtual machines that use static IP addresses, prepare a properly configured address pool.

    For more information, see Creating a Network Profile.

  • Create a blueprint for the virtual machine that you plan to import. This blueprint must be published. have a valid owner and be entitled to that owner.

About this task

An unmanaged virtual machine exists in a hypervisor but is not managed in a vRealize Automation deployment and cannot be viewed in the console. After you import an unmanaged machine, the machine is managed using the vRealize Automation console. Depending on your privileges, you can see the machine on the Managed Machines tab or the Items tab.

Procedure

  1. Generate a virtual machine CSV data file.
    1. Select Infrastructure > Administration > Bulk Imports.
    2. Click Generate CSV File.
    3. Select Unmanaged from the Machines drop-down menu.
    4. Select the Business group default value from the drop-down menu.
    5. Enter the Owner default value.
    6. Select the Converged blueprint default value from the drop-down menu.

      The blueprint must be published and added to an entitlement for the import to be successful.

    7. Select the Component machine default value from the drop-down menu.

      If you select a value for Business group and Converged blueprint, you might see the following results in the CSV data file:

      • Host Reservation (Name or ID) = INVALID_RESERVATION

      • Host To Storage (Name or ID) = INVALID_HOST_RESERVATION_TO_STORAGE

      This happens if you do not have a reservation in the selected business group for the host machine that also hosts the unmanaged machine. If you have a reservation in that business group for the unmanaged machine's host, the Host Reservation and Host To Storage values fill in properly.

    8. Select one of the available resource types from the Resource drop-down menu.

      Option

      Description

      Endpoint

      Information required to access a virtualization host.

      Compute Resource

      Information required to access a group of virtual machines performing a similar function.

    9. Select the name of the virtual machine resource from the Name drop-down menu.
    10. Click OK.
  2. Edit your virtual machine CSV data file.
    1. Open the CSV file with a text editor, and edit the data categories to match existing categories in the target vRealize Automation deployment.

      To import virtual machines contained in a CSV data file, each machine must be associated with the following items:

      • Reservation

      • Storage location

      • Blueprint

      • Machine component

      • Owner that exists in the target deployment

      All of the values for each machine must be present in the target vRealize Automation deployment for import to succeed. You can change the values for reservation, storage location, blueprint, and owner, or add a static IP address value to individual machines by editing the CSV file. cv

      Heading

      Comment

      # Import--Yes or No

      Change to No to prevent a particular machine from being imported.

      Virtual Machine Name

      Do not change.

      Virtual Machine ID

      Do not change.

      Host Reservation (Name or ID)

      Enter the name or ID of a reservation in the target vRealize Automation instance.

      Host To Storage (Name or ID)

      Enter the name or ID of a storage location in the target vRealize Automation instance.

      Deployment Name

      Enter a new name for the deployment, for example, the virtual machine name, you are creating in the target vRealize Automation instance.

      Note:

      Each machine must be imported to its own deployment. You cannot import a single virtual machine to an existing deployment. You cannot import multiple virtual machines to a single deployment.

      Converged Blueprint ID

      Enter the ID of the blueprint in the target vRealize Automation instance that you use to import the virtual machine.

      Note:

      Make sure that you enter only the blueprint ID. Do not enter the blueprint name. You must specify a blueprint that contains only a single machine component. The blueprint must be published and added to an entitlement.

      Component Machine ID

      Enter the name of a machine component that is contained in the blueprint you selected. You cannot import a virtual machine into a blueprint that has more than one component.

      Owner Name

      Enter a user in the target vRealize Automation instance who is entitled to the blueprint.

    2. If you are importing a virtual machine with a static IP address, append a command in the following form to the CSV file.

      ,VirtualMachine.Network#.Address, w.x.y.z, HOP

      Configure the command with the appropriate information for your virtual machine.

      • Change the # to the number of the network interface being configured with this static IP address. For example, VirtualMachineNetwork0.Address.

      • Change w.x.y.z to be the static IP address for the virtual machine. For example, 11.27.42.57.

      • The HOP string, Hidden, Not encrypted, Not runtime, sets the visibility of the property. This default property is removed from the virtual machine after a successful import.

      For a successful import, the IP address must be available in a properly configured address pool. If the address cannot be found or is already in use, the import succeeds without the static IP address definition, and an error is logged.

    3. Save the CSV file and close your text editor.
  3. Use the vRealize Automation console to import your virtual machine to a vRealize Automation deployment.
    1. Select Infrastructure > Administration > Bulk Imports.
    2. Click New.
    3. Enter a unique name for this task in the Name text box, for example, unmanaged import 10.
    4. Enter the CSV file name in the CSV file text box by browsing to the CSV file name.
    5. Select import options.

      Option

      Description

      Start time

      Schedule a future start date. The specified start time is the local server time and not the local time of the user workstation.

      Now

      Begin the import process immediately.

      Delay (seconds)

      If you are importing a large number of virtual machines, select the number of seconds to delay each virtual machine registration. Selecting this option slows the import process. Leave blank to specify no delay.

      Batch size

      If you are importing a large number of virtual machines, select the total number of machines to register at a given time. Selecting this option slows the import process. Leave blank to specify no limit.

      Ignore managed machines

      Leave unselected.

      Skip user validation

      Selecting this option sets the machine's owner to the value listed in the Owner column of the CSV data file without verifying that the user exists. Selecting this option can decrease the import time.

      Test import

      Test the import process without importing the machines so you can test your CSV file for errors.

    6. Click OK.

      The progress of the operation appears on the Bulk Imports page.