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, TrueSight 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 the alternative method of creating a Virtual Guest Job through the BLCLI, see Creating new VMs with the BLCLI and Virtualization - createVirtualGuest BLCLI commands. For details, see BLCLI-reference.
- 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.
Enter the description of the Virtual Guest Job and select the appropriate VGP, as described in the following sections:
Virtual Guest Job - General panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-General.WebHome] was not found.
Virtual Guest Job - Virtual Guest Package Selection panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-Virtual-Guest-Package-Selection.WebHome] was not found.
Define the platform-specific Virtual Guest Job settings, as described in the following tabs:
VMware - Config panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VMware-specific-panels.VMware-Config.WebHome] was not found.
VMware - Settings panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VMware-specific-panels.VMware-Settings.WebHome] was not found.
VMware - Network Connections panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VMware-specific-panels.VMware-Network-Connections.WebHome] was not found.
If you have chosen to customize the operating system for the new virtual guest, the following panels are also displayed:
VM Basic Config - Microsoft Windows panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Microsoft-Windows.WebHome] was not found.
VM Basic Config - Linux panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Linux.WebHome] was not found.
VM Computer Settings panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Computer-Settings.WebHome] was not found.
Run Once Script panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VMware-specific-panels.Run-Once-Script.WebHome] was not found.
IBM - General Settings panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-General-Settings.WebHome] was not found.
IBM - Storage panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-Storage.WebHome] was not found.
IBM - Storage (automatic management) panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-Storage-automatic-management.WebHome] was not found.
IBM - Network panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-Network.WebHome] was not found.
IBM - Physical I O panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-Physical-I-O.WebHome] was not found.
IBM - Advanced panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.IBM-specific-panels.IBM-Advanced.WebHome] was not found.
Solaris - Basic panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Solaris-specific-panels.Solaris-Basic.WebHome] was not found.
Solaris - Network Settings panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Solaris-specific-panels.Solaris-Network-Settings.WebHome] was not found.
Solaris - File Systems - Datasets - Devices Settings panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Solaris-specific-panels.Solaris-File-Systems-Datasets-Devices-Settings.WebHome] was not found.
Solaris - Advanced panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Solaris-specific-panels.Solaris-Advanced.WebHome] was not found.
Microsoft Hyper-V - Basic panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Microsoft-Hyper-V-specific-panels.Microsoft-Hyper-V-Basic.WebHome] was not found.
Microsoft Hyper-V - Storage panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Microsoft-Hyper-V-specific-panels.Microsoft-Hyper-V-Storage.WebHome] was not found.
Microsoft Hyper-V - Network panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Microsoft-Hyper-V-specific-panels.Microsoft-Hyper-V-Network.WebHome] was not found.
Microsoft Hyper-V - Advanced panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Microsoft-Hyper-V-specific-panels.Microsoft-Hyper-V-Advanced.WebHome] was not found.
VM Basic Config - Microsoft Windows panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Microsoft-Windows.WebHome] was not found.
VM Basic Config - Linux panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Linux.WebHome] was not found.
VM Computer Settings panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Computer-Settings.WebHome] was not found.
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.
|
| 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.
|
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.
| |
|---|
| 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.
|
VM Basic Config - Microsoft Windows panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Microsoft-Windows.WebHome] was not found.
VM Basic Config - Linux panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Linux.WebHome] was not found.
VM Computer Settings panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Computer-Settings.WebHome] was not found.
Red Hat Enterprise Virtualization - Basic panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Red-Hat-Enterprise-Virtualization-specific-panels.Red-Hat-Enterprise-Virtualization-Basic.WebHome] was not found.
Red Hat Enterprise Virtualization - Storage panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Red-Hat-Enterprise-Virtualization-specific-panels.Red-Hat-Enterprise-Virtualization-Storage.WebHome] was not found.
Red Hat Enterprise Virtualization - Network panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Red-Hat-Enterprise-Virtualization-specific-panels.Red-Hat-Enterprise-Virtualization-Network.WebHome] was not found.
Red Hat Enterprise Virtualization - Advanced panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Red-Hat-Enterprise-Virtualization-specific-panels.Red-Hat-Enterprise-Virtualization-Advanced.WebHome] was not found.
VM Basic Config - Microsoft Windows panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Microsoft-Windows.WebHome] was not found.
VM Basic Config - Linux panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Basic-Config-Linux.WebHome] was not found.
VM Computer Settings panel - Click here to see descriptions of the fields.
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.VM-Computer-Settings.WebHome] was not found.
Optionally, click Next to display the following panels and specify options.
Virtual Guest Job - Schedule panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-Schedule.WebHome] was not found.
Virtual Guest Job - Default Notifications panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-Default-Notifications.WebHome] was not found.
Virtual Guest Job - ACL Wizard panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-ACL-Wizard.WebHome] was not found.
Virtual Guest Job - Server ACL panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-Server-ACL.WebHome] was not found.
Virtual Guest Job - Instances Properties panel - Click here to see descriptions of the fields
The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252.Using.Creating-and-modifying-TrueSight-Server-Automation-jobs.Panel-reference-for-Jobs-for-virtual-environments.Virtual-Guest-Job-Wizard-Panels.Virtual-Guest-Job-Instance-Properties.WebHome] was not found.
Virtual Guest Job - Server Properties panel - Click here to see descriptions of the fields
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 
.
- Click Finish after completing the last step of the wizard, or click OK to save your revisions to an existing job.
- 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.The referenced document [xwiki:Automation-DevSecOps.Server-Automation.TrueSight-Server-Automation.tssa252._inclusionsLibrary._Schedules-panel-with-Job-Approval-and-change-automation.WebHome] was not found.
Back to top
Where to go from here
Modifying-the-Virtual-Guest-Job