Configuration Guide for Cisco NCS 1014, IOS XR Releases 26.x.x

PDF

Configuration Guide for Cisco NCS 1014, IOS XR Releases 26.x.x

Automatic-In-Service

Updated: June 18, 2026

Want to summarize with AI?

Log in

This section explains how automatic-in-service features enable controllers to transition to in-service state after maintenance, manage soak times, and suppress alarms.

Automatic-In-Service (AINS) is a controller feature that:

  • allows the controller to automatically transition to the in-service state after the maintenance window,

  • associates a soak time period with the automatic-in-service (AINS) state, and

  • suppresses alarms from propagating to EMS/NMS monitoring systems during the AINS maintenance window.

You can configure AINS on the client ports of the QXP, 1.2T, 2.4T, and 2.4TX cards.

AINS states

If there are any service-affecting alarms when AINS is running on ethernet or optics controllers, the AINS state moves to Pending state. When the alarms are cleared, the AINS state moves to Running state.

The AINS soak time period restarts when there are line card reloads, XR reloads, line card warm reloads, power cycles, or alarm conditioning.

This table lists the AINS states.

State

Description

None

AINS is not enabled on the controller or the soak time period is complete.

Pending

AINS is configured on the controller. However, the soak time period has not started because either the primary state of the controller is in Shutdown, Admin down, or Not ready state or the secondary state is in Maintenance state. AINS can also move to Pending state if alarms are raised during the soak time period.

Running

AINS is enabled on the controller. The primary state of the controller is Up and the secondary state is AINS.

Soak time periods

A soak time period is a port timing parameter that:

  • suppresses alarms during the Automatic In Service (AINS) state,

  • begins when all optical and Ethernet alarms on the port are cleared, and

  • specifies the time before a port transitions from AINS to In Service (IS) state.

You can configure the soak time period to be between 1 minute to 48 hours.

All alarms are suppressed during the AINS state. If optical or Ethernet alarms are raised during the soak time period, the AINS state moves to Pending. These alarms are shown in the output of the show alarms brief card location 0/RP0/CPU0 conditions command, not in show alarms brief card location 0/RP0/CPU0 active. After all alarms are cleared, the soak time period initiates, and the AINS state moves to Running. When the soak time period expires, the port transitions to the IS state.

Configure Automatic In-Service (AINS)

Use this task to enable and set the soak time for Automatic In-Service (AINS) on a controller, a muxponder slice, or globally within the system.

AINS allows specific hardware components or the entire system to automatically transition to an in-service state after a defined soak time and reduces manual intervention.

Note

When both muxponder slice AINS and global AINS are configured, the muxponder slice AINS setting takes precedence and the Global AINS timer value displays 0.

Procedure

1.

Run the automatic-in-service controller controller rate controller hours hours minutes minutes command to configure AINS on a controller.

Example:

This is a sample to configure AINS globally.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#ains-soak hours 0 minutes 15
RP/0/RP0/CPU0:ios(config)#commit
2.

Run the hw-module location location mxponder-slice slice-number client-port-ains-soak hours hours minutes minutes command to configure AINS on a muxponder slice.

Example:

This example shows how to configure slice 0 client ports with AINS, setting the soak time to 40 minutes.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module location 0/3/nxr0 mxponder-slice 0 client-port-ains-soak hours 0 minutes 40
RP/0/RP0/CPU0:ios(config)#commit
3.

Run the ains-soak hours hours minutes minutes command to configure AINS globally.

Example:

This is a sample to configure AINS globally.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#ains-soak hours 0 minutes 15
RP/0/RP0/CPU0:ios(config)#commit

Disable AINS

Use this task to disable the AINS on a muxponder slice, which affects all client ports within that slice.

Procedure

1.

Run the hw-module location location mxponder-slice slice-number client-port-ains-soak hours hours minutes minutes command to disable AINS on all muxponder client ports. Set the hours and minutes to 0.

Example:

This is a sample in which AINS is disabled on all client ports.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module location 0/3/nxr0 mxponder-slice 0 client-port-ains-soak hours 0 minutes 0
RP/0/RP0/CPU0:ios(config)#commit
2.

Run the hw-module location location mxponder-slice slice-number client-port-ains-soak hours hours minutes minutescommand to disable AINS on a muxponder slice. Set the hours and minutes to 0.

Example:

This is a sample in which AINS is disabled on all client ports of slice 0.


RP/0/RP0/CPU0:ios(config)#hw-module location 0/3/nxr0 mxponder-slice 0 client-port-ains-soak hours 0 minutes 0
RP/0/RP0/CPU0:ios(config)#commit