Show Multilink Bundle and IMA Group Commands

multilink-bundle

Syntax

multilink-bundle [bundle-id | slot/mda | type {mlppp | ima-grp}] [detail]

multilink-bundle [{bundle-id | slot/mda} | [ppp [multiclass] | ima]]

Context

show

Description

This command displays multilink bundle information. An operator can display:

  • all bundles on the system/adapter card or all bundles of a given type on the system by specifying the value of type filter to be either mlppp or ima-grp

  • bundle-specific information in summary (no detail option) or detailed format (detail option specified) for one or more bundles

  • protocol-specific information (for example, PPP or IMA) for the specified bundle

Parameters

bundle-id

the multilink (PPP or IMA) bundle identifier. The command syntax must be used as follows:

Syntax: bundle-type-slot/mda.bundle-num

             bundle-ppp-slot/mda.bundle-num (a multilink PPP bundle)

             bundle-ima-slot/mda.bundle-num (an IMA group bundle)

             bundle: keyword

             slot: MDA slot numbers

             bundle-num: 1 to 32

ppp

displays PPP bundle information

ppp multiclass

displays multi-class MLPPP information

ima, ima-grp

displays IMA-type groups

mlppp

displays MLPPP-type groups

detail

provides detailed information

Output

The following outputs are examples of multilink bundle information:

Output Example
*A:ALU-1># show multilink-bundle
===============================================================================
Bundle Summary
===============================================================================
Bundle               Type    Admin     Oper      Port      Min    Total/
Id                           State     State     State     Links  Active Links
-------------------------------------------------------------------------------
bundle-ppp-1/1.1     mlppp   Down      Down      Ghost     1      0/0
bundle-ppp-1/4.8     mlppp   Up        Down      Ghost     1      0/0
bundle-ima-1/6.3     ima-grp Down      Down      Ghost     1      0/0
-------------------------------------------------------------------------------
Bundles : 3
===============================================================================
*A:ALU-1>
Table: Multilink Bundle Field Descriptions

Label

Description

Bundle Id

The port ID for this bundle

Type

The type of this multilink bundle:

mlppp: the bundle is of type MLPPP

ima: the bundle is of type IMA group

Admin State

Up: the bundle is administratively up

Down: the bundle is administratively down

Oper State

Up: the bundle is operationally up

Down: the bundle is operationally down

Port State

The state level of the port:

none: the port is either in its initial creation state or is just about to be deleted

ghost: no member links are configured as part of this bundle

down: all member links are in ‟none”, ‟ghost”, or ‟down” state

linkUp: at least one member link is in port state ‟link up” but the bundle protocol is not yet operationally up (due to the bundle protocol still coming up; for example, due to insufficient number of member links in ‟link up” state yet or to bundle being shut down)

Up: the bundle is ready to pass some kinds of traffic as the bundle protocol has come up (at least ‟minimum links” member links are in the port state up and the bundle protocol is up)

Min Links

The minimum number of links that must be active for a bundle to be active. If the number of links drop below the given minimum, then the multilink bundle will transition to an operation down state.

Total Links

The total number active of member links configured for this bundle

Active Links

The total number of active links for the bundle

Output Example
*A:ALU-1># show multilink-bundle type ima-grp
===============================================================================
Bundle Summary
===============================================================================
Bundle               Type    Admin     Oper      Port      Min    Total/
Id                           State     State     State     Links  Active Links
-------------------------------------------------------------------------------
bundle-ima-1/6.3     ima-grp Down      Down      Ghost     1      0/0
-------------------------------------------------------------------------------
Bundles : 1
===============================================================================
*A:ALU-1>#
*A:ALU-1># show multilink-bundle bundle-ima-1/6.3
===============================================================================
Bundle Summary
===============================================================================
Bundle               Type    Admin     Oper      Port      Min    Total/
Id                           State     State     State     Links  Active Links
-------------------------------------------------------------------------------
bundle-ima-1/6.3     ima-grp Down      Down      Ghost     1      0/0
-------------------------------------------------------------------------------
Bundles : 1
===============================================================================
*A:ALU-1>
Note:

The ima-grp command shows all bundles in the IMA group. The bundle-ima command shows information on the specified bundle. The fields for both commands are the same.

Table: Multilink Bundle IMA Group Field Descriptions

Label

Description

Bundle Id

The port ID for this bundle

Type

The type of this multilink bundle:

ima: the bundle is of type IMA group

Admin State

Up: the bundle is administratively up

Down: the bundle is administratively down

Oper State

Up: the bundle is operationally up

Down: the bundle is operationally down

Port State

The state level of the port:

none: the port is either in its initial creation state or is just about to be deleted

ghost: no member links are configured as part of this bundle

