Package com.sun.appserv.management.client

Contains classes and interfaces concerned with connectivity to the Appserver Connecting to the Domain Admin Server (DAS)

AMX supports connection to the DAS only; it does not support connections to individual server instances.

See:
Description

Interface Summary

ConnectionSource

A source of an MBeanServerConnection.

Class Summary

AdminRMISSLClientSocketFactory	Not for public use RMISSLClientSocketFactory which allows the configuration of security parameters by an RMI client; by default is not possible to configure these parameters.
AdminRMISSLClientSocketFactoryEnvImpl	Not for public use Class which encapsulates knowledge of how to exchange data between the RMISSLClientSocketFactory stub and the JVM into which it gets downloaded.
AppserverConnectionSource	Supports connectivity to Sun Appserver 8.1 and later (not available prior to 8.1).
HandshakeCompletedListenerImpl	A default HandshakeCompletedListener which remembers the last HandshakeCompletedEvent that occured.
MapConverter	Converts Maps obtained from the server back into their proprietary (non-standard) java types.
ProxyFactory	Factory for AMX proxies.
TLSParams	Class encapsulating parameters available for use with TLS.
TrustAnyTrustManager	This TrustManager applies no logic as to whether its peer certificate is trusted; it trusts all peers.
TrustStoreTrustManager	This X509TrustManager implementation supports a trust-store file and allows adding new certificates to it.

Package com.sun.appserv.management.client Description

Contains classes and interfaces concerned with connectivity to the Appserver

Connecting to the Domain Admin Server (DAS)

AMX supports connection to the DAS only; it does not support connections to individual server instances. This makes it simple to interact with all servers, clusters, etc with a single connection.

To connect to the server, you will need to determine the following:

• hostname of the Domain Admin Server
• RMI administrative port of the Domain Admin Server (not the http port used by the admin GUI). The default is 8686.
• admin user
• admin password
• whether TLS/SSL is enabled or not

To determine the RMI admin port and whether TLS is enabled, you can always view domain.xml. Look for the jmx-connector element; it should look something like this:

<jmx-connector accept-all="false" address="0.0.0.0" auth-realm-name="admin-realm" enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="true">

In the above example, security is enabled, so useTLS must be true. The RMI administrative port is 8686.

Note that in an EE build, TLS is generally enabled, so useTLS must be true and the trustStore and truststorePassword are required. Connections will fail (or hang) if useTLS is not set appropriately. In a PE build, TLS is not enabled by default.

Once you have connected to the DAS via an AppserverConnectionSource call getDomainRoot() to get an instance of DomainRoot. All further interfaces may be obtained from DomainRoot, directly or indirectly.