Showing Hardware State (asg stat)

Description

Use the "asg stat" command in Gaia gClish or the Expert mode to show the state of the system and hardware components.

The command output shows:

Security Gateway Mode (Gateway or VSX)
Number of members in the Security Group
Number of Virtual Systems
Information related to VSX configuration
Uptime
Software Version

Syntax

asg stat

-h

      -i list_all

      -i sgm_info

      -i tasks

      -v [-amw]

      vs [all [-p]]

Note - If you run this command in the context of a Virtual System, the output applies only to that Virtual System.

Parameters

Parameter	Description
No Parameters	Shows the Security Group status (short output).
`-h`	Shows the built-in help.
`-i list_all`	Shows: The IDs of the Security Group Members, their state and IP addresses Tasks and on which Security Group Member they run
`-i sgm_info`	Shows the IDs of the Security Group Members, their state and IP addresses
`-i tasks`	Shows the list of Tasks and on which Security Group Member they run: SMO - Single Management Object General - General LACP - Interface Bonding CH Monitor - Site state monitor DR Manager - Dynamic Routing manager UIPC - Unique IP Address for each Site Alert - Alerts
`-v [-amw]`	Shows the detailed Security Group status (verbose output). The "`-amw`" parameter shows the update status for the applicable Software Blades.
`vs [all [-p]]`	Shows the VSX information: `vs` Shows general output for a Virtual System. Run this command in the context of the applicable Virtual System. `vs all` Output also shows all Virtual Systems. `vs all -p` Output shows a summary health status for all Virtual Systems. For more information on a specific Virtual System, run the "`asg stat vs`" command in the context of the Virtual System.

Examples

Example 1 - Default Output (asg stat)

Syntax

asg stat

Example output from a Dual Site configuration

[Expert@MyChassis-ch0x-0x:0]# asg stat

--------------------------------------------------------------------------------

| System Status - Maestro                                                      |

--------------------------------------------------------------------------------

| Chassis Mode                | Active Up                                      |

| Up time                     | 21:29:56 hours                                 |

| SGMs                        | 12/12                                          |

| Version                     | R80.20SP (Build Number XXX)                    |

--------------------------------------------------------------------------------

| Chassis Parameters                                                           |

--------------------------------------------------------------------------------

| Unit         |          Chassis 1            |          Chassis 2            |

--------------------------------------------------------------------------------

| SGMs         |            6 / 6              |            6 / 6              |

| Ports        |            5 / 5              |            5 / 5              |

| SSMs         |            2 / 2              |            2 / 2              |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#

Example output from a Single Site configuration

[Expert@MyChassis-ch0x-0x:0]# asg stat

--------------------------------------------------------------------------------

| System Status - Maestro                                                      |

--------------------------------------------------------------------------------

| Up time                     | 02:10:27 hours                                 |

| SGMs                        | 30/30                                          |

| Version                     | R80.20SP (Build Number XXX)                    |

--------------------------------------------------------------------------------

| Chassis Parameters                                                           |

--------------------------------------------------------------------------------

| Unit         |                          Chassis 1                            |

--------------------------------------------------------------------------------

| SGMs         |                           30 / 30                             |

| Ports        |                            4 / 4                              |

| SSMs         |                            2 / 2                              |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#

Example 2 - Detailed Output (asg stat -v)

Syntax

asg stat -v

Example output from a Dual Site configuration - top section

This output shows a Security Group with 12 Security Group Members in the Active (UP) state (out of total 12).

The Site #1 is Active. The Site #2 is Standby.

[Expert@MyChassis-ch0x-0x:0]# asg stat -v

--------------------------------------------------------------------------------

| System Status - Maestro                                                      |

--------------------------------------------------------------------------------

| Chassis Mode                | Active Up                                      |

| Up time                     | 21:30:50 hours                                 |

| SGMs                        | 12/12                                          |

| Version                     | R80.20SP (Build Number XXX)                    |

--------------------------------------------------------------------------------

| SGM ID             Chassis 1                          Chassis 2              |

|                    ACTIVE                             STANDBY                |

--------------------------------------------------------------------------------

|  1                   ACTIVE                             ACTIVE               |

|  2                   ACTIVE                             ACTIVE               |

|  3                   ACTIVE                             ACTIVE               |

|  4                   ACTIVE                             ACTIVE               |

|  5                   ACTIVE                             ACTIVE               |

