hydra

Class HostPrms

java.lang.Object

hydra.BasePrms

hydra.HostPrms

public class HostPrms
extends BasePrms

A class used to store keys for host configuration settings. The settings are used to create instances of HostDescription.

The number of instances is gated by names. The remaining parameters have the indicated default values. If fewer non-default values than names are given for these parameters, the remaining instances will use the last value in the list. See $JTESTS/hydra/hydra.txt for more details.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Long	antHomes (String(s)) Path to Ant home directories.
static java.lang.String	APPLE
static java.lang.Long	bootstrapPort (int(s)) Port on which the Bootstrapper was started on each host.
static java.lang.Long	extraTestDirs (String(s)) Path to auxiliary test classes for each logical host, used by GemFire add-ons such as GFMon.
static java.lang.Long	gemfireHomes (String(s)) Path to GemFire product directory for each logical host.
static java.lang.String	HITACHI
static java.lang.String	HOST_NAME_PROPERTY
static java.lang.Long	hostNames (String(s) or List of list of String(s)) Physical host names, if a simple list.
static java.lang.String	IBM
static java.lang.Long	javaHomes (String(s)) Path to Java home directories for each logical host.
static java.lang.Long	javaVendors (String(s)) Vendors used by the VMs specified in javaHomes.
static java.lang.Long	jprobeHomes (String(s)) Path to JProbe home directories for each logical host.
static java.lang.String	JROCKIT
static java.lang.Long	names (String(s)) Logical names of the host descriptions.
static java.lang.Long	osTypes (String(s)) O/S type for each logical host.
static java.lang.Long	resourceDirBaseMapFileName (String) Absolute name of file containing a mapping of physical host names to absolute base directories, as a list of properties.
static java.lang.Long	resourceDirBases (String(s)) Absolute base directories for managed resources that use them, for example, gemfire system logs and statarchives.
static java.lang.String	SUN
static java.lang.Long	testDirs (String(s)) Path to test classes for each logical host.
static java.lang.Long	userDirs (String(s)) User directories.

Fields inherited from class hydra.BasePrms

DASH, DEFAULT, NONE

Constructor Summary

Constructors

Constructor and Description
HostPrms()

Method Summary

Modifier and Type	Method and Description
static java.util.SortedMap<java.lang.String,java.util.Vector<java.lang.String>>	getHostNameMap()
static java.lang.String	getJavaVendor() Returns the java vendor for this VM.
static java.lang.String	getJavaVendor(int i) Returns the i'th value for javaVendors; Defaults to the vendor in the invoking VM, which, during test configuration, is the hydra master controller.
static java.util.SortedMap	getResourceDirBaseMap()
static void	main(java.lang.String[] args)

Methods inherited from class hydra.BasePrms

dumpKeys, keyForName, nameForKey, setValues, tab, tasktab

Methods inherited from class java.lang.Object

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

Field Detail

HOST_NAME_PROPERTY

public static final java.lang.String HOST_NAME_PROPERTY

See Also:

Constant Field Values

names

public static java.lang.Long names

(String(s)) Logical names of the host descriptions. Each name must be unique. Defaults to null. See the include files in $JTESTS/hydraconfig for common configurations.

bootstrapPort

public static java.lang.Long bootstrapPort

(int(s)) Port on which the Bootstrapper was started on each host. Defaults to BasePrms.NONE.

This parameter is used to bootstrap a hydra hostagent on a remote host. The port must match the one used to start a Bootstrapper on the remote host. A bootstrap port is required for remote hosts running Windows, and for remote hosts running Unix when the hydra master is on Windows. All other hostagent bootstrapping relies on ssh.

See Also:

Bootstrapper

hostNames

public static java.lang.Long hostNames

(String(s) or List of list of String(s)) Physical host names, if a simple list. Otherwise, a list of lists where each list is a logical host #name prefix followed by a list of physical host names to which logical host names with that prefix are mapped round robin.

The local host can be specified as "localhost". Default is the master host.

osTypes

public static java.lang.Long osTypes

(String(s)) O/S type for each logical host. For valid values, see HostHelper#OSType. Defaults to the O/S ltype of the hydra master.

This parameter must be configured appropriately in tests where at least one host uses a different O/S than the hydra master.

gemfireHomes

public static java.lang.Long gemfireHomes

(String(s)) Path to GemFire product directory for each logical host. Defaults to the value of -Dgemfire.home in the hydra master controller JVM.

userDirs

public static java.lang.Long userDirs

(String(s)) User directories. Default is the master user directory.

resourceDirBases

public static java.lang.Long resourceDirBases

(String(s)) Absolute base directories for managed resources that use them, for example, gemfire system logs and statarchives. When set, a managed resource uses as its working directory the base plus the test name. Used when running tests on remote hosts to avoid costly network overhead. Defaults to null, which is the master user.dir.

To move the remote directories back to the master user.dir after the test, run using BatteryTest with -DmoveRemoteDirs=true.

See also resourceDirBaseMapFileName.

resourceDirBaseMapFileName

public static java.lang.Long resourceDirBaseMapFileName

(String) Absolute name of file containing a mapping of physical host names to absolute base directories, as a list of properties. Overrides resourceDirBases. Defaults to null (no map file is used).

testDirs

public static java.lang.Long testDirs

(String(s)) Path to test classes for each logical host. Defaults to the value of -DJTESTS in the hydra master controller JVM.

extraTestDirs

public static java.lang.Long extraTestDirs

(String(s)) Path to auxiliary test classes for each logical host, used by GemFire add-ons such as GFMon. Defaults to the value of -DEXTRA_JTESTS in the hydra master controller JVM.

javaHomes

public static java.lang.Long javaHomes

(String(s)) Path to Java home directories for each logical host. Defaults to the value of -Djava.home in the hydra master controller JVM.

javaVendors

public static java.lang.Long javaVendors

(String(s)) Vendors used by the VMs specified in javaHomes. Default is the vendor used by the hydra master controller VM. Valid values are "Sun" (HotSpot), "IBM", "JRockit", "Apple", "Hitachi".

SUN

public static final java.lang.String SUN

See Also:

Constant Field Values

IBM

public static final java.lang.String IBM

See Also:

Constant Field Values

JROCKIT

public static final java.lang.String JROCKIT

See Also:

Constant Field Values

APPLE

public static final java.lang.String APPLE

See Also:

Constant Field Values

HITACHI

public static final java.lang.String HITACHI

See Also:

Constant Field Values

jprobeHomes

public static java.lang.Long jprobeHomes

(String(s)) Path to JProbe home directories for each logical host. Defaults to the value of -DJPROBE in the hydra master controller JVM.

antHomes

public static java.lang.Long antHomes

(String(s)) Path to Ant home directories. Defaults to the value of -DANT_HOME in the hydra master controller JVM.

Constructor Detail

HostPrms

public HostPrms()

Method Detail

getHostNameMap

public static java.util.SortedMap<java.lang.String,java.util.Vector<java.lang.String>> getHostNameMap()

getResourceDirBaseMap

public static java.util.SortedMap getResourceDirBaseMap()

getJavaVendor

public static java.lang.String getJavaVendor()

Returns the java vendor for this VM. This is really the JVM type. For example, it distinguishes Oracle HotSpot and Oracle JRockit.

getJavaVendor

public static java.lang.String getJavaVendor(int i)

Returns the i'th value for javaVendors; Defaults to the vendor in the invoking VM, which, during test configuration, is the hydra master controller.

main

public static void main(java.lang.String[] args)