org.apache.ace.nodelauncher
Interface NodeLauncher

public interface NodeLauncher

A TargetLauncher starts, stops and interrogates named nodes. These nodes represent running JVMs in some sense; they can be provided by some cloud-provider, or running JVMs on a single machine.

It is up to the provider to decide what to run on the given Node. This can be either a single Management Agent, which can be identified by the id, or a Node Manager.

Method Summary

Properties	getProperties(String id) Retrieves properties from the node.
void	start(String id) Starts a new node with the given ID.
void	stop(String id) Destroys the node with the given ID.

Method Detail

start

void start(String id)
           throws Exception

Starts a new node with the given ID. Does not check whether this ID is already in use.

Parameters:

id - A textual ID for the node.

Throws:

Exception - Be aware that the implementation may pass through implementation-specific exceptions.

stop

void stop(String id)
          throws Exception

Destroys the node with the given ID. Does not check whether this ID actually exists.

Parameters:

id - A textual ID for the node.

Throws:

Exception - Be aware that the implementation may pass through implementation-specific exceptions.

getProperties

Properties getProperties(String id)
                         throws Exception

Retrieves properties from the node. These will include, at least

• ip The public IP address of the node.

Parameters:

id - The textual ID for the node.

Returns:

the properties of the node, or null if this node cannot be found.

Throws:

Exception - Be aware that the implementation may pass through implementation-specific exceptions.