Configuring physical ports with CLI

This section provides information to configure cards, MDAs, and ports.

Preprovisioning guidelines

7705 SAR Gen 2 platforms have a console port, either located on the CPM or integrated into the chassis, to connect terminals to the router.

Configure command options from a system console connected to a router console port, using Telnet to access a router remotely or SSH to open a secure shell connection.

Predefining entities

To initialize a card, the chassis slot, line card type, and MDA type must match the preprovisioned command options. In this context, preprovisioning means to configure the entity type (such as the card type, MDA type, port, and interface) that is planned for a chassis slot, card, or MDA. Preprovisioned entities can be installed but not enabled or the slots can be configured but remain empty until populated. Provisioning means that the preprovisioned entity is installed and enabled.

You can:

  • Preprovision ports and interfaces after the line card and MDA types are specified.

  • Install line cards in slots with no pre-configuration command options specified. After the card is installed, the card and MDA types must be specified.

  • Install a line card in a slot provisioned for a different card type (the card does not initialize). The existing card and MDA configuration must be deleted and replaced with the current information.

Preprovisioning a port

Before a port can be configured, the slot must be preprovisioned with an allowed card type and the MDA must be preprovisioned with an allowed MDA type. Some recommendations to configure a port include:

  • Ethernet

    • Configure an access port for customer facing traffic on which services are configured.

    • An encapsulation type may be specified to distinguish services on the port or channel. Encapsulation types are not required for network ports.

    • To configure an Ethernet access port, see Configuring Ethernet access ports.

Maximizing bandwidth use

After ports are preprovisioned, Link Aggregation Groups (LAGs) can be configured to increase the bandwidth available between two nodes.

All physical links or channels in a LAG/bundle combine to form one logical connection. A LAG/bundle also provides redundancy in case one or more links that participate in the LAG/bundle fail. For command syntax for LAG, see Configuring LAG.

Basic configuration

The most basic configuration must specify the following:

  • line card type (must be an allowed card type)

  • MDA slot

  • MDA (must be an allowed MDA type)

  • specific port to configure

The following is an example of card configuration for the 7705 SAR Gen 2.

MD-CLI

