You can use properties files to change Object Request Broker
(ORB) properties and associated interceptors, plug-ins, properties
and thread pool attributes under a server.
Before you begin
Determine the changes that you want to make to your Object
Request Broker configuration.
Start the wsadmin scripting tool.
To start wsadmin using the Jython language, run the wsadmin
-lang jython command from the bin directory
of the server profile.
About this task
Using a properties file, you can create, modify, or delete
Object Request Broker configuration properties.
Run administrative
commands using wsadmin to change a properties file for an Object Request
Broker, validate the properties, and apply them to your configuration.
Table 1. Actions for Object Request
Broker properties files. You can create, modify, and
delete Object Request Broker properties.Action |
Procedure |
create |
Not applicable |
modify |
Edit properties and then run the applyConfigProperties command. |
delete |
Not applicable |
create Property, Plug-ins, or Interceptors |
Set properties and then run the applyConfigProperties command. |
delete Property, Plug-ins, or Interceptors |
Specify those properties to delete in the properties
file and then run the deleteConfigProperties command. |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create Object Request Broker properties.
- Specify ObjectRequestBroker properties in a properties
file.
Open an editor and specify Object Request Broker
properties in a properties file. You can copy the following example
properties into an editor and modify the properties as needed for
your situation. You can use properties files to change Object Request
Broker properties and associated interceptors, plug-ins, properties
and thread pool attributes under a server.
# SubSection 1.0 # ObjectRequestBroker Service
#
ResourceType=ObjectRequestBroker
ImplementingResourceType=ObjectRequestBroker
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ObjectRequestBroker=
AttributeInfo=services
#
#Properties
#
requestTimeout=180 #integer,required,default(0)
context=!{serverName}
forceTunnel=never
tunnelAgentURL=null
connectionCacheMaximum=240 #integer,required,default(0)
requestRetriesDelay=0 #integer,required,default(0)
requestRetriesCount=1 #integer,required,default(0)
useServerThreadPool=false #boolean,default(false)
connectionCacheMinimum=100 #integer,required,default(0)
enable=true #boolean,default(false)
commTraceEnabled=false #boolean,default(false)
locateRequestTimeout=180 #integer,required,default(0)
noLocalCopies=false #boolean,default(false)
#
# SubSection 1.0.1 # ORBInterceptors
#
ResourceType=ObjectRequestBroker
ImplementingResourceType=ObjectRequestBroker
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ObjectRequestBroker=
AttributeInfo=interceptors(name,null)
#
#Properties
#
com.ibm.ISecurityLocalObjectBaseL13Impl.CSIClientRI=
com.ibm.debug.olt.ivbtrjrt.OLT_RI=
com.ibm.ws.wlm.client.WLMClientInitializer=
com.ibm.ws.runtime.workloadcontroller.OrbWorkloadRequestInterceptor=
com.ibm.ws.activity.remote.cos.ActivityServiceServerInterceptor=
com.ibm.ISecurityLocalObjectBaseL13Impl.ClientRIWrapper=
com.ibm.debug.DebugPortableInterceptor=
com.ibm.ws.wlm.server.WLMServerInitializer=
com.ibm.ws.Transaction.JTS.TxInterceptorInitializer=
com.ibm.ISecurityLocalObjectBaseL13Impl.SecurityComponentFactory=
com.ibm.ISecurityLocalObjectBaseL13Impl.ServerRIWrapper=
com.ibm.ISecurityLocalObjectBaseL13Impl.CSIServerRI=
com.ibm.ejs.ras.RasContextSupport=
#
# SubSection 1.0.2 # ORBPlugins
#
ResourceType=ObjectRequestBroker
ImplementingResourceType=ObjectRequestBroker
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ObjectRequestBroker=
AttributeInfo=plugins(name,null)
#
#
#Properties
#
com.ibm.ws.orbimpl.WSORBPropertyManager=
com.ibm.ws.wlm.client.WLMClient=
com.ibm.ws.pmi.server.modules.OrbPerfModule=
com.ibm.ISecurityUtilityImpl.SecurityPropertyManager=
com.ibm.ws.csi.CORBAORBMethodAccessControl=
com.ibm.ws.orbimpl.transport.WSTransport=
#
# SubSection 1.0.3 # Thread pool for ORB
#
ResourceType=ThreadPool
ImplementingResourceType=ObjectRequestBroker
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ObjectRequestBroker=:ThreadPool=
AttributeInfo=threadPool
#
#
#Properties
#
maximumSize=50 #integer,required,default(5)
name=ORB.thread.pool
inactivityTimeout=3500 #integer,required,default(5000)
minimumSize=10 #integer,required,default(1)
isGrowable=false #boolean,default(false)
#
# SubSection 1.0.4 # ORBProperties
#
ResourceType=ObjectRequestBroker
ImplementingResourceType=ObjectRequestBroker
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ObjectRequestBroker=
AttributeInfo=properties(name,value)
#
#Properties
#
com.ibm.ws.orb.transport.WSSSLClientSocketFactoryName=com.ibm.ws.security.orbssl.WSSSLClientSocketFactoryImpl
com.ibm.CORBA.RasManager=com.ibm.websphere.ras.WsOrbRasManager
com.ibm.CORBA.ConnectionInterceptorName=com.ibm.ISecurityLocalObjectBaseL13Impl.SecurityConnectionInterceptor
com.ibm.ws.orb.transport.useMultiHome=true
com.ibm.ws.orb.transport.WSSSLServerSocketFactoryName=com.ibm.ws.security.orbssl.WSSSLServerSocketFactoryImpl
com.ibm.CORBA.enableLocateRequest=true
com.ibm.websphere.management.registerServerIORWithLSD=true
EnvironmentVariablesSection
#
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Run the applyConfigProperties command
to create an ObjectRequestBroker configuration.
Running
the applyConfigProperties command applies the properties
file to the configuration. In this Jython example, the optional -reportFileName parameter
produces a report named report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt'])
- Modify existing Object Request Broker properties.
- Obtain a properties file for the Object Request Broker
that you want to change.
You can extract a properties
file for an ObjectRequestBroker using the extractConfigProperties command.
- Open the properties file in an editor and change the
properties as needed.
Ensure that the environment variables
in the properties file match your system.
- Run the applyConfigProperties command.
- Delete the Object Request Broker properties.
To
delete one or more properties, specify only those properties to delete
in the properties file and run deleteConfigProperties.
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
Object Request Broker.
What to do next
Save the changes to your configuration.