Cisco ASR 1000 Series Aggregation
Services Routers Software Configuration
Guide
May 22, 2015
Cisco Systems, Inc.
www.cisco.com
Cisco has more than 200 offices worldwide.
Addresses, phone numbers, and fax numbers
are listed on the Cisco website at
www.cisco.com/go/offices.
Text Part Number: OL-16506-15
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
This preface describes the objectives and organization of this document and explains how to find
additional information on related products and services. This preface contains the following sections:
• Objectives, page 1
• Document Revision History, page 2
• Organization, page 4
Objectives
• Related Documentation, page 6
• Conventions, page 6
• Obtaining Documentation and Submitting a Service Request, page 7
This document provides an overview of software functionality that is specific to the Cisco ASR 1000
Series Aggregation Services Routers. It is not intended as a comprehensive guide to all of the software
features that can be run using the Cisco ASR 1000 Series Routers, but only the software aspects that are
specific to these routers.
For information on general software features that are also available on the Cisco ASR 1000 Series
Routers, see the Cisco IOS XE technology guide for that specific software feature.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
1
Document Revision History
The Document Revision History records technical changes to this document. The table shows the Cisco
IOS XE software release number and document revision number for the change, the date of the change,
and a brief summary of the change.
Release No.DateChange Summary
IOS XE 3.13.1 December 12, 2014
IOS XE 3.13July 30, 2014
IOS XE 3.12March 28, 2014
IOS XE 3.12March 28, 2014
IOS XE 3.12March 28, 2014
IOS XE 3.11.0 November 21, 2013
IOS XE 3.10.0 July 30, 2013
IOS XE 3.9.0March 28, 2013
IOS XE 3.8.0November 28, 2012
IOS XE 3.7.0July 25, 2012
• Added “PPP Half-Bridge on the Cisco ASR 1000 Series
Routers” chapter.
• Added new content to document IEEE 1588v2 PTP
Support in the “IEEE 1588v2 PTP Support” chapter.
• Added HDLC-Ethernet Interworking feature updates in
the “High-Level Data Link Control-Ethernet
Interworking, page 39” section of the “Configuring
MPLS Layer 2 VPNs”
• Added Multi Member-link MLPPPoA or MLPPPoEoA
feature updates in the “Cisco IOS XE Scaling Limits for
MLP Bundles” section of the “Multilink PPP Support
for the Cisco ASR 1000 Series Routers” chapter.
updates in the “Software Upgrade Processes Supported
by Cisco ASR 1000 Series Routers” chapter.
• Added MVPNv6 support for the “MVPN MLDP over
GRE” feature in the “LSM-MLDP-based MVPN
Support” chapter.
• Added MVPNv4 support for the “MVPN MLDP over
GRE” feature in the “LSM-MLDP-based MVPN
Support” chapter.
• Added “Packet Trace”chapter.
• Added new content to document UniDirectional Link
Detection (UDLD) Protocol in the “UniDirectional
Link Detection (UDLD) Protocol” chapter.
• Added Minimal Disruptive Restart Process section in
the “Software Upgrade Processes Supported by Cisco
ASR 1000 Series Routers” chapter.
• Added new content to document the Configuring Cisco
Right-To-Use License in the “Configuring a Cisco
Right-To-Use License” chapter.
• Added new content to the Synchronous Ethernet in the
“Network Synchronization Support” chapter.
• Added new content to document the Walk-by User
Support for PWLAN in ISG in the “Broadband
Scalability and Performance” chapter.
• Added new content to the bridge domain interface
configurations in the “Configuring Bridge Domain
Interfaces” chapter.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2
OL-16506-17
IOS XE 3.6.0March 30, 2012• Added new content to document the Cisco License Call
Home in the “Configuring Cisco License Call Home”
chapter.
• Added new content to document the Frame Relay to
ATM Bridged Interworking in the “Configuring MPLS
Layer 2 VPNs” chapter.
• Added new content to document the xconnect support
on GEC (VPWS) on ASR1000 in the “Configuring
MPLS Layer 2 VPNs” chapter.
IOS XE 3.4.0S July 25, 2011
IOS XE 3.3.0S March 30, 2011
IOS XE 3.2.0S November 24, 2010
IOS XE 3.1.0S July 30, 2010
IOS XE 2.6February 26, 2010
• Added new content to document the Monitoring and
Maintaining Multilink Frame Relay feature in the
“Monitoring and Maintaining Multilink Frame Relay”
chapter.
• Added new content to document In Service One-Shot
Software Upgrade Procedure in the “Software Upgrade
Processes Supported by Cisco ASR 1000 Series
Routers” chapter.
• Added new content to document the Scalability and
Performance in the “Broadband Scalability and
Performance” chapter.
• Added software upgrade information for ASR 1001
chassis in the “Using Subpackages for Software
Upgrade on a Cisco ASR 1001 Router or a Cisco ASR
1002-X Router” section in “Software Upgrade
Processes Supported by Cisco ASR 1000 Series
Routers” chapter.
• Added new content to document bridge domain
interface configurations in the “Configuring Bridge
Domain Interfaces” chapter.
• Added new content to document the Synchronous
Ethernet in the “Network Synchronization Support”
chapter.
• Added upgrade and file package information in the
“Software Packaging and Architecture” chapter.
• Added restriction regarding ISSU support in Cisco IOS
XE Release 3.1S in “Software Upgrade Processes
Supported by Cisco ASR 1000 Series Routers” chapter.
• Added support for the Call Home feature in the
“Configuring Call Home” chapter.
• Moved the ISSU compatibility tables into the Release
Notes for Cisco ASR 1000 Series Aggregation Services
Routers document.
OL-16506-17
• Relocated other ISSU compatibility information into
the “Software Upgrade Processes Supported by Cisco
ASR 1000 Series Routers” chapter.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3
IOS XE 2.5December 15, 2009Updated the “Software Upgrade Processes Supported by
Cisco ASR 1000 Series Routers” chapter with new
compatibility information.
IOS XE 2.4June 30, 2009
IOS XE 2.3February 27, 2009Updated the “Software Upgrade Processes Supported by
IOS XE 2.2November 20, 2008Updated the “Software Upgrade Processes Supported by
IOS XE 2.2November 3, 2008Added new content to document compatibility of different
IOS XE 2.2October 3, 2008Updated book to document ISSU procedures for Cisco IOS
IOS XE 2.2September 23, 2008Added the “Troubleshooting Software Mismatch with ESP
IOS XE 2.1July 2, 2008Added the “Configuring and Accessing the Web User
• Updated the “Software Upgrade Processes Supported
by Cisco ASR 1000 Series Routers” chapter with new
compatibility information.
• Updated book with installation information for the new
optional subpackage for the Cisco WebEx Node for
ASR 1000 Series.
Cisco ASR 1000 Series Routers” chapter with new
compatibility information.
Cisco ASR 1000 Series Routers” chapter with new
compatibility information.
versions of Cisco IOS XE software in the “Software
Upgrade Processes Supported by Cisco ASR 1000 Series
Routers” chapter.
XE Release 2.2. Removed ISSU procedures from the
“Consolidated Packages and SubPackage Management”
chapter of the book and created the “Software Upgrade
Processes Supported by Cisco ASR 1000 Series Routers”
chapter.
Board ASR1000-ESP10-N” section for the Cisco ASR 1000
Embedded Services Processor 10G Non Crypto Capable
feature.
Interface” section.
IOS XE 2.1May 2, 2008First release of the book.
Organization
This document contains the following chapters:
TitleDescription
Software Packaging and ArchitectureProvides an introduction to Cisco ASR 1000 Series
Using Cisco IOS XE SoftwareProvides an introduction to accessing the
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4
Added Appendix “Configuration Examples”.
Routers software packaging, processes, and file
systems.
command-line interface (CLI) and using the Cisco
software and related tools.
OL-16506-17
TitleDescription
Console Port, Telnet, and SSH HandlingProvides an overview and configuration options for the
handling of incoming console port, telnet, and SSH
traffic on the Cisco ASR 1000 Series Routers.
Consolidated Packages and SubPackage
Management
Software Upgrade ProcessProvides information on ISSU compatibility and
High Availability OverviewProvides an overview of the High Availability
Scalability and PerformanceProvides information on scaling and performance on
Cisco License Call HomeProvides information on activating the Cisco License
Configuring Call Home for Cisco ASR 1000
Series Aggregation Services Routers
Configuring Cisco Right-To-Use LicenseProvides information on activating the Cisco
UniDirectional Link Detection (UDLD)
Protocol
Using the Management Ethernet InterfaceProvides an overview and configuration options for the
Synchronous Ethernet Support On The Cisco
ASR 1000 Series Routers
Configuring Ethernet Over Soft GREProvides an overview and configuration for the Generic
Configuring Bridge Domain InterfacesProvides an overview of configuration options for the
Monitoring and Maintaining Multilink Frame
Relay
Configuring MPLS Layer 2 VPNsProvides an overview of the Frame Relay to ATM
Provides information on downloading, installing, and
running the software on the Cisco ASR 1000 Series
Routers.
performing limited-downtime software upgrades on the
Cisco ASR 1000 Series Routers.
architecture, behavior, and features on the Cisco ASR
1000 Series Routers.
the Cisco ASR 1000 Series Routers.
for Call Home feature.
Provides information about the Call Home feature,
which supports e-mail-based and web-based
notification of critical system events. A versatile range
of message formats are available for optimal
compatibility with pager services, standard e-mail, or
XML-based automated parsing applications.
Right-To-Use License.
Provides an overview and configuration options for the
UDLD protocol on the Cisco ASR 1000 Series Routers.
Management Ethernet interface on the Cisco ASR 1000
Series Routers.
Provides an overview and configuration options for the
Synchronous Ethernet on the Cisco ASR 1000 Series
Routers.
Routing Encapsulation (GRE) is a tunneling protocol
that can encapsulate a wide variety of network layer
protocols inside virtual point-to-point links over an IP
internetwork.
Bridge Domain Interface on the Cisco ASR 1000 Series
Routers.
Provides an overview of monitoring and maintaining
the Multilink Frame Relay feature for the Cisco ASR
1000 Series Routers.
Bridged Interworking feature.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5
TitleDescription
LSM-MLDP-based MVPN SupportProvides information on the Label Switched Multicast
Tracing and Trace ManagementProvides an overview of tracing on the Cisco ASR 1000
PPP Half-Bridge on the Cisco ASR 1000
Series Routers
Configuring and Accessing the Web User
Interface
Related Documentation
(LSM) feature supports IPv4 and IPv6 multicast traffic
over a Multi-Protocol Label Switching (MPLS)
network.
Series Router, and how to manage the tracing process
and files.
Provides information about PPP half-bridge on the
Cisco ASR 1000 Series Routers.
Provides an overview of the Cisco ASR 1000 Series
Router web user interface, and information on
configuring and accessing the web user interface.
This section refers you to other documentation that also might be useful as you configure your Cisco
ASR 1000 Series Router. The documentation listed below is available online.
Cisco ASR 1000 Series Routers Documentation
The Cisco ASR 1000 Series has a documentation roadmap that provides listings to a broad range of
documentation available for the Cisco ASR 1000 Series Routers. See the Cisco ASR 1000 Series Router Documentation Roadmap at:
The documentation homepage for the Cisco ASR 1000 Series Routers contains a wide variety of
hardware and software information for the Cisco ASR 1000 Series Routers and can be viewed at:
For information on commands, see one of the following resources:
• Cisco IOS XE Software Command References
• Command Lookup Tool (cisco.com login required)
Conventions
This document uses the following conventions:
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
6
ConventionIndication
bold fontCommands and keywords and user-entered text appear in bold font.
OL-16506-17
italic fontDocument titles, new or emphasized terms, and arguments for which you supply
values are in italic font.
[ ]Elements in square brackets are optional.
{x | y | z }Required alternative keywords are grouped in braces and separated by
vertical bars.
[ x | y | z ]Optional alternative keywords are grouped in brackets and separated by
vertical bars.
stringA nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
courier fontTerminal sessions and information the system displays appear in courier font.
< >Nonprinting characters such as passwords are in angle brackets.
[ ]Default responses to system prompts are in square brackets.
!, #An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
NoteMeans reader take note.
TipMeans the following information will help you solve a problem.
CautionMeans reader be careful. In this situation, you might perform an action that could result in equipment
damage or loss of data.
TimesaverMeans the described action saves time. You can save time by performing the action described in
the paragraph.
Warning
Means reader be warned. In this situation, you might perform an action that could result in
bodily injury.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS version 2.0.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
7
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
8
OL-16506-17
CHA P T ER
1
Software Packaging and Architecture
The Cisco ASR 1000 Series Aggregation Services Routers introduce a new software packaging model
and architecture.
This chapter discusses this new packaging and architecture and contains the following sections:
• Software Packaging on the Cisco ASR 1000 Series Routers, page 1-1
• Processes Overview, page 1-6
• File Systems on the Cisco ASR 1000 Series Router, page 1-8
• Autogenerated File Directories and Files, page 1-9
Software Packaging on the Cisco ASR 1000 Series Routers
This section covers the following topics:
• ASR 1000 Series Routers Software Overview, page 1-1
• Consolidated Packages, page 1-2
• Individual Software SubPackages Within a Consolidated Package, page 1-3
• Optional Software SubPackages Outside of Consolidated Packages, page 1-4
• Provisioning Files, page 1-4
• ROMmon Image, page 1-5
• File to Upgrade Field Programmable Hardware Devices, page 1-5
ASR 1000 Series Routers Software Overview
The Cisco ASR 1000 Series Routers run using Cisco IOS XE software. Cisco IOS XE is released using
consolidated packages and optional subpackages.
Each consolidated package contains a collection of software subpackages. Each software subpackage is
an individual software file that controls a different element or elements of the Cisco ASR 1000 Series
Router. Each individual software subpackage can be upgraded individually, or all software subpackages
for a specific consolidated package can be upgraded as part of a complete consolidated package upgrade.
Importantly, IOS (the RPIOS subpackage) is considered one of the seven individual subpackages that
makes up a complete consolidated package. For additional information on individual software
subpackages, see the “Consolidated Packages” section on page 1-2.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
1-1
Software Packaging on the Cisco ASR 1000 Series Routers
A collection of software subpackages packaged together creates a single consolidated package. A
consolidated package allows users to upgrade all individual subpackages on the router with a single
software image download. Consolidated packages can be downloaded from Cisco.com; users who want
to run the router using individual subpackages that are part of the consolidated package must first
download the image from Cisco.com and extract the individual subpackages from the image, which can
be done by entering request platform command-line interface commands.
Beginning in Cisco IOS XE Release 2.4, support for a supplemental, optional subpackage of type called
sipspawma is introduced to support the Cisco WebEx Node for ASR 1000 Series shared port adapter
(SPA). Optional subpackages are installed similarly to individual subpackages; however, optional
subpackages are not bundled as part of a consolidated package like prior support for the individual
subpackages, and optional subpackages must be downloaded independently.
See the “Consolidated Packages” section on page 2 and “Individual Software SubPackages Within a
Consolidated Package” section on page 1-3 of this book for additional information on extracting
individual subpackages from a consolidated package, supplemental optional subpackages, and other
information on managing software.
Consolidated Packages
Chapter 1 Software Packaging and Architecture
A consolidated package is a single image composed of individual software subpackage files. A single
consolidated package file is a bootable file, and the Cisco ASR 1000 Series Router can be run using the
consolidated package.
NoteConsolidated packages only contain the required individual subpackage files. These packages do not
contain supplemental, optional subpackages, such as the “sipspawma” package for the Cisco WebEx
Node for ASR 1000 Series.
Each consolidated package also contains a provisioning file. A provisioning file is used for booting in
cases where the individual subpackages are extracted from the consolidated package, or optional
subpackages are used to run the router. For additional information on the advantages and disadvantages
of running a complete consolidated package, see the “Running the Cisco ASR 1000 Series Routers: An
Overview” section on page 4-1. For additional information on provisioning files, see the “Provisioning
Files” section on page 1-4.
For information about the consolidated packages available in a specific version of Cisco IOS XE, see the
release notes for that version of Cisco IOS XE. The Cisco IOS XE Software Release Notes contains the
release notes for each version of Cisco IOS XE.
Important Information About Consolidated Packages
The important information about consolidated packages include:
• For each version of a consolidated package, the RPBase, RPControl, ESPBase, SIPSPA, and
SIPBase subpackages are identical among consolidated packages.
• For each version of consolidated package, the RPIOS subpackage is always different among
consolidated packages.
• A consolidated package file is a bootable file. If the router is configured to run using a the complete
consolidated package, boot the router using the consolidated package file. If the router is configured
to run using individual subpackages, boot the router using the provisioning file. For additional
information on the advantages and disadvantages of running a complete consolidated package, see
the “Running the Cisco ASR 1000 Series Routers: An Overview” section on page 4-1. For additional
1-2
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
Chapter 1 Software Packaging and Architecture
Software Packaging on the Cisco ASR 1000 Series Routers
information on provisioning files, see the “Provisioning Files” section on page 1-4.
• If you need to install optional subpackages, then you must boot the router using the individual
subpackage provisioning file method.
Individual Software SubPackages Within a Consolidated Package
provides an overview of the Cisco ASR 1000 Series Routers subpackages and the purpose of each
individual subpackage. Every consolidated package will have all of these individual subpackages. To see
additional information about each individual subpackages in a particular Cisco IOS XE release, see
Cisco IOS XE Release Notes for that release.
Table 1-1Individual SubPackages
SubPackagePurpose
RPBaseProvides the operating system software for the Route Processor.
RPControlControls the control plane processes that interface between the IOS
process and the rest of the platform.
RPAccessExports processing of restricted components, such as Secure Socket
Layer (SSL), Secure Shell (SSH), and other security features.
RPIOSProvides the Cisco IOS kernel, which is where IOS features are stored
and run.
Each consolidated package has a different RPIOS.
ESPBaseProvides the ESP operating system and control processes, and the
ESP software.
SIPBaseControls the SIP operating system and control processes.
SIPSPAProvides the SPA driver and Field Programmable Device (FPD)
images.
Important Notes About Individual SubPackages
The important information about individual subpackage include:
• Individual subpackages cannot be downloaded from Cisco.com individually. To get these individual
subpackages, users must download a consolidated package and then extract the individual
subpackages from the consolidated package using the command-line interface.
• If the router is being run using individual subpackages instead of being run using a complete
consolidated package, the router must be booted using a provisioning file. A provisioning file is
included in all consolidated packages and is extracted from the image along with the individual
subpackages whenever individual subpackages are extracted. For additional information on
provisioning files, see the “Provisioning Files” section on page 1-4.
Optional Software SubPackages Outside of Consolidated Packages
Beginning in Cisco IOS XE Release 2.4, the ASR 1000 Series Routers support a new type of
subpackage—this is an optional software subpackage that is available as a separate, external package
that is downloaded and installed along with the other required subpackages.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
1-3
Software Packaging on the Cisco ASR 1000 Series Routers
sipspawmak9 is an optional subpackage that provides the system software for the Cisco WebEx Node
for ASR 1000 Series Routers.
Important Notes About Optional SubPackages
The important information about optional subpackages include:
• Optional subpackages are downloaded separately from consolidated package files. Optional
subpackages are not contained within a consolidated package for a release.
• Optional package installation works similarly to the installation of individual subpackages using a
provisioning file.
• Optional subpackages can be uninstalled to remove provisioning when the package no longer
applies to an RP.
• Optional subpackages are easily supported by the standard ISSU upgrade process as long as the
package is located in the directory of the provisioning file for each RP.
Provisioning Files
Chapter 1 Software Packaging and Architecture
NoteYou must use the provisioning files to manage the boot process if you need to install optional
subpackages.
Provisioning files manage the boot process when the Cisco ASR 1000 Series Router is configured to run
using individual subpackages or optional subpackages (such as the package for the Cisco WebEx Node
for ASR 1000 Series). When individual subpackages are being used to run the Cisco ASR 1000 Series
Router, the router has to be configured to boot the provisioning file. The provisioning file manages the
bootup of each individual subpackage and the Cisco ASR 1000 Series Router assumes normal operation.
Provisioning files are extracted automatically when individual subpackage files are extracted from a
consolidated package.
Provisioning files are not necessary for running the router using the complete consolidated package; if
you want to run the router using the complete consolidated package, simply boot the router using the
consolidated package file.
See the “Running the Cisco ASR 1000 Series Routers: An Overview” section on page 4-1 for additional
information on the advantages and disadvantages of running individual subpackages versus running a
complete consolidated package.
1-4
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
Chapter 1 Software Packaging and Architecture
Important Notes About Provisioning Files
The important information about provisioning files include:
• Each consolidated package contains two provisioning files. One of the provisioning files is always
named “packages.conf”, while the other provisioning file will have a name based on the
consolidated package naming structure. In any consolidated package, both provisioning files
perform the exact same function.
• In most cases, the “packages.conf” provisioning file should be used to boot the router. Configuring
the router to boot using this file is generally easier because the router can be configured to boot using
“packages.conf”, so no changes have to be made to the boot statement when Cisco IOS XE is
upgraded (the boot systemfile-system:packages.conf configuration command can remain
unmodified before and after an upgrade).
• The provisioning file and individual subpackage files must be kept in the same directory. The
provisioning file does not work properly if the individual subpackage files are in other directories.
• The provisioning filename can be renamed; the individual subpackage filenames cannot be renamed.
• After placing the provisioning file and the individual subpackage files in a directory and booting the
router, it is highly advisable not to rename, delete, or alter any of these files. Renaming, deleting, or
altering the files can lead to unpredictable router problems and behaviors.
Software Packaging on the Cisco ASR 1000 Series Routers
ROMmon Image
An independent ROMmon image is released periodically separate from consolidated packages or any
other software releases.
See the documentation that accompanies the ROMmon image for information on each ROMmon image.
For additional information on ROMmon, see the Cisco ASR 1000 Series Routers Maintain and Operate Guide.
File to Upgrade Field Programmable Hardware Devices
Starting in Cisco IOS XE Release 3.1.0S, a hardware programmable package file used to upgrade field
programmable hardware devices is released as needed. A package file is provided for the field
programmable device to customers in cases where a field upgrade is required. If the Cisco ASR 1000
Series Router contains an incompatible version of the hardware programmable firmware on the Cisco
ASR1000-RP, Cisco ASR1000-SIP, or Cisco ASR1000-ESP, then that firmware may need to be
upgraded.
Generally an upgrade is only necessary in cases where a system message indicates one of the field
programmable devices on the Cisco ASR 1000 Series Router needs an upgrade or a Cisco technical
support representative suggests an upgrade.
In Cisco IOS XE Release 3.1.0S, a package file that contains a new version of the Complex
Programmable Logic Device (CPLD) code is available for users who need to upgrade old versions of
firmware on a Cisco ASR1000-RP2 or Cisco ASR1000-SIP10 in a Cisco ASR 1013 Router.
OL-16506-15
For more information on upgrading field programmable hardware devices, see the Upgrading Field
Programmable Hardware Devices for Cisco ASR 1000 Series Routers document.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
1-5
Processes Overview
Processes Overview
Cisco IOS XE has numerous components that run entirely as separate processes on the Cisco ASR 1000
Series Routers. This modular architecture increases network resiliency by distributing operating
responsibility among separate processes rather than relying on Cisco IOS software for all operations.
This section covers the following topics:
• IOS as a Process, page 1-7
• Dual IOS Processes, page 1-8
Table 1-2 provides a list of the important individual processes for the Cisco ASR 1000 Series Routers.
These processes run in the background, and the CLI on Cisco ASR 1000 Series Routers using Cisco
IOS-XE is identical in look, feel, and usage to the Cisco IOS CLI on most platforms. This information
is provided because it may be useful for checking router state and troubleshooting, but understanding
this information is not essential to understanding most router operations.
Table 1-2Individual Processes
ProcessPurposeAffected FRUs
Chassis ManagerResponsible for all chassis
Host ManagerProvides an interface between
LoggerProvides IOS facing logging
Interface ManagerProvides an interface between
IOSThe IOS process implements
management functions,
including management of the
HA state, environmental
monitoring, and FRU state
control.
the IOS process and many of
the information-gathering
functions of the underlying
platform kernel and operating
system.
services to processes running
on each FRU.
the IOS process and the
per-SPA interface processes on
the SIP.
all forwarding and routing
features for the router.
Chapter 1 Software Packaging and Architecture
SubPackage
Mapping
RP (one instance per
RP)
SIP (one instance per
SIP)
ESP (one instance per
ESP)
RP (one instance per
RP)
SIP (one instance per
SIP)
ESP (one instance per
ESP)
RP (one instance per
RP)
SIP (one instance per
SIP)
ESP (one instance per
ESP)
RP (one instance per
RP)
SIP (one instance per
SIP)
RP (one per software
redundancy instance per
RP). Maximum of two
instances per RP.
RPControl
SIPBase
ESPBase
RPControl
SIPBase
ESPBase
RPControl
SIPBase
ESPBase
RPControl
SIPBase
RPIOS
1-6
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
Chapter 1 Software Packaging and Architecture
Table 1-2Individual Processes (continued)
ProcessPurposeAffected FRUs
Forwarding ManagerManages the downloading of
Pluggable ServicesThe integration point between
Shell ManagerProvides all user interface
SPA driver processProvides an isolated process
CPP driver processManages the CPP hardware
CPP HA processManages HA state for the CPP
CPP SP processPerforms high-latency tasks
configuration to each of the
ESPs and the communication
of forwarding plane
information, such as statistics,
to the IOS process.
platform policy application,
such as authentication and the
IOS process.
features and handling related
to features in the nonIOS
image of the consolidated
package, which are also the
features available in diagnostic
mode when the IOS process
fails.
driver for a specific SPA.
forwarding engine on the ESP.
hardware forwarding engine.
for the CPP-facing
functionality in the ESP
instance of the Forwarding
Manager process.
RP (one per software
redundancy instance per
RP). Maximum of two
instances per RP.
ESP (one per ESP)
RP (one per software
redundancy instance per
RP). Maximum of two
instances per RP.
RP (one instance per
RP)
SPA (one instance per
SPA per SIP)
ESP (one instance per
ESP)
ESP (one instance per
ESP)
ESP (one instance per
ESP)
Processes Overview
SubPackage
Mapping
RPControl
ESPBase
RPControl
RPControl
SIPSPA
ESPBase
ESPBase
ESPBase
IOS as a Process
OL-16506-15
In almost all previous Cisco router platforms, an overwhelming majority of the internal software
processes are run using Cisco IOS memory.
The Cisco ASR 1000 Series Routers introduce a distributed software architecture that moves many
operating system responsibilities out of the IOS process. In this architecture, IOS, which previously was
responsible for almost all of the internal software processes, now runs as one of many Linux processes
while allowing other Linux processes to share responsibility for running the router.
This architecture allows for better allocation of memory so the router can run more efficiently.
Furthermore, the Cisco ASR 1000 Series Routers has a command-line interface in diagnostic mode that
can be accessed in certain scenarios even if the IOS process fails. See the “Understanding the Diagnostic
Mode” section on page 2-7 for information on diagnostic mode.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
1-7
Processes Overview
Dual IOS Processes
The Cisco ASR 1000 Series Router introduces a dual IOS process model that allows for increased high
availability at all times.
Using SSO or RPR, a second IOS process can be enabled on a Cisco ASR 1002 or 1004 Router. On Cisco
ASR 1000 Series Routers configured with dual Route Processors, the second IOS process runs on the
standby Route Processor.
The state of these dual IOS processes can be checked by entering the show platform command.
The advantages of a second IOS process includes:
Chapter 1 Software Packaging and Architecture
• Increased fault tolerance—In the event of an active IOS failure, the second IOS process immediately
becomes the active IOS process with little to no service disruption.
• No downtime software upgrades—IOS and other software on the router can be upgraded using the
In Service Software Upgrade (ISSU) feature in the standby IOS process, thereby allowing the
network to remain active during the software upgrade. See the “Router#” section on page 4-20 for
additional information on when ISSU can and cannot be used to perform no downtime software
upgrades.
File Systems on the Cisco ASR 1000 Series Router
Table 1-3 provides a list of file systems that can be seen on the Cisco ASR 1000 Series Routers.
Table 1-3File Systems
File SystemDescription
bootflash:The boot flash memory file system on the active RP.
cns:The Cisco Networking Services file directory.
harddisk:The hard disk file system on the active RP.
The harddisk: file system is not available on the Cisco ASR 1002 Routers.
nvram:Router NVRAM. You can copy the startup configuration to NVRAM or from
NVRAM.
obfl:The file system for Onboard Failure Logging files.
stby-bootflash:The boot flash memory file system on the standby RP.
stby-harddisk:The hard disk file system on the standby RP.
The harddisk: file system is not available on the Cisco ASR 1002 Routers.
stby-usb[0-1]:The Universal Serial Bus (USB) flash drive file systems on the standby RP.
The stby-usb: file system is not available on the Cisco ASR 1002 Routers.
system:The system memory file system, which includes the running configuration.
tar:The archive file system.
tmpsys:The temporary system files file system.
usb[0-1]:The Universal Serial Bus (USB) flash drive file systems on the active RP.
Only usb0: is available on the Cisco ASR 1002 Router.
1-8
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
Chapter 1 Software Packaging and Architecture
If you run into a file system not listed in Tabl e 1-3 , enter the? help option or see the copy command
reference for additional information on that file system.
Autogenerated File Directories and Files
This section discusses the autogenerated files and directories that might appear on your Cisco ASR 1000
Series Routers, and how the files in these directories can be managed.
Table 1-4 provides a list and descriptions of autogenerated files on the Cisco ASR 1000 Series Routers.
Table 1-4Autogenerated Files
File or DirectoryDescription
crashinfo filesA crashinfo file may appear in the bootflash: or harddisk: file system.
These files provide descriptive information of a crash and may be useful for
tuning or troubleshooting purposes, but the files are not part of router
operations and can be erased without impacting the functioning of the router.
core directoryThe storage area for.core files.
If this directory is erased, it will automatically regenerate itself at bootup. The
.core files in this directory can be erased without impacting any router
functionality, but the directory itself should not be erased.
lost+found directory This directory is created on bootup if a system check is performed. Its
appearance is completely normal and does not indicate any issues with the
router.
tracelogs directoryThe storage area for trace files.
Processes Overview
Trace files are useful for troubleshooting; if the IOS process fails, for instance,
users or troubleshooting personnel can access trace files using diagnostic mode
to gather information related to the IOS failure.
Trace files, however, are not part of router operations and can be erased without
impacting the router’s performance.
Important Notes About Autogenerated Directories
The important information about autogenerated directories include:
• Any autogenerated file on the bootflash: directory should not be deleted, renamed, moved, or altered
in any way unless directed by customer support. Altering autogenerating files on the bootflash: can
have unpredictable consequences for system performance.
• Crashinfo, core, and trace files can be deleted, but the core and tracelog directories that are
automatically part of the harddisk: file system should not be deleted.
OL-16506-15
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
1-9
Processes Overview
Chapter 1 Software Packaging and Architecture
1-10
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-15
Using Cisco IOS XE Software
This chapter provides information to prepare you to configure the Cisco ASR 100Series Routers:
• Accessing the CLI Using a Router Console, page 2-1
• Using the Auxiliary Port, page 2-4
• Using Keyboard Shortcuts, page 2-5
• Using the History Buffer to Recall Commands, page 2-5
• Understanding the Command Mode, page 2-6
• Understanding the Diagnostic Mode, page 2-7
• Getting Help, page 2-8
• Using the no and default Forms of Commands, page 2-11
• Saving Configuration Changes, page 2-11
• Managing Configuration Files, page 2-11
• Filtering the Output of the show and more Commands, page 2-13
• Powering Off a Router, page 2-14
• Finding Support Information for Platforms and Cisco Software Images, page 2-14
CHA P T ER
2
Accessing the CLI Using a Router Console
The following sections describe how to access the command-line interface (CLI) using a
directly-connected console or by using Telnet or a modem to obtain a remote console:
• Accessing the CLI Using a Directly-Connected Console, page 2-2
• Accessing the CLI from a Remote Console Using Telnet, page 2-3
• Accessing the CLI from a Remote Console Using a Modem, page 2-4
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
2-1
Accessing the CLI Using a Router Console
Accessing the CLI Using a Directly-Connected Console
This section describes how to connect to the console port on the router and use the console interface to
access the CLI.
The console port on a Cisco ASR 1000 Series Router is an EIA/TIA-232 asynchronous, serial connection
with no flow control and an RJ-45 connector. The console port is located on the front panel of each Route
Processor (RP).
Connecting to the Console Port
To connect to the console port, complete the following steps:
Step 1Configure your terminal emulation software with the following settings:
• 9600 bits per second (bps)
• 8 data bits
• No parity
• 1 stop bit
Chapter 2
• No flow control
Step 2Connect to the port using the RJ-45-to-RJ-45 cable and RJ-45-to-DB-25 DTE adapter or using the
RJ-45-to-DB-9 DTE adapter (labeled “Terminal”).
Using the Console Interface
Every RP on a Cisco ASR 1000 Series Router has a console interface. Notably, a standby RP can be
accessed using the console port in addition to the active RP in a dual RP configuration.
To access the CLI using the console interface, complete the following steps:
Step 1After you attach the terminal hardware to the console port on the router and you configure your terminal
emulation software with the proper settings, the following prompt appears:
Press RETURN to get started.
Step 2Press Return to enter user EXEC mode. The following prompt appears:
Router>
Step 3From user EXEC mode, enter the enable command as shown in the following example:
Router> enable
Step 4At the password prompt, enter your system password. If an enable password has not been set on your
system, this step may be skipped.
The following example shows entry of the password enablepass:
Password: enablepass
2-2
Step 5When your enable password is accepted, the privileged EXEC mode prompt appears:
Router#
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 2
Step 6You now have access to the CLI in privileged EXEC mode and you can enter the necessary commands
to complete your desired tasks.
Step 7To exit the console session, enter the quit command as shown in the following example:
Router# quit
Accessing the CLI from a Remote Console Using Telnet
This section describes how to connect to the console interface on a router using Telnet to access the CLI.
Preparing to Connect to the Router Console Using Telnet
Before you can access the router remotely using Telnet from a TCP/IP network, you need to configure
the router to support virtual terminal lines (vtys) using the line vty global configuration command. You
also should configure the vtys to require login and specify a password.
Accessing the CLI Using a Router Console
NoteTo prevent disabling login on the line, be careful that you specify a password with the password
command when you configure the login line configuration command. If you are using authentication,
authorization, and accounting (AAA), you should configure the login authentication line configuration
command. To prevent disabling login on the line for AAA authentication when you configure a list with
the login authentication command, you must also configure that list using the aaa authentication login
global configuration command. For more information about AAA services, see the Cisco IOS XE Security Configuration Guide, and the Cisco IOS Security Command Reference Guide.
In addition, before you can make a Telnet connection to the router, you must have a valid host name for
the router or have an IP address configured on the router. For more information about requirements for
connecting to the router using Telnet, information about customizing your Telnet services, and using
Telnet key sequences, see the Cisco IOS Configuration Fundamentals Configuration Guide.
Using Telnet to Access a Console Interface
To access a console interface using Telnet, complete the following steps:
Step 1From your terminal or PC, enter one of the following commands:
• connect host [port] [keyword]
• telnet host [port] [keyword]
In this syntax, host is the router hostname or an IP address, port is a decimal port number (23 is the
default), and keyword is a supported keyword. For more information, see the Cisco IOS Configuration Fundamentals Command Reference Guide.
OL-16506-17
NoteIf you are using an access server, then you will need to specify a valid port number such as telnet
172.20.52.40 2004, in addition to the hostname or IP address.
The following example shows the telnet command to connect to the router named router:
unix_host% telnet router
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-3
Using the Auxiliary Port
Step 2At the password prompt, enter your login password. The following example shows entry of the password
NoteIf no password has been configured, press Return.
Step 3From user EXEC mode, enter the enable command as shown in the following example:
Step 4At the password prompt, enter your system password. The following example shows entry of the
Chapter 2
Trying 172.20.52.40...
Connected to 172.20.52.40.
Escape character is '^]'.
unix_host% connect
mypass:
User Access Verification
Password: mypass
Router> enable
password enablepass:
Password: enablepass
Step 5When the enable password is accepted, the privileged EXEC mode prompt appears:
Router#
Step 6You now have access to the CLI in privileged EXEC mode and you can enter the necessary commands
to complete your desired tasks.
Step 7To exit the Telnet session, use the exit or logout command as shown in the following example:
Router# logout
Accessing the CLI from a Remote Console Using a Modem
To access the router remotely using a modem through an asynchronous connection, connect the modem
to the console port.
The console port on a Cisco ASR 1000 Series Aggregation Services Router is an EIA/TIA-232
asynchronous, serial connection with no flow control and an RJ-45 connector. The console port is
located on the front panel of the RP.
To connect a modem to the console port, place the console port mode switch in the in position. Connect
to the port using the RJ-45-to-RJ-45 cable and the RJ-45-to-DB-25 DCE adapter (labeled “Modem”).
Using the Auxiliary Port
The auxiliary port on the Route Processor does not serve any useful purpose for customers.
This port should only be accessed under the advisement of a customer support representative.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-4
OL-16506-17
Chapter 2
Using Keyboard Shortcuts
Commands are not case sensitive. You can abbreviate commands and parameters if the abbreviations
contain enough letters to be different from any other currently available commands or parameters.
Table 2-1 lists the keyboard shortcuts for entering and editing commands.
Table 2-1Keyboard Shortcuts
KeystrokesPurpose
Ctrl-B or
the Left Arrow key
Ctrl-F or
the Right Arrow key1
Ctrl-AMove the cursor to the beginning of the command line
Ctrl-EMove the cursor to the end of the command line
Esc BMove the cursor back one word
Esc FMove the cursor forward one word
1. The arrow keys function only on ANSI-compatible terminals such as VT100s.
1
Using Keyboard Shortcuts
Move the cursor back one character
Move the cursor forward one character
Using the History Buffer to Recall Commands
The history buffer stores the last 20 commands you entered. History substitution allows you to access
these commands without retyping them, by using special abbreviated commands.
Table 2-2 lists the history substitution commands.
Table 2-2History Substitution Commands
CommandPurpose
Ctrl-P or the Up Arrow key
Ctrl-N or the Down Arrow key1Return to more recent commands in the history buffer after
Router# show historyWhile in EXEC mode, list the last several commands you have just
1. The arrow keys function only on ANSI-compatible terminals such as VT100s.
1
Recall commands in the history buffer, beginning with the most
recent command. Repeat the key sequence to recall successively
older commands.
recalling commands with Ctrl-P or the Up Arrow key.
entered.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-5
Understanding the Command Mode
Understanding the Command Mode
The command modes available in the traditional Cisco IOS CLI are exactly the same as the command
modes available in Cisco IOS XE.
You use the CLI to access Cisco IOS XE software. Because the CLI is divided into many different modes,
the commands available to you at any given time depend on the mode that you are currently in. Entering
a question mark (?) at the CLI prompt allows you to obtain a list of commands available for each
command mode.
When you log in to the CLI, you are in user EXEC mode. User EXEC mode contains only a limited
subset of commands. To have access to all commands, you must enter privileged EXEC mode, normally
by using a password. From privileged EXEC mode, you can issue any EXEC command—user or
privileged mode—or you can enter global configuration mode. Most EXEC commands are one-time
commands. For example, show commands show important status information, and clear commands
clear counters or interfaces. The EXEC commands are not saved when the software reboots.
Configuration modes allow you to make changes to the running configuration. If you later save the
running configuration to the startup configuration, these changed commands are stored when the
software is rebooted. To enter specific configuration modes, you must start at global configuration mode.
From global configuration mode, you can enter interface configuration mode and a variety of other
modes, such as protocol-specific modes.
ROM monitor mode is a separate mode used when the Cisco IOS XE software cannot load properly. If
a valid software image is not found when the software boots or if the configuration file is corrupted at
startup, the software might enter ROM monitor mode.
Table 2-3 describes how to access and exit various common command modes of the Cisco IOS XE
software. It also shows examples of the prompts displayed for each mode.
Chapter 2
Table 2-3Accessing and Exiting Command Modes
Command
ModeAccess MethodPromptExit Method
User EXECLog in.
Privileged
EXEC
Global
configuration
From user EXEC mode, use the enable EXEC
command.
From privileged EXEC mode, use the
configure terminal privileged EXEC
command.
Router>
Router#
Router(config)#
Use the logout command.
To return to user EXEC mode, use
the disable command.
To return to privileged EXEC
mode from global configuration
mode, use the exit or end
command.
Interface
configuration
From global configuration mode, specify an
interface using an interface command.
Router(config-if)#
To return to global configuration
mode, use the exit command.
To return to privileged EXEC
mode, use the end command.
2-6
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 2
Understanding the Diagnostic Mode
Table 2-3Accessing and Exiting Command Modes (continued)
Command
ModeAccess MethodPromptExit Method
DiagnosticThe router boots up or accesses diagnostic
mode in the following scenarios:
In some cases, diagnostic mode will be reached
when the IOS process or processes fail. In most
scenarios, however, the router will.
A user-configured access policy was
configured using the transport-map command
that directed the user into diagnostic mode. See
the “”chapter of this book for information on
configuring access policies.
The router was accessed using a Route
Processor auxiliary port.
A break signal (Ctrl-C, Ctrl-Shift-6, or the
send break command) was entered and the
router was configured to go into diagnostic
mode when the break signal was received.
ROM monitorFrom privileged EXEC mode, use the reload
EXEC command. Press the Break key during
the first 60 seconds while the system is booting.
Router(diag)#
>
If the IOS process failing is the
reason for entering diagnostic
mode, the IOS problem must be
resolved and the router rebooted to
get out of diagnostic mode.
If the router is in diagnostic mode
because of a transport-map
configuration, access the router
through another port or using a
method that is configured to
connect to the Cisco IOS CLI.
If the router is accessed through
the Route Processor auxiliary port,
access the router through another
port. Accessing the router through
the auxiliary port is not useful for
customer purposes anyway.
To exit ROM monitor mode, use
the continue command.
Understanding the Diagnostic Mode
Diagnostic mode is new on the Cisco ASR 1000 Series Routers.
The router boots up or accesses diagnostic mode in the following scenarios:
• The IOS process or processes fail, in some scenarios. In other scenarios, the RP will simply reset
when the IOS process or processes fail.
• A user-configured access policy was configured using the transport-map command that directs the
user into diagnostic mode.
• The router was accessed using a Route Processor auxiliary port.
• A send break signal (Ctrl-C or Ctrl-Shift-6) was entered while accessing the router, and the router
was configured to enter diagnostic mode when a break signal was sent.
In diagnostic mode, a subset of the commands that are also available in User EXEC mode are made
available to users. Among other things, these commands can be used to:
• Inspect various states on the router, including the IOS state.
• Replace or roll back the configuration.
• Provide methods of restarting the IOS or other processes.
• Reboot hardware, such as the entire router, an RP, an ESP, a SIP, a SPA, or possibly other hardware
components.
• Transfer files into or off of the router using remote access methods such as FTP, TFTP, SCP, and so
on.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-7
Getting Help
The diagnostic mode provides a more comprehensive user interface for troubleshooting than previous
routers, which relied on limited access methods during failures, such as ROMmon, to diagnose and
troubleshoot IOS problems.
The diagnostic mode commands are stored in the nonIOS packages on the Cisco ASR 1000 Series
Routers, which is why the commands are available even if the IOS process is not working properly.
Importantly, all the commands available in diagnostic mode are also available in privileged EXEC mode
on the router even during normal router operation. The commands are entered like any other commands
in the privileged EXEC command prompts when used in privileged EXEC mode.
Getting Help
Entering a question mark (?) at the CLI prompt displays a list of commands available for each command
mode. You can also get a list of keywords and arguments associated with any command by using the
context-sensitive help feature.
To get help specific to a command mode, a command, a keyword, or an argument, use one of the
commands listed in Table 2-4:
Chapter 2
Table 2-4Help Commands and Purpose
CommandPurpose
helpProvides a brief description of the help system in any
abbreviated-command-entry?Provides a list of commands that begin with a particular
abbreviated-command-entry<Tab> Completes a partial command name.
?Lists all commands available for a particular command mode.
command ?Lists the keywords or arguments that you must enter next on
Finding Command Options
This section provides an example of how to display syntax for a command. The syntax can consist of
optional or required keywords and arguments. To display keywords and arguments for a command, enter
a question mark (?) at the configuration prompt or after entering part of a command followed by a space.
The Cisco IOS XE software displays a list and brief description of available keywords and arguments.
For example, if you were in global configuration mode and wanted to see all the keywords or arguments
for the arap command, you would type arap ?.
The <cr> symbol in command help output stands for “carriage return.” On older keyboards, the carriage
return key is the Return key. On most modern keyboards, the carriage return key is the Enter key. The
<cr> symbol at the end of command help output indicates that you have the option to press Enter to
complete the command and that the arguments and keywords in the list preceding the <cr> symbol are
optional. The <cr> symbol by itself indicates that no more arguments or keywords are available and that
you must press Enter to complete the command.
command mode.
character string. (No space between command and question
mark.)
the command line. (Space between command and question
mark.)
2-8
Table 2-5 shows examples of how you can use the question mark (?) to assist you in entering commands.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 2
Table 2-5Finding Command Options
CommandComment
Router> enable
Password: <password>
Router#
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#
Router(config)# interface serial ?
<0-6>Serial interface number
Router(config)# interface serial 4 ?
/
Router(config)# interface serial 4/ ?
<0-3>Serial interface number
Router(config)# interface serial 4/0 ?
<cr>
Router(config)# interface serial 4/0
Router(config-if)#
load-intervalSpecify interval for load calculation
for an
interface
locaddr-priorityAssign a priority group
loggingConfigure logging for interface
loopbackConfigure internal loopback on an
interface
mac-addressManually set interface MAC address
mlsmls router sub/interface commands
mpoaMPOA interface configuration commands
mtuSet the interface Maximum Transmission
Unit (MTU)
netbiosUse a defined NETBIOS access list or
enable
name-caching
noNegate a command or set its defaults
nrzi-encodingEnable use of NRZI encoding
ntpConfigure NTP
.
.
.
Router(config-if)#
Enter the enable command and password to access
privileged EXEC commands. You are in privileged
EXEC mode when the prompt changes to a “
the “
>”; for example, Router> to Router#.
Enter the configure terminal privileged EXEC
command to enter global configuration mode. You
are in global configuration mode when the prompt
changes to
Enter interface configuration mode by specifying
the serial interface that you want to configure using
the interface serial global configuration command.
Enter ? to display what you must enter next on the
command line. In this example, you must enter the
serial interface slot number and port number,
separated by a forward slash.
When the <cr> symbol is displayed, you can press
Enter to complete the command.
You are in interface configuration mode when the
prompt changes to
Enter ? to display a list of all the interface
configuration commands available for the serial
interface. This example shows only some of the
available interface configuration commands.
Getting Help
#” from
Router(config)#.
Router(config-if)#.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-9
Getting Help
Table 2-5Finding Command Options (continued)
CommandComment
Router(config-if)# ip ?
Interface IP configuration subcommands:
access-groupSpecify access control for packets
accountingEnable IP accounting on this interface
addressSet the IP address of an interface
authenticationauthentication subcommands
bandwidth-percentSet EIGRP bandwidth limit
broadcast-addressSet the broadcast address of an
interface
cgmpEnable/disable CGMP
directed-broadcast Enable forwarding of directed
broadcasts
dvmrpDVMRP interface commands
hello-intervalConfigures IP-EIGRP hello interval
helper-addressSpecify a destination address for UDP
broadcasts
hold-timeConfigures IP-EIGRP hold time
.
.
.
Router(config-if)# ip
Router(config-if)# ip address ?
A.B.C.DIP address
negotiatedIP Address negotiated over PPP
Router(config-if)# ip address
Router(config-if)# ip address 172.16.0.1 ?
A.B.C.DIP subnet mask
Router(config-if)# ip address 172.16.0.1
Router(config-if)# ip address 172.16.0.1 255.255.255.0 ?
secondaryMake this IP address a secondary
address
<cr>
Router(config-if)# ip address 172.16.0.1 255.255.255.0
Enter the command that you want to configure for
the interface. This example uses the ip command.
Enter ? to display what you must enter next on the
command line. This example shows only some of
the available interface IP configuration commands.
Enter the command that you want to configure for
the interface. This example uses the ip address
command.
Enter ? to display what you must enter next on the
command line. In this example, you must enter an IP
address or the negotiated keyword.
A carriage return (<cr>) is not displayed; therefore,
you must enter additional keywords or arguments to
complete the command.
Enter the keyword or argument that you want to use.
This example uses the 172.16.0.1 IP address.
Enter ? to display what you must enter next on the
command line. In this example, you must enter an IP
subnet mask.
A <cr> is not displayed; therefore, you must enter
additional keywords or arguments to complete the
command.
Enter the IP subnet mask. This example uses the
255.255.255.0 IP subnet mask.
Enter ? to display what you must enter next on the
command line. In this example, you can enter the
secondary keyword, or you can press Enter.
Chapter 2
Router(config-if)# ip address 172.16.0.1 255.255.255.0
Router(config-if)#
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-10
A <cr> is displayed; you can press Enter to
complete the command, or you can enter another
keyword.
In this example, Enter is pressed to complete the
command.
OL-16506-17
Chapter 2
Using the no and default Forms of Commands
Using the no and default Forms of Commands
Almost every configuration command has a no form. In general, use the no form to disable a function.
Use the command without the no keyword to re-enable a disabled function or to enable a function that
is disabled by default. For example, IP routing is enabled by default. To disable IP routing, use the no ip routing command; to re-enable IP routing, use the ip routing command. The Cisco IOS software
command reference publications provide the complete syntax for the configuration commands and
describe what the no form of a command does.
Many CLI commands also have a default form. By issuing the command default command-name, you
can configure the command to its default setting. The Cisco IOS software command reference
publications describe the function of the default form of the command when the default form performs
a different function than the plain and no forms of the command. To see what default commands are
available on your system, enter default ? in the appropriate command mode.
Saving Configuration Changes
Use the copy running-config startup-config command to save your configuration changes to the startup
configuration so that the changes will not be lost if the software reloads or a power outage occurs. For
example:
Router# copy running-config startup-config
Building configuration...
It might take a minute or two to save the configuration. After the configuration has been saved, the
following output appears:
[OK]
Router#
This task saves the configuration to NVRAM.
Managing Configuration Files
On the Cisco ASR 1000 Series Routers, the startup configuration file is stored in the nvram: file system
and the running-configuration files are stored in the system: file system. This configuration file storage
setup is not unique to the Cisco ASR 1000 Series Routers and is used on several Cisco router platforms.
As a matter of routine maintenance on any Cisco router, users should backup the startup configuration
file by copying the startup configuration file from NVRAM onto one of the router’s other file systems
and, additionally, onto a network server. Backing up the startup configuration file provides an easy
method of recovering the startup configuration file in the event the startup configuration file in NVRAM
becomes unusable for any reason.
The copy command can be used to backup startup configuration files. The following examples show the
startup configuration file in NVRAM being backed up:
Example 1: Copying a Startup Configuration File to Bootflash
Router# dir bootflash:
Directory of bootflash:/
OL-16506-17
11 drwx 16384 Dec 4 2007 04:32:46 -08:00 lost+found
86401 drwx 4096 Dec 4 2007 06:06:24 -08:00 .ssh
14401 drwx 4096 Dec 4 2007 06:06:36 -08:00 .rollback_timer
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-11
Managing Configuration Files
28801 drwx 4096 May 29 2008 16:31:41 -07:00 .prst_sync
43201 drwx 4096 Dec 4 2007 04:34:45 -08:00 .installer
12 -rw- 208904396 May 28 2008 16:17:34 -07:00
asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin
Example 3: Copying a Startup Configuration File to a TFTP Server
Router# copy bootflash:startup-config tftp:
Address or name of remote host []? 172.17.16.81
Destination filename [pe24_asr-1002-confg]? /auto/tftp-users/user/startup-config
!!
3517 bytes copied in 0.122 secs (28828 bytes/sec)
2-12
For more detailed information on managing configuration files, see the Managing Configuration Files
section in the Cisco IOS XE Configuration Fundamentals Configuration Guide.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 2
Filtering the Output of the show and more Commands
Filtering the Output of the show and more Commands
You can search and filter the output of show and more commands. This functionality is useful if you
need to sort through large amounts of output or if you want to exclude output that you need not see.
To use this functionality, enter a show or more command followed by the “pipe” character ( | ); one of
the keywords begin, include, or exclude; and a regular expression on which you want to search or filter
(the expression is case sensitive):
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-13
Powering Off a Router
show command | {append | begin | exclude | include | redirect | section | tee} regular-expression
The output matches certain lines of information in the configuration file. The following example
illustrates how to use output modifiers with the show interface command when you want the output to
include only lines in which the expression “protocol” appears:
Router# show interface | include protocol
FastEthernet0/0 is up, line protocol is up
Serial4/0 is up, line protocol is up
Serial4/1 is up, line protocol is up
Serial4/2 is administratively down, line protocol is down
Serial4/3 is administratively down, line protocol is down
Powering Off a Router
Before you turn off a power supply, make certain the chassis is grounded and you perform a soft
shutdown on the power supply. Not performing a soft shutdown will often not harm the router, but may
cause problems in certain scenarios.
To perform a soft shutdown before powering off the router, enter the reload command to halt the system
and then wait for ROM Monitor to execute before proceeding to the next step.
The following screenshot shows an example of this process:
Router# reload
Proceed with reload? [confirm]
...(Some messages are omitted here)
Initializing Hardware...
Chapter 2
Calculating the ROMMON CRC...CRC is correct.
Place the power supply switch in the Off position after seeing this message.
Finding Support Information for Platforms and Cisco Software
Images
Cisco software is packaged in feature sets consisting of software images that support specific platforms.
The feature sets available for a specific platform depend on which Cisco software images are included
in a release. To identify the set of software images available in a specific release or to find out if a feature
is available in a given Cisco IOS XE software image, you can use Cisco Feature Navigator or the
software release notes.
Using the Cisco Feature Navigator
Use Cisco Feature Navigator to find information about platform support and software image support.
Cisco Feature Navigator enables you to determine which Cisco IOS XE software images support a
specific software release, feature set, or platform. To access Cisco Feature Navigator, go to
http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
2-14
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 2
Using the Software Advisor
To see if a feature is supported by a Cisco IOS XE release, to locate the software document for that
feature, or to check the minimum software requirements of Cisco IOS XE software with the hardware
installed on your router, Cisco maintains the Software Advisor tool on Cisco.com at
You must be a registered user on Cisco.com to access this tool.
Using the Software Release Notes
Cisco IOS XE software releases include release notes that provide the following information:
• Platform support information
• Memory recommendations
• New feature information
• Open and resolved severity 1 and 2 caveats for all platforms
Release notes are intended to be release-specific for the most current release, and the information
provided in these documents may not be cumulative in providing information about features that first
appeared in previous releases. Refer to Cisco Feature Navigator for cumulative feature information.
Finding Support Information for Platforms and Cisco Software Images
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
2-15
Finding Support Information for Platforms and Cisco Software Images
Chapter 2
2-16
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
CHA P T ER
3
Console Port, Telnet, and SSH Handling
This chapter covers the following topics:
• Console Port Overview for the Cisco ASR 1000 Series Routers, page 3-1
• Console Port Handling Overview, page 3-1
• Telnet and SSH Overview for the Cisco ASR 1000 Series Routers, page 3-2
• Persistent Telnet and Persistent SSH Overview, page 3-2
• Configuring a Console Port Transport Map, page 3-3
Console Port Overview for the Cisco ASR 1000 Series Routers
The console port on the Cisco ASR 1000 Series Router is an EIA/TIA-232 asynchronous, serial
connection with no flow control and an RJ-45 connector. The console port is used to access the router
and is located on the front panel of the Route Processor (RP).
For information on accessing the router using the console port, see the “Accessing the CLI Using a
Directly-Connected Console” section on page 2-2.
Console Port Handling Overview
Users using the console port to access the router are automatically directed to the IOS command-line
interface, by default.
If a user is trying to access the router through the console port and sends a break signal (a break signal
can be sent by entering Ctrl-C or Ctrl-Shift-6, or by entering the send break command at the Telnet
prompt) before connecting to the IOS command-line interface, the user is directed into a diagnostic mode
by default if the nonRPIOS subpackages can be accessed.
These settings can be changed by configuring a transport map for the console port and applying that
transport map to the console interface.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
3-1
Chapter 3
Telnet and SSH Overview for the Cisco ASR 1000 Series Routers
Telnet and SSH Overview for the Cisco ASR 1000 Series Routers
Telnet and Secure Shell (SSH) on the Cisco ASR 1000 Series Routers can be configured and handled
like Telnet and SSH on other Cisco platforms. For information on traditional Telnet, see the line
command in the Cisco IOS Terminal Services Command Reference guide located at:
The Cisco ASR 1000 Series Routers also introduces persistent Telnet and persistent SSH. Persistent
Telnet and persistent SSH allow network administrators to more clearly define the treatment of incoming
traffic when users access the router through the Management Ethernet port using Telnet or SSH. Notably,
persistent Telnet and persistent SSH provide more robust network access by allowing the router to be
configured to be accessible through the Ethernet Management port using Telnet or SSH even when the
IOS process has failed.
Persistent Telnet and Persistent SSH Overview
In traditional Cisco routers, accessing the router using Telnet or SSH is not possible in the event of an
IOS failure. When Cisco IOS fails on a traditional Cisco router, the only method of accessing the router
is through the console port. Similarly, if all active IOS processes have failed on a Cisco ASR 1000 Series
Router that is not using persistent Telnet or persistent SSH, the only method of accessing the router is
through the console port.
With persistent Telnet and persistent SSH, however, users can configure a transport map that defines the
treatment of incoming Telnet or SSH traffic on the Management Ethernet interface. Among the many
configuration options, a transport map can be configured to direct all traffic to the IOS command-line
interface, diagnostic mode, or to wait for an IOS vty line to become available and then direct users into
diagnostic mode when the user sends a break signal while waiting for the IOS vty line to become
available. If a user uses Telnet or SSH to access diagnostic mode, that Telnet or SSH connection will be
usable even in scenarios when no IOS process is active. Therefore, persistent Telnet and persistent SSH
introduce the ability to access the router via diagnostic mode when the IOS process is not active. For
information on diagnostic mode, see the “Understanding the Diagnostic Mode” section on page 2-7.
See the “Configuring Persistent Telnet” section on page 3-5 and the “Configuring Persistent SSH”
section on page 3-8 for information on the various other options that are configurable using persistent
Telnet or persistent SSH transport maps.
3-2
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 3
Configuring a Console Port Transport Map
This task describes how to configure a transport map for a console port interface on the Cisco ASR 1000
Series Router.
SUMMARY STEPS
1. (Required) enable
2. (Required) configure terminal
3. (Required) transport-map type console transport-map-name
7. (Required) transport type console console-line-number input transport-map-name
DETAILED STEPS
Configuring a Console Port Transport Map
Step 1
Step 2
Step 3
Step 4
Command or ActionPurpose
enable
Enables privileged EXEC mode.
• Enter your password if prompted.
Example:
Router> enable
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
transport-map type console transport-map-name
Creates and names a transport map for handling console
connections, and enter transport map configuration mode.
Example:
Router(config)# transport-map type console
consolehandler
connection wait [allow interruptible | none]
Specifies how a console connection will be handled using
this transport map:
Example:
Router(config-tmap)# connection wait none
• allow interruptible—The console connection waits for
an IOS vty line to become available, and also allows
user to enter diagnostic mode by interrupting a console
connection waiting for the IOS vty line to become
available. This is the default setting.
OL-16506-17
NoteUsers can interrupt a waiting connection by
entering Ctrl-C or Ctrl-Shift-6.
• none—The console connection immediately enters
diagnostic mode.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3-3
Configuring a Console Port Transport Map
Command or ActionPurpose
Step 5
banner [diagnostic | wait] banner-message
Example:
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character
'X'.
--Welcome to Diagnostic Mode-X
Router(config-tmap)#
Step 6
exit
Example:
Router(config-tmap)# exit
Step 7
transport type console console-line-number
input transport-map-name
Example:
Router(config)# transport type console 0
input consolehandler
Chapter 3
(Optional) Creates a banner message that will be seen by
users entering diagnostic mode or waiting for the IOS vty
line as a result of the console transport map configuration.
• diagnostic—Creates a banner message seen by users
directed into diagnostic mode as a result of the console
transport map configuration.
• wait—Creates a banner message seen by users waiting
for the IOS vty to become available.
• banner-message—The banner message, which begins
and ends with the same delimiting character.
Exits transport map configuration mode to re-enter global
configuration mode.
Applies the settings defined in the transport map to the
console interface.
The transport-map-name for this command must match the
transport-map-name defined in the transport-map type
console command.
Examples
In the following example, a transport map to set console port access policies is created and attached to
console port 0:
Router(config)# transport-map type console consolehandler
Router(config-tmap)# connection wait allow interruptible
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character 'X'.
Welcome to diagnostic mode
X
Router(config-tmap)# banner wait X
Enter TEXT message. End with the character 'X'.
Waiting for IOS vty line
X
Router(config-tmap)# exit
Router(config)# transport type console 0 input consolehandler
3-4
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 3
Configuring Persistent Telnet
This task describes how to configure persistent Telnet on the Cisco ASR 1000 Series Routers.
Prerequisites
For a persistent Telnet connection to access an IOS vty line on the Cisco ASR 1000 Series Router, local
login authentication must be configured for the vty line (the login command in line configuration mode).
If local login authentication is not configured, users will not be able to access IOS using a Telnet
connection into the Management Ethernet interface with an applied transport map. Diagnostic mode will
still be accessible in this scenario.
SUMMARY STEPS
1. (Required) enable
2. (Required) configure terminal
3. (Required) transport-map type persistent telnet transport-map-name
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character
'X'.
--Welcome to Diagnostic Mode-X
Router(config-tmap)#
Step 6
transport interface gigabitethernet 0
Chapter 3
Specifies how a persistent Telnet connection will be
handled using this transport map:
• allow—The Telnet connection waits for an IOS vty line
to become available, and exits the router if interrupted.
• allow interruptible—The Telnet connection waits for
the IOS vty line to become available, and also allows
user to enter diagnostic mode by interrupting a Telnet
connection waiting for the IOS vty line to become
available. This is the default setting.
NoteUsers can interrupt a waiting connection by
entering Ctrl-C or Ctrl-Shift-6.
• none—The Telnet connection immediately enters
diagnostic mode.
• none disconnect—The Telnet connection does not wait
for the IOS vty line and does not enter diagnostic mode,
so all Telnet connections are rejected if no vty line is
immediately available in IOS.
(Optional) Creates a banner message that will be seen by
users entering diagnostic mode or waiting for the IOS vty
line as a result of the persistent Telnet configuration.
• diagnostic—creates a banner message seen by users
directed into diagnostic mode as a result of the
persistent Telnet configuration.
• wait—creates a banner message seen by users waiting
for the vty line to become available.
• banner-message—the banner message, which begins
and ends with the same delimiting character.
Applies the transport map settings to the Management
Ethernet interface (interface gigabitethernet 0).
Example:
Router(config-tmap)# transport interface
gigabitethernet 0
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3-6
Persistent Telnet can only be applied to the Management
Ethernet interface on the Cisco ASR 1000 Series Routers.
This step must be taken before applying the transport map
to the Management Ethernet interface.
OL-16506-17
Chapter 3
Command or ActionPurpose
Step 7
exit
Example:
Router(config-tmap)# exit
Step 8
transport type persistent telnet input
transport-map-name
Example:
Router(config)# transport type persistent
telnet input telnethandler
Examples
Configuring Persistent Telnet
Exits transport map configuration mode to re-enter global
configuration mode.
Applies the settings defined in the transport map to the
Management Ethernet interface.
The transport-map-name for this command must match the
transport-map-name defined in the transport-map type
persistent telnet command.
In the following example, a transport map that will make all Telnet connections wait for an IOS vty line
to become available before connecting to the router, while also allowing the user to interrupt the process
and enter diagnostic mode, is configured and applied to the Management Ethernet interface (interface
gigabitethernet 0).
A diagnostic and a wait banner are also configured.
The transport map is then applied to the interface when the transport type persistent telnet input
command is entered to enable persistent Telnet.
Router(config)# transport-map type persistent telnet telnethandler
Router(config-tmap)# connection wait allow interruptible
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character 'X'.
--Welcome to Diagnostic Mode-X
Router(config-tmap)# banner wait X
Enter TEXT message. End with the character 'X'.
--Waiting for IOS Process-X
OL-16506-17
Router(config-tmap)# transport interface gigabitethernet 0
Router(config-tmap)# exit
Router(config)# transport type persistent telnet input telnethandler
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3-7
Configuring Persistent SSH
Configuring Persistent SSH
This task describes how to configure persistent SSH on the Cisco ASR 1000 Series Routers.
SUMMARY STEPS
1. (Required) enable
2. (Required) configure terminal
3. (Required) transport-map type persistent ssh transport-map-name
Specifies how a persistent SSH connection will be handled
using this transport map:
• allow—The SSH connection waits for the vty line to
become available, and exits the router if interrupted.
• allow interruptible—The SSH connection waits for
the vty line to become available, and also allows users
to enter diagnostic mode by interrupting a SSH
connection waiting for the vty line to become available.
This is the default setting.
NoteUsers can interrupt a waiting connection by
• none—The SSH connection immediately enters
diagnostic mode.
• none disconnect—The SSH connection does not wait
for the vty line from IOS and does not enter diagnostic
mode, so all SSH connections are rejected if no vty line
is immediately available.
Names the RSA keypair to be used for persistent SSH
connections.
Configuring Persistent SSH
entering Ctrl-C or Ctrl-Shift-6.
Step 6
Step 7
Example:
Router(config-tmap)# rsa keypair-name sshkeys
authentication-retries number-of-retries
Example:
Router(config-tmap)# authentication-retries 4
banner [diagnostic | wait] banner-message
Example:
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character
'X'.
--Welcome to Diagnostic Mode-X
Router(config-tmap)#
For persistent SSH connections, the RSA keypair name
must be defined using this command in transport map
configuration mode. The RSA keypair definitions defined
elsewhere on the router, such as through the use of the ip ssh rsa keypair-name command, do not apply to persistent
SSH connections.
No rsa-keypair-name is defined by default.
(Optional) Specifies the number of authentication retries
before dropping the connection.
The default number-of-retries is 3.
(Optional) Creates a banner message that will be seen by
users entering diagnostic mode or waiting for the vty line as
a result of the persistent SSH configuration.
• diagnostic—Creates a banner message seen by users
directed into diagnostic mode as a result of the
persistent SSH configuration.
• wait—Creates a banner message seen by users waiting
for the vty line to become active.
• banner-message—The banner message, which begins
and ends with the same delimiting character.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3-9
Configuring Persistent SSH
Command or ActionPurpose
Step 8
time-out timeout-interval
Example:
Router(config-tmap)# time-out 30
Step 9
transport interface gigabitethernet 0
Example:
Router(config-tmap)# transport interface
gigabitethernet 0
Step 10
exit
Example:
Router(config-tmap)# exit
Step 11
transport type persistent ssh input
transport-map-name
Example:
Router(config)# transport type persistent ssh
input sshhandler
Chapter 3
(Optional) Specifies the SSH time-out interval in seconds.
The default timeout-interval is 120 seconds.
Applies the transport map settings to the Management
Ethernet interface (interface gigabitethernet 0).
Persistent SSH can only be applied to the Management
Ethernet interface on the Cisco ASR 1000 Series Routers.
Exits transport map configuration mode to re-enter global
configuration mode.
Applies the settings defined in the transport map to the
Management Ethernet interface.
The transport-map-name for this command must match the
transport-map-name defined in the transport-map type
persistent ssh command.
Examples
In the following example, a transport map that will make all SSH connections wait for the vty line to
become active before connecting to the router is configured and applied to the Management Ethernet
interface (interface gigabitethernet 0). The RSA keypair is named sshkeys.
This example only uses the commands required to configure persistent SSH.
Router(config)# transport-map type persistent ssh sshhandler
Router(config-tmap)# connection wait allow
Router(config-tmap)# rsa keypair-name sshkeys
Router(config-tmap)# transport interface gigabitethernet 0
In the following example, a transport map is configured that will apply the following settings to any users
attempting to access the Management Ethernet port via SSH:
• Users using SSH will wait for the vty line to become active, but will enter diagnostic mode if the
attempt to access IOS through the vty line is interrupted.
• The RSA keypair name is sshkeys
• The connection allows one authentication retry.
• The banner “--Welcome to Diagnostic Mode--” will appear if diagnostic mode is entered as a
result of SSH handling through this transport map.
• The banner “--Waiting for vty line--” will appear if the connection is waiting for the vty line
to become active.
The transport map is then applied to the interface when the transport type persistent ssh input
command is entered to enable persistent SSH:
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 3
Viewing Console Port, SSH, and Telnet Handling Configurations
Router(config-tmap)# rsa keypair-name sshkeys
Router(config-tmap)# authentication-retries 1
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character 'X'.
--Welcome to Diagnostic Mode-X
Router(config-tmap)#banner wait X
Enter TEXT message. End with the character 'X'.
--Waiting for vty line-X
Router(config-tmap)# time-out 30
Router(config-tmap)# transport interface gigabitethernet 0
Router(config-tmap)# exit
Router(config)# transport type persistent ssh input sshhandler
Viewing Console Port, SSH, and Telnet Handling Configurations
Use the show transport-map [all | name transport-map-name | type [console | persistent [ssh |
telnet]]] EXEC or privileged EXEC command to view the transport map configurations.
In the following example, a console port, persistent SSH, and persistent Telnet transport are configured
on the router and various forms of the show transport-map command are entered to illustrate the
various ways the show transport-map command can be entered to gather transport map configuration
information.
Router# show transport-map all
Transport Map:
Name: consolehandler
Type: Console Transport
The show platform software configuration access policy command can be used to view the current
configurations for the handling of incoming console port, SSH, and Telnet connections. The output of
this command provides the current wait policy for each type of connection, as well as any information
on the currently configured banners. Unlike show transport-map, this command is available in
diagnostic mode so it can be entered in cases when you need transport map configuration information
but cannot access the IOS CLI.
Router# show platform software configuration access policy
The current access-policies
In the following example, the connection policy and banners are set for a persistent SSH transport map,
and the transport map is enabled.
The show platform software configuration access policy output is given both before the new transport
map is enabled and after the transport map is enabled so the changes to the SSH configuration are
illustrated in the output.
Router# show platform software configuration access policy
3-14
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 3
Viewing Console Port, SSH, and Telnet Handling Configurations
The current access-policies
Method : telnet
Rule : wait with interrupt
Shell banner:
Welcome to Diagnostic Mode
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# transport-map type persistent ssh sshhandler
Router(config-tmap)# connection wait allow interruptible
Router(config-tmap)# banner diagnostic X
Enter TEXT message. End with the character 'X'.
Welcome to Diag Mode
X
Router(config-tmap)# banner wait X
Enter TEXT message. End with the character 'X'.
Router(config)# transport type persistent ssh input sshhandler
Router(config)# exit
Router# show platform software configuration access policy
The current access-policies
Method : telnet
Rule : wait with interrupt
Shell banner:
Welcome to Diagnostic Mode
Wait banner :
Waiting for IOS process
Method : ssh
Rule : wait with interrupt
Shell banner:
Welcome to Diag Mode
OL-16506-17
Wait banner :
Waiting for IOS
Method : console
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
3-15
Important Notes and Restrictions
Rule : wait with interrupt
Shell banner:
Wait banner :
Important Notes and Restrictions
The important notes and restriction pertaining to the console port, SSH, and telnet handling include:
• The Telnet and SSH settings made in the transport map override any other Telnet or SSH settings
when the transport map is applied to the Management Ethernet interface.
• Only local usernames and passwords can be used to authenticate users entering a Management
Ethernet interface. AAA authentication is not available for users accessing the router through a
Management Ethernet interface using persistent Telnet or persistent SSH.
• Applying a transport map to a Management Ethernet interface with active Telnet or SSH sessions
can disconnect the active sessions. Removing a transport map from an interface, however, does not
disconnect any active Telnet or SSH sessions.
• Configuring the diagnostic and wait banners is optional but recommended. The banners are
especially useful as indicators to users of the status of their Telnet or SSH attempts.
Chapter 3
3-16
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
CHA P T ER
4
Consolidated Packages and SubPackages
Management
This chapter discusses how consolidated packages and software subpackages (individual and optional)
are managed and are used to run the Cisco ASR 1000 Series Aggregation Services Routers. It contains
the following sections:
• Running the Cisco ASR 1000 Series Routers: An Overview, page 4-1
• Software File Management Using Command Sets, page 4-4
• Managing and Configuring the Router to Run Using Consolidated Packages and Individual
SubPackages, page 4-6
• Upgrading Individual SubPackages, page 4-18
NoteThis section of the document does not discuss limited downtime upgrades. For information on limited
downtime upgrades, see the “Software Upgrade Processes Supported by Cisco ASR 1000 Series
Routers” section on page 5-1.
Running the Cisco ASR 1000 Series Routers: An Overview
The Cisco ASR 1000 Series Routers can be run using a complete consolidated package or using
individual subpackages.
This section covers the following topics:
• Running the Cisco ASR 1000 Series Routers Using Individual and Optional SubPackages: An
Overview, page 4-2
• Running the Cisco ASR 1000 Series Routers Using a Consolidated Package: An Overview, page 4-2
• Running the Cisco ASR 1000 Series Routers: A Summary, page 4-3
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
4-1
Chapter 4 Consolidated Packages and SubPackages Management
Running the Cisco ASR 1000 Series Routers: An Overview
Running the Cisco ASR 1000 Series Routers Using Individual and Optional
SubPackages: An Overview
The Cisco ASR 1000 Series Routers can be configured to run using individual subpackages and optional
subpackages.
When the router is configured to run using individual and optional subpackages:
• Each individual subpackage within a consolidated package is extracted onto the router as its own
file.
• Additionally, any optional subpackages must be separately downloaded and stored in the same
directory with the provisioning file and the other individual subpackages that have been extracted.
• The router then runs by accessing each file as needed for operational purposes. All individual and
optional subpackage files must be stored in the same directory on the router for the router to run
properly using individual subpackages.
When a Cisco ASR 1000 Series Router is configured to run using individual and optional subpackages,
software image content from the RP is copied into memory on an as-needed basis only. Memory is
conserved for other router processes, such as passing traffic. The router, therefore, allows for the highest
peak traffic load when configured to run using individual subpackages.
When running the Cisco ASR 1000 Series Routers using individual and optional subpackages, the router
must be configured to boot using the provisioning file that was included in the consolidated package with
the individual subpackage files. This provisioning file must also be in the same directory as the
individual and optional subpackage files. The router boots faster when configured to run using individual
and optional subpackages than it does when configured to run using a consolidated package.
A Cisco ASR 1000 Series Router cannot be configured to run individual and optional subpackages stored
on a TFTP or any other network server. The individual and optional subpackages along with the
provisioning file must be copied onto the bootflash: file system to run the router using this method.
Running the Cisco ASR 1000 Series Routers Using a Consolidated Package: An
Overview
The Cisco ASR 1000 Series Routers can also be configured to run using a consolidated package.
NoteBooting the router from a consolidated package is not supported for installation of optional subpackages.
For more information, see the “Running the Cisco ASR 1000 Series Routers Using Individual and
Optional SubPackages: An Overview” section on page 4-2.
When the router is configured to run using a consolidated package, the entire consolidated package file
is copied onto the router or accessed by the router via TFTP or another network transport method. The
router runs using the consolidated package file.
When a Cisco ASR 1000 Series Router is configured to run using the consolidated package file, more
memory is required to process router requests because the router has to search one larger file for every
request. The peak amount of memory available for passing network traffic is therefore lower when the
router is configured to run using a consolidated package.
A Cisco ASR 1000 Series Router configured to run using a consolidated package is booted by booting
the consolidated package file. Because this file is large, the boot process for routers running using the
consolidated package is slower than the boot process for routers running individual subpackages.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-2
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Running the Cisco ASR 1000 Series Routers: An Overview
A Cisco ASR 1000 Series Router configured to run using a consolidated package does have some
advantages over a Cisco ASR 1000 Series Router configured to run individual subpackages. First, a
consolidated package can be booted and utilized using TFTP or another network transport method.
Secondly, configuring the router to use the one consolidated package file is easier than managing several
individual subpackage files. Running the router using a consolidated package may be the right method
of running the router in certain networking environments.
The consolidated package should be stored on bootflash:, usb[0-1]:, or a remote file system when this
method is used to run the router.
Running the Cisco ASR 1000 Series Routers: A Summary
This section summarizes the advantages and disadvantages of each method of running your Cisco ASR
1000 Series Routers.
The advantages of running your router using individual subpackages include:
• Optimizes router memory usage—When the router is booting using the individual and optional
subpackage method, software image content from the Router Processor (RP) is copied into memory
on an as-needed basis only, which conserves memory for other router processes. The router boots
fastest and allows for the highest peak traffic load when booted using the individual subpackage boot
approach.
The advantages of running your router using a consolidated package include:
• Simplified installation—Only one software file needs to be managed instead of several separate
images.
• Storage—A consolidated package, unlike individual subpackages, can be used to run the router
while being stored in bootflash:, on a USB Flash disk, or on a network server. A consolidated
package can be booted and utilized using TFTP or another network transport method, while the
individual subpackage method requires the individual subpackage files to be copied into the
bootflash: file directory on the router.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-3
Software File Management Using Command Sets
Table 4-1 summarizes the advantages and disadvantages of the approaches.
Table 4-1Advantages and Disadvantages of Running Individual subPackages and Consolidated
Packages
ApproachAdvantagesDisadvantages
Individual and optional
subpackages
NoteThis method is
required if you
need to install any
optional
subpackages for
your system.
Consolidated Package
Chapter 4 Consolidated Packages and SubPackages Management
• Optimizes memory usage,
allowing for faster boot times
and increased traffic loads.
• Easier management. Only
have to manage one file
instead of many files.
• A consolidated package file
can be stored in bootflash:, on
a USB Flash disk, or on any
TFTP or other network server.
• Multiple software subpackages
more difficult to manage.
• Cannot be booted from TFTP or
any other network server. If you
are going to use the individual
subpackage boot method, each
individual subpackage file must
be placed in the bootflash:
directory.
• Individual and optional
subpackage files and the
provisioning file must be stored
in bootflash:.
• Slower boot times and lessened
maximum system scalability
because the larger image must be
processed at all times.
Software File Management Using Command Sets
Software files can be managed on the Cisco ASR 1000 Series Routers using three distinct command sets.
This section provides overviews of the following command sets:
• The request platform Command Set, page 4-4
• The copy Command, page 4-5
• The issu Command Set, page 4-5
The request platform Command Set
The request platform software package command is part of the larger request platform command set
being introduced on the Cisco ASR 1000 Series Routers. For additional information on each request
platform command and the options available with each command, see the Cisco IOS Configuration
Fundamentals Command Reference.
The request platform software package command, which can be used to upgrade individual
subpackages and a complete consolidated package, is used to upgrade software on the Cisco ASR 1000
Series Routers. Notably, the request platform software package command is the recommended way of
performing an individual subpackage upgrade, and also provides the only method of no-downtime
upgrades of individual subpackages on the router when the router is running individual subpackages.
4-4
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
The request platform software package command requires that the destination device or process be
specified in the command line, so the commands can be used to upgrade software on both an active or a
standby processor. The request platform software package command allows for no downtime software
upgrades in many scenarios.
The basic syntax of the command is request platform software package install rp rp-slot-number file file-URL, where rp-slot-number is the number of the RP slot and file-URL is the path to the file being
used to upgrade the Cisco ASR 1000 Series Router. The command has other options; see the request platform software package command references for information on all of the options available with
this command set.
In Cisco IOS XE Release 2.4, the request platform software package uninstall command is introduced
on the Cisco ASR 1000 Series Routers to remove provisioning of an optional subpackage from an RP.
The syntax for the command follows the install form of the command: request platform software
package uninstall rp rp-slot-number type pkg, where rp-slot-number is the number of the RP slot and
pkg is the type of optional subpackage file to be removed.
NoteFor additional information on limited downtime upgrades using the request platform software package
command set, see the “Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers”
section on page 5-1.
Software File Management Using Command Sets
The copy Command
The copy command can be used to move consolidated packages and individual subpackages onto the
router, though using this command to move individual subpackage files from one storage area to another
is often inefficient (in these scenarios, it is almost always preferable to move the consolidated package,
then extract the subpackages, or to extract the subpackages without moving the consolidated package).
To upgrade a consolidated package on the Cisco ASR 1000 Series Routers, copy the consolidated
package onto a file system, usually bootflash: or usb[0-1]: on the router, using the copy command as you
would on most other Cisco routers. After making this copy, configure the router to boot using the
consolidated package file.
To upgrade the router and reboot using individual subpackages, copy the consolidated package onto the
router using the copy command, enter the request platform software package expand command to
extract the individual subpackages, and configure the router to boot using subpackages. Other methods,
such as copying each individual subpackage in the same consolidated package from a directory or using
the request platform software package command to extract the subpackages onto a router directory are
also usable, though copying individual subpackages is often inefficient.
See the copy command reference for a list of the options that are available with the copy command.
The issu Command Set
The issu command set that is available on other Cisco routers is also available on the Cisco ASR 1000
Series Routers. The issu command set can be used to perform both consolidated package and individual
subpackage upgrades.
The issu command set includes the issu command with the loadversion, runversion, commitversion,
and abortversion options. See the issu command references for information on all of the options
available with each of these commands.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-5
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
A confirm prompt is displayed when the command issu abortversion is issued and when the standby
has not reached the terminal (hot) state.
The following example shows a confirm prompt notification:
The system is without a fully initialized peer and service impact will occur. Proceed with
abort? [confirm]
The issu runversion command is optional for completing a consolidated package upgrade on the
Cisco ASR 1000 Series Routers. You can enter issu commitversion from the active RP to complete the
software upgrade, then use the redundancy force-switchover command to switch to the upgraded RP
on this platform, if desired.
NoteFor additional information on limited downtime upgrades using the issu command set, see the “Software
Upgrade Processes Supported by Cisco ASR 1000 Series Routers” section on page 5-1.
Managing and Configuring the Router to Run Using Consolidated
Packages and Individual SubPackages
This section discusses the following topics:
• Quick Start Software Upgrade, page 4-6
• Managing and Configuring a Router to Run Using a Consolidated Package, page 4-7
• Managing and Configuring a Router to Run Using Individual SubPackages From a Consolidated
Package, page 4-10
• Managing and Configuring a Router to Run Using Optional SubPackages, page 4-14
• Troubleshooting Software Mismatch with ESP Board ASR1000-ESP10-N, page 4-18
Quick Start Software Upgrade
The following instructions provide a quick start version of upgrading the software running the Cisco
ASR 1000 Series Routers. These instructions assume you have access to the consolidated package and
that the files will be stored in a bootflash: file system that is not storing any previously installed
subpackages or consolidated packages and that has enough room for the file or files.
For more detailed installation examples, see the other sections of this chapter.
To upgrade the software using a quick start version, perform the following steps:
Step 1Copy the consolidated package into bootflash: using the copy URL-to-image bootflash: command.
Step 2If you want to run the router using individual subpackages, enter the request platform software
package expand filebootflash:image-name command. If you want to run the router using a
consolidated package, skip this step.
Step 3Enter the dir bootflash: command to verify your consolidated package or your extracted subpackages
are in the directory.
4-6
Step 4If you are trying to run individual subpackages, use the delete bootdisk:image-name to delete the
consolidated package. If you want to run the router using the consolidated package, skip this step.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Step 5Set up the boot parameters for your boot. Set the configuration register to 0x2 by entering the
config-register 0x2102 global configuration command, and enter the boot system flash
bootflash:image-name (if running using the consolidated package) or boot system flash
bootflash:provisionging-file-name (if running using individual subpackages) global configuration
command.
Step 6Enter copy running-config startup-config to save your configuration.
Step 7Enter the reload command to reload the router and finish the boot. The upgraded software should be
running when the reload completes.
Managing and Configuring a Router to Run Using a Consolidated Package
NoteDo not use this procedure if you also need to install any optional subpackages.
This section documents the following procedures:
• Managing and Configuring a Consolidated Package Using the copy Command, page 4-7
• Managing and Configuring a Consolidated Package Using the request platform software package
install Command, page 4-8
Managing and Configuring a Consolidated Package Using the copy Command
To upgrade a consolidated package on the Cisco ASR 1000 Series Routers using the copy command,
copy the consolidated package into the bootflash: directory on the router using the copy command as
you would on most other Cisco routers. After making this copy, configure the router to boot using the
consolidated package file.
In the following example, the consolidated package file is copied onto the bootflash: file system from
TFTP. The config-register is then set to boot using boot system commands, and the boot system
commands instruct the router to boot using the consolidated package stored in the bootflash: file system.
The new configuration is then saved using the copy running-config startup-config command, and the
system is then reloaded to complete the process.
928862208 bytes total (503156736 bytes free)
Router# config t
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#boot system flash
Router(config)#config-reg 0x2102
Router(config)#exit
Router#show run | include boot
boot-start-marker
boot system flash bootflash:asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin
boot-end-marker
Router# copy run start
Destination filename [startup-config]?
Building configuration...
[OK]
Router# reload
Managing and Configuring a Consolidated Package Using the request platform software package
install Command
In the following example, the request platform software package install command is used to upgrade
a consolidated package running on RP 0. The force option, which forces the upgrade past any prompt
(such as already having the same consolidated package installed), is used in this example.
Router# request platform software package install rp 0 file
bootflash:asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin force
--- Starting installation state synchronization --Finished installation state synchronization
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Locating image files and validating name syntax
Inspecting image file types
Processing image file constraints
Extracting super package content
Verifying parameters
Validating package type
Copying package files
Checking and verifying packages contained in super package
Creating candidate provisioning file
WARNING:
WARNING: Candidate software will be installed upon reboot
WARNING:
Finished image file verification
--- Starting candidate package set construction --Verifying existing software set
Processing candidate provisioning file
Constructing working set for candidate package set
Constructing working set for running package set
Checking command output
Constructing merge of running and candidate packages
Finished candidate package set construction
--- Starting compatibility testing --Determining whether candidate package set is compatible
WARNING:
WARNING: Candidate software combination not found in compatibility database
WARNING:
Determining whether installation is valid
Determining whether installation is valid ... skipped
Checking IPC compatibility with running software
Checking IPC compatibility with running software ... skipped
Checking candidate package set infrastructure compatibility
Checking infrastructure compatibility with running software
Checking infrastructure compatibility with running software ... skipped
Finished compatibility testing
SUCCESS: Software provisioned. New software will load on reboot.
OL-16506-17
Router# reload
NoteA reload must be performed to finish this procedure.
The “Managing and Configuring a Consolidated Package Using the copy Command” section on page 4-7
includes an example of how to configure the router to boot using the consolidated package, and then an
example of what happens after the reload is performed to finish the installation.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-9
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Managing and Configuring a Router to Run Using Individual SubPackages From
a Consolidated Package
To run the router using individual subpackages from a consolidated package, follow one of the following
procedures:
• Extracting a Consolidated Package and Booting Using the Provisioning File, page 4-10
• Copying a Set of Individual SubPackage Files, and Booting Using a Provisioning File, page 4-14
Extracting a Consolidated Package and Booting Using the Provisioning File
To extract a consolidated package and to boot using provisioning file, perform the following steps:
Step 1Perform one of the following tasks:
• Copy the consolidated package file (or, in cases where you have every individual subpackage and a
provisioning file for the subpackages available, each individual subpackage and the provisioning
file) onto the bootflash: file system using the copy command. Make sure to copy the consolidated
package into the bootflash: file system and directory where you want to store the provisioning file
and the individual image subpackages. Enter the request platform software package expand file bootflash:url-to-Cisco-IOS-XE-imagename command with no other option to extract the
provisioning file and the individual subpackages out of the consolidated package file and into the
current directory in bootflash:.
• Copy the consolidated package file onto any file system on your router, then enter the request
platform software package expand file file-system:url-to-Cisco-IOS-XE-imagename to bootflash:
command to extract the provisioning file and the individual image subpackages onto the bootflash:
file system.
NoteAfter performing this step, do not move any of the files. The bootup process cannot function properly
unless all of the subpackages and the provisioning file are located in the same directory.
Also, do not rename the subpackage files. Only the provisioning file can be renamed, and the renaming
of the provisioning file, if desired, should be done at this step before the router is rebooted.
Step 2Configure the router to boot using the provisioning file.
The sequence below provides an example that would boot the router using the provisioning file named
packages.conf that was stored with the other subpackages in the bootflash: file system:
Router(config)# no boot system
Router(config)# config-register 0x2102
Router(config)# boot system flash bootflash:packages.conf
Router(config)# exit
*May 11 01:31:04.815: %SYS-5-CONFIG_I: Configured from console by con
Router# copy running-config startup-config
Building configuration...
[OK]
Router# reload
4-10
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Extracting the SubPackages and the Provisioning File: Example 1
The following example shows how to extract the individual subpackages and the provisioning file from
a consolidated package that has already been placed in the directory where you want to store the
individual subpackages and the provisioning file.
Output of the directory before and after the extraction is given to confirm the files were extracted.
11 drwx 16384 Dec 4 2007 04:32:46 -08:00 lost+found
86401 drwx 4096 Dec 4 2007 06:06:24 -08:00 .ssh
14401 drwx 4096 Dec 4 2007 06:06:36 -08:00 .rollback_timer
28801 drwx 4096 Mar 18 2008 17:31:17 -07:00 .prst_sync
43201 drwx 4096 Dec 4 2007 04:34:45 -08:00 .installer
12 -rw- 208904396 May 9 2008 14:36:31 -07:00
asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin
57611 -rw- 47071436 May 22 2008 11:26:23 -07:00
asr1000rp1-espbase.02.01.00.122-33.XNA.pkg
57602 -rw- 5740 May 22 2008 11:26:22 -07:00
asr1000rp1-packages-adventerprisek9.02.01.00.122-33.XNA.conf
57612 -rw- 20334796 May 22 2008 11:26:24 -07:00
asr1000rp1-rpaccess.02.01.00.122-33.XNA.pkg
57613 -rw- 22294732 May 22 2008 11:26:24 -07:00
asr1000rp1-rpbase.02.01.00.122-33.XNA.pkg
57614 -rw- 21946572 May 22 2008 11:26:25 -07:00
asr1000rp1-rpcontrol.02.01.00.122-33.XNA.pkg
57615 -rw- 48099532 May 22 2008 11:26:26 -07:00
asr1000rp1-rpios-adventerprisek9.02.01.00.122-33.XNA.pkg
57616 -rw- 34324684 May 22 2008 11:26:27 -07:00
asr1000rp1-sipbase.02.01.00.122-33.XNA.pkg
57617 -rw- 22124748 May 22 2008 11:26:28 -07:00
asr1000rp1-sipspa.02.01.00.122-33.XNA.pkg
57603 -rw- 6256 May 22 2008 11:26:28 -07:00 packages.conf
13 -rw- 45977 Apr 9 2008 16:48:46 -07:00 target_support_output.tgz.tgz
OL-16506-17
928862208 bytes total (286662656 bytes free)
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-11
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Extracting the SubPackages and the Provisioning File: Example 2
The following example shows how to extract the individual subpackages and the provisioning file from
a consolidated package that has already been placed on the router in a directory that will not store the
individual subpackages and the provisioning file. In this particular example, the contents of a
consolidated package stored in usb0: are extracted into bootflash:.
Output of the bootflash: directory before and after the extraction is given to confirm the files were
extracted:
Router# dir usb0:
Directory of usb0:/
1240 -rwx 208904396 May 27 2008 14:10:20 -07:00
asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin
255497216 bytes total (40190464 bytes free)
Router# dir bootflash:
Directory of bootflash:/
11 drwx 16384 Dec 13 2004 03:45:47 -08:00 lost+found
87937 drwx 4096 Dec 13 2004 03:46:45 -08:00 .rollback_timer
14657 drwx 4096 Dec 13 2004 03:47:17 -08:00 .installer
29313 drwx 4096 Dec 13 2004 03:53:00 -08:00 .ssh
12 -rw- 33554432 Dec 13 2004 03:53:49 -08:00 nvram_00100
58625 drwx 4096 May 7 2008 17:27:51 -07:00 .prst_sync
11 drwx 16384 Dec 13 2004 03:45:47 -08:00 lost+found
87937 drwx 4096 Dec 13 2004 03:46:45 -08:00 .rollback_timer
14657 drwx 4096 Dec 13 2004 03:47:17 -08:00 .installer
29313 drwx 4096 Dec 13 2004 03:53:00 -08:00 .ssh
12 -rw- 33554432 Dec 13 2004 03:53:49 -08:00 nvram_00100
43979 -rw- 47071436 May 27 2008 14:25:01 -07:00
asr1000rp1-espbase.02.01.00.122-33.XNA.pkg
58625 drwx 4096 May 7 2008 17:27:51 -07:00 .prst_sync
43970 -rw- 5740 May 27 2008 14:25:00 -07:00
asr1000rp1-packages-adventerprisek9.02.01.00.122-33.XNA.conf
43980 -rw- 20334796 May 27 2008 14:25:01 -07:00
asr1000rp1-rpaccess.02.01.00.122-33.XNA.pkg
43981 -rw- 22294732 May 27 2008 14:25:02 -07:00
asr1000rp1-rpbase.02.01.00.122-33.XNA.pkg
43982 -rw- 21946572 May 27 2008 14:25:03 -07:00
asr1000rp1-rpcontrol.02.01.00.122-33.XNA.pkg
43983 -rw- 48099532 May 27 2008 14:25:04 -07:00
asr1000rp1-rpios-adventerprisek9.02.01.00.122-33.XNA.pkg
43984 -rw- 34324684 May 27 2008 14:25:05 -07:00
asr1000rp1-sipbase.02.01.00.122-33.XNA.pkg
43985 -rw- 22124748 May 27 2008 14:25:05 -07:00
asr1000rp1-sipspa.02.01.00.122-33.XNA.pkg
43971 -rw- 6256 May 27 2008 14:25:05 -07:00 packages.conf
4-12
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
945377280 bytes total (478752768 bytes free)
Extracting the SubPackages, Configuring the Router to Boot Using the Provisioning File, and Reloading the Router:
Example 3
In the following example, the provisioning file and the individual subpackages are extracted from a
consolidated package. The router is then configured to boot using the provisioning file. This example
also shows the config-register being set and the running configuration being saved because these tasks
must be performed for the router to reload properly. The router is then reloaded to complete the process.
11 drwx 16384 Dec 4 2007 04:32:46 -08:00 lost+found
86401 drwx 4096 Dec 4 2007 06:06:24 -08:00 .ssh
14401 drwx 4096 Dec 4 2007 06:06:36 -08:00 .rollback_timer
28801 drwx 4096 Mar 18 2008 17:31:17 -07:00 .prst_sync
43201 drwx 4096 Dec 4 2007 04:34:45 -08:00 .installer
12 -rw- 208904396 May 9 2008 14:36:31 -07:00
asr1000rp1-adventerprisek9.02.01.00.122-33.XNA.bin
57611 -rw- 47071436 May 22 2008 11:26:23 -07:00
asr1000rp1-espbase.02.01.00.122-33.XNA.pkg
57602 -rw- 5740 May 22 2008 11:26:22 -07:00
asr1000rp1-packages-adventerprisek9.02.01.00.122-33.XNA.conf
57612 -rw- 20334796 May 22 2008 11:26:24 -07:00
asr1000rp1-rpaccess.02.01.00.122-33.XNA.pkg
57613 -rw- 22294732 May 22 2008 11:26:24 -07:00
asr1000rp1-rpbase.02.01.00.122-33.XNA.pkg
57614 -rw- 21946572 May 22 2008 11:26:25 -07:00
asr1000rp1-rpcontrol.02.01.00.122-33.XNA.pkg
57615 -rw- 48099532 May 22 2008 11:26:26 -07:00
asr1000rp1-rpios-adventerprisek9.02.01.00.122-33.XNA.pkg
57616 -rw- 34324684 May 22 2008 11:26:27 -07:00
asr1000rp1-sipbase.02.01.00.122-33.XNA.pkg
57617 -rw- 22124748 May 22 2008 11:26:28 -07:00
asr1000rp1-sipspa.02.01.00.122-33.XNA.pkg
57603 -rw- 6256 May 22 2008 11:26:28 -07:00 packages.conf
13 -rw- 45977 Apr 9 2008 16:48:46 -07:00 target_support_output.tgz.tgz
OL-16506-17
928862208 bytes total (286662656 bytes free)
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-13
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Router(config)# no boot system
Router(config)# config-register 0x2102
Router(config)# boot system flash bootflash:packages.conf
Router(config)# exit
Router# copy run start
Router# reload
Copying a Set of Individual SubPackage Files, and Booting Using a Provisioning File
To copy a set of individual subpackage files and to boot using a provisioning file, perform the following
steps:
NoteAlthough this upgrade method works, it is less efficient than other methods of upgrading the router’s
software.
Step 1Copy each individual subpackage and the provisioning file into the bootflash: directory using the copy
command. Note that this method of running the router will only work if all the individual subpackages
for a release and a provisioning file are downloaded onto the router and stored in the bootflash: directory.
No other file directories should be used for booting the router using individual subpackages.
The files can also be moved on the router physically using a USB Flash drive.
Step 2Configure the router to boot using the provisioning file.
The sequence below provides an example that describes how to boot the router using the provisioning
file named packages.conf that was stored with the other subpackages in the bootflash: file system. The
router runs using individual subpackages once the reload is complete.
Router(config)# no boot system
Router(config)# config-register 0x2102
Router(config)# boot system flash bootflash:packages.conf
Router(config)# exit
*May 11 01:31:04.815: %SYS-5-CONFIG_I: Configured from console by con
Router# write memory
Building configuration...
[OK]
Router# reload
Managing and Configuring a Router to Run Using Optional SubPackages
To manage and configure a Cisco ASR 1000 Series Router to run using optional subpackages, perform
the following tasks:
• Installing an Optional SubPackage, page 4-15
• Uninstalling an Optional SubPackage, page 4-16
4-14
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
Installing an Optional SubPackage
NoteIf you install the Cisco WebEx Node for ASR 1000 Series SPA before the software subpackage is
installed, you will receive the error message %ASR1000_RP_SPA-3-MISSING_SPA_PKG_ERR. This
message will resolve once you download and install the appropriate sipspawma subpackage and then
reload the router in individual subpackage mode.
To run the router using an optional subpackage, perform the following steps for each RP in the system:
Step 1Verify that the RP is running in individual subpackage mode and was booted from a provisioning file.
For more information, see the “Managing and Configuring a Router to Run Using Individual
SubPackages From a Consolidated Package” section on page 4-10.
Step 2Verify that the version of the optional subpackage that you want to install is the same version as the
software running on the active RP.
Step 3Download the optional subpackage that you want to install. Optional subpackages must be downloaded
independently from consolidated packages for the Cisco ASR 1000 Series Routers.
Step 4On each RP, copy the optional subpackage to the directory where any other individual subpackages and
the provisioning file is located.
Step 5Run the request platform software package install rp file command, as shown in the following
example.
NoteDo not use the optional slot or bay keywords for the initial installation.
WARNING: No package of type sipspawmak9 is installed.
WARNING: Package will be installed for all SIP slots and bays.
OL-16506-17
Finished image file verification
--- Starting candidate package set construction --- Verifying existing software set
Processing candidate provisioning file Constructing working set for candidate package set
Constructing working set for running package set Checking command output Constructing
merge of running and candidate packages Checking if resulting candidate package set would
be complete Finished candidate package set construction
--- Starting compatibility testing --Determining whether candidate package set is compatible
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-15
Chapter 4 Consolidated Packages and SubPackages Management
Managing and Configuring the Router to Run Using Consolidated Packages and Individual SubPackages
WARNING:
WARNING: Candidate software combination not found in compatibility database
WARNING:
Determining whether installation is valid
WARNING:
WARNING: Candidate software combination not found in compatibility database
WARNING:
Software sets are identified as compatible Checking IPC compatibility with running
software Checking candidate package set infrastructure compatibility Checking
infrastructure compatibility with running software Checking package specific compatibility
Finished compatibility testing
--- Starting list of software package changes --- No old package files removed New files
list:
Added asr1000rp1sipspawmak9.BLD_V122_33_XND_ASR_RLS4_THROTTLE_LATEST_20090511_042308.pkg
Finished list of software package changes
--- Starting candidate package set construction --- Verifying existing software set
Processing candidate provisioning file Constructing working set for candidate package set
Constructing working set for running package set Checking command output Constructing
merge of running and candidate packages Checking if resulting candidate package set would
be complete Finished candidate package set construction
--- Starting compatibility testing --Determining whether candidate package set is compatible Determining whether installation
is valid Software sets are identified as compatible Checking IPC compatibility with
running software Checking candidate package set infrastructure compatibility Checking
infrastructure compatibility with running software Checking package specific compatibility
Finished compatibility testing
--- Starting list of software package changes --- Old files list:
Removed asr1000rp1sipspawmak9.BLD_V122_33_XND_ASR_RLS4_THROTTLE_LATEST_20090511_042308.pkg
No new package files added
Finished list of software package changes
--- Starting analysis of software changes --- Finished analysis of software changes
--- Starting update running software --- Blocking peer synchronization of operating
information Creating the command set placeholder directory
Finding latest command set
Finding latest command shortlist lookup file
Finding latest command shortlist file
Assembling CLI output libraries
Assembling CLI input libraries
Applying interim IPC and database definitions
Replacing running software
Replacing CLI software
Restarting software
Restarting software: target frus filtered out ... skipped
Applying final IPC and database definitions
Generating software version information
Notifying running software of updates
Unblocking peer synchronization of operating information Unmounting old packages
Cleaning temporary installation files
Finished update running software
SUCCESS: Finished installing software.
Step 2Use the show version provisioned command to verify that the optional subpackage is no longer
installed.
Step 3(Optional) Use the request platform software clean command to remove the unused packages.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
4-17
Chapter 4 Consolidated Packages and SubPackages Management
Upgrading Individual SubPackages
Troubleshooting Software Mismatch with ESP Board ASR1000-ESP10-N
The Cisco ASR 1000 ESP board ASR1000-ESP10-N enables you to install a Cisco ASR 1000 Series
Aggregation Services Router without encryption features. This unrestricted product format, in which all
encryption chips have been removed, can be provided in the Cisco ASR 1002, 1004, and 1006 Series
Routers. This ESP must be used with the appropriate Cisco IOS XE 2.2 image that does not contain
encryption software.
You cannot load Cisco IOS XE software images or subpackages which contain encryption software, onto
a Cisco ASR 1000 Series Router that contains the non crypto enabled ESP board (ASR1000-ESP10-N).
As soon as the combination of an encryption-enabled Cisco IOS XE image and encryption-disabled ESP
is detected—on bootup, online removal or insertion, or during an install—a message is emitted:
ESP[0|1] does not support strong cryptography. Chassis will reload.
The Route Processor (RP) then reloads the chassis and reboots continuously.
To troubleshoot this problem, follow these steps:
Step 1Enable ROM Monitor (ROMmon) mode by entering the reload command.
Step 2Press the Break key during the first 60 seconds while the system is booting.
Step 3Force the system to remain in ROMmon mode, waiting for manual bootup, by entering the command:
confreg 0x0.
Step 4Load the latest Cisco IOS XE package or subpackages that are compatible with the ASR1000-ESP10-N
ESP board.
Compatible subpackages include:
–
Cisco ASR1000 Series RP1 IP BASE W/O CRYPTO
–
Cisco ASR1000 Series RP1 ADVANCED IP SERVICES W/O CRYPTO
–
Cisco ASR1000 Series RP1 ADVANCED ENTERPRISE SERVICES W/O CRYPTO
Step 5Remove the forced manual boot mode by entering the command: confreg config register setting, where
config register setting is the default for the user system, often 0x2102.
Step 6Reboot the system.
Upgrading Individual SubPackages
One consolidated package contains seven individual subpackages. Each individual subpackage can be
upgraded independently.
When using this method to upgrade subpackages, however, remember that all subpackages that are part
of the same consolidated package should be used together on the Cisco ASR 1000 Series Routers.
Individual subpackage upgrades are atypical on the Cisco ASR 1000 Series Routers, because it is very
rare to experience a case where a single subpackage is upgraded without upgrading all the subpackages
from the consolidated package. Individual subpackage upgrades are most useful when only a single
subpackage of an otherwise functioning set of subpackages requires an upgrade.
This section uses the SPA subpackage installation to illustrate an individual subpackage upgrade.
Although it does not comprehensively cover every possible individual subpackage upgrade scenario, the
CLI for each type of upgrade is similar.
4-18
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 4 Consolidated Packages and SubPackages Management
Upgrading a SPA SubPackage
In the following example, the request platform software package install command is used to upgrade
a SIPSPA subpackage for the SPA in bay 0 of the SIP in router slot 1. In this example, the force option,
which forces the upgrade past any prompt (such as already having the same subpackage installed), is
used.
CautionDo not run your router using subpackages from different consolidated packages.
The Cisco ASR 1000 Series Router is not designed to use multiple subpackages from different
consolidated packages. Running subpackages from different consolidated packages is not recommended
and can cause unpredictable router behavior.
Individual subpackages should only be upgraded individually if you or a Cisco customer support
representative has determined that upgrading to the same subpackage that is running could have some
benefit for your Cisco ASR 1000 Series Router.
Router# request platform software package install rp 0 file
bootflash:asr1000rp1-sipspa.02.01.00.122-33.XNA.pkg slot 1 bay 0 force
--- Starting installation state synchronization --Finished installation state synchronization
--- Starting candidate package set construction --Verifying existing software set
Processing candidate provisioning file
Constructing working set for candidate package set
Constructing working set for running package set
Checking command output
Constructing merge of running and candidate packages
Finished candidate package set construction
--- Starting compatibility testing --Determining whether candidate package set is compatible
WARNING:
WARNING: Candidate software combination not found in compatibility database
WARNING:
OL-16506-17
Determining whether installation is valid
Software sets are identified as compatible
Checking IPC compatibility with running software
Checking candidate package set infrastructure compatibility
Checking infrastructure compatibility with running software
Finished compatibility testing
--- Starting impact testing --Checking operational impact of change
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
Committing provisioning file
Finished commit of software changes
--- Starting analysis of software changes --Finished analysis of software changes
--- Starting update running software --Blocking peer synchronization of operating information
Creating the command set placeholder directory
Finding latest command set
Assembling CLI output libraries
Assembling CLI input libraries
Applying interim IPC and database definitions
interim IPC and database definitions applied
Replacing running software
Replacing CLI software
Restarting software
Restarting SPA CC1/0
Applying interim IPC and database definitions
Notifying running software of updates
Unblocking peer synchronization of operating information
Unmounting old packages
Cleaning temporary installation files
Finished update running software
SUCCESS: Finished installing software.
Chapter 4 Consolidated Packages and SubPackages Management
Router#
4-20
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
CHA P T ER
5
Software Upgrade Processes Supported by
Cisco ASR 1000 Series Routers
Cisco ASR 1000 Series Aggregation Services Routers support the following software upgrade
procedures:
• In-Service Software Upgrades (ISSU) for redundant platforms—The ISSU process allows software
to be updated or otherwise modified while packet forwarding continues with minimal interruption.
ISSU supports two different software upgrade modes:
–
Consolidated package mode
–
Subpackage mode
The supported platforms include Cisco ASR 1006 and Cisco ASR 1013 Routers.
• Upgrade process with service impact for non redundant platforms—Non-hardware-redundant
chassis models (such as the Cisco ASR 1001 Router, Cisco ASR 1001-X Router, Cisco ASR 1002
Router, Cisco ASR 1002-X Router, and Cisco ASR 1004 Router) do not support ISSU upgrade or
downgrade. Instead subpackage software upgrade is supported only if the router is running in
subpackage mode.Traffic loss cannot be avoided during the installation of the ESP package as a part
of ISSU.
Table 5-1 lists Compatibility matrix of the software upgrade process for various Cisco ASR 1000 Series
Aggregation Services Router.
OL-16506-17
Table 5-1Software Upgrade Compatibility Matrix for Various Cisco ASR 1000 Series
Aggregation Services Router Platforms
Platform Consolidated PackageSubPackage
Cisco ASR 1006 RouterSupportedSupported
CiscoASR 1013 RouterSupportedSupported
CiscoASR 1004 RouterNot SupportedSupported
CiscoASR 1002 RouterNot Supported Supported
Cisco ASR 1002-X Router Not SupportedSupported
CiscoASR 1002-F Router Not SupportedSupported
CiscoASR 1001 RouterNot SupportedSupported
CiscoASR 1001-X Router Not SupportedSupported
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-1
Contents
Contents
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach
links to specific feature documentation in this module and to see a list of the releases in which each feature is
supported, use the “Feature Information for Software Upgrade Process” section on page 5-251.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS
software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An
account on Cisco.com is not required.
This guide discusses various software upgrade procedures and contains the following sections:
• Prerequisites for Software Upgrade Processes, page 5-2
• ISSU Upgrade for Redundant Platforms, page 5-2
• Upgrade Process with Service Impact for Nonredundant Platforms, page 5-74
• Minimal Disruptive Restart ISSU, page 5-152
Prerequisites for Software Upgrade Processes
Be sure to complete the following prerequisites for running the ISSU process based on your chassis
model:
• Refer to the ISSU compatibility tables in the Release Notes for Cisco ASR 1000 Series Aggregation
Services Routers.
• 4 GB of DRAM memory is required for installing software upgrade on a system with RP1 route
processor.
• ISSU is supported when the router is running in subpackage mode or in consolidated package mode.
• For the Cisco ASR 1001 Router, Cisco ASR 1001-X Router and Cisco ASR 1002-X Router, the
Cisco IOS Software redundancy requires 8-GB DRAM and the IOS software redundancy license.
ISSU Upgrade for Redundant Platforms
ISSU represent a full or partial software upgrade of a system from one version to another with minimal
outage on the forwarding plane (minimal packet loss) and no outage on the control plane.
This section covers the following topics:
5-2
• Overview of ISSU on the Cisco ASR 1000 Series Routers, page 5-3
• ISSU Upgrade Procedures, page 5-6
• In Service One-Shot Software Upgrade Procedure, page 5-71
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Overview of ISSU on the Cisco ASR 1000 Series Routers
For the Cisco ASR 1000 Series Routers, ISSU-compatibility depends on the software subpackage being
upgraded and the hardware configuration. Consolidated packages are ISSU-compatible in dual RP
configurations only and have other limitations described later in this document. Some RP and ESP
software subpackages can be upgraded in service even in single RP or ESP hardware configurations via
dual IOS processes running on the RP; others require dual RP or ESP configurations for an ISSU
upgrade. The SPA and SIP software subpackages must be upgraded on a per-SPA or per-SIP basis. See
Table 5-2 to view an In Service table that addresses the contexts where limited interruption upgrades can
be performed.
If you are updating multiple subpackages, you should also realize that the sequence of the upgrade is
important to minimize router downtime for the software upgrade (see the “Using ISSU to Upgrade
Subpackages (Prior to Cisco IOS XE Release 2.1.2)” section on page 5-72).
The specific procedures in this document represent supported and tested installation sequences. The
Cisco IOS XE system software allows other installation sequences for special purposes under the
guidance of Cisco customer support representatives, but the steps in this document should be followed
otherwise. These steps should be followed completely, as the Cisco ASR 1000 Series Routers are
designed to run one version of Cisco IOS XE for all consolidated packages and subpackages on an RP,
and running subpackages from different versions of Cisco IOS XE can cause unexpected router behavior.
When performing ISSU upgrades on the Cisco ASR 1000 Series Routers, it is important to remember
that minimal interruption upgrades can be performed using either the issu command set or the request platform command set, and that either command set can be used to perform limited interruption
individual consolidated package or subpackage upgrades.
ISSU Upgrade for Redundant Platforms
NoteROMmon images are downloaded separately from Cisco IOS XE images and have their own installation
procedures, and are therefore not mentioned as part in this document as part of the ISSU upgrade
procedure.
Table 5-2 provides a list of the Cisco ASR 1000 Series Routers subpackages and whether or not they can
be upgraded without losing any network traffic in single and dual RP and ESP configurations using
ISSU.
SubpackageNonredundant RP and ESPRedundant RP and ESP
SIPSPA
ELCBase
ELCSPA
NIM SSD
7
8
9
10
NGWIC T1E1
1. Only supported if software redundancy is configured on the RP.
2. ESP has to reload to complete ESPBase subpackage upgrade. All router traffic will be lost during ESP upgrade.
3. An ESP switchover occurs as part of the upgrade, so traffic is forwarded with minimal interruption.
4. ESP has to reload to complete ESPBase subpackage upgrade. All router traffic will be lost during ESP upgrade and
ESPX86Base is not included in the RP1 bundle.
5. An ESP switchover occurs as part of the upgrade, so traffic is forwarded with minimal interruption.ESPX86Base is not
included in the RP1 bundle.
6. Any SIPBase upgrade will require the SPA interfaces to go down during the upgrade for all the SPAs in the SIP.
7. Any SIPSPA upgrade will require the SPA interfaces for that particular SPA to go down during the upgrade.
8. Any ELCBase upgrade will require the ELC interfaces to go down during the upgrade for all the SPAs in the SIP. ELCBase
is not included in the RP1 bundle
9. Any ELCSPA upgrade will require the ELC interfaces for that particular SPA to go down during the upgrade. ELCSPA is not
included in the RP1 bundle
10. NIM SSD is a built-in module available in ASR 1001-X platform. It is a slot for an extra harddisk, which helps increase the
memory.
11. NGWIC T1E1 is a built-in module available in ASR 1001-X platform, used for serial interface. Any NGWIC T1E1 upgrade
will require T1E1 interfaces for that particular SPA to go down during the upgrade.
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
No (SPAs in SIP do not forward
traffic during upgrade)
No (Built-in SPAs in an Ethernet
Line Card (ELC) do not forward
traffic during upgrade)
No (Built-in SPAs in an ELC do
not forward traffic during
upgrade)
No (NIM reload required)
11
No (T1E1 do not forward traffic
during upgrade)
Yes (With MDR, traffic is
forwarded with minimal
interruption)
Yes (With MDR, traffic is
forwarded with minimal
interruption)
Yes (With MDR, traffic is
forwarded with minimal
interruption)
NA
NA
ISSU Rollback Timer Overview
The Cisco ASR 1000 Series Router ISSU procedure has a rollback timer. Rollback timers are used for
for ISSU procedures on all Cisco routers that support ISSU, but this section will provide a brief overview
of ISSU rollback timers on the Cisco ASR 1000 Series Routers.
During ISSU, the rollback timer begins after the consolidated package or subpackage is loaded. If the
upgrade does not move forward in the amount of time specified in the rollback timer, the configuration
will automatically “roll back” to the previous configuration and the ISSU upgrade will be cancelled.
Upgrades using the issu command set and the request platform command set both have the rollback
timer option. The issu command set always uses a rollback timer; the request platform command set
does not use a rollback timer unless the auto-rollback option is used in the request platform software package install command line.
For the issu command set, the issu acceptversion command can be entered to stop the rollback timer
without committing the upgrade during the ISSU upgrade. The issu commitversion command can be
entered to stop the rollback timer and commit the ISSU upgrade.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-4
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
For the request platform command set, the request platform software package install rp slot commit
command must be entered to stop the rollback timer only in cases where the auto-rollback option is
used.
The rollback timer for the issu command set can be configured by entering the issu set rollback-timer
command. The rollback timer when used with the request platform command set is specified when you
use the auto-rollback option when entering the issu request platform software package install
command.
For ISSU upgrades on Cisco ASR 1000 Series Routers, it may be advisable to set long rollback times
when the upgrade is being performed on routers with large configurations.
The amount of time left on the rollback timer during an ISSU upgrade can be checked by entering the
show issu rollback-timer command.
Software Upgrade with Dual IOS Processes on a Single RP Overview
To complete a software upgrade of an individual subpackage using dual IOS processes on a single RP,
SSO must first be enabled.
Software upgrade with dual IOS processes is useful for upgrading the individual RP subpackages that
can be upgraded without a router reload. See Table 5- 2 for a list of these subpackages. Importantly, note
that most subpackage upgrades in a single RP configuration require a hardware reload to complete
(whether an RP reload for an RP subpackage, an ESP reload for the ESPBase subpackage, a SIP reload
for a SIPBase subpackage, or a SPA reload for the SIPSPA subpackage), so limited interruption upgrades
for single RP configurations are not available in most upgrade scenarios.
For information on configuring a second IOS process on a single RP, see the “Using Subpackages for
Software Upgrade on a Cisco ASR 1002 Router or Cisco ASR 1004 Router (software upgrade Command
Set)” section on page 5-91.
ISSU Upgrade for Redundant Platforms
Cisco IOS XE Software Package Compatibility for ISSU
When upgrading the Cisco IOS XE operating system software using the ISSU process, it is important to
determine the compatibility of the upgraded software to your current software and hardware. The ISSU
process allows software to be updated or otherwise modified while packet forwarding continues with
minimal interruption.
Cisco IOS XE release compatibility using the ISSU process utilizes the SSO functionality to preserve
state while software versions on the router differ, as during an upgrade. Most SSO-capable features in
each Cisco IOS XE release are ISSU capable. ISSU is only supported if SSO is enabled in the
configuration and the system is in a steady state (SSO ready state has been achieved). ISSU compatibility
depends on the set of specific feature clients that are in use and whether they support ISSU. All ISSU
upgrades include at least one IOS switchover operation. It is important to understand which features are
in use and whether these features are ISSU compatible.
Cisco ASR1006 or ASR 1013 series routers are hardware-redundant chassis. The hardware-redundant
chassis has two ESP linecards and two RPs which exchange state using hardware links. The Cisco
ASR1002 and ASR1004 Series Routers are not hardware redundant, but are software-redundancy
capable. The nonredundant chassis has a single RP and a single ESP, but allows the operation of up to
two IOS processes on the single RP to exchange states locally.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-5
ISSU Upgrade for Redundant Platforms
Restrictions for ISSU
Restrictions for the ISSU procedures include:
NoteCisco IOS XE software compatibility is between “like” images, for example, advipservicesk9 to
advipservicesk9, adventerprisek9 to adventerprisek9, and so on. Cross-image-type upgrades or
installations are not supported in the ISSU process. For example, you cannot upgrade ipbase to
advipservicesk9 or advipservices to advipservicesk9.
• Different image types must not be run simultaneously.
• For ATM SPAs on the Cisco ASR1000 Series Routers, ISSU from releases prior to Cisco IOS XE
Release 2.5.0 to Cisco IOS XE Release 2.5.0, or from Cisco IOS XE Release 2.5.0 to a release prior
to Cisco IOS XE Release 2.5.0, is not supported. If you want to perform ISSU in this environment,
you must first remove the configuration from the ATM SPAs on the router, and then shut down the
SPAs using the shutdown command prior to running the ISSU process.
• Cisco IOS XE releases not listed as compatible in the ISSU compatibility tables (documented in the
Release Notes for Cisco ASR 1000 Series Aggregation Services Routers as stated in the
“Prerequisites for Software Upgrade Processes” section on page 5-2) must not be run
simultaneously (in a Cisco ASR1006 series router or Cisco ASR 1013 series router) or co-installed
on any of the Cisco ASR1000 Series Routers since unexpected failures of one or both RPs or state
loss can be experienced. Cisco IOS XE releases listed as partially compatible may incur a loss of
state. Cisco IOS XE releases listed as requiring an intermediate release are not directly compatible;
however, a migration path is available to preserve some or all state by upgrading to a separate
intermediate version, as shown in the tables. The tables do not cover nonredundant (software or
hardware) environments as no incremental update is possible under those circumstances.
• In Cisco IOS XE Release 3.1S, ISSU upgrade and subpackage software upgrade from Cisco IOS XE
Release 2.x.x to Cisco IOS XE Release 3.x.xS, including release 3.1S, are not supported. The ISSU
downgrade from Cisco IOS XE Release 3.x.xS, including release 3.1S to 2.x.x, is also not supported.
ISSU upgrade and subpackage software upgrade is restarted from Cisco IOS XE Release 3.1S.
Therefore, rebuilds and releases after Cisco IOS XE Release 3.1S will support ISSU and software
upgrade and downgrade, based on the ISSU compatibility matrix tables.
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
NoteWhen you run the software upgrade from Cisco IOS XE Release 2.x.x to Cisco IOS XE Release 3.x.xS,
you have to load the new image on both RPs, verify that it is good code, change the boot loader variable,
and reboot the whole chassis. Failure to do that results in a "wedged" router and the only remedy is
physically pull out one of the RPs, boot on the remaining RP, downgrade its code to the same version as
the pulled out RP and start the process over again.
ISSU Upgrade Procedures
This section contains the following topics:
• Using ISSU to Perform a Consolidated Package Upgrade in a Dual Route Processor Configuration,
page 5-7
• Using ISSU to Upgrade the Subpackages in a Dual Route Processor Configuration, page 5-13
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-6
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
ISSU Upgrade for Redundant Platforms
Using ISSU to Perform a Consolidated Package Upgrade in a Dual Route Processor Configuration
Consolidated packages can only be upgraded using ISSU in dual Route Processor configurations. ISSU
is not supported for consolidated package upgrades in single Route Processor configurations.
If you want the RPs on your Cisco ASR 1000 Series router to be running using a consolidated package
after the ISSU upgrade is complete, use the following instructions:
NoteThis procedure will only work if the current RPs are already running consolidated packages.
Router# dir bootflash:
Router# dir stby-bootflash:
issu loadversion rp upgrade-rp-number
standby-file-system:filename
Example:
Router# issu loadversion rp 1 file
stby-bootflash:asr1000rp1-adventerprisek9.02.01.01.12
2-33.XNA1.bin
(Optional) Display the contents of the target
directories to confirm the successful copy of the file
package.
Load the target consolidated package onto the
standby RP.
After you receive the message indicating that the
terminal state has been reached, go on to Step 6.
5-8
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Command or ActionPurpose
Step 6
Step 7
Step 8
Step 9
issu runversion
Example:
Router# issu runversion
telnet ip-address port
Example:
[unix-server-1 ~]$ telnet 172.17.52.157 2003
User Access Verification
Username: user
Password: ********
Router>
issu acceptversion
Example:
Router# issu acceptversion
issu commitversion
ISSU Upgrade for Redundant Platforms
Run the consolidated package that was loaded in
Step 5.
NoteIf this command is entered before the
terminal state is reached, a “
” or “Standby RP is not in
online
terminal state
” error message will be seen
peer is not
and the issu runversion command will not
work. If the issu runversion command does
not run for these reasons, wait for the
“
terminal state is reached” message to
appear and retry the issu runversion
command. You can also monitor the terminal
state using the show platform command.
After ISSU runversion is completed, a switchover
will automatically occur and the standby RP will
become the active RP.
Log in to the RP being upgraded, preferably using
the RP’s console port, to complete the upgrade. (This
is the new active RP, that was the standby RP prior to
the ISSU process.)
NoteEnsure the hostname does not end in “-stby”
after logging into the RP, as this indicates
that the RP being accessed is still the standby
RP.
There are many ways to log on to a console port. The
example shows access to the console port from a
UNIX host using telnet.
(Optional) Stops the ISSU rollback timer.
This step is optional as long as Step 9 is completed
before the rollback timer expires.
Completes the ISSU upgrade.
Example:
Router# issu commitversion
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-9
ISSU Upgrade for Redundant Platforms
Command or ActionPurpose
Step 10
Step 11
show version
show version active-RP running
show version active-RP provisioned
show platform
show running-configuration
hw-module slot RP-slot reload
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
(Optional) Enter the show version, show platform,
or show running-configuration commands to
confirm that the upgrade completed successfully, as
follows:
• show version—Confirm that the correct
software version is running on your router and
that the RP was booted from the correct file.
• show running-configuration—Confirm that
the booting configuration, in particular the boot
system statements, are correct.
TipUse the show running-config | include boot
command to display only the boot statements
from the show running-configuration
output.
• show platform— Confirm that both RP0 and
RP1 are correctly running as active and standby.
Reload the new software on the Standby RP.
Examples
Example:
Router# hw-module slot R0 reload
The following example shows how to perform consolidated package upgrade in a dual route processor
configuration:
Router(config)# ip tftp source-interface gigabitethernet 0
Router# copy tftp bootflash:
Address or name of remote host []? 172.17.16.81
Source filename []?
/auto/tftp-users/user/asr1000rp1-adventerprisek9.02.01.01.122-33.XNA1.bin
Destination filename [asr1000rp1-adventerprisek9.02.01.01.122-33.XNA1.bin]?
Accessing
tftp://172.17.16.81//auto/tftp-users/user/asr1000rp1-adventerprisek9.02.01.01.122-33.XNA1.
bin...
Loading /auto/tftp-users/user/asr1000rp1-adventerprisek9.02.01.01.122-33.XNA1.bin from
*Jul 21 23:37:25.480: %REDUNDANCY-5-PEER_MONITOR_EVENT: Active detected a standby
insertion (raw-event=PEER_REDUNDANCY_STATE_CHANGE(5))
Finished installation state synchronization
*Jul 21 23:37:26.349: %REDUNDANCY-3-IPC: IOS versions do not match.
*Jul 21 23:38:47.172: %HA_CONFIG_SYNC-6-BULK_CFGSYNC_SUCCEED: Bulk Sync succeeded
*Jul 21 23:38:47.173: %RF-5-RF_TERMINAL_STATE: Terminal state reached for (SSO)
Router# issu runversion
--- Starting installation state synchronization ---
Finished installation state synchronization
Initiating active RP failover
SUCCESS: Standby RP will now become active
PE23_ASR-1006#
System Bootstrap, Version 12.2(33r)XN2, RELEASE SOFTWARE (fc1)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 2008 by cisco Systems, Inc.
5-12
<additional output removed for brevity>
*Jul 21 23:43:31.970: %SYS-5-RESTART: System restarted -Cisco IOS Software, IOS-XE Software (PPC_LINUX_IOSD-ADVENTERPRISEK9-M), Version
12.2(33)XNA, RELEASE SOFTWARE (fc1)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2008 by Cisco Systems, Inc.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Compiled Thu 01-May-08 00:29 by mcpre
*Jul 21 23:43:31.978: %SSH-5-ENABLED: SSH 1.99 has been enabled
*Jul 21 23:43:35.196: Relay: standby progression done
*Jul 21 23:43:35.197: %PLATFORM-6-RF_PROG_SUCCESS: RF state STANDBY HOT
At this point of the procedure, use your UNIX client to log in to the other RP:
[unix-server-1 ~]$ telnet 172.17.52.157 2003
User Access Verification
*Jul 21 23:57:05.528: %ASR1000_OIR-6-ONLINECARD: Card (rp) online in slot R0
*Jul 21 23:57:25.480: %REDUNDANCY-5-PEER_MONITOR_EVENT: Active detected a standby
insertion (raw-event=PEER_FOUND(4))
*Jul 21 23:57:25.480: %REDUNDANCY-5-PEER_MONITOR_EVENT: Active detected a standby
insertion (raw-event=PEER_REDUNDANCY_STATE_CHANGE(5))
*Jul 21 23:58:47.172: %HA_CONFIG_SYNC-6-BULK_CFGSYNC_SUCCEED: Bulk Sync succeeded
*Jul 21 23:58:47.173: %RF-5-RF_TERMINAL_STATE: Terminal state reached for (SSO)
Using ISSU to Upgrade the Subpackages in a Dual Route Processor Configuration
OL-16506-17
This section provides instructions on performing an ISSU upgrade on a Cisco ASR 1000 Series Router
with dual RPs that is currently running individual subpackages.
This section covers the following topics:
• Using ISSU to Upgrade the Subpackages on a Cisco ASR 1006 or ASR 1013 Router (issu Command
Set), page 5-14
• Using ISSU to Upgrade Subpackages on a Cisco ASR 1006 Router or ASR 1013 Router (request
platform command set), page 5-43
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-13
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
ISSU Upgrade for Redundant Platforms
Using ISSU to Upgrade the Subpackages on a Cisco ASR 1006 or ASR 1013 Router (issu Command Set)
This section provides the instructions for performing an ISSU upgrade using subpackages on a Cisco
ASR 1006 router or ASR 1013 router with a dual RP setup using the issu command set.
This procedure can only be performed if the current ASR 1006 or ASR 1013 routers have two active RPs
and both RPs are running subpackages.
NoteIn step 9, each individual subpackage that was extracted in step 6 is copied to the directory where
the subpackages that are currently running the standby RP are stored.
10. issu loadversion rp standby-RPfile URL-to-standby-file-system:asr1000rp*version*.pkg force
11. hw-module slot standby-RPreload
12. issu loadversion rp active-RPfile
URL-to-active-file-system:asr1000rp2-{sipbase,sipspa}*version*.pkg slotSIP-slot-number force
issu commitversion
Repeat the step 12, for each available SIP installed in the router before moving onto the next step.
ISSU Upgrade for Redundant Platforms
13. issu loadversion rp active-RPfile
URL-to-active-file-system:asr1000rp2-{elcbase,elcspa}*version*.pkg slotELC-slot-number force
issu commitversion
Repeat the step 13, for each available ELC installed in the router before moving onto the next step.
14. issu loadversion rp active-RP file URL-to-active-file-system:asr1000rp2-esp*version*.pkg slot
standby-ESP-slot
issu commitversion
issu loadversion rp active-RP file URL-to-active-file-system:asr1000rp2-esp*version*.pkg slot
active-ESP-slot
issu commitversion
15. issu loadversion rp active-RP file URL-to-active-file-system:asr1000rp2*version*.pkg force
issu commitversion
16. show version active-RP provisioned
show version active-RP installed
17. redundancy force-switchover
18. request platform software package clean
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-15
ISSU Upgrade for Redundant Platforms
DETAILED STEPS
Command or ActionPurpose
Step 1
show version
show version
dir
filesystem: directory
show platform
show redundancy states
active-rp installed
Example:
Router# show version
Router# show version r0 installed
Router# dir bootflash:
Router# show platform
Router# show redundancy states
Step 2
copy running-config startup-config
Example:
Router# copy running-config startup-config
Step 3
mkdir URL-to-directory-name
Example:
Router# mkdir usb0:221subs
Step 4
ip tftp source-interface gigabitethernet port
Example:
Router(config)# ip tftp source-interface
gigabitethernet 0
Step 5
copy tftp: URL-to-target-location
Example:
Router# copy tftp: usb0:221subs
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
(Optional) Use the following commands to confirm the
current router configuration, as follows:
• show version and show version active-rp
installed—Verify the running version of the Cisco IOS
XE software on the router, and which file was used to
boot the router, and where that file is stored.
• dir—Confirm that the files that were used to boot the
router are located in the directory.
• show platform—Confirm the current status of the
active and standby RPs.
• show redundancy states—Confirm the operational
and configured redundancy states.
After you have confirmed that the system states are
acceptable, save the current configuration to the startup
configuration.
Create a directory to store the consolidated package and
subpackages.
This directory must be created in most cases because the
consolidated packages and subpackages have to be
separated from the subpackages that booted the router at
this step of the procedure.
Specifies the Gigabit Ethernet TFTP source-interface to be
configured:
slot/port—Specifies the location of the TFTP
source-interface.
NoteTo copy a file using TFTP through the Management
Ethernet interface, the ip tftp source-interface
GigabitEthernet 0 command must be entered
before entering the copy tftp command.
Copy the consolidated package file into the directory
created in Step 3.
The consolidated package in this step should not be copied
into the same directory where the subpackages that are
currently running your router are stored (the directory
containing the packages.conf provisioning file from which
the router was booted).
5-16
TipIt is recommended that you copy the package onto a
usb: or harddisk: file system for space
considerations when performing this step of the
procedure.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Extract the subpackages out of the consolidated package
file into the temporary directory.
NoteTake extra care to extract the subpackages to a
temporary subdirectory and do not delete any of the
files currently running the router at this point of the
procedure.
To erase the files that were running on the router
before the ISSU upgrade, enter the request platform software package clean command after
the ISSU upgrade has been completed.
(Optional) Display the directory to confirm that the files
were extracted.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
Copy the subpackages out of the temporary directory into
the directory on the router where the subpackages running
the standby RP are currently stored.
NoteMake sure to copy all the subpackage files extracted
in step 6 to the current active packages directory.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-19
ISSU Upgrade for Redundant Platforms
Command or ActionPurpose
Step 10
issu loadversion rp standby-RP file
target-standbyRP-URL-for-sub-packages:asr1000rp*
version*.pkg force
Example:
Router# issu loadversion rp 1 file
stby-bootflash:asr1000rp*03.13.00.S.154-3.S-ext
*.pkg force
Step 11
hw-module slot standby-RP reload
Example:
Router# hw-module slot R1 reload
Step 12
issu loadversion rp active-RP file
URL-to-active-file-system:asr1000rp2-{sipbase,sip
spa}*
version*.pkg slot SIP-slot-number force
issu commitversion
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Upgrade the RP subpackages on the standby RP, where the
“rp*” wildcard is specified to capture all of the RP
subpackages for the desired upgrade release.
Reload the standby RP.
Upgrade the SIP and SPA subpackages for each SIP on the
router.
NoteThis step must be completed one SIP at a time, and
repeated for each SIP installed on the router before
performing the next step.
Step 13
Example:
Router# issu loadversion rp 0 file
bootflash:asr1000rp2-{sipbase,sipspa}*03.13.00.
S.154-3.S-ext*.pkg slot 0 force
issu loadversion rp active-RP file
URL-to-active-file-system:asr1000rp2-{elcbase,elc
spa}*
version*.pkg slot SIP-slot-number force
issu commitversion
Repeat this step for each ELC installed in the
router before moving onto the next step.
Example:
Router# issu loadversion rp 0 file
bootflash:asr1000rp2-{elcbase,elcspa}*03.13.00.
S.154-3.S-ext*.pkg slot 0 force
TipYou can use the show ip interface brief command
to identify which slots contain SIPs and SPAs. The
interfaces with three numbers (in the form
SIP-number/SPA-number/interface-number)
identify the SIP and SPA locations in the router.
NoteThe pattern options used in this CLI (sipbase and
sipspa) were introduced in Cisco IOS XE Release
2.1.2 and are not available in previous Cisco IOS
XE Releases.
See the “ISSU Procedures (Prior to Cisco IOS XE
Release 2.1.2)” section on page 5-72 for pre-Cisco
IOS XE Release 2.1.2 ISSU upgrade procedures.
Upgrade the ELC and SPA subpackages for each ELC on
the router.
NoteThis step must be completed for one ELC at a time,
and repeated for each ELC installed on the router
before performing the next step.
TipYou can use the show ip interface brief command
to identify which slots contain ELCs and SPAs. The
interfaces with three numbers (in the form
ELC-number/SPA-number/interface-number)
identify the ELC and SPA locations in the router.
5-20
NoteThe pattern options used in this CLI (elcbase and
elcspa) were introduced in Cisco IOS XE Release
3.10S and are not available in previous Cisco IOS
XE Releases.
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
Router# issu loadversion rp 0 file
bootflash:asr1000rp2*03.13.00.S.154-3.S-ext*.pk
g force
issu commitversion
show version active-RP provisioned
show version
active-RP installed
ISSU Upgrade for Redundant Platforms
Upgrade the ESP Base subpackage on the standby and the
active ESPs.
After entering the issu loadversion rp command on the
active RP, the ESP switchover will occur automatically.
Minimal traffic interruption will occur as a result of this
switchover.
Upgrade all of the subpackages on the active RP.
NoteThis step is required to ensure that all subpackages
on the router were upgraded as part of this
procedure, and might upgrade some subpackages
that would otherwise be missed in the process.
(Optional) Confirm that the subpackages are provisioned
and installed.
Step 17
Step 18
Examples
Example:
Router# show version r0 provisioned
Router# show version r0 installed
redundancy force-switchover
Example:
Router# redundancy force-switchover
request platform software package clean
Example:
Router# request platform software package clean
The following example shows ISSU upgrade using subpackages on a Cisco ASR 1006 router or ASR
1013 router with a dual RP setup using the issu command set
Router# show version
Cisco IOS Software, IOS-XE Software (X86_64_LINUX_IOSD-ADVENTERPRISEK9-M), Version
15.3(2)S, RELEASE SOFTWARE (fc1)
<output removed for brevity>
System image file is "bootflash:Active_Dir/packages.conf"
Force an RP switchover to complete the upgrade.
(Optional) Removes all unused subpackages files from the
router.
OL-16506-17
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
5-21
ISSU Upgrade for Redundant Platforms
<output removed for brevity>
cisco ASR1013 (RP2) processor with 4208889K/6147K bytes of memory.
Processor board ID FOX1343GJGC 20 Gigabit Ethernet interfaces
6 Ten Gigabit Ethernet interfaces
32768K bytes of non-volatile configuration memory.
8388608K bytes of physical memory.
1925119K bytes of eUSB flash at bootflash:.
78085207K bytes of SATA hard disk at harddisk:.
2 ASR1000-SIP40 ok 1d03h
2/0 SPA-1X10GE-L-V2 ok 1d03h
2/1 SPA-1X10GE-L-V2 ok 1d03h
2/2 SPA-1X10GE-L-V2 ok 1d03h
2/3 SPA-1X10GE-L-V2 ok 1d03h
4 ASR1000-2T+20X1GE ok 1d03h
4/0 BUILT-IN-2T+20X1GE ok 1d03h
R0 ASR1000-RP2 ok, active 1d03h
R1 ASR1000-RP2 ok, standby 1d03h
F0 ASR1000-ESP100 ok, active 1d03h
F1 ASR1000-ESP100 ok, standby 1d03h
P0 ASR1013-PWR-AC ok 1d03h
P1 ASR1013-PWR-AC ok 1d03h
P2 ASR1013-PWR-AC ok 1d03h
P3 ASR1013-PWR-AC ps, fail 1d03h
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
stby-bootflash:Active_Dir/asr1000rp*03.13.00.S.154-3.S-ext*.pkg force
--- Starting local lock acquisition on R0 ---
Finished local lock acquisition on R0
--- Starting installation state synchronization ---
Finished installation state synchronization
--- Starting local lock acquisition on R1 ---
Finished local lock acquisition on R1
--- Starting file path checking ---
Finished file path checking
--- Starting image file verification ---
Checking image file names
Locating image files and validating name syntax
Found asr1000rp2-elcbase.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-elcspa.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-espbase.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-espx86base.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-rpaccess.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-rpbase.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-rpcontrol.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-rpios-adventerprisek9.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-sipbase.03.13.00.S.154-3.S-ext.pkg
Found asr1000rp2-sipspa.03.13.00.S.154-3.S-ext.pkg
Verifying image file locations
Inspecting image file types
WARNING: In-service installation of IOSD package
WARNING: requires software redundancy on target RP
WARNING: or on-reboot parameter
WARNING: Automatically setting the on-reboot flag
WARNING: In-service installation of RP Base package
WARNING: requires software reboot of target RP
Processing image file constraints
Creating candidate provisioning file
Finished image file verification
Chapter 5 Software Upgrade Processes Supported by Cisco ASR 1000 Series Routers
5-28
--- Starting candidate package set construction ---
Verifying existing software set
Processing candidate provisioning file
Constructing working set for candidate package set
Constructing working set for running package set
Checking command output
Constructing merge of running and candidate packages
Checking if resulting candidate package set would be complete
Finished candidate package set construction
--- Starting compatibility testing ---
Determining whether candidate package set is compatible
Determining whether installation is valid
Determining whether installation is valid ... skipped
Verifying image type compatibility
Checking IPC compatibility for candidate software
Checking candidate package set infrastructure compatibility
Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide
OL-16506-17
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.