The EAM Sample Solution is a Web-based application. The solution demonstrates how to use OVF and vSphere Installation Bundle (VIB) files to deploy ESX agent virtual machines to ESXi servers that a vCenter Server instance manages. The EAM Sample Solution also optionally installs the VIB files and integrates them with DvFilter.

The EAM Sample Solution is preconfigured to work with the Pivotal tc Server. For information about installing the Pivotal tc Server, see the Pivotal tc Server.

Prerequisites
■

Download the vSphere ESX Agent Manager SDK.

■

Verify that you have a running vCenter Server 6.0 instance.

Procedure
1

In a command window, go to the root folder of your tc Server.

For example, tcserver\vfabric-tc-server-standard.

2

Create an instance of a tc Server named tcserver where you can run the EAM Sample Solution using one of the following commands.

Option

Command

Windows

tcruntime-instance.bat create tcserver

Linux

tcruntime-instance.sh create tcserver
3

Install the tcserver instance by running one of the following commands.

Option

Command

Windows

tcruntime-ctl.bat tcserver install

Linux

tcruntime-ctl.sh tcserver install
4

Copy the file eam-sample.war from the ESX Agent Manager SDK work folder to the webapps folder in your tc Server.

■

Source location: the eam_work_folder that you created in Download the vSphere ESX Agent Manager SDK

■

Destination location: tcserver\vfabric-tc-server-standard\tcserver\webapps

5

Unzip the eam-sample.war file into the tcserver\vfabric-tc-server-standard\tcserver\webapps\ folder.

6

Open the tcserver\vfabric-tc-server-standard\tcserver\webapps\eam-sample\WEB-INF\eamri.properties file in a text editor.

7

Provide the IP address of the machine where you run the solution, and the username and password for your vCenter Server system in the eamri.properties file. 

# IP of your machine.
self.ip=solution_IP_address
# URL prefix. If running on any other port than standard Tomcat port change 8080 to
# the used port.
self.url.prefix=http://*:port_number/eam-sample

# vCenter Server  settings.
vc.host=vCenter_Server_IP_address
vc.http.proxy.port = 80
vc.https.proxy.port = 443
vc.user = username
vc.password = password
Note

If you run the tc Server on the same machine as vCenter Server, change the default port value of the self.url.prefix property from 8080 to 18080 to avoid a port clash between the vCenter Server instance and the tc Servers.

8

Leave the vib.deploy property value set to false.

9

Save and close the file.

10

(Optional) If you changed the default port in the eamri.properties file, you must replicate this change in the tc Server configuration file tcserver\vfabric-tc-server-standard\tcserver\conf\catalina.properties.

bio.http.port=port_number

11

Restart the tc Server instance tcserver by running one of the following commands.

Option

Command

Windows

tcruntime-ctl.bat tcserver start

Linux

tcruntime-ctl.sh tcserver start
12

In a Web browser, go to http://tcserver_IP_address:port_number/eam-sample/ to check that the EAM Sample Solution is running.

Note

Make sure that you use the correct port number in the URL, if you changed it from the default value.

You should see the text The EAM Sample Solution is up and running.

You have set up and started the EAM Sample Solution.

What to do next

View the EAM Sample Solution in the vSphere Web Client and use it to deploy ESX agent virtual machines.

Previous topic: Download the vSphere ESX Agent Manager SDK
Next topic: View the EAM Sample Solution in Solutions Manager