Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Configuring AINS

 

Auto-In-Service (AINS) temporarily suppresses alarm reporting against a managed entity for first-time provisioning or during a maintenance interval, which eliminates managing transitory faults that occur while a service or system component is being set up.

You can configure system-wide and interface level AINS support.

System-wide AINS Support

If you do not configure AINS settings when provisioning a new interface, the system-wide AINS default values are applied to that interface. The following table lists the system-wide AINS commands:

Parameter

Description

Range

Default Value

default-ains

Enables or disables AINS on new interfaces.

true: Enable AINS

false: Disable AINS

false

default-ains-timer

Sets the AINS countdown duration on new interfaces, in hours and minutes, in the format: HH:MM.

00:00 to 99:59

08:00

Interface-level AINS Support

Interface-level AINS values are configured on a specified interface. The following table lists the interface-level AINS commands:

Parameter

Description

Range

Default Value

ains

Enables or disables AINS on a specified interface.

true: Enable AINS

false: Disable AINS

false

ains-timer

Sets the AINS countdown duration on the interface, in hours and minutes, in the format: HH:MM.

00:00 to 99:59

08:00

For more information about configuring interfaces, refer to the BTI7800 Series Command Line Reference Guide.

Guidelines

AINS can be set to true for any interface regardless of the setting of any other attribute, including the administrative status of the interface.

AINS settings persist in the database and survive system restarts.

When an interface operational state changes to "down", the current countdown timer is cancelled and the countdown timer reinitializes to the AINS timer setting when the operational status of the interface returns to "up".

When AINS is enabled for an interface, there is no alarm reporting for that interface. Raise or clear traps are not generated for faults on the interface, and there are no entries in the interface alarm list—show alarms, in addition, no threshold crossing alerts are generated. All faults raised against the interface can be viewed in the condition list—show conditions.

AINS enabled on an interface automatically transitions to disabled when the following occurs:

  • No fault is raised against the interface.

  • The operational status of the interface is “up”.

  • The interface remains fault free, with operational status “up” for a duration equal to the AINS countdown duration setting.

Once AINS automatically transitions to disabled, any fault subsequently raised against the interface is reported as an alarm. To satisfy the conditions for automatically transitioning from enabled to disabled, a fault-free, operationally up condition must persist for the duration equal to the interface AINS timer setting. When an interface with AINS enabled enters this state, the persistence interval begins and the remaining duration in the persistence interval is tracked with a countdown timer for the interface. If a fault is raised or the operational status changes to any value other than “up”, the current countdown timer is cancelled and reinitializes to the AINS timer setting when the interface returns to fault-free, operationally up status.

Since the automatic transition to disabled depends on the operational status of the interface being “up”, the transition out of AINS does not occur if:

  • The interface is administratively disabled.

  • Supporting equipment or other supporting interface is not operationally “up”.

AINS can be configured on an interface at any time. If a countdown timer is active for an interface, setting the AINS timer on that interface reinitializes the current active timer to the new timer setting.

AINS Status Monitoring

Each interface supports a new read-only attribute named Ains Countdown Timer, which is displayed in the show interface output. This attribute displays only if the AINS countdown timer is active. If an interface with AINS enabled is fault free and operationally up, Ains Countdown Timer displays the remaining time in the persistence interval in hours and minutes, for example 07:48 for 7 hours, 48 minutes.

Configuration Examples

Following are examples of AINS system-wide and interface configuration and monitoring:

Enabling AINS System-wide

bti7800(config)# show running-configuration system

Enabling AINS on an Interface

bti7800(config)# interface 10ge:1/3/1/1 type ethernetCsmacd

Provisioning the AINS timer on an Interface

This example configures the timer for 2 hours, 30 minutes:

bti7800(config)# interface 10ge:1/3/1/2 type ethernetCsmacd ains-timer 02:30

Checking the Interface Status: Operationally Down

Note: Only a portion of the whole interface status is displayed.

bti7800(config)# do show interface 10ge:1/3/1/2

Checking the Interface Status: Operationally Up

bti7800(config)# do show interface 10ge:1/3/1/2