hydra

Class MasterProxy

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

hydra.MasterProxy

All Implemented Interfaces:

MasterProxyIF, java.io.Serializable, java.rmi.Remote

public class MasterProxy
extends java.rmi.server.UnicastRemoteObject
implements MasterProxyIF

Implements the remote interface for client access to the master.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

Constructors

Constructor and Description
MasterProxy()

Method Summary

Modifier and Type	Method and Description
ClientVmRecord	bounceUnitTestVm(int pid) For internal hydra use only.
void	configureNetworkConnection(java.lang.String source, java.lang.String target, int op, int way) For internal hydra use only.
java.util.List<java.util.List<java.lang.String>>	getClientMapping() Called remotely by client processes to get the client mapping as a list of lists, where each sublist is the threadgroup plus the thread name.
java.util.Vector	getClientVmids() For internal hydra use only.
java.util.Map	getClientVms() For internal hydra use only.
DerbyServerHelper.Endpoint	getDerbyServerEndpoint() For internal hydra use only.
java.lang.Object	getGlobalNext(java.lang.Long key) For internal hydra use only.
HostAgentIF	getHostAgent(java.lang.String host) For internal hydra use only.
TestConfig	getHostAgentTestConfig()
java.util.Map	getNetworkConnectionState() For internal hydra use only.
java.util.Vector	getOtherClientVmids(int vmid) For internal hydra use only.
int	getPid(int vmid) For internal hydra use only.
TestConfig	getTestConfig()
java.lang.Integer	getVmid(java.lang.String host, int pid) Called remotely by client processes to get VM ID corresponding to host and PID.
void	invoke(java.lang.String classname, java.lang.String methodname, java.lang.Class[] types, java.lang.Object[] args) Invokes the specified class method.
void	lockToSynchronizeJavaGroupsForBug30341() Start workaround for Bug 30341.
void	printClientProcessStacks()
void	reboot(java.lang.String srcName, int srcVmid, int actionId, java.lang.String reason, RebootInfo target) For internal hydra use only.
void	recordAgent(AgentHelper.Endpoint endpoint)
void	recordDir(HostDescription hd, java.lang.String name, java.lang.String dir)
void	recordHadoop(HadoopDescription hdd, HadoopDescription.NodeDescription nd, int pid, boolean secure)
void	recordHDFSPIDNoDumps(HostDescription hd, int pid, boolean secure)
void	recordLocator(DistributedSystemHelper.Endpoint endpoint) For internal hydra use only.
void	recordPID(HostDescription hd, int pid)
void	recordPIDNoDumps(HostDescription hd, int pid)
void	recordRootCommand(HostDescription hd, java.lang.String cmd, java.lang.String dir)
HydraThreadGroupInfo	registerClient(int vmid, int tid, RemoteTestModuleIF mod) For internal hydra use only.
void	registerClientDisconnect(int vmid) For internal hydra use only.
void	registerGemFireLocatorAgent(GemFireLocatorAgentRecord lar) For internal hydra use only.
void	registerHostAgent(HostAgentRecord har) For internal hydra use only.
void	removeHadoop(HadoopDescription hdd, HadoopDescription.NodeDescription nd, int pid, boolean secure)
void	removeHDFSPIDNoDumps(HostDescription hd, int pid, boolean secure)
void	removePID(HostDescription hd, int pid)
void	removePIDNoDumps(HostDescription hd, int pid)
void	reportResult(int tsid, int vmid, int tid, TestTaskResult result) For internal hydra use only.
void	reportStatMonitorError(java.lang.Throwable t) For internal hydra use only.
ClientVmInfo	reserveClientVmForStart(java.lang.String srcName, int srcVmid, ClientVmInfo target) For internal hydra use only.
ClientVmInfo	reserveClientVmForStop(java.lang.String srcName, int srcVmid, int syncMode, int stopMode, ClientVmInfo target) For internal hydra use only.
RebootInfo	reserveForReboot(java.lang.String srcName, int srcVmid, java.lang.String target, boolean liveOnly) For internal hydra use only.
boolean	reservePort(java.lang.String host, int port) For internal hydra use only.
void	showNetworkConnectionState() For internal hydra use only.
void	startClientVm(java.lang.String srcName, int srcVmid, int actionId, java.lang.String reason, int syncMode, ClientVmInfo target) For internal hydra use only.
void	stopClientVm(java.lang.String srcName, int srcVmid, int actionId, java.lang.String reason, int syncMode, int stopMode, int startMode, ClientVmInfo target) For internal hydra use only.
void	unlockToSynchronizeJavaGroupsForBug30341()

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MasterProxy