down: all member links are in ‟none”, ‟ghost”, or ‟down” state

linkUp: at least one member link is in port state ‟link up” but the bundle protocol is not yet operationally up (due to the bundle protocol still coming up; for example, due to insufficient number of member links in ‟link up” state yet or to bundle being shut down)

Up: the bundle is ready to pass some kinds of traffic as the bundle protocol has come up (at least ‟minimum links” member links are in the port state up and the bundle protocol is up)

Min Links

The minimum number of links that must be active for a bundle to be active. If the number of links drop below the given minimum, then the multilink bundle will transition to an operation down state.

Total Links

The total number active of member links configured for this bundle

Active Links

The total number of active links for the bundle

Bundles

The number of bundles on the port

Output Example
*A:ALU-1># show multilink-bundle type ima-grp detail
===============================================================================
Bundle bundle-ima-1/6.3 Detail
===============================================================================
Description        : MultiLink Bundle
Bundle Id          : bundle-ima-1/6.3   Type               : ima-grp
Admin Status       : down               Oper Status        : down
Minimum Links      : 1                  Bundle IfIndex     : 583012355
Total Links        : 0                  Active Links       : 0
Red Diff Delay     : 25                 Yellow Diff Delay  : N/A
Red Diff Delay Act : down               MRRU               : N/A
Short Sequence     : N/A                Oper MRRU          : N/A
Oper MTU           : 1524               Fragment Threshold : 128 bytes
Up Time            : N/A                Bandwidth          : 0 KBit
PPP Input Discards : N/A                Primary Member Port: None
Mode               : access
===============================================================================
Traffic Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Octets                                                 0                      0
Packets                                                0                      0
Errors                                                 0                      0
===============================================================================
Port Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Unicast Packets                                        0                      0
Multicast Packets                                      0                      0
Broadcast Packets                                      0                      0
Discards                                               0                      0
Unknown Proto Discards                                 0
===============================================================================
*A:ALU-1>
*A:ALU-1># show multilink-bundle bundle-ima-1/6.3 detail
===============================================================================
Bundle bundle-ima-1/6.3 Detail
===============================================================================
Description        : MultiLink Bundle
Bundle Id          : bundle-ima-1/6.3   Type               : ima-grp
Admin Status       : down               Oper Status        : down
Minimum Links      : 1                  Bundle IfIndex     : 583012355
Total Links        : 0                  Active Links       : 0
Red Diff Delay     : 25                 Yellow Diff Delay  : N/A
Red Diff Delay Act : down               MRRU               : N/A
Short Sequence     : N/A                Oper MRRU          : N/A
Oper MTU           : 1524               Fragment Threshold : 128 bytes
Up Time            : N/A                Bandwidth          : 0 KBit
PPP Input Discards : N/A                Primary Member Port: None
Mode               : access
===============================================================================
Traffic Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Octets                                                 0                      0
Packets                                                0                      0
Errors                                                 0                      0
===============================================================================
Port Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Unicast Packets                                        0                      0
Multicast Packets                                      0                      0
Broadcast Packets                                      0                      0
Discards                                               0                      0
Unknown Proto Discards                                 0
===============================================================================
*A:ALU-1>
Note:

The ima-grp detail command shows all bundles in the IMA group. The bundle-ima detail command shows information on the specified bundle. The fields for both commands are the same.

Table: Multilink Bundle IMA Group Detailed Field Descriptions

Label

Description

Description

The configured description for this bundle

Bundle Id

The port ID for this bundle

Admin Status

Up: the bundle is administratively up

Down: the bundle is administratively down

Minimum Links

The minimum number of links that must be active for a bundle to be active. If the number of links drop below the given minimum, then the multilink bundle will transition to an operation down state.

Total Links

The total number of active member links configured for this bundle

Red Diff Delay

The maximum acceptable differential delay for individual circuits within this multilink bundle. If the delay exceeds this threshold, a trap is issued.

Red Diff Delay Act

The action that will be taken on the IMA group once the Red Diff Delay is exceeded

Oper MTU

The negotiated size of the largest packet that can be sent on the port or channel, specified in octets

Mode

network: the port is configured for transport network use

access: the port is configured for service access

Type

Indicates that this bundle is of type IMA group

Oper Status

The operational port status of a member link

Bundle IfIndex

The bundle’s interface index number, which reflects its initialization sequence

Active Links

The total number of active links for the bundle

Bandwidth

The bandwidth configured for this IMA group bundle in kb/s

Traffic Statistics

Octets Input/Output

The total number of octets received and transmitted on the port

Packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a multicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent.

Errors Input/Output

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.

For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors.

Port Statistics

Unicast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a multicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent.

