# Virtual Machine Manager Copyright (C) 2009 France Telecom |

Documentation Home Installation Resource Configuration About VMM MBeans Client programming Reference Javadocs Drivers Dummy driver VMware VI driver Xen driver Driver framework | ## Installation
Software Prerequisites
Java 1.6 runtime
Starting up the VMM agent
Set the environment variable VMM_HOME to the path of the directory into which you have installed VMM Execute the shell command: `$VMM_HOME/bin/vmmstart.sh`
Checking the connection with the VMM agent
VMM comes with a simple CLI control program which allows you to recursively list the content (in terms of MBeans) of the VMM agent. Set the environment variable VMM_HOME to the path of the directory into which you have installed VMM and execute the shell command: ```$VMM_HOME/bin/vmmcontrol.sh list` You may also use any JMX management console such as the jconsole bundled with Sun JDK. The URL of the JMX RMI connector to use is as follows (assuming the console is run on the same machine as the VMM agent): `service:jmx:rmi:///jndi/rmi://localhost:9999/server`
Shutting down the VMM agent
Set the environment variable VMM_HOME to the path of the directory into which you have installed VMM Execute the shell command: `$VMM_HOME/bin/vmmcontrol.sh shutdown`
Configuring the VMM agent
The $VMM_HOME/etc directory contains all configuration files of the VMM agent: the agent configuration file agent.properties the XML managed resource configuration driver-specific property files the log4j configuration file log4j.properties The agent.properties file lets tou define the following properties:
Name | Default value | Description
--- | --- | ---
vmm.port | 9999 | port number of the JMX RMI connector server on which the agent will listen for client connections. Note that the agent will attempts to create a RMI registry on this port if none exists on the local machine.
vmm.resourceFile | managed-resources.xml | file name of the resource configuration file to be read at start up by the agent. This file must be located in the $VMM_HOME/etc dircetory