stattest

Description

Check Point AMON client to query SNMP OIDs.

You can use this command as an alternative to the standard SNMP commands for debug purposes - to make sure the applicable SNMP OIDs provide the requested information.

Notes:

You can run this command only in the Expert mode.

On a Multi-Domain Server Dedicated Check Point server that runs Check Point software to host virtual Security Management Servers called Domain Management Servers. Synonym: Multi-Domain Security Management Server. Acronym: MDS., you must run this command in the context of the applicable Domain Management Server Check Point Single-Domain Security Management Server or a Multi-Domain Security Management Server.:

mdsenv <IP Address or Name of Domain Management Server>

Syntax

To query a Regular OID:

stattest get [-d] [-h <Host>] [-p <Port>] [-x <Proxy Server>] [-v <VSID>] [-t <Timeout>] <Regular_OID_1> <Regular_OID_2> ... <Regular_OID_N>

These are specified in the SNMP MIB files.

For Check Point MIB files, see sk90470.

To query a Statistical OID:

stattest get [-d] [-h <Host>] [-p <Port>] [-x <Proxy Server>] -l <Polling Interval> -r <Polling Duration> [-v <VSID>] [-t <Timeout>] <Statistical_OID_1> <Statistical_OID_2> ... <Statistical_OID_N>

Statistical OIDs take some time to "initialize".

For example, to calculate an average, it is necessary to collect enough samples.

Check Point statistical OIDs are registered in the $CPDIR/conf/statistical_oid.conf file.

Parameters

Parameter

Description

-d

Runs the command in debug mode.

Use only if you troubleshoot the command itself.

Best Practice - If you use this parameter, then redirect the output to a file, or use the script command to save the entire CLI session.

-h <Host>

Specifies the remote Check Point host to query by its IP address or resolvable hostname.

-p <Port>

Specifies the port number, on which the AMON server listens. Default port is 18192.

-x <Proxy Server>

Specifies the Proxy Server by its IP address or resolvable hostname.

Note - Use only when you query a remote host.

-l <Polling Interval>

Specifies the time in seconds between queries.

Note - Use only when you query a Statistical OID.

-r <Polling Duration>

Specifies the time in seconds, during which to run consecutive queries.

Note - Use only when you query a Statistical OID.

-v <VSID>

On a VSX Gateway Physical server that hosts VSX virtual networks, including all Virtual Devices that provide the functionality of physical network devices. It holds at least one Virtual System, which is called VS0., specifies the context of a Virtual Device to query.

-t <Timeout>

Specifies the session timeout in milliseconds.

<Regular_OID_1> <Regular_OID_2> ... <Regular_OID_N>

Specifies the Regular OIDs to query.

Notes:

OID must not start with period.
Separate the OIDs with spaces.
You can specify up to 100 OIDs.

<Statistical_OID_1> <Statistical_OID_2> ... <Statistical_OID_N>

Specifies the Statistical OIDs to query.

Notes:

OID must not start with period.
Separate the OIDs with spaces.
You can specify up to 100 OIDs.

Example - Query a Regular OID

Query the CPU Idle utilization at the OID 1.3.6.1.4.1.2620.1.6.7.2.3 (procIdleTime).

[Expert@HostName]# stattest get 1.3.6.1.4.1.2620.1.6.7.4.2

Example - Query a Statistical OID

Query the CPU Idle utilization at the OID 1.3.6.1.4.1.2620.1.6.7.2.3 (procIdleTime).

Information is collected with intervals of 5 seconds during 5 seconds

[Expert@HostName]# stattest get -l 5 -r 5 1.3.6.1.4.1.2620.1.6.7.2.3