Configure an ORB service

We can use wsadmin.sh to configure an Object Request Broker (ORB) service in the environment. An ORB manages the interaction between clients and servers, using the Internet InterORB Protocol (IIOP). It enables clients to make requests and receive responses from servers in a network-distributed environment.

There are two ways to perform this task. Complete the steps in this topic to use the AdminConfig object to modify the ORB configuration. Alternatively, we can use the configureORBService Jython script in the AdminServerManagement script library to configure settings for the ORB service. The wsadmin tool automatically loads the script when the tool starts. Use the following syntax to configure JVM settings using the configureORBService script:

AdminServerManagement.configureORBService(nodeName, serverName, requestTimeout, requestRetriesCount, requestRetriesDelay, connectionCacheMax, connectionCacheMin, locateRequestTimeout, otherAttributeList)

For additional information and argument definitions, see the documentation for the AdminServerMananagment script library.

1. Start the wsadmin scripting tool.
   

2. Identify the application server and assign it to the server variable.

   Use the AdminConfig object and the getid command to retrieve the configuration ID of the server of interest:

   • Jacl:
     set s1 [$AdminConfig getid /Cell:mycell/Node:mynode/Server:server1/]

   • Jython:

     s1 = AdminConfig.getid('/Cell:mycell/Node:mynode/Server:server1/')
     print s1 

   Element	Description
   set	Jacl command
   s1	Variable name
   $	Jacl operator for substituting a variable name with its value
   AdminConfig	Object representing the WAS configuration
   getid	AdminConfig command
   Cell	Object type
   mycell	Name of the object that will be modified
   Node	Object type
   mynode	Name of the object that will be modified
   Server	Object type
   server1	Name of the object that will be modified
   print	Jython command

   Example output:

   server1(cells/mycell/nodes/mynode/servers/server1|server.xml#Server_1)

3. Determine the ORB that belongs to the server.

   Use the AdminConfig object and the list command to identify the ORB that belongs to the server and assign it to the orb variable:

   • Jacl:
     set orb [$AdminConfig list ObjectRequestBroker $s1]

   • Jython:

     orb = AdminConfig.list('ObjectRequestBroker', s1)
     print orb

   Element	Description
   set	Jacl command
   orb	Variable name
   $	Jacl operator for substituting a variable name with its value
   AdminConfig	Object representing the WAS configuration
   list	AdminConfig command
   ObjectRequestBroker	AdminConfig object
   s1	Evaluates to the ID of server of interest
   print	Jython command

   Example output:

   (cells/mycell/nodes/mynode/servers/server1|server.xml#ObjectRequestBroker_1)

4. Modify the ORB configuration attributes.

   The following example modifies the connection cache maximum and pass by value attributes. We can modify the example to change the value of other attributes.

   • Jacl:
     $AdminConfig modify $orb {{connectionCacheMaximum 252} {noLocalCopies true}}

   • Jython:
     AdminConfig.modify(orb, [['connectionCacheMaximum', 252], ['noLocalCopies', 'true']])

   Element	Description
   $	Jacl operator for substituting a variable name with its value
   AdminConfig	Object representing the WAS configuration
   modify	AdminConfig command
   orb	Evaluates to the ID of ORB
   connectionCacheMaximum	Attribute
   252	Value of the connectionCacheMaximum attribute
   noLocalCopies	Attribute
   true	Value of the noLocalCopies attribute

5. Save the configuration changes.

   Use the following command example to save the configuration changes:

   AdminConfig.save()

6. In a network deployment environment only, synchronize the node.

   Use the syncActiveNodes script in the AdminNodeManagement script library to propagate the changes to all active nodes:

   AdminNodeManagement.syncActiveNodes()

Related tasks

Use the wsadmin scripting AdminConfig object for scripted administration

Object Request Broker tuning guidelines

Object Request Broker service settings

Server settings configuration scripts

Node administration scripts

Commands for the AdminConfig object