6
Tuning the Oracle Management Server

There may be special circumstances which require specific tuning of the Management Server to improve performance such as when the enterprise is managing a large number of nodes. Tuning can be perform by setting the Management Server configuration parameters. Refer to the sections below.

After editing the omsconfig.properties file, you must stop and restart the Management Server in order for the changes to take effect.

Setting the Ping Interval

The Management Server is designed to ping all targets on a pre-defined interval to monitor the state of all managed targets.

To manage the interval between pings, you can use the following property in the omsconfig.properties file to set the ping interval:

oms.vdp.ping_interval=<integer; time in minutes; default 2>

Note that the interval set determines the interval (time in number of minutes) at which the Management Server tests for node up/down, regardless of the polling frequency that you have set in the event which contains a node up/down test.

The default for the time is 2. For Management Servers managing a large number of nodes (more than 64 nodes), you can adjust this parameter to provide the Management Server enough time to ping all the nodes.

Setting the Maximum Connections Out

The Management Server is designed to maintain a certain number of outgoing connections toward different Intelligent Agents simultaneously.

To manage the number of simultaneous outgoing connections, you can use the following property in the omsconfig.properties file:

oms.vdg.max_out_conns =<integer; default 64>

The default is 64. Oracle recommends that this value to be greater or equal to the number of nodes managed by the Management Server in order to avoid performance degradation. If the maximum number of managed nodes is less than 64, Oracle recommends keeping the default value. If the maximum number of managed nodes is more than 64, set the value to the number of nodes.

Setting the Maximum Connections In

The Management Server is designed to maintain a certain number of incoming connections simultaneously.

To manage the number of simultaneous incoming connections, you can use the following property in the omsconfig.properties file:

oms.vdg.max_in_conns=<integer; default 32>

To prevent performance degradation, it is recommended that you set this value to be half the value of the oms.vdg.max_out_conns.

Setting the Management Server Retry Interval

If the Management Server and the repository server lose connection, the Management Server can be configured to try to re-establish the connection to the repository server. The Management Server is designed to retry at a pre-defined intervals with these two parameters:

• oms.repository.connect_timeout

• oms.repository.connect_numTries

To specify the interval between retries, use the following properties in the omsconfig.properties file to set the retry interval:

oms.repository.connect_timeout=<time in seconds>
oms.repository.connect_numTries=<integer>

oms.repository.connect_timeout is the maximum time (in seconds) the Management Server will wait for the repository database to start up.

oms.repository.connect_numTries is the maximum number of tries the Management Server will make to connect to the repository before starting up the Management Server services.

The retry interval is calculated as the value of oms.repository.connect_timeout divided by the value of oms.repository.connect_numTries.

By default, the properties are set as follows:

oms.repository.connect_timeout=120
oms.repository.connect_numTries=12

The Management Server will try to establish a repository connection at startup at 10 second intervals for a total of 12 times.

Smoothing Over Temporary Network Failures

The Management Server tries to ping all nodes every interval in order to detect whether a node is up or down.

If it detects that it was able to successfully ping a node in the previous interval and not in the present interval, it would mark that node as down.

The ping can be made more tolerant to temporary network outages by the following parameters.

oms.vdg.conn_retries = (integer, default 1). 

This parameter specifies the number of retries the Management Server will try to establish a connection either for pinging or for other communication. The Management Server defaults to 1. In other words, it will not retry any connection.

For networks prone to temporary outages, set it to 2 or 3.

oms.vdg.conn_retries_delay = (integer, default 5)

This parameter specifies the amount of time in seconds the Management Server will wait between retries to establish a connection.

This parameter needs to be set to a value depending on the duration of network outages.

The above parameters are documented in omsconfig.properties.template in $ORACLE_HOME/sysman/config directory.