You can use the proxy agent utility to modify the initial configurations that are encrypted in the VRMAgent.exe.config file agent configuration file, or to change the machine deletion policy for virtualization platforms.
About this task
Configure the vSphere agent in preparation for creating and using vSphere endpoints to be used in vRealize Automation blueprints.
Some portions of the file are encrypted, while others are not. For example, the serviceConfiguration section of VRMAgent.exe.config is not encrypted.
Log in as a system administrator to the machine where you installed the vSphere agent.
- Open a Windows command console as an administrator.
- Go to the agents installation directory.
cd Program Files (x86)\VMware\vCAC\CD Agents\agent_name.
- (Optional) Enter DynamicOps.Vrm.VRMencrypt.exe VRMAgent.exe.config get to view the current configuration settings.
The following is an example of the output of the command:
managementEndpointName: VCendpoint doDeletes: True
- (Optional) Enter the
set managementEndpointNamecommand to change the name of the endpoint you configured at installation.
DynamicOps.Vrm.VRMencrypt.exe VRMAgent.exe.config set managementEndpointNameMy Endpoint.
You change this property to rename the endpoint within vRealize Automation instead of changing endpoints.
- (Optional) Enter the
set doDeletescommand to configure the virtual machine deletion policy.
DynamicOps.Vrm.VRMencrypt.exe VRMAgent.exe.config set doDeletesfalse.
(Default) Delete virtual machines destroyed in vRealize Automation from vCenter Server.
Move virtual machines destroyed in vRealize Automation to the VRMDeleted directory in vCenter Server.
- (Optional) Require a trusted certificate for the vSphere agent by setting the trustAllCertificates parameter to false using the following statement in the
serviceConfigurationsection of the VRMAgent.exe.config file:
trustAllCertificates = "false"
Because this setting is not encrypted, you cannot use the
DynamicOps.Vrm.VRMencrypt.exe VRMAgent.exe.config set trustAllCertificates falsecommand.
(Default) The vSphere agent does not require a trusted certificate from vCenter Server.
The vSphere agent requires a trusted certificate from vCenter Server.
- Navigate to vRealize Automation Agent – agentname service. and restart the
What to do next
For high-availability, you can install and configure a redundant agent for your endpoint. Install each redundant agent on a separate server, but name and configure the agents identically.