hydra

Class CacheServerHelper

java.lang.Object

hydra.CacheServerHelper

public class CacheServerHelper
extends java.lang.Object

Provides support for command-line cache servers managed by hydra clients. Automatically manages server PIDs in the nukerun.sh script so they are nuked when the test is nuked.

Each cache server must be given a unique name. Methods in this class assume but do not enforce this and are not thread-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CacheServerHelper.Record Represents the runtime record for a cache server.

Constructor Summary

Constructors

Constructor and Description
CacheServerHelper()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getStartCommand(java.lang.String name, ClientDescription cd, java.lang.String cacheXmlFile, java.lang.String[] extraArgs) Returns the command line for a "start" operation on the given cache server.
static java.lang.String	getStopCommand(java.lang.String name, HostDescription hd) Returns the command line for a "stop" operation on the given cache server.
static void	killCacheServer(java.lang.String name) Kills the cache server with the given name with a mean kill.
static void	startCacheServer(java.lang.String name, java.lang.String cacheXmlFile) Starts a command-line cache server with the given name on the local host, configured using the XML file.
static void	startCacheServer(java.lang.String name, java.lang.String cacheXmlFile, java.lang.String[] extraArgs) Starts a command-line cache server with the given name on the local host, configured using the XML file and optional extra arguments.
static void	stopCacheServer(java.lang.String name) Stops the cache server with the given name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CacheServerHelper

public CacheServerHelper()

Method Detail

startCacheServer

public static void startCacheServer(java.lang.String name,
                                    java.lang.String cacheXmlFile)

Starts a command-line cache server with the given name on the local host, configured using the XML file. Sets the system directory to the same name in the user directory of the creator. The name must be unique test-wide.

Throws:

HydraRuntimeException - if the cache server does not start.

startCacheServer

public static void startCacheServer(java.lang.String name,
                                    java.lang.String cacheXmlFile,
                                    java.lang.String[] extraArgs)

Starts a command-line cache server with the given name on the local host, configured using the XML file and optional extra arguments. Sets the system directory to the same name in the user directory of the creator. The name must be unique test-wide.

Throws:

HydraRuntimeException - if the cache server does not start.

killCacheServer

public static void killCacheServer(java.lang.String name)

Kills the cache server with the given name with a mean kill.

Throws:

HydraRuntimeException - if the cache server is not running.

HydraTimeoutException - if the kill takes more than 300 seconds.

stopCacheServer

public static void stopCacheServer(java.lang.String name)

Stops the cache server with the given name.

Throws:

HydraRuntimeException - if the cache server is not running or did not stop.

getStartCommand

public static java.lang.String getStartCommand(java.lang.String name,
                                               ClientDescription cd,
                                               java.lang.String cacheXmlFile,
                                               java.lang.String[] extraArgs)

Returns the command line for a "start" operation on the given cache server.

getStopCommand

public static java.lang.String getStopCommand(java.lang.String name,
                                              HostDescription hd)

Returns the command line for a "stop" operation on the given cache server.