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.

Prerequisites
■

Download the vSphere ESX Agent Manager SDK.

■

Verify that you have a running instance of vSphere 5.5 with vCenter Server installed.

■

Use the vSphere web client to connect to your vSphere 5.5 server.

■

From the Home screen in the web client, choose VMs and Templates, and then select the VM that is hosting vCenter Server.

■

Choose the Summary tab and then click Launch Console.

■

From the console window, change to the \usr\local\tcserver directory. This directory contains the tc Server, that is similar to the open source Apache Tomcat Server, but is customized for use with VMware products.

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

Description

tcruntime-instance.bat create tcserver

Windows

tcruntime-instance.sh create tcserver

Linux
3

Install the tcserver 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: tcserver\vfabric-tc-server-standard\eamserver\webapps

5

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

6

Open the file tcserver\vfabric-tc-server-standard\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 between the vCenter and tc Servers.

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 tcserver\vfabric-tc-server-standard\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 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