Multicast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a unicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a unicast or broadcast address at this sublayer, including those that were discarded or not sent.

Broadcast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a unicast or multicast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a unicast or multicast address at this sublayer, including those that were discarded or not sent.

Discards Input/Output

The number of inbound/outbound packets chosen to be discarded to possibly free up buffer space

Unknown proto discards Input/Output

For packet-oriented interfaces, the number of packets received via the interface that were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces that support protocol multiplexing, the number of transmission units received via the interface that were discarded because of an unknown or unsupported protocol. For any interface that does not support protocol multiplexing, this counter will always be 0. Unknown proto discards do not show up in the packet counts.

Output Example
*A:ALU-1># show multilink-bundle type mlppp
===============================================================================
Bundle Summary
===============================================================================
Bundle               Type    Admin     Oper      Port      Min    Total/
Id                           State     State     State     Links  Active Links
-------------------------------------------------------------------------------
bundle-ppp-1/1.1     mlppp   Down      Down      Ghost     1      0/0
bundle-ppp-1/4.8     mlppp   Up        Down      Ghost     1      0/0
-------------------------------------------------------------------------------
Bundles : 2
===============================================================================
*A:ALU-1>#

*A:ALU-1># show multilink-bundle bundle-ppp-1/4.8
===============================================================================
Bundle Summary
===============================================================================
Bundle               Type    Admin     Oper      Port      Min    Total/
Id                           State     State     State     Links  Active Links
-------------------------------------------------------------------------------
bundle-ppp-1/4.8     mlppp   Up        Down      Ghost     1      0/0
-------------------------------------------------------------------------------
Bundles : 1
===============================================================================
*A:ALU-1>#

A:ALU-1# show multilink-bundle bundle-ppp-1/1.13 ppp multiclass 
===============================================================================
MLPPP Per Class Traffic Statistics for bundle-ppp-1/1.13
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Class  0                                                                       
  Octets                                      2993101300             2993220860
  Packets                                        3054185                3054307
  Errors                                               0                      0
Class  1                                                                       
  Octets                                      2987258540             2993219880
  Packets                                        3048223                3054306
  Errors                                               0                      0
Class  2                                                                       
  Octets                                      2987255600             2993220860
  Packets                                        3048220                3054307
  Errors                                               0                      0
Class  3                                                                       
  Octets                                      2987257560             2993220860
  Packets                                        3048222                3054307
  Errors                                               0                      0
===============================================================================
Note:

The mlppp command shows all bundles in the MLPPP group. The bundle-ppp command shows information on the specified bundle. The fields for both commands are the same.

Table: Multilink Bundle MLPPP Field Descriptions

Label

Description

Bundle Id

The port ID for this bundle

Type

The type of this multilink bundle:

mlppp: the bundle is of type MLPPP

Admin State

Up: the bundle is administratively up

Down: the bundle is administratively down

Oper State

Up: the bundle is operationally up

Down: the bundle is operationally down

Port State

The state level of the port:

none: the port is either in its initial creation state or is just about to be deleted

ghost: no member links are configured as part of this bundle

down: all member links are in the ‟none”, ‟ghost”, or ‟down” state

linkUp: at least one member link is in the port state ‟link up” but the bundle protocol is not yet operationally up (due to the bundle protocol still coming up; for example, due to an insufficient number of member links in the ‟link up” state or to the bundle being shut down)

Up: the bundle is ready to pass some kinds of traffic as the bundle protocol has come up (at least ‟minimum links” member links are in the port state up and the bundle protocol is up)

Min Links

The minimum number of links that must be active for a bundle to be active. If the number of links drops below the given minimum, then the multilink bundle will transition to an operation down state.

Total Links

The total number of active member links configured for this bundle

Active Links

The total number of active links for the bundle

Bundles

Number of bundles on the port

Class

The MC-MLPPP service class

Octets Input/Output

The total number of octets received and transmitted on the port

Packets Input/Output

The total number of packets received and transmitted on the port

Errors Input/Output

The number of packets that contained errors preventing them from being deliverable

Output Example
*A:ALU-1># show multilink-bundle type mlppp detail
===============================================================================
Bundle bundle-ppp-1/1.1 Detail
===============================================================================
Description        : MultiLink Bundle
Bundle Id          : bundle-ppp-1/1.1   Type               : mlppp
Admin Status       : down               Oper Status        : down
Minimum Links      : 1                  Bundle IfIndex     : 572522497
Total Links        : 0                  Active Links       : 0
Red Diff Delay     : 0                  Yellow Diff Delay  : 0
Red Diff Delay Act : none               MRRU               : 1524
Short Sequence     : false              Oper MRRU          : 1524
Oper MTU           : 1526               Fragment Threshold : 128 bytes
Up Time            : N/A                Bandwidth          : 0 KBit
PPP Input Discards : 0                  Primary Member Port: None
Mode               : network            Net. Egr. Queue Pol:
===============================================================================
Traffic Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Octets                                                 0                      0
Packets                                                0                      0
Errors                                                 0                      0
===============================================================================
Port Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Unicast Packets                                        0                      0
Multicast Packets                                      0                      0
Broadcast Packets                                      0                      0
Discards                                               0                      0
Unknown Proto Discards                                 0
===============================================================================

