The EAM Sample Solution is a Web-based application that demonstrates how to use OVF and (optionally) 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 VMware vFabric tc Server. For information about installing vFabric tc Server, see the vFabric tc Server Documentation.

Download the vSphere ESX Agent Manager SDK.

Verify that you have a running instance of vSphere 5.1.

Download vFabric tc Server from http://www.vmware.com/products/vfabric-tcserver/overview.html.

Unzip the tc Server download to an appropriate location on your system and set up the environment variables that tc Server requires.

1

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

For example, your_tcserver\vfabric-tc-server-standard-2.5.X-X.

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

Description

tcruntime-instance.bat create tcserver

Windows

tcruntime-instance.sh create tcserver

Linux

3

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

Option

Description

tcruntime-ctl.bat tcserver install

Windows

tcruntime-ctl.sh tcserver install

Linux

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: your_tcserver\vfabric-tc-server-standard-2.5.X-X\eamserver\webapps

5

Unzip the eam-sample.war file into the your_tcserver\vfabric-tc-server-standard-2.5.X-X\eamserver\webapps\ folder.

6

Open the file your_tcserver\vfabric-tc-server-standard-2.5.X-X\eamserver\webapps\eam-sample\WEB-INF\eamri.properties 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 eamri.properties.

# 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://*:8080/eam-sample

# vCenter 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 self.url.prefix from 8080 to 18080 to avoid a port clash with the vCenter Tomcat server.

8

Leave the vib.deploy value set to false.

9

Save and close the file.

10

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

bio.http.port=port_number

11

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

Option

Description

tcruntime-ctl.bat tcserver start

Windows

tcruntime-ctl.sh tcserver start

Linux

12

In a browser, go to http://tcserver_IP_address:8080/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 set up and started the EAM Sample Solution.

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