|  6                   ACTIVE                             ACTIVE               |

--------------------------------------------------------------------------------

... output was truncated for brevity - the example continues below ...

Example output from a Single Site configuration - top section

This output shows a Security Group with 30 Security Group Members in the Active (UP) state (out of total 30).

[Expert@MyChassis-ch0x-0x:0]# asg stat -v

--------------------------------------------------------------------------------

| System Status - Maestro                                                      |

--------------------------------------------------------------------------------

| Up time                     | 02:10:39 hours                                 |

| SGMs                        | 30/30                                          |

| Version                     | R80.20SP (Build Number XXX)                    |

--------------------------------------------------------------------------------

| SGM ID                              Chassis 1                                |

|                                     ACTIVE                                   |

--------------------------------------------------------------------------------

|  1                                    ACTIVE                                 |

|  2                                    ACTIVE                                 |

|  3                                    ACTIVE                                 |

... output was truncated for brevity ...

|  30                                   ACTIVE                                 |

--------------------------------------------------------------------------------

... output was truncated for brevity - the example continues below ...

Explanation about the output:

Field

Instructions

SGM ID

Identifier of the Security Group Member.

The (local) is the Security Group Member, on which you ran the command.

State

State of the Security Group Member:

ACTIVE - The Security Group Member is processing traffic
DOWN - The Security Group Member is not processing traffic
Detached - No Security Group Member is detected in a slot

Note - To change manually the state of the Security Group Member, use the "g_clusterXL_admin" command (see Configuring the Cluster State (g_clusterXL_admin)).

Example output from a Dual Site configuration - bottom section

... output was truncated for brevity - the example starts above ...

--------------------------------------------------------------------------------

| Chassis Parameters                                                           |

--------------------------------------------------------------------------------

| Unit        |        Chassis 1          |        Chassis 2          | Weight |

--------------------------------------------------------------------------------

| SGMs        |          6 / 6            |          6 / 6            |   6    |

| Ports       |                           |                           |        |

|   Standard  |          5 / 5            |          5 / 5            |  11    |

|   Bond      |          0 / 0            |          0 / 0            |  11    |

|   Other     |          0 / 0            |          0 / 0            |   6    |

| Sensors     |                           |                           |        |

|   SSMs      |          2 / 2            |          2 / 2            |  11    |

|             |                           |                           |        |

| Grade       |        113 / 113          |        113 / 113          |   -    |

--------------------------------------------------------------------------------

| Minimum grade gap for chassis failover:                               11     |

| Synchronization                                                              |

|     Sync to Active chassis:    Enabled                                       |

|     Sync to Standby chassis:   Enabled                                       |

--------------------------------------------------------------------------------

| Chassis HA mode:              Active Up                                      |

--------------------------------------------------------------------------------

Example output from a Single Site configuration - bottom section

... output was truncated for brevity - the example starts above ...

--------------------------------------------------------------------------------

| Chassis Parameters                                                           |

--------------------------------------------------------------------------------

| Unit        |                      Chassis 1                        | Weight |

--------------------------------------------------------------------------------

| SGMs        |                       30 / 30                         |   6    |

| Ports       |                                                       |        |

|   Standard  |                        4 / 4                          |  11    |

|   Bond      |                        0 / 0                          |  11    |

|   Other     |                        0 / 0                          |   6    |

| Sensors     |                                                       |        |

|   SSMs      |                        2 / 2                          |  11    |

|             |                                                       |        |

| Grade       |                      246 / 246                        |   -    |

--------------------------------------------------------------------------------

| Synchronization                                                              |

|     Sync to Active chassis:    Enabled                                       |

--------------------------------------------------------------------------------

Note - In the notation "<Number> / <Number>", the left number shows the number of components that in the UP state, and the right number shows the number the components that must be in the UP state.

For example, on the SGMs line, "30 / 30" means that there are currently 30 Security Group Members in the UP state out of the 30 that must be in the UP state.

Field

Description

Grade

The sum of the grades of all components.

The grade of each component is the unit weight multiplied by the number of components that are in the UP state.

You can configure the unit weight of each component to show the importance of the component in the system.

To configure the unit weight, run in Gaia gClish:

set chassis high-availability factors <Hardware Component>

For example, to change the weight of the Security Group Member to 12, run in Gaia Clish on that Security Group Member:

set chassis high-availability factors sgm 12

See Configuring Security Group High Availability.

