You can import an unmanaged virtual machine to a vRealize Automation environment.

About this task

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

The bulk import option does not support deployments that are provisioned from a blueprint that contains an NSX network and security component or a software component.

Prerequisites

  • 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 Using Network Profiles to Control IP Address Ranges.

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

      These messages appear if you do not have a reservation in the selected business group for the host virtual machine that also hosts the unmanaged virtual machine. If you have a reservation in that business group for the unmanaged virtual machine 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.

      Menu Item

      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, and edit the data categories to match existing categories in the target vRealize Automation environment.

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

      • Reservation

      • Storage location

      • Blueprint

      • Virtual machine component

      • Owner that exists in the target deployment

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

      Heading

      Comment

      # Import--Yes or No

      Change to No to prevent a particular virtual 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 environment.

      Host To Storage (Name or ID)

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

      Deployment Name

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

      Note:

      Each virtual 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.

      Blueprint ID

      Enter the ID of the blueprint in the target vRealize Automation environment 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 select a blueprint that contains only a single virtual machine component. The blueprint must be published and added to an entitlement.

      Component Machine ID

      Enter the name of a virtual 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 environment 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.
  3. Use the vRealize Automation management interface to import your virtual machine to a vRealize Automation environment.
    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 filename in the CSV file text box by browsing to the CSV filename.
    5. Select import options.

      Option

      Description

      Start time

      Schedule a future start date. The chosen 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 many virtual machines, select the number of seconds to delay each virtual machine registration. Selecting this menu item slows the import process. Leave blank to select no delay.

      Batch size

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

      Ignore managed machines

      Leave unselected.

      Skip user validation

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

      Test import

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

    6. Click OK.

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