APS Port Commands

port

Syntax

[no] port {aps-id}

Context

config

Description

This command enables access to the context to configure APS on SONET/SDH ports and assigns an APS group ID. Both working and protection circuits must be configured with the same APS group ID on either the same 7705 SAR node (SC-APS) or on two 7705 SAR nodes (MC-APS).

Parameters

aps

keyword

id

1 to 8

aps

Syntax

aps

Context

config>port

Description

This command configures APS on SONET/SDH ports. An APS group contains a working and protection circuit with the same APS group ID on either a single 7705 SAR node (SC-APS) or on two 7705 SAR nodes (MC-APS).

The working circuit must be connected to the peer working circuit, and the protection circuit must be connected to the peer protection circuit.

The aps command is only available for APS groups, not for physical ports.

advertise-interval

Syntax

advertise-interval advertise-interval

no advertise-interval

Context

config>port>aps

Description

This command specifies the time interval, in 100s of milliseconds, between ‟I am operational” messages sent by the protection and working circuits to their neighbor in an MC-APS group. The advertise-interval value is valid only for an MC-APS.

Default

10

Parameters

advertise-interval

the time interval, in 100s of milliseconds, between transmitted operational messages

Values

10 to 650

hold-time

Syntax

hold-time hold-time

no hold-time

Context

config>port>aps

Description

This command specifies how much time can pass without the node receiving an advertise packet from its neighbor before the MC-APS signaling link is considered operationally down. The hold time is in 100s of milliseconds and is usually the advertise-interval value multiplied by 3.

Parameters

hold-time

specifies, in 100s of milliseconds, how long to wait for an APS advertise packet before the neighbor in an MC-APS group is considered operationally down.

Values

10 to 650

hold-time-aps

Syntax

hold-time-aps {[lsignal-fail sf-time] [lsignal-degrade sd-time]}

no hold-time-aps

Context

config>port>aps

Description

This command configures hold-down timers to debounce signal failure conditions (lais, b2err-sf) and signal degrade conditions (b2err-sd) for 1+1 unidirectional SC-APS switching mode. If the signal fail or signal degrade conditions exceed the configured hold-down time, APS is activated.

Default

no hold-time-aps (values are 0)

Parameters

sf-time

the signal failure hold-down time in milliseconds, from 1 to 100

sd-time

the signal degrade hold-down time in milliseconds, from 1 to 100

neighbor

Syntax

neighbor ip-address

no neighbor

Context

config>port>aps

Description

This command specifies the neighbor's IP address in an MC-APS group. When the value of the neighbor IP address is set to 0.0.0.0, or not set, this implies that the APS group is configured as an SC-APS group.

The route to the neighbor must not traverse the MC-APS member (working or protection) circuits. It is recommended that the neighbor IP address configured be on a shared network between the routers that own the working and protection circuits. The node should be connected with a direct interface to ensure optimum failover time.

By default, no neighbor address is configured and both the working and protection circuits should be configured on the same router as an SC-APS group.

Default

0.0.0.0

Parameters

ip-address

specifies the neighbor's IP address for MC-APS.

Values

ipv4-address:       a.b.c.d

ipv6-address:       x:x:x:x:x:x:x:x (eight 16-bit pieces)

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

protect-circuit

Syntax

protect-circuit port-id

no protect-circuit

Context

config>port>aps

Description

This command configures a physical port that will act as the protection circuit for this APS group.

The protection circuit port must contain only the default configuration and cannot belong to another APS group. The protection circuit port must be of the same type as the working circuit (SONET/SDH) for the APS group; if it is not, the command will return an error.

A protection circuit can only be added if the working circuit already exists. The protection circuit must be removed from the configuration before the working circuit can be removed.

When a port is a protection circuit of an APS group, the configuration options available in the config>port port-id>sonet-sdh context are not allowed for that port unless they are in the following exception list:

  • clock-source

  • [no] loopback

  • [no] report-alarm

  • section-trace

  • [no] threshold

When a port is configured as a protection circuit of an APS group, the configurations listed above and all service configurations related to the APS port are operationally inherited by the protection circuit. If the protection circuit cannot inherit the configurations (due to resource limitations), the configuration attempt fails and an error is returned to the user.

The protection circuit must be shut down before it can be removed from the APS group port. The inherited configuration for the circuit and APS operational commands for that circuit are not preserved when the circuit is removed from the APS group.

The no form of this command removes the protection circuit.

Default

n/a

Parameters

port-id

the physical port that will act as the protection circuit for this APS group in the format slot/mda/port

rdi-alarms

Syntax

[no] rdi-alarms {suppress | circuit}

Context

config>port>aps

Description

This command configures how RDI alarms (line, path, section) are generated on physical circuits of an APS port. The command is only supported in 1+1 unidirectional SC-APS mode. When you configure RDI alarms on a port on the 2-port OC3/STM1 Channelized Adapter card, the second port is automatically configured with a matching RDI alarms setting. As a consequence, both ports will then support only 1+1 unidirectional SC-APS mode.

Default

circuit

Parameters

suppress

RDI hardware generation on working and protection circuits is suppressed. No alarms are generated upon an Rx failure of that circuit.

circuit

RDI alarms are hardware-generated independently on each working and protection circuit based on an Rx failure of that circuit, regardless of APS line status

revert-time

Syntax

revert-time minutes

no revert-time

Context

config>port>aps

Description

This command configures how long the 7705 SAR waits before switching back to the working circuit after it has been restored to service.

If the minutes value is changed, it takes effect at the next initiation of the wait-to-restore (WTR) timer.

This command does not modify the length of a WTR timer that has already been started. The WTR timer of a non-revertive switch can be assumed to be infinite.

The no form of this command restores the default (non-revertive) mode – the switch back does not occur unless the protection circuit fails or it is manually switched by the operator.

Parameters

minutes

the time to wait, in minutes, before reverting to the working circuit after it has been restored to service

Values

0 to 60

Default

5

switching-mode

Syntax

switching mode {bi-directional | uni-1plus1}

Context

config>port>aps

Description

This command configures the switching mode for the APS port. SC-APS supports both bi-directional and uni-1plus1; MC-APS supports only bi-directional switching mode.

Default

bi-directional

Parameters

bi-directional

provides protection in both directions

uni-1plus1

provides protection in one direction

working-circuit

Syntax

working-circuit port-id

no working-circuit

Context

config>port>aps

Description

This command configures a physical port that will act as the working circuit for this APS group.

The working circuit port must contain only the default configuration and cannot be part of another APS group. The working circuit must be created before the protection circuit.

When a port is a working circuit of an APS group, the configuration options available in the config>port port-id>sonet-sdh context are not allowed for that port unless they are in the following exception list:

  • clock-source

  • [no] loopback

  • [no] report-alarm

  • section-trace

  • [no] threshold

When a port is configured as a working circuit of an APS group, the configurations listed above and all service configurations related to the APS port are operationally inherited by the working circuit from the APS group ID. If the working circuit cannot inherit that configuration (for example, due to resource limitations), the configuration attempt fails and an error is returned to the user.

The working circuit must be shut down before it can be removed from an APS group. The inherited configuration for the circuit and APS operational commands for that circuit are not preserved when the circuit is removed from the APS group.

All configurations for the APS group under the config>port context and its submenus and all configuration for services that use this APS group ID are preserved as a non-activated configuration since the APS group no longer has any physical circuits assigned.

The no form of this command removes the working circuit. The working circuit can only be removed from the configuration after the protection circuit has been removed.

Parameters

port-id

the physical port that will act as the working circuit for this APS group in the format slot/mda/port