asg stat

This command is supported only on these:

  • ElasticXL Cluster

  • Maestro Security Group

  • Scalable Chassis Security Group

Notes:

  • You can run this command in Gaia gClish or in the Expert mode.

  • If you run this command in the context of a VSNext Virtual Gateway / Legacy VSX Virtual System, the output applies only to that Virtual Gateway / Legacy Virtual System.

Description

Show the state of the Security Group and its hardware components.

To show this output continuously, use the "asg monitor (on Security Groups)" command.

The command output shows:

  • Security Gateway Mode (Gateway or Legacy VSX)

  • Number of Security Group Members in the Security Group

  • Number of VSNext Virtual Gateways / Legacy VSX Virtual Systems

  • Information related to VSNext / Legacy VSX configuration

  • Uptime

  • Software Version

Related Commands

Syntax

asg stat

      -h

      -i list_all

      -i sgm_info

      -i tasks

      -v [-amw]

      vs [all [-p]]

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:

-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 a 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 and their states.

  • vs all -p

    Output also shows all Virtual Systems and a summary sentences for the health status instead of shows the state of each Virtual System.

For more information on a specific Virtual System, run the "asg stat vs" command in the context of the Virtual System.

Examples

Syntax

asg stat

Example output of "asg stat" from a Maestro Single Site configuration

[Expert@HostName-ch0x-0x:0]# asg stat
--------------------------------------------------------------------------------
| System Status - Maestro                                                      |
--------------------------------------------------------------------------------
| Up time                     | 02:10:27 hours                                  |
| Members                     | 2/2                                             |
| Version                     | R82 (Build Number XXX)                          |
--------------------------------------------------------------------------------
| Site Parameters                                                               |
--------------------------------------------------------------------------------
| Unit         |                          Site1                                 |
--------------------------------------------------------------------------------
| Members      |                            2 / 2                               |
| Ports        |                            2 / 2                               |
| SSMs         |                            2 / 2                               |
--------------------------------------------------------------------------------
[Expert@HostName-ch0x-0x:0]#

Example output of "asg stat" from a Maestro Dual Site configuration

[Expert@HostName-ch0x-0x:0]# asg stat
--------------------------------------------------------------------------------
| System Status - Maestro                                                      |
--------------------------------------------------------------------------------
| Cluster Mode                | Active Up                                      |
| Up time                     | 21:29:56 hours                                 |
| Members                     | 12/12                                          |
| Version                     | R82 (Build Number XXX)                         |
--------------------------------------------------------------------------------
| Site Parameters                                                              |
--------------------------------------------------------------------------------
| Unit         |          Site1                |          Site2                |
--------------------------------------------------------------------------------
| Members      |            6 / 6              |            6 / 6              |
| Ports        |            5 / 5              |            5 / 5              |
| SSMs         |            2 / 2              |            2 / 2              |
--------------------------------------------------------------------------------
[Expert@HostName-ch0x-0x:0]#

Syntax

asg stat -v

Example output of "asg stat -v" from a Maestro Single Site configuration

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

[Expert@HostName-ch0x-0x:0]# asg stat -v
--------------------------------------------------------------------------------
| System Status - Maestro                                                      |
--------------------------------------------------------------------------------
| Up time                     | 02:10:39 hours                                 |
| Members                     | 6/6                                            |
| Version                     | R82 (Build Number XXX)                        |
--------------------------------------------------------------------------------
| Member ID                              Site1                                 |
|                                        ACTIVE                                |
--------------------------------------------------------------------------------
|  1                                    ACTIVE                                 |
|  2                                    ACTIVE                                 |
|  3                                    ACTIVE                                 |
|  4                                    ACTIVE                                 |
|  5                                    ACTIVE                                 |
|  6                                    ACTIVE                                 |
--------------------------------------------------------------------------------
| Site Parameters                                                              |
--------------------------------------------------------------------------------
| Unit        |                     Site1                             | Weight |
--------------------------------------------------------------------------------
| Members     |                        6 / 6                          |   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 site:       Enabled                                       |
--------------------------------------------------------------------------------

Example output of "asg stat -v" from a Maestro Dual Site configuration

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

The Maestro Site #1 is Active.

The Maestro Site #2 is Standby.

[Expert@HostName-ch0x-0x:0]# asg stat -v
--------------------------------------------------------------------------------
| System Status - Maestro                                                      |
--------------------------------------------------------------------------------
| Cluster Mode                | Active Up                                      |
| Up time                     | 5 days, 21:23:47 hours                         |
| Members                     | 6/6                                            |
| Version                     | R82 (Build Number XXX)                        |
--------------------------------------------------------------------------------
| Member ID             Site1                              Site2               |
|                       ACTIVE                             STANDBY             |
--------------------------------------------------------------------------------
|  1                   ACTIVE                             ACTIVE               |
|  2                   ACTIVE                             ACTIVE               |
|  3                   ACTIVE                             ACTIVE               |
|  4                   ACTIVE                             ACTIVE               |
|  5                   ACTIVE                             ACTIVE               |
|  6                   ACTIVE                             ACTIVE               |
--------------------------------------------------------------------------------
| Site Parameters                                                              |
--------------------------------------------------------------------------------
| Unit        |        Site1              |        Site2              | Weight |
--------------------------------------------------------------------------------
| Members     |          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 site failover:                                  11     |
| Synchronization                                                              |
|     Sync to Active site:       Enabled                                       |
|     Sync to Standby site:      Enabled                                       |
--------------------------------------------------------------------------------
| Site HA mode:                 Active Up                                      |
--------------------------------------------------------------------------------

Example output of "asg stat -v" from an ElasticXL Cluster Dual Site configuration

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

The Site #1 is Active.

The Site #2 is Standby.