public MasterProxy()
            throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

Method Detail

getTestConfig

public TestConfig getTestConfig()
                         throws java.rmi.RemoteException

Specified by:

getTestConfig in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getHostAgentTestConfig

public TestConfig getHostAgentTestConfig()
                                  throws java.rmi.RemoteException

Specified by:

getHostAgentTestConfig in interface MasterProxyIF

Throws:

java.rmi.RemoteException

registerGemFireLocatorAgent

public void registerGemFireLocatorAgent(GemFireLocatorAgentRecord lar)
                                 throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by the locatoragent to register itself with the master.

Specified by:

registerGemFireLocatorAgent in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordLocator

public void recordLocator(DistributedSystemHelper.Endpoint endpoint)
                   throws java.rmi.RemoteException

Description copied from interface: MasterProxyIF

For internal hydra use only.

Specified by:

recordLocator in interface MasterProxyIF

Throws:

java.rmi.RemoteException

lockToSynchronizeJavaGroupsForBug30341

public void lockToSynchronizeJavaGroupsForBug30341()
                                            throws java.rmi.RemoteException

Start workaround for Bug 30341.

Specified by:

lockToSynchronizeJavaGroupsForBug30341 in interface MasterProxyIF

Throws:

java.rmi.RemoteException

unlockToSynchronizeJavaGroupsForBug30341

public void unlockToSynchronizeJavaGroupsForBug30341()
                                              throws java.rmi.RemoteException

Specified by:

unlockToSynchronizeJavaGroupsForBug30341 in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getDerbyServerEndpoint

public DerbyServerHelper.Endpoint getDerbyServerEndpoint()
                                                  throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by hydra clients to get the derby server endpoint.

Specified by:

getDerbyServerEndpoint in interface MasterProxyIF

Throws:

java.rmi.RemoteException

registerHostAgent

public void registerHostAgent(HostAgentRecord har)
                       throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by hostagents to register themselves with the master.

Specified by:

registerHostAgent in interface MasterProxyIF

Throws:

java.rmi.RemoteException

reportStatMonitorError

public void reportStatMonitorError(java.lang.Throwable t)
                            throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by hostagents to report a statistics monitor error.

Specified by:

reportStatMonitorError in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getHostAgent

public HostAgentIF getHostAgent(java.lang.String host)
                         throws java.rmi.RemoteException

For internal hydra use only.

Called by ProcessMgr to get a hostagent for a host.

Specified by:

getHostAgent in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getVmid

public java.lang.Integer getVmid(java.lang.String host,
                                 int pid)
                          throws java.rmi.RemoteException

Called remotely by client processes to get VM ID corresponding to host and PID.

Specified by:

getVmid in interface MasterProxyIF

Returns:

the VM ID if it exists else null.

Throws:

java.rmi.RemoteException

getClientMapping

public java.util.List<java.util.List<java.lang.String>> getClientMapping()
                                                                  throws java.rmi.RemoteException

Called remotely by client processes to get the client mapping as a list of lists, where each sublist is the threadgroup plus the thread name.

Specified by:

getClientMapping in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getPid

public int getPid(int vmid)
           throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by client processes to get accurate PID (for Linux).

Specified by:

getPid in interface MasterProxyIF

Throws:

java.rmi.RemoteException

registerClient

public HydraThreadGroupInfo registerClient(int vmid,
                                           int tid,
                                           RemoteTestModuleIF mod)
                                    throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by client threads to register themselves with the master.

Specified by:

registerClient in interface MasterProxyIF

Throws:

java.rmi.RemoteException

registerClientDisconnect

public void registerClientDisconnect(int vmid)
                              throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by client threads to register disconnect with the master.

Specified by:

registerClientDisconnect in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getClientVms

public java.util.Map getClientVms()
                           throws java.rmi.RemoteException

For internal hydra use only.

Called remotely by the unit test controller.

Specified by:

getClientVms in interface MasterProxyIF

Throws:

java.rmi.RemoteException

reportResult

public void reportResult(int tsid,
                         int vmid,
                         int tid,
                         TestTaskResult result)
                  throws java.rmi.RemoteException

For internal hydra use only.

Used by client threads to report task results to master.

Specified by:

reportResult in interface MasterProxyIF

Throws:

java.rmi.RemoteException

printClientProcessStacks

public void printClientProcessStacks()
                              throws java.rmi.RemoteException

