Show TOC Start of Content Area

Function documentation Administration Adapter Service  Locate the document in its SAP Library structure

Use

The Administration Adapter Service is part of the distributed services level of the JMX infrastructure. It provides:

·        a remote connector to the MBean Server based on RMI/P4

·        convenient interfaces for working with the MBeans registered by the Basic Administration Service

·        a Swing-based GUI for remote administration (the Visual Administrator)

·        shell commands for console administration.

The Administration Adapter Service provides users with the option of having access to the MBean Server remotely. To do this they have to look up the service interface of the Administration Adapter Service from the JNDI using the following syntax:

Syntax

InitialContext ctx = new InitialContext(brokerProperties);

    RemoteAdminInterface remoteAdminInterface = (RemoteAdminInterface)ctx.lookup("adminadapter");

 

The object that is returned is remote, and other remote convenient interfaces can be retrieved from it, as well as the remote DefaultMBeanAdministrator that provides direct access to the methods of the MBean Server remotely.

The convenient interfaces provide the option for any user or administration tool to work with the MBeans registered by the Basic Administration Service (that is, to manage the server), based on the semantics of the resources that are instrumented by these MBeans. This means that the Administration Adapter Service provides a higher-level view of the server. This view is represented by a tree whose root node is the MBean that instruments the cluster.

The RemoteAdminInterface has a method for retrieving the tree of MBeans and also provides interfaces for managing each type of tree node.

When registered in the MBean Server, each MBean, if it extends the com.sap.pj.jmx.mbeaninfo.AdditionalInfoProviderMBean class, can specify a path in the administrator’s tree where it must appear when displayed. This path is specified by the admin.pathproperty and “/” is used as a delimiter (for example /Cluster/Server One/My Mbean). There is also the option to group MBeans under a common node in the administrator’s tree – this can be done by placing $GROUP_ as a prefix in the respective part of the name (for example /Cluster/Server One/$GROUP_Services/EJB). The MBeans are visible in the tree only if their parent is also visible.

All nodes in the administrator’s tree have a type. It can be one of the types displayed below (which are defined as constants in com.sap.engine.services.adminadapter.interfaces.MBeanTreeNode):

Node Types

Type

Description

Convenient Interface

TYPE_CLUSTER_MBEAN

The root node representing the cluster.

com.sap.engine.services.
adminadapter.interfaces.
ClusterAdministrator

TYPE_CLUSTER_NODE_MBEAN

Represents a cluster node.

com.sap.engine.services.
adminadapter.interfaces.
ClusterAdministrator

TYPE_KERNEL_MBEAN

Represents the standard MBean that instruments the kernel of a cluster node.

com.sap.engine.services.
adminadapter.interfaces.
KernelAdministrator

TYPE_SERVICE_MBEAN

Represents a standard MBean that instruments a service.

com.sap.engine.services.
adminadapter.interfaces.
ServiceAdministrator

TYPE_LIBRARY_MBEAN

Represents a standard MBean that instruments a library.

com.sap.engine.services.
adminadapter.interfaces.
LibraryAdministrator

TYPE_INTERFACE_MBEAN

Represents a standard MBean that instruments an interface.

com.sap.engine.services.
adminadapter.interfaces.
InterfaceAdministrator

TYPE_GROUP

Represents a standard MBean that instruments a service.

There is no administrator interface as groups can specify only names and do not provide any additional functionality.

TYPE_UNSPECIFIED_MBEAN

All other MBeans.

com.sap.engine.services.
adminadapter.interfaces.
DefaultMBeanAdministrator

 

The convenient interfaces also enable the registration of event listeners. Users can register to receive notifications about added/removed MBeans, started/stopped services, changed properties, and so on.

Withthe ServiceAdministrator you can have easy access to the functionality of the specific MBean for a service. The generateManagementInterfaceProxy() method returns a proxy object that can be cast to the specific interface defined by the service.

The Swing-based GUI is also part of the Administration Adapter Service. It uses convenient interfaces and the administrator’s tree that can be retrieved from the RemoteAdminInterface to represent the management functionality.

The console counterpart of the GUI administrator consists of several shell commands that are grouped in the ADMIN command group.

End of Content Area