Managed object metadata

Information about a node, such as operating system platform and product features, is maintained in the configuration repository in the form of properties. As product features are installed on a node, new property settings are added.

WebSphere Application Server system management uses the managed object metadata properties as follows:

• To display the node version in the administrative console

• To ensure that new configuration types or attributes are not created or set on older release nodes

• To ensure that new resource types are not created on old release nodes

• To ensure that new applications are not installed on old release nodes because the old run time cannot support the new applications

The following base property keys are defined for WAS:

com.ibm.websphere.baseProductVersion: The version of WAS installed.

com.ibm.websphere.nodeOperatingSystem: The operating system platform on which the node runs.

com.ibm.websphere.deployed.features: A list of features that extends a profile. An example of a feature is an administrative console plug-in.

(ZOS) com.ibm.websphere.nodeSysplexName: The sysplex name on a z/OS operating system.

Here are examples of metadata property values. The com.ibm.websphere.deployed.features metadata property value is split on multiple lines for printing purposes.

com.ibm.websphere.baseProductVersion=7.0.0.0
com.ibm.websphere.deployed.features=
com.ibm.ws.base_6.0.0.0,com.ibm.ws.j2ee_6.0.0.0,
com.ibm.ws.uddi_6.0.0.0,com.ibm.ws.wsgateway_6.0.0.0

(AIX)

com.ibm.websphere.nodeOperatingSystem=aix

(Linux)

com.ibm.websphere.nodeOperatingSystem=linux

(HPUX)

com.ibm.websphere.nodeOperatingSystem=hpux

(Solaris)

com.ibm.websphere.nodeOperatingSystem=solaris

(Windows)

com.ibm.websphere.nodeOperatingSystem=windows

(iSeries)

com.ibm.websphere.nodeOperatingSystem=os400

(ZOS)

com.ibm.websphere.nodeSysplexName=PLEX1
com.ibm.websphere.nodeOperatingSystem=os390

For detailed information on metadata properties, view the ManagedObjectMetadataHelper class in the application programming interfaces documentation.

An administrator can query managed object metadata through the wsadmin tool or Application Server APIs. They can additionally be viewed on the Node Installation properties administrative console page. This information provides details on the Application Server API method.

An accessor class is used to obtain the managed object metadata properties. An accessor instance is created through its factory. A helper class, which uses the accessor instance, makes it easy to query the base metadata properties. These classes are all part of the com.ibm.websphere.management.metadata package in the Application Server API documentation. The specific names of these classes are:

• com.ibm.websphere.management.metadata.ManagedObjectMetadataHelper
• com.ibm.websphere.management.metadata.ManagedObjectMetadataAccessor
• com.ibm.websphere.management.metadata.ManagedObjectMetadataAccessorFactory

Related:

Additional Application Programming Interfaces (APIs)

Add, manage, and remove nodes

Administer nodes and resources

Get started with wsadmin scripting

Use administrative programs (JMX)

Node installation properties