7.2

Table Of Contents
Table 17. Custom Properties for Changing IP Address of a Provisioned Machine with a Guest
Agent (Continued)
Custom Property Description
n
Set custom property
VirtualMachine.Software0.ScriptPath as
VirtualMachine.Software0.ScriptPath =
c:\dosomething.bat [MyPassword].
If you set VirtualMachine.ScriptPath.Decrypt to false, or
do not create the VirtualMachine.ScriptPath.Decrypt
custom property, then the string inside the square brackets
( [ and ]) is not decrypted.
For more information about custom properties you can use with the guest agent, see Custom Properties
Reference.
Configuring the Guest Agent to Trust a Server
Installing the public key PEM file for the vRealize Automation Manager Service Host in the correct guest
agent folder is the most secure approach to configuring the guest agent to trust a server.
Locate the guest agent folder on each template for the cert.pem PEM file for the Manager Service Host
to trust a server:
n
Windows guest agent folder on each template that uses the gugent
C:\VRMGuestAgent\cert.pem
n
Linux guest agent folder on each template that uses the gugent
/usr/share/gugent/cert.pem
If you do not put the cert.pem file in this location, the template reference machine cannot use the
guest agent. For example, if you try to collect the public key information after the VM is started for by
altering scripts, you break the security condition.
Note As an alternative, you can configure the guest agent to populate the trusted cert.pem file on first
use but this is less secure than manually installing the cert.pem file on each template. Consider this
alternative if you use a single template for multiple servers. To allow the guest agent to trust the first
server it connects to, create a template with no cert.pem file in the Windows VRMGuestAgent or
Linux /usr/share/gugent directory. The guest agent populates the cert.pem file the first time it
connects to a server.
Additional considerations apply, depending on your configured environment:
n
For WIM installations, you must add the public key PEM file contents to the PEBuilder console
executable and user interface. The console flag is /cert filename.
n
For RedHat kickstart installations, you must cut and paste the public key into the sample file,
otherwise the guest agent fails to execute.
Configuring vRealize Automation
VMware, Inc. 32