Creating the VGP in BMC Server Automation for Hyper-V

You can build a repeatable process for deploying new virtual systems by using a virtual guest package (VGP). The VGP describes the new virtual system you want to add.

Before you begin

Review the following sections for requirements and recommendations for creating VGPs.


  • Create VGPs in the CSM_Virtual_Guest_Packages folder (under Depot) in the BMC Server Automation Console.
  • Ensure that Windows templates and Linux templates are created as described in the BMC Server Automation documentation.
  • Ensure that the VGP for bare-metal VMs is assigned a larger disk space than the space that is assigned to the system package. Otherwise, the provisioning fails with the somewhat misleading error message OS Not Found.
  • Ensure that the guest VM has the latest version of the VMM agent installed and running as a service. For successful Linux provisioning, the guest VM must have the latest version of the VMM agent installed and running as a service. The VMM 2012 SP1 Beta does not ship the VMM agent, so you must use the GA version of Microsoft VMM 2012 SP1. Click here to review the Microsoft online technical documentation for installing the VMM agent.


  • Do not include any static IP addresses in the configuration of the VGP.
  • Do not include any information that is instance-specific, such as a hard-coded host name.

To create a VGP for BMC Cloud Lifecycle Management

This section describes how to create a VGP manually. Beginning with BMC Server Automation 8.2, you can also create VGPs automatically by using the Virtual Guest Template Enrollment Job. For more information, see the related topic in the BMC Server Automation documentation.

  1. From the Depot folder, right-click the depot folder where you want to add the VGP.
  2. From the pop-up menu, select New > Virtual Guest Package and then Hyper-V.


    You should create VGPs in the Depot in the CSM_Virtual_Guest_Packages folder.

  3. On the Virtual Guest Package dialog, enter the following:

    The VM name and the server name are required. However, BMC Cloud Lifecycle Management overrides these values.




    Enter a name for the package.


    Enter a brief description of the package.

    Member of

    Browse to the CSM_Virtual_Guest_Packages folder in the Depot.

    VM Guest Package type

    Choose HyperV Bare Metal to configure the VGP and create a new VM, or select HyperV Template Based to base the VGP on an existing template. If you selected the template-based option, perform the following steps:

    • Click Browse to choose a template on which to base the new VM.
    • Select the server that contains the template.
    • Select the template from the displayed list, and click OK.
  4. Click Next.
  5. On the Permissions panel, verify that VirtualGuestPackageHyperV.* permissions is enabled for the VGP.
  6. Click Finish.
    A dialog displays, indicating that the package is being saved to the Depot.

To modify the VGP

BMC Server Automation does not support the Add disk option for a powered on VM. Any subsequent transactional requestable offerings that use that option will fail.

