{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b2b66a2f-17a9-411e-b94b-ec1d53966f24"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"afbb28e7-6126-4cc1-b97f-53fb3baeb94d"}},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This page describes how to configure guest setup that will use hypervisor tools on VMware vCenter and VCD. ","type":"text"}]},{"type":"paragraph","content":[{"text":"You must install hypervisor tools on your VM templates before you configure guest setup.","type":"text"}]}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"mermaid","parameters":{"macroParams":{"fileName":{"value":"mermaid_1678352244315"},"theme":{"value":"default"},"version":{"value":"3"},"__bodyContent":{"value":"{\"diagramDefinition\":\"flowchart TD\\n\\n\\nA2[Hypervisor
tools]-->|Deploy

Reconfigure: no DHCP|B2{OS}-->|Win|Z-->c2[/Unattend file/]-->D2[Network via
DHCP only]\\nZ(( ))\\nstyle Z fill:#g1g,stroke:#100,stroke-width:2px\\nZ-->f2[/Custom
specification/]-->G2[Network via DHCP
or Static IP injection] \\nB2-->|Linux|h2[/Custom
specification/]-->I2[Network via DHCP
or Static IP injection] \\n \\n \\n \\n\\nstyle A2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle B2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle c2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle D2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle f2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle h2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle G2 fill: #ff9f3c,stroke: #ff9f3c\\nstyle I2 fill: #ff9f3c,stroke: #ff9f3c\"}"}},"macroMetadata":{"macroId":{"value":"a8eeba08-5b9b-4483-ae93-0467e17433a6"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://mermaidchart.herokuapp.com/images/mermaid_82.png"}}],"title":"Mermaid Integration for Confluence"}},"localId":"45857e4b-8171-40c6-9c6b-82b2dad3d62f"}},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"With hypervisor tools, Abiquo can do the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set a fully qualified domain name (FQDN)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generate a random password at deploy and optionally send by email and/or SMS to owner","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inject network configuration if no DHCP server is available","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inject variables into the VM","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"To inject a network configuration (static IP address) in Windows, you must use a custom specification. You cannot use an ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux VMs, the platform will configure a global DNS that will apply to all NICs on the VM","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Customize the Windows unattend file for hypervisor tools","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If you are using vCenter 7.0.3 U3, please see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://abiquo.atlassian.net/wiki/spaces/doc/pages/456753202"}},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For guest tools with Windows, the platform default is to use a Windows unattend file. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The default ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file is ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://abiquo.atlassian.net/wiki/spaces/doc/pages/311365026"}},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"When you configure Windows with an unattend file, the VM obtains its IP addresses using DHCP","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Guest setup with a Windows ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file runs the first time you deploy a VM. ","type":"text"},{"type":"hardBreak"},{"text":"If the guest setup is not successful, the VM deploy or reconfigure will fail and roll back.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the Windows ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file, Abiquo sets:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fully qualified domain name (FQDN)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Guest password at deploy time","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The Abiquo default Windows ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file also includes these static settings:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TimeZone with default W. Europe Standard Time","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JoinWorkgroup with default WORKGROUP","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To configure a custom Windows ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file for a datacenter","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in to the Remote Services server as an administrator","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create your own custom ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file and make the tomcat user the owner of the file","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default Abiquo will replace the following variables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$adminPassword","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$domain","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"$hostName","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":"abiquo.properties","type":"text","marks":[{"type":"code"}]},{"text":" file and set the location of your custom ","type":"text"},{"text":"unattend","type":"text","marks":[{"type":"code"}]},{"text":" file. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"// Path to Windows unattend file\ncom.abiquo.esxi.experimental.customize.win.unattendfile=/root/windows_unattend.xml","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Your Windows VMs will obtain their network configuration with DHCP.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure Windows with a custom specification for hypervisor tools","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not want to use an unattend file, then you can use a custom specification. ","type":"text"},{"type":"hardBreak"},{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://abiquo.atlassian.net/wiki/spaces/doc/pages/311364572"}},{"text":". ","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If there is no DHCP service available and you use a custom specification, Abiquo can assign a static IP address to the VM. ","type":"text"},{"type":"hardBreak"},{"text":"The guest setup will run the first time you deploy a VM and when you add a NIC to a powered-off VM","type":"text"}]}]},{"type":"paragraph","content":[{"text":"On VMware, to use a custom specification to configure Windows, set the ","type":"text"},{"text":"unattendfile","type":"text","marks":[{"type":"code"}]},{"text":" property to false.","type":"text"}]},{"type":"codeBlock","content":[{"text":"com.abiquo.esxi.experimental.customize.win.unattendfile=false","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also configure these properties to ensure that Abiquo waits for guest setup stages to complete.","type":"text"}]},{"type":"codeBlock","content":[{"text":"com.abiquo.esxi.experimental.customize.configure.timeoutms=1200000\ncom.abiquo.esxi.experimental.customize.waitpassword.timeoutms=1200000","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure guest initial password","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Prepare for guest setup with cloud-init or similar"},"name":{"value":"Configure guest initial password"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"b1640146-c08c-4237-8395-a6876fe87be5"},"schemaVersion":{"value":"1"},"title":"Excerpt Include"}},"localId":"b6125155-4f4e-42af-a633-1e573bfbd27b"}}]},{"type":"paragraph"},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure FQDN","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Prepare for guest setup with cloud-init or similar"},"name":{"value":"Configure FQDN"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"327977c8-23ab-4629-b3b8-48db000e1f27"},"schemaVersion":{"value":"1"},"title":"Excerpt Include"}},"localId":"1962b05d-4096-498f-9c53-40b0fc39a9cc"}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prepare VM templates for static IP injection with hypervisor tools","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, Abiquo uses DHCP to configure IP addresses. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are not using DHCP, prepare your VM templates for static IP injection.","type":"text"}]},{"type":"paragraph","content":[{"text":"For Linux with CENTOS:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download a minimal CentOS OVA, for example, ","type":"text"},{"text":"https://sourceforge.net/projects/virtualappliances/files/Linux/CentOS/CentOS-7.0-amd64-minimal.ova/download","type":"text","marks":[{"type":"link","attrs":{"href":"https://sourceforge.net/projects/virtualappliances/files/Linux/CentOS/CentOS-7.0-amd64-minimal.ova/download"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If Perl is not installed, then install it","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install VMware tools from vCenter, following the instructions for Option 2 at: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://webhostinggeeks.com/howto/how-to-install-vmware-tools/"}},{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"For Windows:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download a Windows template such as ","type":"text"},{"text":"WS-2019-template-40GB-BIOS-1.vmdk","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install VMware tools","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Abiquo, for the ","type":"text"},{"text":"Guest setup option","type":"text","marks":[{"type":"strong"}]},{"text":", select ","type":"text"},{"text":"Hypervisor tools","type":"text","marks":[{"type":"strong"}]},{"text":", and select the ","type":"text"},{"text":"Guest initial password","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox","type":"text"}]}]}]},{"type":"paragraph"},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Edit a VM template for guest setup","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Prepare for guest setup with cloud-init or similar"},"name":{"value":"Edit a VM template for guest setup"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"18bfe696-627c-4f6a-94e8-5ee4e25f7779"},"schemaVersion":{"value":"1"},"title":"Excerpt Include"}},"localId":"05c92916-9d6a-4c79-b8e9-0d13705f36a5"}}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Users can now automate their VMs with guest setup. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://abiquo.atlassian.net/wiki/spaces/doc/pages/341573991"}},{"text":" ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting hypervisor tools","type":"text"}]},{"type":"paragraph","content":[{"text":"For troubleshooting Linux VMs, please check this file: ","type":"text"},{"text":"/var/log/vmware-imc/toolsDeployPkg.log","type":"text","marks":[{"type":"code"}]}]}],"version":1}

Browser not supported