Properties and command line options

You use properties to specify how the probe interacts with the device. You can override the default values by using the properties file or the command line options.

The following table describes the properties and command line options specific to this probe. For more information about generic Netcool/OMNIbus properties and command line options, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide.
Table 1. Properties and command line options

Property name

Command line option

Description

CommandPort integer

-commandport integer

Use this property to specify the port number used by the probe to listen for commands.

The default is 6970.

CommandPortLimit integer

-commandportlimit integer

Use this property to specify the maximum number of telnet connections that can be made to the probe.

The default is 10.

EnableEndPointFailover string

-enableendpointfailover string

Use this property to specify failover capability upon connection or reconnection. If enabled and a failover occurs the probe will connect both the JMS and HTTP interfaces to the backup Huawei U2000.

false: The probe does not attempt to connect to the backup Huawei U2000 upon failover.

true: The probe attempts to connect to the backup Huawei U2000 upon failover.

The default is false.

Note: If EnableEndPointFailover is set to true, you must configure the following properties:
  • SecondaryResyncHTTP ConnectionURL
  • SecondaryUpdateHTTP ConnectionURL
  • SecondaryTransportType
  • SecondaryTransportFile

EncodingStandard string

-encodingstandard integer

Use this property to specify the Encoding Standard Default ISO-8859-1 to include the Latin alphabet 1.

The default is ISO-8859-1.

HttpConnectionConnect Timeout integer

-httpconnectionconnect timeout integer

Use this property to specify the time (in seconds) following which the HTTP connection will timeout on connect operation.

The default is 20.

HttpConnectionRead Timeout integer

-httpconnectionreadtimeout integer

Use this property to specify the time (in seconds) following which the HTTP connection will timeout on read operation.

The default is 300.

Note: The value of this property should be increased to a value greater than the response time of Huawei U2000 system

HttpPassword string

-httppassword string

Use this property to specify the password used to authenticate for HTTP operations.

The default is password.

HttpUsername string

-httpusername string

Use this property to specify the username used to authenticate for HTTP operations.

The default is username.

Inactivity integer

-inactivity integer

Use this property to specify the period of inactivity (in seconds) before the probe disconnects.

The default is 0.

ProbeKeyStore string

-probekeystore string

Use this property to specify the path to the keystore file containing the private key and associated certificate for this probe.

Note: This property is required only if the remote target system is configured to authenticate SSL clients.

The default is "".

ProbeKeyStorePassword string

-probekeystorepassword string

Use this property to specify the password required to access the keystore file.

The default is password.

Resync string

-resync

(This is equivalent to Resync with a value of true.)

-noresync

(This is equivalent to Resync with a value of false.)

Use this property to specify whether the probe requests all active alarms from the Huawei U2000 system before connecting to the notification service for new alarms. This property takes the following values:

false: The probe does not resynchronise with the target system at startup.

true: The probe does resynchronise with the target system at startup.

The default is true.

ResyncBatchSize integer

-resyncbatchsize integer

Use this property to specify the number of alarms to retrieve in each batch of resynchronization alarms.

The default is 100.

Note: This property controls the query efficiency and its value depends upon the responsiveness of the communication between the probe and Huawei U2000 during resynchronization. The higher the value to which you set the ResyncBatchSize property, the greater the query efficiency; however, the longer it will take to complete each batch. If the probe times out before the resynchronization completes, set this property to a lower value.

ResyncFilterFile string

-resyncfilterfile string

Use this property to specify the filter used for resynchronization operations.

The default is "".

ResyncHTTPConnectionURL string

-resynchttpconnectionurl string

Use this property to specify the URL of the initial HTTP resynchronization connection.

The default is http://127.0.0.1/AlarmRetrieval?getAlarms.

ResyncInterval integer

-resyncinterval integer

Use this property to specify the time (in seconds) that the probe waits before resynchronizing with the U2000 system.

The default is 0.

Note: If no value is specified, the probe will not perform an interval resychronisation with the U2000 system.

Retry string

-retry

(This is equivalent to Retry with a value of true.)

-noretry

(This is equivalent to Retry with a value of false.)

Use this property to specify whether the probe attempts to reconnect to the system following a timeout:

false: The probe does not attempt to reconnect to the system.

true: The probe attempts to reconnect to the system.

The default is false.

SecondaryTransportFile string

-secondarytransportfile string

Use this property to specify the path to the secondary copy of the JMS transport properties file which specifies the JMS connection settings for the secondary Huawei U2000 server.

The default is "".

SecondaryTransportType string

-secondarytransporttype string

Use this property to specify the transport method being used.

The default is JMS.

SecondaryResyncHTTP ConnectionURL string

-secondaryresync httpconnectionurl string

Use this property to specify the HTTP URL of the alarm list resynchronization connection at the secondary Huawei U2000 server.

The default is "".

SecondaryUpdateHTTP ConnectionURL string

-secondaryupdate httpconnectionurl string

Use this property to specify the HTTP URL of the alarm list update connection on the secondary Huawei U2000.

The default is "".

SecurityProtocol string

-securityprotocol string

Use this property to specify which security protocol the probe uses when SSL encryption is enabled.

If no value is set for the SecurityProtocol property, the probe uses the default protocol for the JRE.

The default is "".

StreamCapture string

-streamcapture string

Use this property to specify whether or not all output is saved to a file.

The default is false.

StreamCaptureFile string

-streamcapturefile string

Use this property to specify the file to which the output is saved.

The default is:

$(OMNIHOME)/var/U2000.stream (UNIX).

%OMNIHOME%\var\U2000.stream (Windows).

TransformerFile string

-transformerfile string

Use this property to specify the file that contains the transformer properties.

The default is:

$(OMNIHOME)/java/conf/transformers.xml (UNIX).

%OMNIHOME%\java\conf\transformers.xml (Windows).

TransportFile string

-transportfile string

Use this property to specify the file that contains the transport properties.

The default is

$(OMNIHOME)/java/conf/jmsTransport.properties (UNIX)

%OMNIHOME%\java\conf\jmsTransport.properties (Windows).

SecondaryTransportType string

-secondarytransporttype string

Use this property to specify the transport method being used.

The default is JMS.

TransportType string

-transporttype string

Use this property to specify the transport method being used on the secondary Huawei U2000 server..

The default is JMS.

TrustedCertsStore string

-trustedcertsstore string

Use this property to specify the file path of the truststore file.

The default is "".

TrustedCerts StorePassword string

-trustedcertsstorepassword string

Use this property to specify the password required to access the keystore file containing the trusted certificates.

The default is password.

UpdateHTTPConnectionURL string

-updatehttpconnection string

Use this property to specify the URL of the HTTP connection which is used to update alarms on the U2000 server.

The default is http://127.0.0.1/AlarmHandling?updateAlarms.