Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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
    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 type ethernetCsmacd
    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 type ethernetCsmacd ains-timer 02:30
    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.

    bti7800(config)# do show interface 10ge:1/3/1/2
    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

    bti7800(config)# do show interface 10ge:1/3/1/2
    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-- 

    Modified: 2017-10-24