Unsupported content


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Creating the VGP in BMC Server Automation for Citrix XenServer

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.

For example, you can base the VGP on an existing VMware vCenter template or create the VGP using values of your own, if you do not have an existing machine or template on which to base the configuration. Having a base package from which to deploy new virtual machines helps enforce consistency and standards, such as including Antivirus and management software on any new virtual machine.

The following sections describe how to create a VGP in BMC Server Automation:

Before you begin

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

About the VGP

A VGP bundles configuration changes so they can be deployed to hosts/clusters using a Virtual Guest Job. A VGP consists of an instruction set and any files needed for implementing configuration changes. Configuration changes can consist of additions, deletions, and modifications to any of the server objects BMC supports on all operating systems. This capability allows you to create multiple VGPs, each designed and tailored for a specific use.


  • You should create VGPs from virtual machine templates that adhere to the requirements described in Creating VM templates.
  • Create VGPs in the CSM_Virtual_Guest_Packages folder (under Depot) in the BMC Server Automation Console.
  • To support hostname configuration in the virtual guest, select the Custom option in the VM Config Type Settings tab. For more information, see VMware - Config.
  • Ensure that the VGP for bare-metal virtual machines is assigned a larger disk space amount than what is assigned to the system package. Otherwise, the provisioning fails with the somewhat misleading error message OS Not Found.


Consider the following general recommendations for creating VGPs:

  • 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, using the Virtual Guest Template Enrollment Job. For more information, see the related topic in the BMC Server Automation online technical documentation.

  1. From the Depot folder, right-click the depot folder where you want to add the VGP. From the pop-up menu, select New > Virtual Guest Package> Citrix XenServer.


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

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

  3. Click Next.
  4. On the Permissions panel, enter the permissions for the VGP. The Permissions panel is an access control list granting roles access to this VGP. Access to all objects, including the sharing of objects between roles, is controlled through access control lists (ACLs). Make sure that your role has the VirtualGuestPackageCitrixXen.* permission to create a VGP for a Citrix XenServer environment.
  5. Click Finish.
    A dialog displays, indicating that the package is being saved to the Depot.

To modify the VGP

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

  1. On each tab in the editor, enter the desired configuration settings for your VGP.
  2. The following panels apply to Citrix XenServer environments:

     Citrix XenServer - Storage - Network Settings panel - Click here to see descriptions of the fields

    The Storage/Network Settings panel lets you specify storage and network settings appropriate for the new virtual machine.


    Click Add to open the Disk Settings dialog box, where you can add any of the following:

    • Disk Name
    • Disk Description
    • Size (MB)
    • Select Server — Select a server from the drop-down list. The selection populates the list of disks at the bottom of the dialog box.
    • Location — Displays the path for the storage location of the disk you selected.


      Only single placement advice is used for multiple VGP disks. As an example, consider the following:

      • A VGP is configured with multiple disks.
      • The target environment has a single Virtual Disk Repository pool with multiple datastores.
      • The resulting VGP created from BMC Cloud Lifecycle Management is not created with multiple disks from multiple datastores. Instead BMC Cloud Lifecycle Management picks up only one datastore based on default or custom placement advice, and creates all the disks on the same datastore.
        This limitation applies to all platforms.


    Click Add to open the Virtual Interface Settings dialog box and add any of the following:

    • Server — Select a server from the drop-down list.
    • Network Name — Select from the networks attached to the selected server.
    • MAC Address — You can either enter a MAC address, or choose to have the address generated automatically.
     Citrix XenServer - General - Memory - Processor Settings panel - Click here to see descriptions of the fields

    The General/Memory/Processor Settings panel lets you specify identification information and processor and memory settings for the virtual machine.

    General settings

    Specify the following:

    • Virtual Machine Name
    • Virtual Machine Description
    • Source VM/Template Name — Read-only field based on the selected VM/template.


      If you select a template with a name that exists both as XenServer and custom templates, preference is given to the custom template, which is used as a reference during the deploy operation.

    • Source VM/Template Description — Read-only field based on the selected VM/template.


      If the template is from a server running XenServer 5.5, the Template Description shown on this panel may not match the template description shown in XenCenter.

    Processor and Memory Settings

    Select the following:

    • Number of VCPUs
    • Initial Memory (MB)
    • Under Boot Settings, specify any advanced boot parameters.
    • Auto Start — Automatically starts the new virtual machine as soon as the host is booted.
  3. Save the package.

Where to go next

Publishing the Product Catalog

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