Prepare for guest setup with hypervisor tools
- 1 Customize the Windows unattend file for hypervisor tools
- 2 Configure Windows with a custom specification for hypervisor tools
- 3 Configure guest initial password
- 4 Configure FQDN
- 5 Prepare VM templates for static IP injection with hypervisor tools
- 6 Edit a VM template for guest setup
- 7 Troubleshooting hypervisor tools
This page describes how to configure guest setup that will use hypervisor tools on VMware vCenter and VCD.
You must install hypervisor tools on your VM templates before you configure guest setup.
With hypervisor tools, Abiquo can do the following:
Set a fully qualified domain name (FQDN)
Generate a random password at deploy and optionally send by email and/or SMS to owner
Inject network configuration if no DHCP server is available
Inject variables into the VM
To inject a network configuration (static IP address) in Windows, you must use a custom specification. You cannot use an unattend
file.
Guest setup with hypervisor tools can run the first time you deploy a VM and when you add a NIC to a VM that is powered off.
On Linux VMs, the platform will configure a global DNS that will apply to all NICs on the VM
Customize the Windows unattend file for hypervisor tools
For guest tools with Windows, the platform default is to use a Windows unattend file.
The default unattend
file is Abiquo default Windows unattend file.
Guest setup with a Windows unattend
file runs the first time you deploy a VM.
If the guest setup is not successful, the VM deploy or reconfigure will fail and roll back.
Using the Windows unattend
file, Abiquo sets:
Fully qualified domain name (FQDN)
Guest password at deploy time
The Abiquo default Windows unattend
file also includes these static settings:
TimeZone with default W. Europe Standard Time
JoinWorkgroup with default WORKGROUP
To configure a custom Windows unattend
file for a datacenter
Log in to the Remote Services server as an administrator
Create your own custom
unattend
file and make the tomcat user the owner of the fileBy default Abiquo will replace the following variables:
$adminPassword
$domain
$hostName
Edit the
abiquo.properties
file and set the location of your customunattend
file. For example:// Path to Windows unattend file com.abiquo.esxi.experimental.customize.win.unattendfile=/root/windows_unattend.xml
Your Windows VMs will obtain their network configuration with DHCP.
Configure Windows with a custom specification for hypervisor tools
If you do not want to use an unattend file, then you can use a custom specification.
See Limitations of a custom specification to configure Windows.
On VMware, to use a custom specification to configure Windows, set the unattendfile
property to false.
com.abiquo.esxi.experimental.customize.win.unattendfile=false
You can also configure these properties to ensure that Abiquo waits for guest setup stages to complete.
com.abiquo.esxi.experimental.customize.configure.timeoutms=1200000
com.abiquo.esxi.experimental.customize.waitpassword.timeoutms=1200000
Configure guest initial password
Configure FQDN
Prepare VM templates for static IP injection with hypervisor tools
By default, Abiquo uses DHCP to configure IP addresses.
If you are not using DHCP, prepare your VM templates for static IP injection.
For Linux with CENTOS:
Download a minimal CentOS OVA, for example, https://sourceforge.net/projects/virtualappliances/files/Linux/CentOS/CentOS-7.0-amd64-minimal.ova/download
If Perl is not installed, then install it
Install VMware tools from vCenter, following the instructions for Option 2 at: https://webhostinggeeks.com/howto/how-to-install-vmware-tools/
For Windows:
Download a Windows template such as
WS-2019-template-40GB-BIOS-1.vmdk
Install VMware tools
In Abiquo, for the Guest setup option, select Hypervisor tools, and select the Guest initial password checkbox
Edit a VM template for guest setup
Users can now automate their VMs with guest setup. See Automate first boot of a VM for guest setup
Troubleshooting hypervisor tools
For troubleshooting Linux VMs, please check this file: /var/log/vmware-imc/toolsDeployPkg.log
Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved