Network Deployment (Distributed operating systems), v8.0 > Reference > Developer detailed usage information


Management of UDDI node states and attributes

We can use the UDDI registry administrative interface to manage the information about a UDDI node and its activation state.

UDDI nodes can be in one of several states, depending on the way the UDDI application is installed. The UddiNode MBean provides four read-only attributes:

The following MBean operations change the state of the UDDI node:

nodeID

The node ID is the unique identifier for a UDDI node. If the UDDI application is installed as a default configuration, the node ID is generated automatically. If the UDDI application is installed manually, the administrator sets the node ID. The node ID must be a valid UDDI key. 
String nodeID = uddiNode.getNode();

System.out.println("node ID: " + nodeId);

nodeState

The nodeState attribute can have one of the values in the following table:

nodeState attribute values. The table lists different nodeState values along with the English text associated with each one.

nodeState value English text associated with state
node.state.uninitialized Not initialized
node.state.initialized Initialized
node.state.initPending Initialization pending
node.state.initInProgress Initialization in progress
node.state.initMigrationPending Migration pending
node.state.initMigration Migration in progress
node.state.initValueSetCreationPending Value set creation pending
node.state.initValueSetCreation Value set creation in progress
node.state.activated Activated
node.state.deactivated Deactivated
node.state.unknown Unknown

After a UDDI application is installed as a default configuration,, the UDDI node is in activated state, that is, ready to receive and process UDDI API requests. The node ID, root key generator, and some other properties are generated and you cannot change them.

After a UDDI application is installed manually, for example, because to specify the UDDI node ID and root key generator values, when the UDDI application starts, the UDDI node is in initPending state. In this state, you can update all writable values until you invoke the initNode operation. The initNode operation loads base tModel entities and value set data, and writes all the configuration data to the database for the UDDI node. During initialization, the UDDI node is in initInProgress state. When initialization completes, the state changes momentarily to initialized and settles at activated. At this point, the state can be switched only between the activated and deactivated states, using the deactivateNode and activateNode MBean operations.

Each node state value is a message key that can be looked up in the messages.properties resource bundle. We can retrieve the attribute value by using the getNodeState method of the UddiNodeProxy class.

  1. Invoke the getNodeState method: 
    String nodeStateKey = uddiNode.getNodeState();
  2. Look up translated text from the resource bundle and produce it as output: 
    String messages = "com.ibm.uddi.v3.management.messages";

ResourceBundle bundle = ResourceBundle.getBundle(messages,Locale.ENGLISH);

String nodeStateText =  bundle.getString(nodeStateKey);

System.out.println("node state: " + nodeStateText);

nodeDescription

We can get the administrator-assigned description for the UDDI node by using the getNodeDescription method of the UddiNodeProxy class.

  • Invoke the getNodeDescription method and produce output: 
    String nodeDescription = uddiNode.getNodeDescription();
System.out.println("node description: " + nodeDescription);

nodeApplicationName

We can use the nodeApplicationName attribute to discover where the UDDI application that corresponds to the UDDI node is installed. The value is a concatenation of the cell, node, and server names, separated by colons.

To retrieve the application location, use the getApplicationId method of the UddiNodeProxy class.

  • Invoke the getApplicationId method and produce output: 
    String nodeApplicationId = uddiNode.getApplicationId();

System.out.println("node application location: " + nodeApplicationId);

activateNode

Changes the state of the UDDI node to activated, if the UDDI node is currently deactivated.

  • Invoke the activateNode operation: 
    uddiNode.activateNode();

deactivateNode

Changes the state of the UDDI node to deactivated, if the UDDI node is currently activated.

  • Invoke the deactivateNode operation: 
    uddiNode.deactivateNode();

initNode

Initializes the UDDI node. When initialization completes, the UDDI node is in the activated state.

  • Invoke the initNode operation: 
     uddiNode.initNode();


Manage the UDDI registry
Use the UDDI registry
Use administrative programs (JMX)


Related


Management of UDDI node configuration properties
Management of UDDI node policies
Management of UDDI node tiers
Management of UDDI publishers
Management of UDDI node value sets
UDDI registry administrative (JMX) interface

+

Search Tips   |   Advanced Search