Page tree

You use a Virtual Guest Job (VGJ), based on a previously created Virtual Guest Package (VGP), to deploy a virtual machine to a target host server. This topic contains the following sections:

Before you begin

To perform this procedure, your role must have, in addition to the VirtualGuestJob.Create and VirtualGuestJob.Read authorizations, also the VirtualGuestPackage.Create and VirtualGuestPackage.Read authorizations. For information about granting authorizations to roles, see Creating roles.

To deploy new virtual systems, BMC Server Automation recommends that you have administrator privileges on the host server to which you are deploying the virtual system.

For virtual machines deployed on a Citrix XenServer, you can only provision OSs on virtual machines created from the following template types:

  • Windows templates
  • Citrix XenApp on Windows
  • Other Install Media

    Note

    Linux templates on Citrix XenServer do not support PXE booting and therefore are not supported. When creating VMs on a Citrix XenServer, ensure that the customized template does not contain the following files:

    • C:\Windows\setupapi.log (logs driver installations)
    • C:\Windows\setupact.log (logs installation actions)
    • C:\Windows\setuperr.log (logs install errors)
    • C:\Windows\Debug\netsetup.log (logs domain joins)
      The presence of these log files in the template may cause the VGJ to fail.

To create a VGJ

Note

 For more information about the alternative method of creating a Virtual Guest Job through the BLCLI, see Creating new VMs with the BLCLI and Virtualization - createVirtualGuest.
  1. Do one of the following:
    • Right-click the Job folder and select New > Virtual Guest Job from the pop-up menu.
    • Right-click the VGP from the Depot and select Deploy Virtual Guest from the pop-up menu. 
      The Virtual Guest Job wizard opens.
  2. Enter the description of the Virtual Guest Job and select the appropriate VGP, as described in the following sections:

    The General panel lets you provide basic information that identifies a Virtual Guest Job.

    Field definitions

    Name

    Enter the name of the Virtual Guest Job.

    Description

    Enter some information about the Virtual Guest Job.

    Save in

    Browse to select a job folder.

    Unlimited

    Select this option to have the job run in parallel on as many target servers as possible.

    Limited

    Select this option to have the job run in parallel on a specific number of target servers.

    1.  Choose the VGP to use for the Job.
    2. Browse to the host server (vCenter, global zone, IBM frame, Citrix XenServer, RedHat KVM server, RHEV Manager server, or Microsoft VMM server) that is the target for the new virtual guest.

      Note

      The IBM frame and the Citrix XenServer are represented by an agentless managed object. A VMware vCenter server might also be represented by an agentless managed object.

    3. Expand the host server node, and drill down until you find your target for the VGJ.
      Note the following considerations for selecting a target, based on platform:

      Platform

      Notes

      VMware

      • Select the target for the new new Virtual Machine as either Host server, Resource Pool, or DRS-enabled Cluster.
      • You can select only one Host server, DRS-enabled Cluster, or Resource Pool from the VMware vCenter as the target for the Virtual Guest Job.

      Solaris

       You can select only one global zone as the target for the Virtual Guest Job.

      IBM

      You can select only one frame as the target for the new IBM AIX or Linux partition or VIOS partition.

      RedHat KVM

      You can select only one virtual host as the target for the domain.

      RHEV

      You can select a RHEV Manager host or a Cluster as the target for the VGJ.

      Citrix XenServer

      • If you are deploying the virtual machine to a Citrix XenServer Pool, all disks belonging to the virtual machine must reside on shared storage for the pool.
      • You can select only one Host as the target for the virtual machine.

      Hyper-V

      You can select only one VMM server as the target for the VGJ.

    4. Click OK.
    5. Click Next.

       

  3. Define the platform-specific Virtual Guest Job settings, as described in the following tabs:

    In both the Config Wizard panel in the Virtual Guest Job wizard and the VM Config Type Settings panel in the Virtual Guest Package, you select the virtual guest configuration and OS settings that are appropriate for the new virtual guest. If the package is based on a template, this panel is read-only, with the exception of the virtual machine name.

    Enter a name for the virtual machine, and then specify any of the following settings. If you are creating the virtual machine from a template or a virtual machine, the template or virtual machine name is shown in the Created from VM/Template field.

    • Under Virtual Machine Configuration, choose one of the following options:
      • Typical — Select this option to choose basic settings for the virtual machine configuration.
      • Custom — Select this option to set advanced configuration options for the virtual machine.
    • Under VM Config file Datastore location, specify the following settings:
      • Select either Datastore or Datastore Cluster from the list.
        From the Datastore/Datastore Cluster window, select the VC server from the server list. Based on your selection, the datastores or datastore clusters get listed with the Capacity, Free space, Type, and, Datacenter. Additionally, Datastore Cluster is also listed if you selected Datastore as the Storage Type.
      • Choose the location for the VMX file, which is the primary configuration file for the virtual machine. This file contains all of the options you select when you set up this virtual machine.
    • Under Target VM folder, you can choose a VM folder to which you want to group the virtual machine. You can either select the folder path by browsing any of the vCenter servers or enter the path manually.

      Note

      The folder attribute will be added for each VM in the Live Browse.

    • Under Guest Operating System, specify the following information:

      • OS Type — Select the operating system type from the list.

      • OS Version — Select the operating system version from the list.

      • Power On VM after creation Select this check box if you want the VM to boot after it is created. Clear this check box if you do not want the VM to boot after it is created. This check box applies to VM provisioning as well as bare metal provisioning.

    Select the Customize OS check box if you want to specify settings for the virtual machine operating system. You specify the settings on two subsequent wizard panels: the Basic Config panel and the Computer Settings panel.

    Both the Settings panel in the Virtual Guest Job wizard and the VM Processor\Memory\Disk Settings panel in the Virtual Guest Package lets you select the virtual processor, memory, and disk settings appropriate for the new virtual guest.

    On this panel, you can:

    • Increase or decrease the number of virtual processors, using the Virtual Processor and Memory Configuration field. Specify the number of virtual processors and the amount of memory that will be allocated to the virtual machine.
    • Increase or decrease the memory allocated to the virtual machine.
    • Add new virtual disks and modify the data stores for the ones that are part of the template, in the Virtual Disk Configuration section.

    Field descriptions

     Field Description

    Virtual Processor and Memory Configuration

    Number of virtual processors — Select the virtual number of virtual processors that will be dedicated to this virtual machine from the drop-down list.
    Memory for this virtual machine — Use the slide bar to set the amount of dedicated memory for this virtual machine.

    Disk Format

    Select one of the following format options from the drop-down list.
    Same format as source — Use this option if you want to use the same storage format as the source template or VM, if you are cloning a template or VM.
    Thin Provisioned format — Use this option if you want to dynamically allocate storage 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 by the VMFS 3 driver 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.

    Note

    This option is support only for VMFS 3 and higher data stores.

    Thick format — Use this option if you want the entire defined space allocated on physical disk. For example, if you are planning to allocate 50 GB disk space to a new virtual machine, the entire 50 GB will be consumed on the physical drives.

    Virtual Disk Configuration

    Do not create a disk
    Create a new virtual disk — After selecting this option, click Add ( ) to display the Add virtual disk dialog box, where you can specify the storage adapter type, the amount of storage, and the location of the datastore. You can also select the Thin Disk Provisioning option to specify that the new virtual disk use thin disk provisioning (described above). Note that a user-added disk can be deleted or modified, however, you cannot change the size or delete the disks provided from the template.

    The Network Connections panel lets you specify the network connections and networking parameters like network port groups and adaptor type. This panel is available in the Virtual Guest Job wizard and in the Virtual Guest Package.

    Field Description
    DNS Configuration In the DNS suffixes field, enter any Domain Name System (DNS) suffixes in comma-seperated format. The DNS suffix is used in DNS name registration and DNS name resolution.
    Network connections

    Click Add () to display the Add Network Connection dialog box. You can add new virtual NICs to the virtual machine, and also modify the template-defined NICs. Any user-added NICs can be deleted, but you cannot delete the NICs provided with the template. You can also specify the IP settings for any NICs that you add.

    Note

    BMC Server Automation supports the use of VMware Distributed Virtual Switch (DVS) port groups.

    • Under Network Connection, add any of the following:
      • VC Servers—Select a vCenter server from the drop-down list.
      • Network—Select from the networks attached to the selected vCenter.
      • Adapter—Choose the adapter type from the drop-down list.
      • Connect at power on—Enable this option to have the virtual machine connect to the network when it is powered on.
    • 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 you have chosen to customize the operating system for the new virtual guest, the following panels are also displayed:

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

    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.

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

    Note

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

    The Run Once Script panel lets you specify optional RunOnce commands in a VMware Virtual Guest Package for VMware Windows-based virtual machines created using a template or from existing Virtual Machines.

    To add a RunOnce command to a Virtual Guest Package, do the following:

    1. In the Virtual Guest Package editor, select the Run Once Script tab.
    2. Click the browse button. The Edit panel is displayed.
    3. Do one of the following:
      • Enter the RunOnce command in the edit window.
      • Click Import to import the command from a script.
      • Click OK.

    The RunOnce commands you specify run after the guest operating system starts, which is in "logged on" mode with Administrator credentials. If you do not want the virtual machine logged on automatically, then add a reboot command to the end of the run once command list (for example, shutdown /r).

    Note

    You can specify only OS commands on the Run Once Script panel; there is no support for executing multi-line scripts.

    Field Description
    General settings

    Specify identification information for the LPAR. The Partition ID and the Profile Name are automatically generated if you leave those fields blank. You can also specify the level of resources that are assigned to the new partition.

    • Partition Name
    • Partition ID
    • Profile Name
    • Use all resources in system—Select this option for the partition to have access to all resources in the system.
    • Auto Boot—Select True to automatically boot the LPAR. Select False if you do not want the LPAR booted automatically. Default value: False.
    Processor settings
    • Processor Type—Select the processor type (Shared or Dedicated), and then choose the following settings. Select Shared to have the partition share CPUs. with other partitions in the shared processor pool. Select Dedicated to assign CPUs for use only by this partition.
    • Processing Units—Specify the following:
      • Minimum processors units
      • Desired processors units
      • Maximum processors units
    • Number of Virtual Processors—Use the following settings to set the range of processors available to the partition.
      • Minimum processors
      • Desired processors
      • Maximum processors
    • Shared Processor Pool—If you selected a Processor Type of Shared, enter the name of the shared processor pool. In a shared processor pool, processor resources are allocated as sub-units of processing power, known as a processing unit (PU) that can span multiple physical CPUs. This enables the physical CPUs to act as a shared pool of CPUs. Default value: DefaultPool (0).
    • Capped/Uncapped Weight—The partition can be capped or uncapped. A capped system has a maximum amount of CPU from the shared pool that can be allocated to it. An uncapped system can use more processing units than is currently configured for it if there is spare capacity in the pool. An uncapped system can use up to 100% of the number of currently configured virtual processors. If you specified that the partition is uncapped, enter a number to indicate how to distribute shared processing power relative to other uncapped systems. For example, a partition with a weight of 128 would get a greater percentage of the available processing power than a partition with a weight of 80.
    Memory settings

    Use the following settings to set the amount of memory available to the partition.

    • Minimum memory
    • Desired memory
    • Maximum memory

    The Storage panel lets you select the virtual adapter settings appropriate for the new LPAR.

    If you chose to manage the storage manually, then the following fields are displayed:

    • Virtual SCSI Adapters
    • Virtual Fiber Channel Adapters
    • Virtual Serial Adapters
      Click Add  to add any of the following types of virtual adapters:

    Virtual SCSI Adapters


    • Select Frame—Select the frame from the drop-down list.
    • Adapter ID—Enter the ID for the virtual fiber channel adapter.
    • Adapter type—Shows the type of adapter.
    • Remote partition—Select the remote partition from the drop-down list. If the partition is an LPAR, the remote partition is a VIO server. If the partition is a VIO server, the remote partition is an LPAR. You create a mapping from the client partition to the remote partition by entering the remote adapter ID.
    • Remote adapter ID—Enter the virtual slot ID for the remote partition.

    Virtual Fiber Channel Adapters


    On the Create Virtual Fiber Channel Adapter dialog, specify:

    • Select Frame—Select the frame from the drop-down list.
    • Adapter ID—Enter the ID for the virtual fiber channel adapter.
    • Adapter type—Shows the type of adapter.
    • Remote partition—Select the remote partition from the drop-down list. If the partition is an LPAR, the remote partition is a VIO server. If the partition is a VIO server, the remote partition is an LPAR. You create a mapping from the client partition to the remote partition by entering the remote adapter ID.
    • Remote adapter ID—Enter the virtual slot ID for the remote partition.

    Virtual Serial Adapters


    On the Create Virtual Serial Adapter dialog, specify:

    • Select Frame—Select the frame from the drop-down list.
    • Adapter ID—Enter the ID for the virtual fiber channel adapter.
    • Adapter type—Shows the type of adapter.
    • Remote partition—Select the remote partition from the drop-down list. If the partition is an LPAR, the remote partition is a VIO server. If the partition is a VIO server, the remote partition is an LPAR. You create a mapping from the client partition to the remote partition by entering the remote adapter ID.
    • Remote adapter ID—Enter the virtual slot ID for the remote partition.

    If you selected the Automatically manage storage virtual server adapters option in the Virtual Guest Package wizard, the Storage panel lets you specify the storage settings appropriate for the new LPAR.

    If you chose to automatically manage storage virtual server adapters, you see a single storage table on the Storage panel, from which you can add storage for the LPAR. This topic includes the following sections:

    Click Add . A dialog box is displayed where you can choose the type of storage you want to add. The following sections describe the available choices.

    To add a Virtual Disk to a shared storage pool

    If you are using version 8.7 or later, you can add a virtual disk to a storage pool or a shared storage pool.

    Warning: If the new virtual disk is also shared between different VIO instances or LPARs, then it could be deleted without warning by another user.

    On the Virtual Disk dialog box, select Virtual Disk from the Storage Type drop-down list, and then specify the following:

    • Location Type—Choose a storage pool or a shared storage pool as the location for the virtual disk. The shared storage pool allows sharing of SAN storage across VIOS instances.
    • Thin Disk ProvisioningUse 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 LPAR 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. If you selected Shared Storage Pool as the location, then this option is selected by default.
    • Name—Enter a name for the virtual disk. You are not required to enter a name; if a name is not specified, one is generated automatically.
    • Location—Browse to a location for the virtual disk.
    • Size—Enter a maximum size for the disk, in gigabytes.

    To add a virtual disk to a storage pool

    To add a virtual disk to a storage pool, complete the following steps:

    1. On the Virtual Disk dialog box, select Virtual Disk from the Storage Type drop-down list.
    2. Specify the following:
      • Name—Enter a name for the virtual disk. You are not required to enter a name; if a name is not specified, one is generated automatically.
      • Location—Browse to a location for the virtual disk.
      • Size—Enter a maximum size for the disk, in gigabytes.

    The screen shit below shows the Virtual Disk dialog box from version 8.6.

    To add a Physical Volume

    On the Physical Volume dialog box:

    1. Select Physical Volume from the Storage Type drop-down list.
    2. Click the Browse button and select an existing physical volume.

    To add a Fiber Channel Port

    On the Fiber Channel Port dialog box:

    1. Select Fiber Channel Port from the Storage Type drop-down list.
    2. Click the Browse button and select an existing port to attach a SAN LUN to an LPAR through a fiber channel adapter.

    BMC BladeLogic Server Automation supports N_Port ID Virtualization (NPIV). NPIV provides the capability to assign a physical fiber channel adapter to multiple unique worldwide port names (WWPNs). To access physical storage from a storage area network (SAN), the storage is mapped to logical unit numbers (LUNs), which are mapped to the ports of the physical fiber channel adapters.

    The Network panel lets you select the virtual adapter settings appropriate for the new LPAR. Click Add  to add any of the following types of virtual adapters:

    Virtual Ethernet Adapter
    On the Select Virtual Ethernet Adapter dialog box, specify:

    • Virtual switch—Select the virtual switch from the drop-down list of available switches. A virtual switch enables partitions on a managed system to communicate internally and to connect to external networks. Default value: Ethernet0.
    • VLAN ID—Enter the unique identification of the Virtual Local Area Network (VLAN), which is a logical network on a physical or virtual switch.
    • IEEE 802.1q compatible adapter—Select this option to configure the virtual Ethernet adapter to communicate over multiple VLANs. IEEE 802.1Q is the networking standard that allows multiple bridges networks to transparently share the same physical network link, without information being leaked between networks.

    Logical Host Ethernet Adapter
    Click Add to add one or more LHEAs. On the Select Logical Host Ethernet Adapter dialog box, specify:

    • Select Frame—Select a frame from the drop-down list.
    • Adapter ID—Set the unique identifier for the LHEA.
    • Physical Port—Select a port from the drop-down list.
    • Port Group—Enter the port group to which the physical port belongs. A port group is a group of logical ports that share one or two physical ports. A port group can support up to 16 logical ports.
    • Logical Port—Enter a logical port from the port group that you want to allocate to the LPAR.
    • Allow all VLAN IDs—Check this box to enable the logical port to accept packets with any VLAN ID.
    • Allowed VLAN IDs—If you want the logical port to accept only packets with specific VLAN IDs, clear the Allow all VLAN IDs check box and enter each VLAN ID into this field. You allow up to 20 VLAN IDs to be accepted on this logical port.

    The Physical I/O panel lets you add the physical devices appropriate for the new LPAR.

    1. Under Physical IO, click Add to add one or more physical devices.
    2. On the Select Physical IOpanel, do the following:
      • IO Pool ID—Optionally, specify the I/O pool if you want to assign the physical I/O slot to an I/O pool.
      • Add Physical IO to Partition Profile—Choose how to add the I/O device to the partition profile. A partition profile is a record on the HMC that specifies a configuration for a logical partition.
        • Add as required—Select this option if you want to specify that the I/O device is dedicated to the partition.
        • Add as desired—Select this option if you want to specify that an I/O device is shared. Selecting this option means that either the I/O device is meant to be shared with other logical partitions, or that the I/O device is optional.
      • Select DRC Index—Select the 8-character hexadecimal string that represents the dynamic reconfiguration connector (DRC) index of the current console adapter from the DRC Index list at the bottom of the panel. The string you select is populated into the DRC Index field above the list.

    The Advanced panel lets you specify optional settings for the LPAR.

    Active Memory Expansion Settings
    Specify the Active Memory Expansion (AME) factor. AME enables the LPAR to compress in-memory data, which allows more data to be placed into memory. The AME factor specifies a target effective memory capacity for the LPAR. For example, if you specify an AME factor of 3.0 and a memory size of 20 GB, then the expanded memory size for the LPAR is 60 GB.

    Memory Settings
    Click Use Shared Memory to specify any of the following shared memory settings (the following fields are not displayed unless you select the Use Shared Memory option):

    • Primary and Seconday Paging VIOS—Browse to the location of a VIOS server that is the primary paging virtual I/O servers (VIOS) for the partition. Optionally, you can add a secondary paging server. A Paging VIOSprovides paging services for the shared memory pool and manages the Hypervisor paging spaces for LPARs using shared memory.
    • Memory Weight—Use the arrows to specify a number to indicate how to distribute shared memory, relative to the other LPARs. The higher the number, the higher priority the partition has for obtaining shared memory. For example, a partition with a weight of 128 would get a greater percentage of the available memory than a partition with a weight of 64.
    • Custom Entitled Memory—Set the desired amount of memory (in MB) that is always available to the LPAR.

    Other Settings
    Specify any of the following settings:

    • Enable Connection Monitoring—This option enables the monitoring of the communication paths between your HMC and the systems that it manages.
    • Enable Redundant Error Path Reporting—This option enables a logical partition to report common server hardware errors and partition hardware errors to the HMC.
    • Boot mode—Specify the boot mode for the LPAR.
    • Workload group—Click browse to specify a workload group for the partition. A partition workload group identifies a set of partitions that reside on the same physical system. Assigning the partition to a workload group enables dynamic allocation of processing power for the partitions based on the goals defined in the domain policy. Default value: blank.

    Field Description
    General settings

    Specify the Zone Name and the Zone Path (which must start with a forward slash / ), and then any of the following settings:

    • Resource Pool — Click Browse to associate the zone with a resource pool that is available on the system. Default value: Not applicable.
    • Auto Boot — Select True to automatically boot the zone when the global zone is booted. Select False if you do not want the zone booted automatically. Default value: False.
    Processor settings

    Select Customize to specify any of the following settings:

    • Processor Type — Select Capped or Dedicated.
      • Capped sets a limit on the amount of CPU resources that can be used by the zone while it is running. Enter a positive integer or positive decimal (with two digits to the right of the decimal) in the Number of CPUs or Range field to represent the CPU cap.
      • Dedicated allocates a subset of the system's processors for exclusive use by the zone while it is running. Enter a positive integer, positive decimal (with two digits to the right of the decimal), or a range in the Number of CPUs or Range field to represent the number of dedicated CPUs for the zone.
    • Number of CPUs or Range — If you specified a CPU range, enter a positive integer or positive decimal (with two digits to the right of the decimal) in the Importance field.
    • Importance — The Importance field defines the relative importance of the dynamic resource pool.
    Memory settings Use these settings to provide limits for the physical, swap, and locked memory usage of the zone. For example, you could specify a maximum swap memory of 256 MB for the zone. You must specify at least one of the memory settings when capping memory for the zone.
    • Physical
    • Locked
    • Maximum Swap

    The Network Settings panel lets you select the network settings appropriate for the new zone.

    Choose the IP type (Shared or Exclusive) and then click Add to specify a network address on the Select Network Address panel.

    • For a Shared IP zone, specify both the IP address and the physical device.
    • Optionally, you can also set the default router. For example, Physical = hme0, Address=192.168.0.1, Default Router=10.0.0.1.
    • For an Exclusive IP zone, specify only the physical device. For example, Physical = bge32001.

    The File Systems /Datasets/ Devices panel lets you select the storage and physical devices settings appropriate for the new zone.

    Click Add to add any of the following types of devices:

    File Systems

    Adding a file system is optional. Click Add to specify additional file systems on the File Systems/Data Sets/ Devices Settings Dialog panel. Use the following options to specify how and where to mount file systems:

    • Dir: Specify the mount point for the file system. For example, Dir=/mnt.
    • Special: Enter the block special device name or directory to mount from the global zone. For example, Special=/dev/dsk/c0t0d0s2.
    • Raw: Enter the raw device on which to run the file system consistency check command (fsck) before mounting the file system. For example, Raw= /dev/rdsk/c0t0d0s2.
    • Type: Enter the file system type. For example, Type = ufs.
    • Options: Enter additional mount options similar to those used with the mount command. For example, Options = nodevices.logging.

    ZFS Data Sets

    Click Add to specify additional Data Sets on the File Systems - Data Sets - Devices Settings Dialog panel. Adding a ZFS data set resource enables storage administration to be delegated to a nonglobal zone.
    Specify the name of the data set, but do not include a leading slash or spaces in the data set name. For example, enter ZFSPool/testzfs.

    Inherited Pkg-Dirs

    Specify the Zone Type (Sparse Root or Whole Root).

    • Select Sparse Root to create a zone that contains a read/write copy of only a portion of the file system existing on the global zone. The other file systems are mounted from the global zone as read-only loop-back virtual file systems. When the zone is created, the global administrator selects which file systems to share with the sparse root zone, By default, the following directories are shared as read-only file systems: /usr, /lib, /sbin, and /platform. These directories are shown in the Inherited Pkg-Dirs section.
    • Select Whole Root to create a zone that contains a read/write copy of the file system that exists on the global zone. When this type of zone is created, all of the packages installed on the global zone are available to the zone. The whole root zone has dedicated use of the package database that is created and copied onto the zone.
      Click Add to specify additional directories to copy into the zone.

     The Advanced panel lets you specify additional settings for the Zone.

    Advanced Settings

    Specify any of the following settings:

    • Boot Args — Enter any boot arguments you want applied to the zone. For example, enter -m debug to set the boot behavior of SMF to write messages at the debug level. Default value: Not applicable.
    • Limit Privileges — Enter a privilege restriction you want applied to the zone. For example, enter PRIV_PROC_ZONE to allow a process to trace or send signals to processes in other zones. Default value: Not applicable.
    • Scheduling Class — Select a scheduling class you want applied to the zone. The scheduling class controls the allocation of available CPU resources among zones, based on their importance. Select from the following options:
      • TS (Time Shared)
      • IA (Inter Active)
      • FSS (Fair Share Scheduler)
      • FX (Fixed Priority)
      • SYS (System)
      • RT (Real Time)

    Devices

    Click Add to specify additional devices on the File Systems/Data Sets/ Devices Settings Dialog panel. Each zone can have devices that are configured when the zone transitions from the installed state to the ready state. Specify the path to a device in the Match field to make the device available and dedicated to the zone. For example, Match=dev/pts.

    Resource Controls

    Click Add to specify a zone-wide resource control on the Additional Configuration Dialog panel. For example, you can specify a maximum number of LWPs that are simultaneously available to the task's processes by entering the following:

    • Name: name=zone .max-lwps
    • Value: priv=privileged,limit=100,action=deny

    Custom Attributes

    Click Add to specify additional attributes.

    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.

    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.

      Note

      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.

    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.

    Note

    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.

    Specify the following:

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

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

    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.

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

    Note

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

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

    Field Description
    Disks

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

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

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

    Field Description
    General settings

    Specify the following:

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

      Note

      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.

      Note

      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.

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

    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.

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

    Note

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

    The Basic panel lets you specify identification information, processor, and memory settings for the virtual guest.

    Field Description
    General settings

    Specify the following:

    • Virtual Guest Name
    • Virtual Guest Description
    • Virtual Guest Storage — Use the Browse button to select storage for the virtual machine.
    • Source Template — Read-only field based on the selected VM or template.
    • Guest Operating System — Select an operating system for the bare metal virtual guest from the drop-down list. For template-based the operating system field is read-only.
    Processor and memory settings

    Select the following:

    • Number of CPU sockets
    • Cores per socket
    • Total Cores (Read-only)
    • Memory (MB)
    • Power On VM after Creation — Select this option if you want to automatically starts the new virtual guest.
    • Customize OS — Select this option if you want to specify settings for the virtual guest operating system. You specify these settings on two subsequent panels: the Basic Config panel and the Computer Settings panel.

    The Storage panel lets you specify storage settings, such as disk name and storage key, that are appropriate for the new virtual guest.

    Click Add to display the Select Storage 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.

      Note

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

    The Network panel lets you specify network settings appropriate for the new virtual guest.

    Click Add to display the Virtual Network Interface Settings dialog box, where you can specify any of 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.
    • 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.

    The Advanced panel lets you specify additional settings, such as disk interface type, for the new virtual guest.

    Specify any of the following:

    • HA Priority — Select a high-availability (HA) failover priority for the virtual guest. Because an HA service can run on only one cluster node at a time, select the failover priority for this virtual guest, relative to others. Select Disabled (the default), if you are not using HA services.
    • Disk Interface Type — Select the interface type for the guest virtual disk.
    • Network Adapter Type — Select the adapter type for the guest virtual network.

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

    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.

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

    Note

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

    The General Settings panel lets you specify identification information and processor and memory settings for the domain.

    Field Description
    General Specify a name for the Domain.
    Processor/ Memory settings

    Select any of the following:

    • Number of VCPUs
    • VM Max Memory (MB)
    • VM Startup Memory (MB)
    • CPU Architecture
    • Boot Automatically

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

    Field Description
    Storage details

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

    • Storage Type— Select File Image or Block Partition.

      Note

      If you select Block Partition, the Use Existing Storage Pools, Server, Pool Name, Size, and Allocate Now options are disabled.

    • Use Existing Storage Pool — If you selected File Image and check this option, the Server and Pool Name drop-down lists are enabled. Select a server, and then select from the pools available on that server.
    • Base Location — if you selected File Image, enter the path to the file (without the file name, as the name is automatically generated), starting with a forward slash ( / ).
    • Location — if you selected Block Partition, enter the path to the partition, starting with a forward slash ( / ).
    • Size (*MB) — set the desired disk space size and check *Allocate Now.
    • Target Device Type (Disk, CD-ROM, or Floppy)
    • Target Device Bus (IDE, SCSI, and so on)

      Note

      For a Target Device Type of CDROM and Floppy, the Target Device Bus must be IDE.

    Network / Bridge details

    Click Add to open the Network Details dialog box and add any of the following:

    • Server
    • Network Type
    • Network Name
    • Auto-generate MAC Address

      Note

      In the Virtual Guest Package and the Virtual Guest Job wizard, you must add at least one bridge network to provision a RHEV KVM domain using PXE.

    • Use this MAC Address
    • Device Model

  4. Optionally, click Next to display the following panels and specify options.
     

    The Schedules panel lets you schedule a job to execute immediately, schedule a job at a specific time in the future, schedule a job on a recurring basis, and define notifications that are issued when a job runs.

    On the Schedule panel, choose Execute Job Now or click Add to define a schedule for this Virtual Guest Job. When scheduling a job, you can perform any of the following tasks:

    • Scheduling a job that executes immediately — To schedule a job that executes immediately, select Execute job now.
    • Scheduling a job — The Schedule tab lets you schedule a job so it can run once, recur hourly, daily, weekly, or monthly, or recur at some arbitrary interval.
    • Defining job notifications — The Job Notifications tab lets you set up notifications that are generated when a scheduled job runs.

    The Default Notifications panel provides options for defining default notifications that are generated when a job completes. If you have set up notifications for a particular scheduled job, those notifications are generated instead of default notifications. Default notifications can also provide information about Virtual Guest Job results.

    Default notifications can take the form of emails or SNMP traps. When a job completes, an SNMP trap is sent to a specified server, where it can be read using software that receives and interprets SNMP traps. Default notifications are sent when you run a job immediately (that is, you do not schedule the job) or a scheduled job completes but you have not set up email or SNMP notifications for that scheduled occurrence.

    On the Notifications panel, optionally specify email or trap notifications for the Job.

    Using the ACL Wizard panel, you can add individual permissions to a Virtual Guest Job (VGJ). You can also set permissions by adding access control list (ACL) templates or ACL policies.

    The Permissions list is an ACL granting roles access to this Virtual Guest Job. ACLs control access to all objects, including the sharing of objects between roles.

    Review the permissions for the VGJ. The VirtualGuestPackageJob ACL, by default, has all of the permissions associated with the VirtualGuestPackage authorization category.

    Using the Server ACL panel, you can set the server access permissions for the virtual guest. You can also set permissions by adding access control list (ACL) templates or ACL policies.

    The Permissions list is an ACL granting roles access to this Virtual Guest Job. ACLs control access to all objects, including the sharing of objects between roles.

    The Virtual Guest Job Instance Properties panel lets you specify values for the local editable properties defined in the Virtual Guest Package and Virtual Guest Job.

    For example, if the "Location" property appeared on this panel, you could modify the property to "Boston" to show the location of the virtual machine being created.

    This capability enables you to set up a template for Virtual Guest Jobs, using specific properties as parameters. You would then need to specify values before each job run in just one panel.

    For any property that has a check in the Editable column, select the property and click in the Value column.

    • To set a property value back to its default value, click Reset to Default Value .
      The value of the property is reset to the value it inherits from a built-in property class. The Value Source column shows the property class from which the value is inherited.
    • Depending on the type of property you are editing, you can take different actions to set a new value, such as entering an alphanumeric string, choosing from an enumerated list, or selecting a date.
      To insert a parameter into the value, enter the value, bracketed with double question mark delimiters (for example, ??MYPARAMETER??) or click Select Property .

    The Server Properties panel lets you review and edit the properties associated with the virtual host server.

    For any property that has a check in the Editable column, select the property and click in the Value column.

    • To set a property value back to its default value, click Reset to Default Value .
      The value of the property is reset to the value it inherits from a built-in property class. The Value Source column shows the property class from which the value is inherited.
    • Depending on the type of property you are editing, you can take different actions to set a new value, such as entering an alphanumeric string, choosing from an enumerated list, or selecting a date.
      To insert a parameter into the value, enter the value, bracketed with double question mark delimiters (for example, ??MYPARAMETER??) or click Select Property .

  5. Click Finish after completing the last step of the wizard, or click OK to save your revisions to an existing job.
  6. To run the job, right-click the job and select Execute.