[ex:]
A:admin@node-2# admin show configuration
    configure {
        card 6 {
            card-type iom4-e
            mda 1 {
                mda-type me1-100gb-cfp2
            }
            fp 1 {
            }
        }
        card 7 {
            card-type iom4-e
            mda 1 {
                mda-type me10-10gb-sfp+
            }
            mda 2 {
                mda-type me1-100gb-cfp2
            }
            fp 1 {
            }
        }
        card 8 {
            card-type iom4-e
            mda 1 {
                mda-type me10-10gb-sfp+
            }
        }

classic CLI

A:node-2> admin display-config 
echo "Card Configuration"
#--------------------------------------------------
    card 6
        card-type iom4-e
        no shutdown
    exit
    card 7
        card-type iom4-e
        mda 1
            mda-type me10-10gb-sfp+
            no shutdown
        exit
        mda 2
            mda-type me1-100gb-cfp2
            no shutdown
        exit
        no shutdown
    exit
    card 8
        card-type iom4-e
        no shutdown
    exit
#--------------------------------------------------

Common configuration tasks

The following sections are basic system tasks that must be performed.

Configuring cards and MDAs

Card configurations include a chassis slot designation. A slot must be preconfigured with the type of cards and MDAs which are allowed to be provisioned.

The following example shows card and MDA configurations for the 7705 SAR Gen 2.

Note: On 7705 SAR Gen 2 platforms, the card is permanently equipped and provisioned in slot 1 cannot be removed.

MD-CLI

[ex: /configure card 1]
A:admin@node-2# info
    mda 1 {
        admin-state enable
        mda-type m2-1g-sfp+2-10g-sfp+
    }
    mda 2 {
        admin-state disable
    }
    mda 3 {
    }
    mda 4 {
    }

classic CLI

A:node-2>config>card# info
#--------------------------------------------------
        card-type iom-sar-1x
        mda 1
            no shutdown
            mda-type m2-1g-sfp+2-10g-sfp+
        exit
        mda 2
            shutdown
            mda-type m4-1g-rj+6-10g-sfp++2-25g-sfp28
        exit
        no shutdown
#----------------------------------------------

Configuring ports

This section provides the CLI and examples to configure port command options.

Configuring port pools

The buffer space is portioned out on a per port basis. Each port gets an amount of buffering which is its fair-share based on the port’s bandwidth compared to the overall active bandwidth.

This mechanism takes the buffer space available and divides it into a portion for each port based on the port’s active bandwidth relative to the amount of active bandwidth for all ports associated with the buffer space. The number of ports sharing the same buffer space depends on the type of MDAs populated on the IOM. An active port is considered to be any port that has an active queue associated. After a queue is created for the port, the system allocates the appropriate amount of buffer space to the port. This process is independently performed for both ingress and egress.

Normally, the amount of active bandwidth is considered as opposed to total potential bandwidth for the port when determining the port’s fair share. If a port is channelized and not all bandwidth is allocated, only the bandwidth represented by the configured channels with queues configured is counted toward the bandwidth represented by the port. Also, if a port may operate at variable speeds (as in some Ethernet ports), only the current speed is considered. Based on the above, the number of buffers managed by a port may change because of queue creation and deletion, channel creation and deletion and port speed variance on the local port or other ports sharing the same buffer space.

After the active bandwidth is calculated for the port, the result may be modified through the use of the following commands.
  • MD-CLI
    configure port modify-buffer-allocation percentage-of-rate egress
    configure port modify-buffer-allocation percentage-of-rate ingress
  • classic CLI
    configure port modify-buffer-allocation egr-percentage-of-rate
    configure port modify-buffer-allocation ing-percentage-of-rate
The default value of each is 100% which allows the system to use all of the ports active bandwidth when deciding the relative amount of buffer space to allocate to the port. When the value is explicitly modified, the active bandwidth on the port is changed according to the specified percentage. If a value of 50% is given, the ports active bandwidth is multiplied by 5, if a value of 150% is given, the active bandwidth is multiplied by 1.5. The ports rate percentage command options may be modified at any time.

To modify (in this example, to double) the size of buffer allocated on ingress for a port.

MD-CLI
configure port 1/2/1 modify-buffer-allocation-rate percentage-of-rate ingress 200
classic CLI
configure port 1/2/1 modify-buffer-allocation-rate ing-percentage-of-rate 200

To modify (in this example, to double) the size of buffer allocated on egress for a port.

MD-CLI
configure port 1/2/1 modify-buffer-allocation-rate percentage-of-rate egress 200
classic CLI
configure port 1/2/1 modify-buffer-allocation-rate egr-percentage-of-rate 200

The default buffer allocation has the following characteristics:

  • Each port manages a buffer according to its active bandwidth (ports with equal active bandwidth get the same buffer size).

  • An access port has 2 default pools created: access-ingress and access-egress.

  • A network port has 2 default pools created: ingress-FP (common pool for all ingress network ports) and network-egress.

  • All queues defined for a port receive buffers from the same buffer pool.

The following example shows port pool configurations.

MD-CLI
[ex:/configure port 1/1/1]
A:admin@node-2# info
    admin-state enable
    access {
        egress {
            pool "default" {
                slope-policy "slopePolicy1"
            }
        }
    }
    network {
        egress {
            pool "default" {
                slope-policy "slopePolicy2"
            }
        }
    }
classic CLI
A:node-2>config>port# info 
----------------------------------------------
        access
            egress
                pool
                    slope-policy "slopePolicy1"
                exit
            exit
        exit
        network
            egress
                pool
                    slope-policy "slopePolicy2"
                exit
            exit
        exit
        no shutdown
----------------------------------------------

The following shows a CBS configuration over subscription example.

MD-CLI
[ex:/configure port 1/1/1]
A:admin@node-2# info
    admin-state enable
    access {
        ingress {
            pool "default" {
                amber-alarm-threshold 10
                resv-cbs {
                    cbs 10
                    amber-alarm-action {
                        step 1
                        max 30
                    }
                }
            }
        }
    }
    ethernet {
        mode access
        encap-type dot1q
    }
classic CLI
A:node-2>config>port# info 
----------------------------------------------
        access
            ingress
                pool 
                    amber-alarm-threshold 10
                    resv-cbs 10 amber-alarm-action step 1 max 30
                exit
            exit
        exit
        ethernet
            mode access
            encap-type dot1q
        exit
        no shutdown

Changing hybrid-buffer-allocation

The following example shows a hybrid-buffer-allocation value change (from default) for ingress. In this example, the network-egress buffer pool is two times the size of the access-egress.

MD-CLI
[ex:/configure port 1/1/2 hybrid-buffer-allocation]
A:admin@node-2# info
    egress-weight {
        access 20
        network 40
    }
classic CLI
A:node-2config>port>hybrid-buffer-allocation# info 
----------------------------------------------
egr-weight access 20 network 40

Configuring Ethernet ports

Configuring Ethernet network ports

A network port is network-facing and participates in the service provider transport or infrastructure network processes.

The following example shows a network port configuration.

MD-CLI
[ex:/configure port A/3]
A:admin@node-2# info
    admin-state enable
    description "Ethernet network port"

classic CLI
A:node-2config>port# info 
----------------------------------------------
        description "Ethernet network port"
        ethernet
        exit
        no shutdown
----------------------------------------------
Configuring Ethernet access ports

Services are configured on access ports that are used for customer-facing traffic. If a SAP is to be configured on a port, it must be configured as access mode. When a port is configured for access mode, the appropriate encapsulation type can be specified to distinguish the services on the port. After a port has been configured for access mode, multiple services can be configured on the port.

The following example shows an Ethernet access port configuration.

MD-CLI
[ex:/configure port 1/1/c1/1]
A:admin@node-2# info
    admin-state enable
    description "Ethernet access port"
    ethernet {
        mode access
        encap-type dot1q
    }
classic CLI
A:node-2>config>port# info
----------------------------------------------
----------------------------------------------
        description "Ethernet access port"
        ethernet
            mode access
            encap-type dot1q
        exit
        no shutdown
----------------------------------------------
Configuring an 802.1x authentication port

The following example shows an 802.1x port configuration.

MD-CLI
[ex:/configure port 1/2/4 ethernet dot1x]
A:admin@node-2# info detail
...
    admin-state enable
    max-authentication-requests 2
    port-control auto
    quiet-period 60
    radius-policy dot1xpolicy
    server-timeout 30
    supplicant-timeout 30
    transmit-period 30
    tunneling false
    tunnel-dot1q true
    tunnel-qinq true
    re-authentication {
        period 3600
    }
   ...
classic CLI
A:node-2>config>port>ethernet>dot1x# info detail
----------------------------------------------
                 port-control auto
                 radius-plcy dot1xpolicy
                 re-authentication
                 re-auth-period 3600
                 max-auth-req 2
                 transmit-period 30
                 quiet-period 60
                 supplicant-timeout 30
                 server-timeout 30
                 no tunneling
                 no shutdown
----------------------------------------------

Configuring LAG

LAG configurations should include at least two ports. Other considerations include the following.

  • A maximum of 64 ports (depending on the lag-id) can be included in a LAG. All ports in the LAG must share the port characteristics inherited from the primary port.

  • Auto-negotiation must be disabled or set to limited mode for ports that are part of a LAG, to guarantee a specific port speed.

  • Ports in a LAG must be configured as full duplex.

The following example shows the LAG configuration output.

MD-CLI
[ex:/configure lag "lag-2"]
A:admin@node-2# info
    description "LAG2"
    mac-address 04:68:ff:00:00:01
    dynamic-cost true
    port-threshold {
        value 4
        action down
    }
    port 1/1/1 {
    }
    port 1/3/1 {
    }
    port 1/5/1 {
    }
    port 1/7/1 {
    }
    port 1/9/1 {
    }
 
classic CLI
A:node-2>config>lag# info detail
----------------------------------------------
        description "LAG2"
        mac 04:68:ff:00:00:01
        port  1/1/1
        port  1/3/1
        port  1/5/1
        port  1/7/1
        port  1/9/1
        dynamic-cost
        port-threshold 4 action down
----------------------------------------------

Configuring GNSS ports

The 7705 SAR-Hx and 7705 SAR-Mx are equipped with an integrated GNSS receiver and GNSS RF port for retrieval and recovery of GPS and Galileo signals.

Note: GPS signal recovery must always be enabled in the system when using the GNSS receiver.

Use the commands in the following context to configure integrated GNSS RF ports, including antenna-cable delay, signal recovery, and elevation-mask angle.

configure port gnss

Configuring TDM ports

Configuring T1/E1 ports

Use the commands in the following context to configure TDM for E1 on the 7705 SAR-Hx and 7705 SAR-Mx.

configure port tdm

The following example shows a TDM configuration for E1.

A:node-2>config>port>tdm# info detail
----------------------------------------------
            no length
            e1
                shutdown
                framing g704
                loopback line
                clock-source node-timed
                signal-mode cas
                report-alarm ais los
                no report-alarm oof rai
                no hold-time
                ssm
                    shutdown
                    ssm-bit 8
                    no tx-dus
                exit
                channel-group 1
                    description "DS0GRP"
                    mode access
                    encap-type cem
                    timeslots 2-16
                    loopback line
                    idle-payload-fill all-ones
                    idle-signal-fill all-ones
                    no shutdown
                exit
            exit
            line-impedance 120
----------------------------------------------
Configuring E1 SSM

Use the commands in the following context to configure Synchronization Status Messaging (SSM) for E1 TDM ports.

configure port tdm e1 ssm
Note:
  • Use only the g704 framing mode with E1 SSM. The no-crc-g704 and e1-unframed framing modes are not compatible with E1 SSM.

  • The ssm-bit applies only to E1 SSM.

The following example shows an SSM configuration on an E1 port.

A:node-2>config>port>tdm# info
----------------------------------------------
            e1
                ssm
                    ssm-bit 4
                    tx-dus
                    no shutdown
                exit
                no shutdown
            exit
----------------------------------------------

Configuring teleprotection ports

Use the following command to configure an IEEE C37.94 TPIF port on an 8-port RS-232 and C37.94 combination MDA on the 7705 SAR-Hx and 7705 SAR-Mx.

configure port tdm tpif
TPIF port configuration
A:node-2>config>port>tdm>tpif$ info detail
----------------------------------------------
                shutdown
                no loopback
                report-alarm los rai
                channel-group 1
                    shutdown
                    no description
                    timeslots 1
                exit
----------------------------------------------

Configuring serial ports for raw socket transport

Use the following CLI syntax to configure raw socket parameters on an RS-232 serial port.

Note: Raw sockets are only supported on RS-232 serial ports.
Raw socket configuration on an RS-232 serial port
A:node-2>config>port>serial>rs232$ info detail
----------------------------------------------
                shutdown
                no loopback
                character-length 8
                no parity
                stop-bits 1
                control-lead
                    input
                        dtr-dsr high
                        rts-dcd high
                    exit
                    output
                        dcd-rts high
                        cts-alb high
                        ri-rdl high
                    exit
                    monitor
                        dtr-dsr off
                        rts-dcd off
                    exit
                exit
                s-bit-signaling off
                no data-position
                no mon-data-inactivity
                no hold-time
                report-alarm ctrlLeadMon monDataInac
                no report-alarm hcmOof hcmRai
                speed 9600
                socket 1
                    shutdown
                    description "SOCKET"
                    rx
                        eop
                            length 1500
                            idle-timeout 50
                            no special-char
                        exit
                        no squelch-delay
                        no unsquelch-delay
                    exit
                    tx
                        inter-session-delay 10
                    exit
                exit
----------------------------------------------