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

On a Management Server / Security Gateway Dedicated Check Point server that runs Check Point software to inspect traffic and enforce Security Policies for connected network resources. / Cluster Member Security Gateway that is part of a cluster.:

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

Notes:

These Regular OIDs are specified in the SNMP MIB files.
For Check Point MIB files, see sk90470.

Syntax to query a Statistical OID

On a Management Server / Security Gateway / Cluster Two or more Security Gateways that work together in a redundant configuration - High Availability, or Load Sharing. Member:

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>

Notes:

These 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.

-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