com.sun.sgs.impl.service.watchdog
Interface WatchdogClient

All Superinterfaces:

Remote

public interface WatchdogClient
extends Remote

A remote interface for callbacks from the Watchdog server.

Method Summary

void	nodeStatusChanges(long[] ids, String[] hosts, Node.Health[] health, long[] backups) Notifies this client that the nodes specified by corresponding information in the ids, hosts, health, and backups arrays have a health change and may need to recover (if the backup ID is equal to the local node ID).
void	reportFailure(String className) Mechanism to report a failure to the Watchdog service.

Method Detail

nodeStatusChanges

void nodeStatusChanges(long[] ids,
                       String[] hosts,
                       Node.Health[] health,
                       long[] backups)
                       throws IOException

Notifies this client that the nodes specified by corresponding information in the ids, hosts, health, and backups arrays have a health change and may need to recover (if the backup ID is equal to the local node ID). The backups array is only only consulted if the corresponding element in health returns false from Health.isAlive(). If no node has been assigned as a backup, it is indicated by -1L.

Parameters:

ids - an array of node IDs

hosts - an array of host names

health - an array of node health

backups - an array of backup node IDs

Throws:

IllegalArgumentException - if array lengths don't match

IOException - if a communication problem occurs while invoking this method

reportFailure

void reportFailure(String className)
                   throws IOException

Mechanism to report a failure to the Watchdog service. This is called by the Watchdog server when a remote node is instructed to shutdown. This method calls the node's local shutdown process to start the shutdown procedure.

Parameters:

className - the class which reported the failure

Throws:

IOException - if a communication problem occurs while invoking this method