com.gemstone.gemfire.admin
Class AdminDistributedSystemFactory

java.lang.Object
  com.gemstone.gemfire.admin.AdminDistributedSystemFactory

public class AdminDistributedSystemFactory
extends Object

Factory for creating GemFire administration entities.

Since:

3.5

Constructor Summary

AdminDistributedSystemFactory()

Method Summary

static void	bindToAddress(String bindAddress) Deprecated. Use DistributedSystemConfig.setBindAddress(java.lang.String) instead.
static DistributedSystemConfig	defineDistributedSystem() Defines a "default" distributed system configuration based on VM system properties and the content of gemfire.properties.
static DistributedSystemConfig	defineDistributedSystem(DistributedSystem system, String remoteCommand) Defines a distributed system configuration for administering the distributed system to which this VM is currently connected.
static AdminDistributedSystem	getDistributedSystem(DistributedSystemConfig config) Returns the distributed system for administrative monitoring and managing.
static LogWriter	getLogWriter() Returns a default GemFire LogWriter for logging.

Methods inherited from class java.lang.Object

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

Constructor Detail

AdminDistributedSystemFactory

public AdminDistributedSystemFactory()

Method Detail

bindToAddress

public static void bindToAddress(String bindAddress)

Deprecated. Use DistributedSystemConfig.setBindAddress(java.lang.String) instead.

Sets the address this VM should bind to when connecting to the distributed system. This involves a system property, so using this option will limit all connections to distributed systems to this one network interface.

Using a null or empty bindAddress will clear the usage of this option and connections to distributed systems will return to using all available network interfaces.

This method always throws UnsupportedOperationException because it is now deprecated and is unsafe to use. Please use DistributedSystemConfig.setBindAddress(java.lang.String) instead.

Parameters:

bindAddress - machine name or IP address to bind to

Throws:

UnsupportedOperationException - because of deprecation

defineDistributedSystem

public static DistributedSystemConfig defineDistributedSystem()

Defines a "default" distributed system configuration based on VM system properties and the content of gemfire.properties. The DistributedSystemConfig.DEFAULT_REMOTE_COMMAND default remote command is used.

See Also:

DistributedSystem.connect(java.util.Properties)

defineDistributedSystem

public static DistributedSystemConfig defineDistributedSystem(DistributedSystem system,
                                                              String remoteCommand)
                                                       throws AdminException

Defines a distributed system configuration for administering the distributed system to which this VM is currently connected. The DistributedSystem is used to configure the discovery mechanism (multicast or locators), bind address, SSL attributes, as well as the logger of the DistributedSystemConfig. Note that the distributed system will not be able to be administered until the connect method is invoked.

Parameters:

system - A connection to the distributed system

remoteCommand - The shell command that is used to launch processes that run on remote machines. If null, then the default will be used.

Throws:

AdminException

Since:

4.0

getDistributedSystem

public static AdminDistributedSystem getDistributedSystem(DistributedSystemConfig config)
                                                   throws AdminException

Returns the distributed system for administrative monitoring and managing. You must then call AdminDistributedSystem.connect() before interacting with the actual system.

Parameters:

config - configuration definition of the system to administer

Returns:

administrative interface for a distributed system

Throws:

AdminException - if unable to connect to the distributed system

getLogWriter

public static LogWriter getLogWriter()

Returns a default GemFire LogWriter for logging. This LogWriter will log to standard out.

Returns:

a GemFire LogWriter for logging