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 Long	antHomes (String(s)) Path to Ant home directories.
static String	APPLE
static Long	bootstrapPort (int(s)) Port on which the Bootstrapper was started on each host.
static Long	extraTestDirs (String(s)) Path to auxiliary test classes for each logical host, used by GemFire add-ons such as GFMon.
static Long	gemfireHomes (String(s)) Path to GemFire product directory for each logical host.
static String	HITACHI
static String	HOST_NAME_PROPERTY
static Long	hostNames (String(s) or List of list of String(s)) Physical host names, if a simple list.
static String	IBM
static Long	javaHomes (String(s)) Path to Java home directories for each logical host.
static Long	javaVendors (String(s)) Vendors used by the VMs specified in javaHomes.
static Long	jprobeHomes (String(s)) Path to JProbe home directories for each logical host.
static String	JROCKIT
static Long	names (String(s)) Logical names of the host descriptions.
static Long	osTypes (String(s)) O/S type for each logical host.
static Long	resourceDirBaseMapFileName (String) Absolute name of file containing a mapping of physical host names to absolute base directories, as a list of properties.
static Long	resourceDirBases (String(s)) Absolute base directories for managed resources that use them, for example, gemfire system logs and statarchives.
static String	SUN
static Long	testDirs (String(s)) Path to test classes for each logical host.
static 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 SortedMap<String,Vector<String>>	getHostNameMap()
static String	getJavaVendor() Returns the java vendor for this VM.
static 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 SortedMap	getResourceDirBaseMap()
static void	main(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 String HOST_NAME_PROPERTY

See Also:

Constant Field Values

names

public static 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 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 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 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 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 Long userDirs

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

resourceDirBases

public static 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 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 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 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 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 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 String SUN

See Also:

Constant Field Values

IBM

public static final String IBM

See Also:

Constant Field Values

JROCKIT

public static final String JROCKIT

See Also:

Constant Field Values

APPLE

public static final String APPLE

See Also:

Constant Field Values

HITACHI

public static final String HITACHI

See Also:

Constant Field Values

jprobeHomes

public static 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 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 SortedMap<String,Vector<String>> getHostNameMap()

getResourceDirBaseMap

public static SortedMap getResourceDirBaseMap()

getJavaVendor

public static 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 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(String[] args)