Virtual Machine Manager

Copyright (C) 2009 France Telecom

Documentation

Reference

Drivers

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