asg_route

This command is supported only on these:

  • ElasticXL Cluster

  • Maestro Security Group

  • Scalable Chassis Security Group

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

Description

Shows routing information.

Related Commands

Syntax

asg_route {-h | --help}

asg_route [-6] [-a] [-b <SGM IDs>] [--vs <VS ID>] [--summary] [--compare-os-db]

      [{-i |--inactive} <Parameter>]

      [{-n |--dyn-route} <Parameter>]

      [{-r |--route} <Parameter>]

Parameters

Parameter

Description

-h

--help

Shows the built-in help.

No Parameters

Shows all routes (IPv4 and IPv6).

-6

Shows only IPv6 routes.

-a

Includes the Security Group Members that are in the "DOWN" state.

-b <SGM IDs>

Specifies the Security Group Members, for which to run this command.

By default, applies to all Security Group Members.

Applies to Security Group Members as specified by the <SGM IDs>.

<SGM IDs> can be:

  • No <SGM IDs> specified, or all

    Applies to all Security Group Members and all Sites

  • One Security Group Member (for example, 1_1)

  • A comma-separated list of Security Group Members (for example, 1_1,1_4)

  • A range of Security Group Members (for example, 1_1-1_4)

  • One Site (chassis1, or chassis2)

  • The Active Site (chassis_active)

--vs <VS ID>

Specifies the IDs of the Traditional VSX Virtual Systems.

Applies to the Traditional Virtual Systems as specified by the <VS IDs>.

<VS IDs> can be:

  • No <VS IDs> specified (default) - Applies to the context of the current Virtual System

  • One Virtual System

  • A comma-separated list of Virtual Systems (for example, 1,2,4,5)

  • A range of Virtual Systems (for example, 3-5)

  • all - Shows all Virtual Systems

This parameter is only applicable in a VSX environment.

--summary

Shows only a summary of all routes.

--compare-os-db

Shows only the inconsistency after it compares the routes between the Security Group database and the Gaia OS database.

{-i |--inactive} <Parameter>

Show only inactive routes.

Valid <Parameters> are:

  • all - Shows all inactive routes.

  • aggregate - Shows only the aggregate routes.

  • bgp - Shows only the BGP routes.

  • direct - Shows only the directly connected routes.

  • ospf - Shows only the OSPF routes.

  • static - Shows only the static routes.

  • rip - Shows only the RIP routes.

{-n |--dyn-route} <Parameter>

Show only dynamic routes.

Valid <Parameters> are:

  • all - Shows all dynamic routes.

  • bgp - Shows only the BGP routes.

  • ospf - Shows only the OSPF routes.

  • rip - Shows only the RIP routes.

{-r |--route} <Parameter>

Show only specified routes.

Valid <Parameters> are:

  • all - Shows all routes.

  • aggregate - Shows only the aggregate routes.

  • bgp - Shows only the BGP routes.

  • destination <IP Address> - Shows only the route to the specified destination.

  • direct - Shows only the directly connected routes.

  • exact <Network IP Address> - Shows only the specific route.

  • ospf - Shows only the OSPF routes.

  • rip - Shows only the RIP routes.

  • static - Shows only the static routes.

  • subnets <Network IP Address> - Shows only the routes for the specified the network and its subnets.

Examples

[Expert@SG-s01-01:0]# asg_route
Collecting routing information, may take few seconds...
=================================== VS 0=======================================

Fetching Routes info from Members:
1_01,1_02,1_03

-------------------------------------------------------
Status:  Routes info is identical on all Members
-------------------------------------------------------

Identical DB Routes: (7 records)
       NP - NAT Pool, U - Unreachable, i - Inactive
C               10.33.23.0/24       is directly connected, eth1-Mgmt1
C               127.0.0.0/8         is directly connected, lo
C               192.0.2.0/24        is directly connected, Sync
C               198.51.101.0/25     is directly connected, eth1-CIN
C               198.51.101.128/25   is directly connected, eth2-CIN
S               0.0.0.0/0           via 10.33.23.1, eth1-Mgmt1, active


Types: C - Connected, S - Static, R - RIP, B - BGP,
       O - OSPF IntraArea (IA - InterArea, E - External, N - NSSA)
       A - Aggregate, K - Kernel Remnant, H - Hidden, P - Suppressed
       SBR - Source-Based Routes

-------------------------------------------------------
Identical UIPS for Site 1 Routes: (0 records)
UIPS is disabled on Site 1

*************************************************************************
Summary of inconsistent DB routes:: no inconsistent routes found
*************************************************************************

================================================================================
=================================== VS 1=======================================

Fetching Routes info from Members:
1_01,1_02,1_03

-------------------------------------------------------
Status:  Routes info is identical on all Members
-------------------------------------------------------

Identical DB Routes: (5 records)
       NP - NAT Pool, U - Unreachable, i - Inactive
C               10.34.200.0/24      is directly connected, bond3
C               127.0.0.0/8         is directly connected, lo
C               192.168.34.0/24     is directly connected, bond2.34
S               0.0.0.0/0           via 192.168.34.1, bond2.34, active


Types: C - Connected, S - Static, R - RIP, B - BGP,
       O - OSPF IntraArea (IA - InterArea, E - External, N - NSSA)
       A - Aggregate, K - Kernel Remnant, H - Hidden, P - Suppressed
       SBR - Source-Based Routes

-------------------------------------------------------
Identical UIPS for Site 1 Routes: (0 records)
UIPS is disabled on Site 1

*************************************************************************
Summary of inconsistent DB routes:: no inconsistent routes found
*************************************************************************

================================================================================
[Expert@SG-s01-01:0]#
 
[Expert@SG-s01-01:0]# asg_route --summary
Collecting routing information, may take few seconds...
=================================== VS 0=======================================

Fetching Summary info from Members:
1_01,1_02,1_03

-------------------------------------------------------
Status:  Summary info is identical on all Members
-------------------------------------------------------

Identical DB Summary: (10 records)
Total            6
aggregate        0
bgp              0
connected        5
igrp             0
isis             0
kernel           0
nat-pool         0
rip              0
static           1


-------------------------------------------------------
Identical UIPS for Site 1 Summary: (0 records)
UIPS is disabled on Site 1

*************************************************************************
Summary of inconsistent DB routes:: no inconsistent routes found
*************************************************************************

================================================================================
=================================== VS 1=======================================

Fetching Summary info from Members:
1_01,1_02,1_03

-------------------------------------------------------
Status:  Summary info is identical on all Members
-------------------------------------------------------

Identical DB Summary: (10 records)
Total            4
aggregate        0
bgp              0
connected        3
igrp             0
isis             0
kernel           0
nat-pool         0
rip              0
static           1


-------------------------------------------------------
Identical UIPS for Site 1 Summary: (0 records)
UIPS is disabled on Site 1

*************************************************************************
Summary of inconsistent DB routes:: no inconsistent routes found
*************************************************************************

================================================================================

[Expert@SG-s01-01:0]#
 
[Expert@SG-s01-01:0]# asg_route --route subnets 8.0.0.0

[Expert@SG-s01-01:0]# asg_route -n ospf