You install the supported Java Runtime Environment, the guest agent, and the Software bootstrap agent on your Windows reference machine to create a template, snapshot, or Amazon Machine Instance that supports Software components.

Software supports scripting with Windows CMD, PowerShell 2.0.

Important

Because the boot process must not be interrupted, configure the virtual machine so that nothing causes the virtual machine's boot process to pause before reaching the final operating system login prompt. For example, verify that no processes or scripts prompt for user interaction when the virtual machine starts.

Identify or create a reference machine.

If you have previously installed the guest agent or Software bootstrap agent on this machine, remove the agents and runtime logs. See Updating Existing Virtual Machine Templates in vRealize Automation.

If you plan to remotely access the virtual machine Windows remote desktop for troubleshooting or for other reasons, install the Remote Desktop Services (RDS) for Windows.

Verify that all of the network configuration artifacts are removed from the network configuration files.

If you want to use the most secure approach for establishing trust between the guest agent and your Manager Service machine, obtain the SSL certificate in PEM format from your Manager Service machine. For more information about how the guest agent establishes trust, see Configuring the Windows Guest Agent to Trust a Server.

Verify that the Darwin user has Log on as a service access rights on the Windows reference machine.

1

Log in to your Windows reference machine as a Windows Administrator and open a command prompt.

2

Download and install the supported Java Runtime Environment from https://vRealize_VA_Hostname_fqdn:5480/service/software/index.html.

a

Download the Java SE Runtime Environment zip file https://vRealize_VA_Hostname_fqdn:5480/service/software/download/jre-version-win64.zip.

b

Create a \opt\vmware-jre folder and unzip the JRE file to the folder.

c

Open a PowerShell command window and enter type \opt\vmware-jre\bin\java -version to verify the installation.

The installed version of Java appears.

3

Download and install the vRealize Automation guest agent from https://vRealize_VA_Hostname_fqdn:5480/installer/.

a

Download GugentZip_version to the C drive on the reference machine.

b

Right-click the file and select Properties.

c

Click General.

d

Click Unblock.

e

Extract the files.

f

Unzip the installation file to C:\.

This produces the directory C:\VRMGuestAgent. Do not rename this directory.

4

Configure the guest agent to communicate with the Manager Service.

a

Open an elevated command prompt.

b

Navigate to C:\VRMGuestAgent.

c

Configure the guest agent to trust your Manager Service machine.

Option

Description

Allow the guest agent to trust the first machine to which it connects.

No configuration required.

Manually install the trusted PEM file.

Place the Manager Service PEM file in the C:\VRMGuestAgent\ directory.

d

Run winservice -i -h Manager_Service_Hostname_fdqn:portnumber -p ssl.

The default port number for the Manager Service is 443.

Option

Description

If you are using a load balancer

Enter the fully qualified domain name and port number of your Manager Service load balancer. For example, winservice -i -h load_balancer_manager_service.mycompany.com:443 -p ssl.

With no load balancer

Enter the fully qualified domain name and port number of your Manager Service machine. For example, winservice -i -h manager_service_machine.mycompany.com:443 -p ssl.

If you are preparing an Amazon machine image

You need to specify that you are using Amazon. For example, winservice -i -h manager_service_machine.mycompany.com:443:443 -p ssl -c ec2

5

Download the Software agent bootstrap file from https://vRealize_VA_Hostname_fqdn:5480/service/software/index.html.

a

Download the Software bootstrap agent file https://vRealize_VA_Hostname_fqdn:5480/service/software/download/vmware-vra-software-agent-bootstrap-windows_version.zip.

b

Right-click the file and select Properties.

c

Click General.

d

Click Unblock.

Important

If you do not disable this Windows security feature, you cannot use the Software agent bootstrap file.

e

Unzip the vmware-vra-software-agent-bootstrap-windows_version.zip file to the \temp folder.

6

Install the Software bootstrap agent.

a

Open a Windows CMD console and navigate to the \temp folder.

b

Enter the command to install the agent bootstrap.

install.bat password=Password managerServiceHost=manager_service_machine.mycompany.com managerServicePort=443 httpsMode=true cloudProvider=ec2|vca|vcd|vsphere

The default port number for the Manager Service is 443. Accepted values for cloudprovider are ec2, vca, vcd, and vsphere. The install.bat script creates a user account called darwin for the software bootstrap agent using the password you set in the install command. The Password you set must meet the Windows password requirements.

7

Verify that the user darwin_user exists.

a

Enter lusrmgr.msc at a command prompt.

b

Verify that the user darwin_user exists and belongs to the administrator group.

c

Set the password to never expire.

The setting ensures that the template remains usable after 30 days.

If the user is not available, verify that the Windows server password is accurate.

8

Shut down the Windows virtual machine.

Convert your reference machine into a template for cloning, an Amazon machine image, or a snapshot so your IaaS architects can use your template when creating blueprints.