Specified by:

printClientProcessStacks in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getGlobalNext

public java.lang.Object getGlobalNext(java.lang.Long key)
                               throws java.rmi.RemoteException

For internal hydra use only.

Used by client threads to get the global next from a RobinG.

Specified by:

getGlobalNext in interface MasterProxyIF

Throws:

java.rmi.RemoteException

reservePort

public boolean reservePort(java.lang.String host,
                           int port)
                    throws java.rmi.RemoteException

For internal hydra use only.

Used by client threads to reserve a port with the master, who adds it to the list of used ports for the host.

Specified by:

reservePort in interface MasterProxyIF

Returns:

whether the port was successfully reserved

Throws:

java.rmi.RemoteException

reserveClientVmForStop

public ClientVmInfo reserveClientVmForStop(java.lang.String srcName,
                                           int srcVmid,
                                           int syncMode,
                                           int stopMode,
                                           ClientVmInfo target)
                                    throws java.rmi.RemoteException,
                                           ClientVmNotFoundException

For internal hydra use only.

Reserves a client VM matching the specified info for future stop. Returns null if no match is found.

Specified by:

reserveClientVmForStop in interface MasterProxyIF

Parameters:

srcName - Thread name for the invoking client.

srcVmid - Logical VM id for the invoking client.

syncMode - Synchronization mode for the dynamic stop.

stopMode - Stop mode for the dynamic stop.

target - Information used to select the target client VM.

Returns:

Fully specified information for the selected VM.

Throws:

ClientVmNotFoundException - if a reservation could not be made.

java.lang.IllegalArgumentException - if the target info is invalid.

java.rmi.RemoteException

reserveClientVmForStart

public ClientVmInfo reserveClientVmForStart(java.lang.String srcName,
                                            int srcVmid,
                                            ClientVmInfo target)
                                     throws java.rmi.RemoteException,
                                            ClientVmNotFoundException

For internal hydra use only.

Reserves a client VM matching the specified info for future start. Returns null if no match is found.

Specified by:

reserveClientVmForStart in interface MasterProxyIF

Parameters:

srcName - Thread name for the invoking client.

srcVmid - Logical VM id for the invoking client.

target - Information used to select the target client VM.

Returns:

Fully specified information for the selected VM.

Throws:

ClientVmNotFoundException - if a reservation could not be made.

java.lang.IllegalArgumentException - if the target info is invalid.

java.rmi.RemoteException

stopClientVm

public void stopClientVm(java.lang.String srcName,
                         int srcVmid,
                         int actionId,
                         java.lang.String reason,
                         int syncMode,
                         int stopMode,
                         int startMode,
                         ClientVmInfo target)
                  throws java.rmi.RemoteException

For internal hydra use only.

Stops the target VM.

Specified by:

stopClientVm in interface MasterProxyIF

Throws:

java.rmi.RemoteException

startClientVm

public void startClientVm(java.lang.String srcName,
                          int srcVmid,
                          int actionId,
                          java.lang.String reason,
                          int syncMode,
                          ClientVmInfo target)
                   throws java.rmi.RemoteException

For internal hydra use only.

Starts the target VM.

Specified by:

startClientVm in interface MasterProxyIF

Throws:

java.rmi.RemoteException

bounceUnitTestVm

public ClientVmRecord bounceUnitTestVm(int pid)
                                throws java.rmi.RemoteException

For internal hydra use only.

Bounces the VM with the given PID.

Specified by:

bounceUnitTestVm in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getClientVmids

public java.util.Vector getClientVmids()
                                throws java.rmi.RemoteException

For internal hydra use only.

Returns the VM IDs (as Integers) for all client VMs, regardless of whether the VMs are currently started or stopped.

Specified by:

getClientVmids in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getOtherClientVmids

public java.util.Vector getOtherClientVmids(int vmid)
                                     throws java.rmi.RemoteException

For internal hydra use only.

Returns the VM IDs (as Integers) for all client VMs except the given one, regardless of whether the VMs are currently started or stopped.

Specified by:

getOtherClientVmids in interface MasterProxyIF

Throws:

java.rmi.RemoteException

reserveForReboot

public RebootInfo reserveForReboot(java.lang.String srcName,
                                   int srcVmid,
                                   java.lang.String target,
                                   boolean liveOnly)
                            throws java.rmi.RemoteException,
                                   RebootHostNotFoundException

For internal hydra use only.

Reserves a host for future reboot.

Specified by:

