Set up and Start the EAM Sample Solution

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.

Prerequisites

Procedure

  1. Copy the eam-sample.war file from the ESX Agent Manager SDK folder to a work directory.
  2. Unzip the eam-sample.war file.
  3. Open the <work_directory>\eam-sample\WEB-INF\eamri.properties file in a text editor.
  4. Provide the IP address of the machine where you run the solution, and the user name 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 Web application 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 Web application server.
  5. Leave the vib.deploy property value set to false.
  6. Save and close the file.
  7. (Optional) If you change the default port in the eamri.properties file, you must replicate this change in the Web application server configuration file catalina.properties.
    bio.http.port=<port_number>
  8. Copy the eam-sample directory from your work directory to the deployment location of your Web application server to deploy the EAM Sample solution.
  9. In a Web browser, go to http://<My_Web_App_Server_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 in case you changed the default value.
    You see the text The EAM Sample Solution is up and running.

Results

You have set up and started the EAM Sample Solution.

What to do next

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