Tivoli Monitoring, Version 6.2

sitconfig.sh

Description

Use the sitconfig.sh command to set or change the configuration of the event synchronization. You can use this command to initially create the configuration settings or to update existing settings.

After you change the configuration of the event synchronization, you must manually stop and restart the Situation Update Forwarder process. See the IBM Tivoli Monitoring Installation and Setup Guide for information.

CLI syntax

sitconfig.sh add fileName=config_filename
            fileSize=size
            fileNumber=number
            fileLocation=path
            pollingInterval=seconds
            crcBytecount=count
            cmsSoapUrl=url
            bufferFlushRate=rate
            logLevel=level
            defConfigPath=config path
           type=TEC|Omnibus

sitconfig.sh update fileName=config_filename
            [fileSize=size]
            [fileNumber=number]
            [fileLocation=path]
            [pollingInterval=seconds]
            [crcBytecount=count]
            [cmsSoapUrl=url]
            [bufferFlushRate=rate]
            [logLevel=level]
            defConfigPath=config path
           type=TEC|Omnibus

where:

add
Create the configuration file. The default name is situpdate.conf.
update
Updates the existing specified configuration file.
fileName=config_filename
The name of the configuration file for event synchronization. situpdate.conf is the default file name.
fileSize=size
Specify this parameter to set and change the maximum size, in bytes, for any one event cache file. The minimum (and default) value is 50000. Do not use commas when specifying this value (50,000 instead of 50000).
fileNumber=number
Specify this parameter to set and change the maximum number of event caches files permitted at any given time. The minimum value is 2, while the default value is 10. When this value is reached, the oldest file is deleted to make room for a new file.
fileLocation=path
Specify this parameter if you want to set and change the location on the event server where event cache files are located. The default locations are as follows:
  • On Windows®: C:\tmp\TME\TEC\OM_TEC\persistence.
  • On UNIX®: /var/TME/TEC/OM_TEC/persistence
pollingInterval=seconds
Specify this parameter to set and change the polling interval, in seconds. The minimum value is 1, while the default value is 3. This is the number of seconds that the Situation Update Forwarder process sleeps when there are no updates to process.
crcBytecount=count
Specify this parameter to set and change the number of bytes that the long running process will use when it saves the location of the last event it processes. This value must be an integer. The minimum (and default) is 50.
cmsSoapUrl=url
Specify this parameter to set and change the URL for the SOAP Server configured on the computer where the monitoring server is running. The default value is cms/soap. This value is used to create the URL to which Tivoli Enterprise Console sends event information. For example, http://hostname:port///cms/soap, where hostname is the host name of the monitoring server and port is the port.
bufferFlushRate=rate
Specify this parameter to set and change the maximum number of event updates sent to the monitoring server at one time. The minimum (and default) value is 100 events.
logLevel=level
Specify this parameter to set and change the level of information for event synchronization that is logged. You have the following choices:
  • low (default)
  • med
  • verbose
defConfigPath
Specify this parameter to set the location where the situpdate.conf file is placed. Required when used for Omnibus.
type
Specify this parameter to set the type of use for this config file, either for TEC or Omnibus.

CLI example

The following example changes the trace level for the event synchronization to medium:

   sitconfig.sh update fileName=situpdate.conf logLevel=med



Feedback

[ Top of Page | Previous Page | Next Page | Contents | Index ]