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:

Interface-level AINS Support

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

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

system 
 location UNKNOWN 
 ains 
  default-ains        false 
  default-ains-timer  08:00 
! 

bti7800(config)# system ains default-ains true 
bti7800(config)# system ains default-ains-timer 04:00 
bti7800(config-system)# commit 
Commit complete. 
bti7800(config-system)# 

Enabling AINS on an Interface

bti7800(config-interface-10ge:1/3/1/1)# commit 
Commit complete. 
bti7800(config-interface-10ge:1/3/1/1)# show full-configuration 
interface 10ge:1/3/1/1 
 type    ethernetCsmacd 
 enabled 
 ains          true 
 ains-timer    04:00 
 laser-enabled true 
 fpsd          true 
 loopback-mode noLoopback 
! 
bti7800(config-interface-10ge:1/3/1/1)# 

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)# commit 
Commit complete. 
bti7800(config-interface-10ge:1/3/1/2)# show full-configuration 
interface 10ge:1/3/1/2 
 type    ethernetCsmacd 
 enabled 
 ains          true 
 ains-timer    02:30 
 laser-enabled true 
 fpsd          true 
 loopback-mode noLoopback 
! 
bti7800(config-interface-10ge:1/3/1/2)# 

Checking the Interface Status: Operationally Down

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

Name                                    : 10ge:1/3/1/2   
Description                             :   
Type                                    : ethernet   
Interface Index                         : 2   
Admin State                             : enabled   
Operational State                       : lowerLayerDown   
AINS                                    : enabled   
AINS Timer                              : 02:30   
Laser Enabled                           : enabled   
Laser Status                            :   
--More-- 

Checking the Interface Status: Operationally Up

Name                                    : 10ge:1/3/1/2   
Description                             :   
Type                                    : ethernet   
Interface Index                         : 2   
Admin State                             : enabled   
Operational State                       : up   
AINS                                    : enabled   
AINS Timer                              : 02:30   
AINS Countdown                          : 01:47   
Laser Enabled                           : enabled   
Laser Status                            :   
--More--