[Expert@HostName-ch0x-0x:0]# asg stat -v
--------------------------------------------------------------------------------
| System Status - ElasticXL                                                    |
--------------------------------------------------------------------------------
| Cluster Mode                | Active Up                                      |
| Up time                     | 75 days, 09:36:13 hours                        |
| Members                     | 6 / 6                                          |
| Version                     | R82 (Build Number XXX)                         |
--------------------------------------------------------------------------------
| Member ID             Site1                              Site2               |
|                       ACTIVE                             STANDBY             |
--------------------------------------------------------------------------------
|  1                   ACTIVE                             ACTIVE               |
|  2                   ACTIVE                             ACTIVE               |
|  3                   ACTIVE                             ACTIVE               |
--------------------------------------------------------------------------------
| Site Parameters                                                              |
--------------------------------------------------------------------------------
| Unit        |        Site1              |        Site2              | Weight |
--------------------------------------------------------------------------------
| Members     |          3 / 3            |          3 / 3            |   6    |
|             |                           |                           |        |
| Grade       |         18 / 18           |         18 / 18           |   -    |
--------------------------------------------------------------------------------
| Minimum grade gap for site failover:                                   6     |
| Synchronization                                                              |
|     Sync to Active site:       Enabled                                       |
|     Sync to Standby site:      Enabled                                       |
--------------------------------------------------------------------------------
[Expert@HostName-ch0x-0x:0]#

Explanation about the output:

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

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

Field

Instructions

Member 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/LOST

    The Security Group Member is not communicating / during a reboot.

  • INIT

    The Security Group Member is in the initialization phase after reboot.

  • READY

    The Security Group Member is ready to become Active, and is waiting for all other remote Active members to acknowledge its state.

  • Active(Sync)

    The Security Group Member is in a unicast connections sync.

Note - To change the state of the Security Group Member manually, use these commands:

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 state "UP".

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 cluster configuration 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 cluster configuration high-availability factors member 12

See:

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 on different Sites.

Syntax

asg stat -i tasks

Example output of "asg stat -i tasks" from a Security Group in a Maestro Single Site configuration

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

[Expert@HostName-ch0x-0x:0]# asg stat -i tasks
--------------------------------------------------------------------------------
| Task (Task ID)    |                       Site1                              |
--------------------------------------------------------------------------------
| 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@HostName-ch0x-0x:0]#

Example output of "asg stat -i tasks" from a Security Group in a Maestro 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@HostName-ch0x-0x:0]# asg stat -i tasks
--------------------------------------------------------------------------------
| Task (Task ID)     |        Site1               |        Site2               |
--------------------------------------------------------------------------------
| 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@HostName-ch0x-0x:0]#

Example output of "asg stat -i tasks" from all Security Group Members (in our example, there are two on each Site):

[Expert@HostName-ch0x-0x:0]# g_all asg stat -i tasks
1_01:
--------------------------------------------------------------------------------
| Task (Task ID)     |        Site1               |        Site2               |
--------------------------------------------------------------------------------
| 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)     |        Site1               |        Site2               |
--------------------------------------------------------------------------------
| 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)     |        Site1               |        Site2               |
--------------------------------------------------------------------------------
| 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)     |        Site1               |        Site2               |
--------------------------------------------------------------------------------
| 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@HostName-ch0x-0x:0]#

Syntax

asg stat vs

Example output of "asg stat vs" from a Maestro Dual Site configuration - context of VS #1

[Expert@HostName-ch0x-0x:0]# asg stat
--------------------------------------------------------------------------------
| VSX System Status - Maestro                                                  |
--------------------------------------------------------------------------------
| VS ID                    1                                                   |
| VS Name                  MyVirtualSystem                                     |
| Cluster Mode             Active Up                                           |
| Software Blades          N/A                                                 |
| FW Policy Date           09Oct24 05:46                                       |
| AMW Policy Date          N/A                                                 |
--------------------------------------------------------------------------------
| Site Parameters                                                              |
--------------------------------------------------------------------------------
| Unit         |          Site1                |          Site2                |
--------------------------------------------------------------------------------
| Ports        |            1 / 1              |            1 / 1              |
| FWKs         |            1 / 1              |            1 / 1              |
| Member       |            1 / 1              |            1 / 1              |
--------------------------------------------------------------------------------
[Expert@HostName-ch0x-0x:0]#

Syntax

asg stat vs all

Example output of "asg stat vs all" from a Maestro Dual Site configuration

[Expert@HostName-ch0x-0x:0]# asg stat vs all
--------------------------------------------------------------------------------------------
| VSX System Status - Maestro                                                              |
--------------------------------------------------------------------------------------------
| Cluster Mode                            | Active Up                                      |
| Up time                                 | 5 days, 21:51:58 hours                         |
| Members                                 | 2 / 2                                          |
| Virtual Systems                         | 3                                              |
| Version                                 | R82 (Build Number XXX)                         |
--------------------------------------------------------------------------------------------
| VSID | VS Type & Name        | Site1             | Site2             | Health            |
--------------------------------------------------------------------------------------------
| 0    | V MyVirtualSystem     | STANDBY           | ACTIVE            | OK                |
| 1    | S MyVirtualSwitch     | STANDBY           | ACTIVE            | OK                |
--------------------------------------------------------------------------------------------
| Active Virtual Systems       | 0                 | 2                 |                   |
--------------------------------------------------------------------------------------------
| Synchronization                                                                          |
|     Sync to Active site:       Enabled                                                   |
|     Sync to Standby site:      Enabled                                                   |
--------------------------------------------------------------------------------------------
 
(P) - VS Primary site
 
For more information on a specific VS: run "asg stat vs" from VS context.
 
[Expert@HostName-ch0x-0x:0]#