After the VGP is saved, the VGP editor is displayed, enabling you to modify the VGP.

  1. On each tab in the editor, enter the desired configuration settings for your VGP. The following panels apply to Hyper-V environments:
    • Microsoft Hyper-V - Basic panel

       Click here to see descriptions of the fields.

      Only a static memory configuration is supported; dynamic memory configuration is not supported.

      Under General Settings, specify the following:

      • Virtual Guest Name—Enter a name for the VM.
      • Virtual Guest Description—Optionally enter a short description of the VM.
      • Virtual Guest Storage—Browse to select storage to allocate to the VM.
      • Source Template—This read-only field is displayed only if you have selected a template as the base for the VM.
      • Virtual Guest Operating System—Select an OS for the VM from the drop-down list. This field is read-only if you have selected a template as the base for the VM.
      • Number of CPU Sockets—Select the number of physical CPUs that are available to the VM.
      • Cores Per Socket—Select the number of processors within the physical CPU chip that are available to the VM.
      • Total Cores—This read-only field displays the total number of CPU sockets and cores per socket. For example, if you selected two CPU sockets and two cores per socket, then this field displays a value of 4.
      • Memory (MB)—Select the amount of memory that is available for the VM.
      • Power On VM after Creation—Automatically starts the new VM.
      • Auto boot on host reboot—Automatically starts the VM if the host server is rebooted.
      • Customize OS—Select this check box if you want to specify settings for the VM OS. This field is displayed only if you have selected a template as the base for the VM. You specify the settings on two subsequent wizard panels: the Basic Config panel for Windows and the Computer Settings panel.


      If the VGP is based on a template,  you must select the Customize OS checkbox.

    • Microsoft Hyper-V - Storage panel

       Click here to see descriptions of the fields.

      The first disk in the VGP should always be type IDE.

      Under Virtual Disk, click Add to display the Virtual Disk Settings dialog box, select a server from the drop-down list and specify the following:

      • Size—Enter a disk size, in GB.
      • Storage—Browse to select a storage location.


        The Storage option is required only if you want to place the disk in another storage location (not in the VM storage).

      • Thin Provisioning—Use this option if you want to dynamically allocate storage by using VMware vStorage Thin Provisioning. In this format, the system dynamically consumes the space for the physical disk; space is allocated and expanded on demand whenever the guest OS requests space. For example, if you create an 80 GB disk but only use 20 GB of that disk, the actual disk consumption on the physical drives is 20 GB.
      • Interface Type—Select the interface type from the drop-down list.

    • Microsoft Hyper-V - Network panel

       Click here to see descriptions of the fields.

      For Microsoft Windows 2003 64 bit systems, the NIC type must be synthetic.

      Under Virtual Network Interfaces, click Add  to display the Virtual Network Interface Settings dialog box, select a server from the drop-down list and specify the following:

      • Network Name—Choose from the networks attached to the selected server.
      • MAC Address—You can either enter a MAC address, or have one generated automatically.
      • VLAN ID—Enter a VLAN.
      • Under IP Configuration, there are two tabs for IPv4 and IPv6 addresses. Choose to have the IP address obtained automatically using Dynamic Host Configuration Protocol (DHCP), or choose to use a specific IP address by specifying the following:
        • IP Address
        • Subnet mask (for IPv4)
        • Prefix Length (for IPv6)
        • Default gateway
      • Under DNS Configuration, choose to have the DNS server obtained automatically, or to use a specific server by specifying the following:
        • Primary DNS server
        • Secondary DNS server
        • Tertiary DNS server
      • Specify a DNS Suffix for this Connection.


      If the NIC in a template is in the disconnected state, and the network is not selected in the Virtual Guest Package, the addition to the domain fails during the customization process.  

      Workaround: For Hyper-V environments, the NIC in the template should be connected to the network to which the Virtual Machine is being deployed.

    • Microsoft Hyper-V - Advanced panel

       Click here to see descriptions of the fields.

      Specify the following:

      • CPU Priority—Choose high, medium, or low priority
      • Network Adapter Type—Choose from default, emulated, or synthetic.

    • VM Basic Config - Microsoft Windows panel

       Click here to see descriptions of the fields.

      • Under Local Settings, specify the following:
        • Computer name—Enter a name for the VM or choose to have the name auto-generated.
        • Administrator password—Enter a password for the Administrator user account, and confirm the password by entering it again in the Confirm password field.
      • Under Workgroup or Domain, choose to add the VM to a workgroup or a domain.
        • Workgroup—Enter the name of the workgroup to which you want to add the VM.
        • Windows Server Domain—Enter the domain name to which you want to add the VM. To create a domain account, click Create a computer account in the domain, and fill in the User name, Password, and Confirm Password fields.

    • VM Basic Config - Linux panel

       Click here to see descriptions of the fields.

      Under Computer Settings, specify the following:

      • Under Host name, enter the host name for the new VM. Host names can be any combination of alphanumeric characters and can include hyphens (-). However, special characters are not allowed. The host name field is a required field.
      • Under Domain, you can optionally add the new VM to a specific domain.

    • VM Computer Settings panel

       Click here to see descriptions of the fields.

      • Under User Information, specify any of the following:
        • Name—Enter a name for the primary user of the virtual machine.
        • Organization—Enter a brief description of the organization to which the user belongs.
      • Under License Setup, enter the following license information for the virtual machine:
        • License key—Enter the license key in the format shown on the panel.
        • Per server/Per seat—Specify the type of license for this virtual machine.
      • Under Localization, choose the time zone and locale for the virtual machine.
        • Time zone—Select the time zone from the drop-down list, or enter a custom time zone.
        • Locale—Select the locale for the virtual machine from the drop-down list, or enter a custom locale.


      This panel is present only if the VGP was based on a template.

  2. Save the package.

Where to go next

Publishing the Product Catalog

Was this page helpful? Yes No Submitting... Thank you