Back to top

To schedule a VGJ

In the Schedules panel, define any number of schedules for the VGJ in the list of schedules, and then click Next. You can use any of the following options:

  • Scheduling a job that executes immediately — To schedule a job that executes immediately, select Execute job now. If your system has been configured to require approval information for this job type, select Execute on Approval and then click Browse to display the Enter Approval Information dialog box.
  • Scheduling a job — The Schedule tab lets you schedule a job so it can run one time, recur daily, weekly, or monthly, or recur at some arbitrary interval.
    While scheduling, you can set the time zone for the job. You can also set an execution priority level for the job.

    Note

    For a recurring schedule, BMC Server Automation automatically accounts for differences in time zones and changes in daylight savings time. For example, if you schedule a job that should run weekly at 06:00 Eastern Standard Time, the job always runs at 06:00 Eastern Time, no matter whether standard or daylight savings time is in effect.

    Ensure that all component machines in your BMC Server Automation system have their clocks synchronized. 

  • Defining scheduled job notifications — The Scheduled Job Notifications tab lets you set up notifications that are generated when a scheduled job runs.
  • Providing approval information — The Approval information tab lets you provide required approval information. This tab only appears when your system has been configured to require approval information for this job type. For details about BMC Remedy ITSM approval, see Executing a job with BMC Remedy ITSM approval.

Back to top

Where to go from here

Modifying the Virtual Guest Job