*A:ALU-1># show multilink-bundle bundle-ppp-1/4.8 detail
===============================================================================
Bundle bundle-ppp-1/4.8 Detail
===============================================================================
Description        : MultiLink Bundle
Bundle Id          : bundle-ppp-1/4.8   Type               : mlppp
Admin Status       : up                 Oper Status        : down
Minimum Links      : 1                  Bundle IfIndex     : 578813960
Total Links        : 0                  Active Links       : 0
Red Diff Delay     : 0                  Yellow Diff Delay  : 0
Red Diff Delay Act : none               MRRU               : 1524
Short Sequence     : false              Oper MRRU          : 1524
Oper MTU           : 1526               Fragment Threshold : 128 bytes
Up Time            : N/A                Bandwidth          : 0 KBit
PPP Input Discards : 0                  Primary Member Port: None
Mode               : network            Net. Egr. Queue Pol:
===============================================================================
Traffic Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Octets                                                 0                      0
Packets                                                0                      0
Errors                                                 0                      0
===============================================================================
Port Statistics
===============================================================================
                                                   Input                 Output
-------------------------------------------------------------------------------
Unicast Packets                                        0                      0
Multicast Packets                                      0                      0
Broadcast Packets                                      0                      0
Discards                                               0                      0
Unknown Proto Discards                                 0
===============================================================================
*A:ALU-1>#
Note:

The mlppp detail command shows all bundles in the MLPPP group. The bundle-ppp detail command shows information on the specified bundle. The fields for both commands are the same.

Table: Multilink Bundle MLPPP Detail Field Descriptions

Label

Description

Description

The configured description for this bundle

Bundle Id

The port ID for this bundle

Admin Status

Up: the bundle is administratively up

Down: the bundle is administratively down

Minimum Links

The minimum number of links that must be active for a bundle to be active. If the number of links drop below the given minimum, then the multilink bundle will transition to an operation down state.

Total Links

The total number of active member links configured for this bundle

Red Diff Delay

The maximum acceptable differential delay for individual circuits within this multilink bundle. If the delay exceeds this threshold, a trap is issued.

Red Diff Delay Act

The action that will be taken on the MLPPP bundle once the Red Diff Delay is exceeded

Short Sequence

Indicates whether the MLPPP bundle uses short (12 bit) sequence numbers instead of the default 24-bit sequence number

Oper MTU

The negotiated size of the largest packet that can be sent on the port or channel, specified in octets

Mode

network: the port is configured for transport network use

access: the port is configured for service access

Type

The bundle type

Oper Status

The operational port status of a member link

Bundle IfIndex

The bundle’s interface index number, which reflects its initialization sequence

Active Links

The total number of active links for the bundle

Yellow Diff Delay

The yellow warning threshold for the differential delay for members within a multilink bundle

MRRU

The configured maximum frame size that can be reconstructed from multilink fragments

Oper MRRU

The operating maximum frame size that can be reconstructed from multilink fragments

Bandwidth

The bandwidth configured for this MLPPP bundle in kb/s

Traffic and Port statistics

The traffic and port statistics information displayed for bundles when the detail option is selected is the same as information displayed for physical ports

Traffic Statistics

Octets Input/Output

The total number of octets received and transmitted on the port

Packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a multicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent.

Errors Input/Output

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.

For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors.

Port Statistics

Unicast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a multicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent.

Multicast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a unicast or broadcast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a unicast or broadcast address at this sublayer, including those that were discarded or not sent.

Broadcast packets Input/Output

The number of packets, delivered by this sublayer to a higher (sub) layer, which were not addressed to a unicast or multicast address at this sublayer. The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a unicast or multicast address at this sublayer, including those that were discarded or not sent.

Discards Input/Output

The number of inbound/outbound packets chosen to be discarded to possibly free up buffer space

Unknown proto discards Input/Output

For packet-oriented interfaces, the number of packets received via the interface that were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces that support protocol multiplexing, the number of transmission units received via the interface that were discarded because of an unknown or unsupported protocol. For any interface that does not support protocol multiplexing, this counter will always be 0. Unknown proto discards do not show up in the packet counts.