If you run the "asg stat -v" command, the output shows a greater unit weight and system grade.

Minimum grade gap for chassis failover

Site failover occurs to the Site with the higher grade only if its grade is greater than the other Site by more than the minimum gap.

Minimum threshold for traffic processing - the minimum grade required for the Site to become Active.

Synchronization

Status of synchronization between Security Group Members:

Within a Site - between Security Group Members located in the same Security Group
Between two Sites - between Security Group Members located in different Sites
Exception Rules - exception rules configured by an administrator with the "g_sync_exception" command.

Example 3 - List of Tasks (asg stat -i tasks)

Syntax

asg stat -i tasks

Example output from a Dual Site configuration

The SMO task runs on Site #2 - on the Security Group Member #3, on which you ran this command (see the string "(local)").

[Expert@MyChassis-ch0x-0x:0]# asg stat -i tasks

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |                            |         3(local)           |

| General (1)        |         2                  |         3(local)           |

| LACP (2)           |         2                  |         3(local)           |

| CH Monitor (3)     |         2                  |         3(local)           |

| DR Manager (4)     |                            |         3(local)           |

| UIPC (5)           |         2                  |         3(local)           |

| Alert (6)          |                            |         3(local)           |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#

[Expert@MyChassis-ch0x-0x:0]# member 2_4

Moving to member 2_4

... ...

[Expert@MyChassis-ch0x-0x:0]# asg stat -i tasks

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |                            |         3                  |

| General (1)        |         2                  |         3                  |

| LACP (2)           |         2                  |         3                  |

| CH Monitor (3)     |         2                  |         3                  |

| DR Manager (4)     |                            |         3                  |

| UIPC (5)           |         2                  |         3                  |

| Alert (6)          |                            |         3                  |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#

Example output from all Security Group Members (in our example, there are two on each Site):

[Expert@MyChassis-ch0x-0x:0]# g_all asg stat -i tasks

1_01:

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |         1(local)           |                            |

| General (1)        |         1(local)           |         1                  |

| LACP (2)           |         1(local)           |         1                  |

| CH Monitor (3)     |         1(local)           |         1                  |

| DR Manager (4)     |         1(local)           |                            |

| UIPC (5)           |         1(local)           |         1                  |

| Alert (6)          |         1(local)           |                            |

--------------------------------------------------------------------------------

1_02:

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |         1                  |                            |

| General (1)        |         1                  |         1                  |

| LACP (2)           |         1                  |         1                  |

| CH Monitor (3)     |         1                  |         1                  |

| DR Manager (4)     |         1                  |                            |

| UIPC (5)           |         1                  |         1                  |

| Alert (6)          |         1                  |                            |

--------------------------------------------------------------------------------

2_01:

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |         1                  |                            |

| General (1)        |         1                  |         1(local)           |

| LACP (2)           |         1                  |         1(local)           |

| CH Monitor (3)     |         1                  |         1(local)           |

| DR Manager (4)     |         1                  |                            |

| UIPC (5)           |         1                  |         1(local)           |

| Alert (6)          |         1                  |                            |

--------------------------------------------------------------------------------

2_02:

--------------------------------------------------------------------------------

| Task (Task ID)     |        Chassis 1           |        Chassis 2           |

--------------------------------------------------------------------------------

| SMO (0)            |         1                  |                            |

| General (1)        |         1                  |         1                  |

| LACP (2)           |         1                  |         1                  |

| CH Monitor (3)     |         1                  |         1                  |

| DR Manager (4)     |         1                  |                            |

| UIPC (5)           |         1                  |         1                  |

| Alert (6)          |         1                  |                            |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#

Example output from a Single Site configuration

The SMO task runs on the Security Group Member #1, on which you ran this command (see the string "(local)").

[Expert@MyChassis-ch0x-0x:0]# asg stat -i tasks

--------------------------------------------------------------------------------

| Task (Task ID)    |                       Chassis 1                          |

--------------------------------------------------------------------------------

| SMO (0)           |                        1(local)                          |

| General (1)       |                        1(local)                          |

| LACP (2)          |                        1(local)                          |

| CH Monitor (3)    |                        1(local)                          |

| DR Manager (4)    |                        1(local)                          |

| UIPC (5)          |                        1(local)                          |

| Alert (6)         |                        1(local)                          |

--------------------------------------------------------------------------------

[Expert@MyChassis-ch0x-0x:0]#