Table of Contents

Overview of Configuring Administrative States

Objects That Support Administrative State Configuration
About the Graceful Shutdown Function

Object State Transitions During the Graceful Shutdown Action

Recovering Cards from a Graceful Shutdown on Cisco AS5300 and AS5400 Devices
About the Accept Traffic Function

Object State Transitions During the Accept Traffic Action

About Processing Times for Configuring Administrative States
About the Action Report
Configuring the Administrative State for a Supported Object

Configuring the Administrative State of Objects

This chapter contains the following sections:

• Overview of Configuring Administrative States
  
  
• Objects That Support Administrative State Configuration
  
  
• About the Graceful Shutdown Function
  
  
• Recovering Cards from a Graceful Shutdown on Cisco AS5300 and AS5400 Devices
  
  
• About the Accept Traffic Function
  
  
• About Processing Times for Configuring Administrative States
  
  
• About the Action Report
  
  
• Configuring the Administrative State for a Supported Object
  
  

Overview of Configuring Administrative States

With the Cisco UGM Configure Administrative States option, you can:

• Shutdown an object (T1, E1, E1 combination card, T3, or T3 combination card) from service for maintenance with a minimum of customer impact (Graceful Shutdown).
  
  
• Place the object back in service after maintenance (Accept Traffic).
  
  

---

Note   References to E1 and T3 cards also include the E1 combination and T3 combination cards.

---

• The Object List contains the selected (root) object and its immediate children.
  
  
• Initial dialog box fields are blank—not "Unknown." After a Configure Administrative State action has occurred, the fields retain their values until the next action for that object. The dialog box fields show information from a previous action.
  
  
• All dialog box fields are logged (at INFO level); they are not just Progress Information.
  
  
• If a Configure Administrative State action is in progress at the time of
  Cisco UGM termination, the action is not restarted at the time of a
  Cisco UGM restart. A "Graceful Shutdown interrupted" or "Accept Traffic interrupted" alarm is raised instead. These alarms are visible in the Event Browser and must be manually cleared.
  
  

Objects That Support Administrative State Configuration

The Configure Administrative State function applies to the following objects only:

• T1 and E1 cards
  
  
• CT3 cards
  
  
• PRI + NextPort combination cards
  
  
• CT3 + NextPort combination cards
  
  

You can perform Graceful Shutdown and Accept Traffic actions only for the entire card (not individual ports or channels).

Graceful Shutdown and Accept Traffic are not supported for modem, SPE, VFC, and Carrier cards, the device, and DS0 channels.

About the Graceful Shutdown Function

Before performing this function, set up authentication values for the device. (See the "Task 1: Authenticating the Device Object" section.)

When you start this function, make sure that:

• No other configuration activity is in progress for the selected card or for its host device.
  
  
• The object (which will undergo a graceful shutdown) and its host device is in a normal state.
  
  

You can also gracefully shut down a selected card object in a normal state (no Graceful Shutdown action is currently in effect).

Graceful Shutdown of an object consists of two steps: busyout and shutdown.

• Busyout causes the NAS to inform the other side of the trunk that an object is out of service.
  
  

Busyout does not terminate existing calls; instead, busyout allows existing calls to be completed and prevents any new calls from being established on the object.

Busyout phases out all DS0 operation on the card. When no active DS0s remain, the T1, E1, and/or T3 controllers (as applicable) on the card are shut down.

• Shutdown abruptly stops operation of an active or idle object.
  
  

An Action Report appears at the end of a Graceful Shutdown and shows the results of the action.

The Configure Administrative State option and Graceful Shutdown are available only for some Cisco UGM objects.

For details, see the "Objects That Support Administrative State Configuration" section.

Object State Transitions During the Graceful Shutdown Action

Typical state transitions during the processing of a Graceful Shutdown action are:

• normal to shuttingDown to locked
  
  

These transitions are visible in the bottom left corner of the Configure Administrative State dialog box.

Recovering Cards from a Graceful Shutdown on Cisco AS5300 and AS5400 Devices

