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 ESX servers that a vCenter Server instance manages. The EAM Sample Solution also optionally installs the VIB 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.0.

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 prompt, 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 in which to run the EAM Sample Solution by running the following command.

Option

Description

tcruntime-instance.bat create tcserver

Windows

tcruntime-instance.sh create tcserver

Linux

3

Install the tcserver tc Server instance by running the following command.

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 in 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 are running the tc Server on the same machine as vCenter Server, to avoid a port clash with the vCenter Tomcat server, change the default port value of self.url.prefix, for example, from 8080 to 18080.

8

Leave the vib.deploy value set to false and save and close the file.

9

(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

10

Restart the tc Server instance tcserver by running the following command.

Option

Description

tcruntime-ctl.bat tcserver start

Windows

tcruntime-ctl.sh tcserver start

Linux

11

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.