reserveForReboot in interface MasterProxyIF

Parameters:

srcName - Thread name for the invoking client.

srcVmid - Logical VM id for the invoking client.

target - The target host.

liveOnly - Whether to return only processes that were live at the time of the reboot.

Returns:

Information about the host and the processes running on it.

Throws:

RebootHostNotFoundException - if a reservation could not be made.

java.lang.IllegalArgumentException - if the target is invalid.

java.rmi.RemoteException

reboot

public void reboot(java.lang.String srcName,
                   int srcVmid,
                   int actionId,
                   java.lang.String reason,
                   RebootInfo target)
            throws java.rmi.RemoteException

For internal hydra use only.

Reboots the target.

Specified by:

reboot in interface MasterProxyIF

Throws:

java.rmi.RemoteException

configureNetworkConnection

public void configureNetworkConnection(java.lang.String source,
                                       java.lang.String target,
                                       int op,
                                       int way)
                                throws java.rmi.RemoteException

For internal hydra use only.

Specified by:

configureNetworkConnection in interface MasterProxyIF

Throws:

java.rmi.RemoteException

getNetworkConnectionState

public java.util.Map getNetworkConnectionState()
                                        throws java.rmi.RemoteException

For internal hydra use only.

Specified by:

getNetworkConnectionState in interface MasterProxyIF

Throws:

java.rmi.RemoteException

showNetworkConnectionState

public void showNetworkConnectionState()
                                throws java.rmi.RemoteException

For internal hydra use only.

Specified by:

showNetworkConnectionState in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordAgent

public void recordAgent(AgentHelper.Endpoint endpoint)
                 throws java.rmi.RemoteException

Specified by:

recordAgent in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordPID

public void recordPID(HostDescription hd,
                      int pid)
               throws java.rmi.RemoteException

Specified by:

recordPID in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordPIDNoDumps

public void recordPIDNoDumps(HostDescription hd,
                             int pid)
                      throws java.rmi.RemoteException

Specified by:

recordPIDNoDumps in interface MasterProxyIF

Throws:

java.rmi.RemoteException

removePID

public void removePID(HostDescription hd,
                      int pid)
               throws java.rmi.RemoteException

Specified by:

removePID in interface MasterProxyIF

Throws:

java.rmi.RemoteException

removePIDNoDumps

public void removePIDNoDumps(HostDescription hd,
                             int pid)
                      throws java.rmi.RemoteException

Specified by:

removePIDNoDumps in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordHadoop

public void recordHadoop(HadoopDescription hdd,
                         HadoopDescription.NodeDescription nd,
                         int pid,
                         boolean secure)
                  throws java.rmi.RemoteException

Specified by:

recordHadoop in interface MasterProxyIF

Throws:

java.rmi.RemoteException

removeHadoop

public void removeHadoop(HadoopDescription hdd,
                         HadoopDescription.NodeDescription nd,
                         int pid,
                         boolean secure)
                  throws java.rmi.RemoteException

Specified by:

removeHadoop in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordHDFSPIDNoDumps

public void recordHDFSPIDNoDumps(HostDescription hd,
                                 int pid,
                                 boolean secure)
                          throws java.rmi.RemoteException

Specified by:

recordHDFSPIDNoDumps in interface MasterProxyIF

Throws:

java.rmi.RemoteException

removeHDFSPIDNoDumps

public void removeHDFSPIDNoDumps(HostDescription hd,
                                 int pid,
                                 boolean secure)
                          throws java.rmi.RemoteException

Specified by:

removeHDFSPIDNoDumps in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordRootCommand

public void recordRootCommand(HostDescription hd,
                              java.lang.String cmd,
                              java.lang.String dir)
                       throws java.rmi.RemoteException

Specified by:

recordRootCommand in interface MasterProxyIF

Throws:

java.rmi.RemoteException

recordDir

public void recordDir(HostDescription hd,
                      java.lang.String name,
                      java.lang.String dir)
               throws java.rmi.RemoteException

Specified by:

recordDir in interface MasterProxyIF

Throws:

java.rmi.RemoteException

invoke

public void invoke(java.lang.String classname,
                   java.lang.String methodname,
                   java.lang.Class[] types,
                   java.lang.Object[] args)
            throws java.rmi.RemoteException

Invokes the specified class method. Intended for use by client threads. The invocation is synchronized across clients, so this is suitable for operations such as lazily creating shared blackboards.

Specified by:

invoke in interface MasterProxyIF

Throws:

java.rmi.RemoteException