When you perform a Graceful Shutdown action on a card installed in the Cisco AS5300 and AS5400 devices, the card is removed from the Physical view in Map Viewer. You must bring the card object back into the Map Viewer before performing an Accept Traffic function on the card.

To bring the card object back into the Map Viewer:

Step 1   From the Map Viewer, select and right-click the device in which the card is installed.

Step 2   Select Open Telnet Session.

Step 3   Enter your password to access the device.

Step 4   Enter this command:

no busyout slot_card

Where

slot is the location of the card in the parent device.

card is the description of the card installed in that slot.

The card appears in the Map Viewer's Physical view.

About the Accept Traffic Function

Note   When you accept traffic, make sure that no other configuration activity is in progress for the selected card or for its host chassis.

You can Accept Traffic on a selected card object in the locked state (resulting from a prior Graceful Shutdown action that was previously performed for this object).

By doing so, you can either configure the object to start receiving calls, or undo the effect of a graceful shutdown. The object is now in service.

Accept Traffic activates all T1, E1, and T3 controllers on the card (including those that may have been shut down by means other than the Graceful Shutdown method). Use this Accept Traffic method to activate T1, E1, and T3 controllers that are "down."

Note   If you perform a Graceful Shutdown action on a Cisco AS5350 or AS5400 device, you cannot enter the Accept Traffic command. For details, see the "Configuring the Administrative State for a Supported Object" section.

Object State Transitions During the Accept Traffic Action

Typical state transitions during the processing of an Accept Traffic action are:

• locked to acceptingTraffic to normal
  
  

These transitions are visible in the bottom left corner of the Configure Administrative State dialog box.

Note   The Configure Administrative State option (and Accept Traffic) is available only for some Cisco UGM objects. For details, see the "Objects That Support Administrative State Configuration" section.

About Processing Times for Configuring Administrative States

This section describes processing times associated with Configure Administrative State actions:

• The dialog box fields are updated every 10 seconds.
  
  
• After you click Accept Traffic, allow approximately 60 seconds for the card to start.
  
  
• Allow approximately 40 seconds for the T1, E1, and T3 controllers (as applicable) to start after you click Accept Traffic.
  
  
• When you click Graceful Shutdown, the number of active DS0s must drop to 0 before the shutdown begins. This processing time is difficult to anticipate.
  
  

---

Note   The number of active DS0s drops to 0 if all calls terminate on their own, ports are disconnected, or the card is removed from the chassis.

---

About the Action Report

• The Configure Administrative State dialog box fields are updated every 10 seconds; only the last update for a field is visible in the dialog box. However, all display field updates appear in the Action Report.
  
  
• The Action Report appears either because an action is complete or was interrupted.
  
  
• The maximum number of characters in the report is limited to approximately 500,000.
  
  
• The report is always timestamped, even if the report is "full."
  
  

Configuring the Administrative State for a Supported Object

• When you shut down an object, it and all its descendants in the Physical tree (except Universal ports in combination cards) are shut down as well.
  
  
• Once initiated, you cannot cancel Graceful Shutdown. It must run to completion.
  
  
• You cannot shut down T1, E1, and T3 controllers in loopback mode.
  
  
• At a given time, you can perform only one Configure Administrative State action.
  
  
• When a Configure Administrative State action is being executed on one managed device, you cannot initiate a Configure Administrative State action on another managed device.
  
  
• If you perform a Graceful Shutdown action on a Cisco AS5350 or AS5400 device, you cannot enter the Accept Traffic command because the busyout command is followed by removal of power to the card; the card is logically removed from the chassis; an OIR trap is issued. Since the card is removed from Physical View, the Accept Traffic action has no object to act on.
  
  As a workaround, manually remove or insert the card into the chassis to start discovery, or enter the no busyout <slot> Cisco IOS command to the device.
  
  

Step 1   In the Map Viewer, select an object in the Physical tree.

Step 2   Right-click the object and select Configure Administrative State.

Step 3   Click one of these actions:

• Graceful Shutdown
  
  
• Accept Traffic
  
  

Posted: Wed Dec 4 14:26:49 PST 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.