Properties and command line options

AsyncEventProcessing integer

-synceventprocessing (equivalent to AsyncEventProcessing with a value of 0)

-asynceventprocessing (equivalent to AsyncEventProcessing with a value of 1)

Use this property to specify whether the probe processes alerts synchronously or asynchronously:

0: The probe forces the probe to process alerts synchronously; this means a common timing is established between the sender and the receiver during which the events are sent.

1: The probe forces the probe to process alerts asynchronously; this means that no common timing is established between the sender and the receiver.

The default is 0.

BindAddress string

-ipaddress string

Use this property to specify the IP address to which the probe binds.

The default is " ".

Force integer

-force (equivalent to Force with a value of 1)

-noforce (equivalent to Force with a value of 0)

Use this property to specify whether the probe forces the use of risky property combinations (such as when Interval is less than 10, Retry is greater than 20, or Timeout is less than 250):

0: The probe prevents the use of risky property combinations.

1: The probe forces the use of risky property combinations.

The default is 0.

Interval integer

-interval integer

Use this property to specify the minimum length of time (in milliseconds) that a probe sets aside for pinging and processing the responses of the number of hosts specified by the MaxPingBurst property. If the probe pings and processes the responses in a time shorter than this, it sleeps for the remainder of the Interval period before starting the next ping cycle.

LookupOnFailure integer

-lookuponfailure (equivalent to LookupOnFailure with a value of 1)

-nolookuponfailure (equivalent to LookupOnFailure with a value of 0)

Use this property to force the probe to look up the IP address of a host if it fails to respond to a ping:

1: The probe looks up the IP address of the host that did not respond to a ping.

0: The probe does not look up the IP address of the host that did not respond to a ping.

The default is 0.

MaxPingBurst integer

-maxpingburst integer

Use this property to specify the maximum number of hosts that the probe pings during a single ping cycle.

The default is 1.

MaxPingBurst affects the time it takes the probe to go through the ping file and the load this has on your network. Increasing the value of the MaxPingBurst property reduces the time it takes the probe to go through the whole ping file, but it also increases the burst load on the network.

MultipleUnreachable integer

-singleunreachable (equivalent to MultipleUnreachable with a value of 0)

-multipleunreachable (equivalent to MultipleUnreachable with a value of 1)

Use this property to specify whether the probe sends multiple alerts while the host is unreachable:

0: The probe sends a single alert while the host is unreachable.

1: The probe sends an unreachable alert for every ping to which the host fails to respond.

The default is 1.

NoNameResolution integer

-nameresolution (equivalent to NoNameResolution with a value of 0)

-nonameresolution (equivalent to NoNameResolution with a value of 1)

Use this property to specify whether the probe performs name resolution on IP addresses:

0: The probe performs name resolution.

1: The probe does not perform name resolution, and sends the event to the ObjectServer with the host name given as an IP address in dotted quad format.

The default is 0.

PacketSize integer

-packetsize integer

Use this property to specify the ping packet size.

The default is 64.

PingFile string

-pingfile string

Use this property to specify the path of the file that specifies the hosts, which the probe pings.

The default is $OMNIHOME/probes/arch/ping.file.

PingFileCheck integer

-pingfilecheck integer

Use this property to specify the frequency (in seconds) with which the probe checks for any changes in the ping file. Changes can be addition or removal of hosts, and changes in the Poll, Trip, or TimeOut properties for each hosts. According to these changes the probe pings the hosts.

The default is 60.

Poll integer

-poll integer

Use this property to specify the frequency (in seconds) with which the probe pings each host specified in the ping file.

Once this poll time has elapsed, the probe pings the host. If it responds, the poll timer for the host is reset. If it does not respond, the probe pings the host again once it has gone through all the other hosts in the ping file.

The default is 600.

Retry integer

-retry integer

Use this property to specify the maximum number of times that the probe retries pinging a host without response before it assumes that the host is not reachable. If this number is reached, the probe sends an unreachable event to the ObjectServer.

The default is 3.

SocketBufferSize integer

-socketbuffersize integer

Use this property to increase the maximum buffer size in socket to avoid ping replies from being dropped.

The default is 8192.

TimeOut integer

-timeout integer

Use this property to specify the time (in milliseconds) within which the probe expects the host to respond before assuming that it will not respond to that ping attempt.

The default is 2500.

Trip integer

-trip integer

Use this property to specify the time (in milliseconds) within which the probe expects the host to respond to a ping before deeming the host to be slow.

The default is 2500.