Cisco Craft Works Interface Configuration Guide Cisco IOS XR Software Release 3.3

R3.3 Beta Draft—Cisco Confidential Information

Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100

Text Part Number: OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

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.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

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.

CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website 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. (0502R)

Preface v Document Revision History vi About This Document vi Intended Audience vi Organization of the Document vi Related Documentation vii Conventions vii Obtaining Documentation viii Cisco.com viii Product Documentation DVD viii Ordering Documentation viii Documentation Feedback ix Cisco Product Security Overview ix Reporting Security Problems in Cisco Products ix Obtaining Technical Assistance x Cisco Technical Support & Documentation Website x Submitting a Service Request xi Definitions of Service Request Severity xi Obtaining Additional Publications and Information xi

CHAPTER 1 About CWI Configuration Tools 1-13 CWI Introduction 1-13 Logical Router Configuration 1-14 CWI Logical View 1-14 Launching the CWI Configuration Desktop 1-15 Navigating the Configuration Desktop 1-16 Configuration Applications Tree 1-17 Configuration Applications Pane 1-18 Understanding CWI Configuration Options 1-19 CWI-Based Telnet Plus, Secure Shell, and Terminal Plus Configuration Sessions 1-19 CWI Configuration Editor and Replace Configuration Editor 1-20 CWI Graphical Configuration Features 1-21

Cisco Craft Works Interface Configuration Guide OL-8540-01 iii Contents

R3.3 Beta Draft—Cisco Confidential Information

CHAPTER 2 Managing Router Configuration with CWI 2-25 Opening a CLI Session Using the CWI Telnet Plus 2-25 Modifying an Existing Configuration Using the CWI Configuration Editor 2-27 Editing the Hyperlinks for an Existing Configuration 2-31 Modifying an Existing Configuration Using the CWI Graphical Configuration 2-32 Displaying an Uncommitted Configuration 2-34 Replacing the Entire Configuration 2-35

CHAPTER 3 Performing Bulk Configuration Using CWI 3-37 CWI Bulk Configurations Overview 3-37 Using an Existing Configuration Record as a Template to Modify Records 3-38 Using an Existing Configuration Record as a Template for Cloning 3-39 Deleting Multiple Rows of Configuration 3-41 Editing Multiple Rows of Configuration 3-41

G LOSSARY

I NDEX

Cisco Craft Works Interface Configuration Guide iv OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

Preface

Beta Draft Cisco Confidential Information

Cisco Craft Works Interface Configuration Guide provides information on how to configure the router from Cisco Craft Works Interface (CWI). CWI interface is designed to simplify and expedite router configuration and monitoring. This guide provides instructions on how to perform CWI configuration tasks. The following supplemental information is provided: • How to work with the variety of interfaces provided to manage the router: Telnet, the Cisco IOS XR software command-line interface (CLI), CWI, and the CWI Configuration Editor. • How a configuration is created, stored, committed, and managed. See the “Related Documentation” section on page vii for a complete listing of all available Cisco IOS XR documentation. For information about navigating CWI components, interface elements, and applications, see the Cisco Craft Works Interface User Interface Guide. For detailed information about Cisco IOS XR system configurations, see Cisco IOS XR Getting Started Guide. The preface contains the following sections: • Document Revision History, page vi • About This Document, page vi • Conventions, page vii • Obtaining Documentation, page viii • Documentation Feedback, page ix • Cisco Product Security Overview, page ix • Obtaining Technical Assistance, page x • Obtaining Additional Publications and Information, page xi

Cisco Craft Works Interface Configuration Guide OL-8540-01 v Preface Document Revision History R3.3 Beta Draft—Cisco Confidential Information Document Revision History

The Document Revision History table records technical changes to this document. Table 1 shows the document revision number for the change, the date of the change, and a brief summary of the change. Note that not all Cisco documents use a Change History Table.

Table 1 Change History Table

Revision Date Change Summary OL-8540-01 December 2005 Initial release of this document.

About This Document

The Cisco Craft Works Interface Configuration Guide provides information about configuring Cisco routers from the CWI Configuration Desktop. This guide provides the most important configuration features offered by CWI. This guide assumes that you have reviewed both the Cisco IOS XR Getting Started Guide and Cisco Craft Works Interface Quick Start Guide. You have successfully set up the router and CWI client. For an overview of all CWI components and fields, and for information about navigating CWI, see the Cisco Craft Works Interface User Interface Guide.

Intended Audience

This Cisco Craft Works Interface Configuration Guide is intended for the following categories of personnel: • Experienced service provider administrators • Cisco telecommunication management engineers • Third-party field service technicians who have completed Cisco router training sessions • Customers who use and manage Cisco routers on a daily basis

Organization of the Document

This document can be read from beginning to end or be used as a reference document to locate information on specific topics. For related subjects and information, see the “Related Documentation” section. This guide includes the following chapters: • Chapter 1, “About CWI Configuration Tools” • Chapter 2, “Managing Router Configuration with CWI” • Chapter 3, “Performing Bulk Configuration Using CWI”

Cisco Craft Works Interface Configuration Guide vi OL-8540-01 Preface Conventions R3.3 Beta Draft—Cisco Confidential Information Related Documentation

The following additional documentation is available: • Cisco IOS XR Getting Started Guide • Cisco Craft Works Interface User Interface Guide • Cisco Craft Works Interface Quick Start Guide • Cisco Craft Works Interface Configuration Applications Reference Guide • Cisco IOS XR XML API Guide • Release Notes for Cisco IOS XR Software Release 3.3 • Cisco IOS XR Interface and Hardware Component Command Reference • Cisco IOS XR Interface and Hardware Component Configuration Guide • Other Cisco IOS XR software configuration guides and command references

Conventions

This document uses the following conventions:

Item Convention Commands and keywords boldface font Variable for which you supply values italic font Displayed session and system information screen font Information you enter boldface screen font Variables you enter italic screen font Menu items and button names boldface font Choosing a menu item Option > Network Preferences

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the publication.

Tip Means the following information will help you solve a problem. The information in tips might not contain troubleshooting or task-specific actions, but tips do contain useful information.

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Cisco Craft Works Interface Configuration Guide OL-8540-01 vii Preface Obtaining Documentation R3.3 Beta Draft—Cisco Confidential Information Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation at this URL: http://www.cisco.com/techsupport You can access the Cisco website at this URL: http://www.cisco.com You can access international Cisco websites at this URL: http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

Cisco documentation and additional literature are available in the Product Documentation DVD package, which may have shipped with your product. The Product Documentation DVD is updated regularly and may be more current than printed documentation. The Product Documentation DVD is a comprehensive library of technical product documentation on portable media. The DVD enables you to access multiple versions of hardware and software installation, configuration, and command guides for Cisco products and to view technical documentation in HTML. With the DVD, you have access to the same documentation that is found on the Cisco website without being connected to the Internet. Certain products also have .pdf versions of the documentation available. The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number DOC-DOCDVD=) from Cisco Marketplace at this URL: http://www.cisco.com/go/marketplace/

Ordering Documentation

Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product Documentation Store in the Cisco Marketplace at this URL: http://www.cisco.com/go/marketplace/ Nonregistered Cisco.com users can order technical documentation from 8:00 a.m. to 5:00 p.m. (0800 to 1700) PDT by calling 1 866 463-3487 in the United States and Canada, or elsewhere by calling 011 408 519-5055. You can also order documentation by e-mail at [email protected] or by fax at 1 408 519-5001 in the United States and Canada, or elsewhere at 011 408 519-5001.

Cisco Craft Works Interface Configuration Guide viii OL-8540-01 Preface Documentation Feedback R3.3 Beta Draft—Cisco Confidential Information Documentation Feedback

You can rate and provide feedback about Cisco technical documents by completing the online feedback form that appears with the technical documents on Cisco.com. You can send comments about Cisco documentation to [email protected]. You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address: Cisco Systems Attn: Customer Document Ordering 170 West Tasman Drive San Jose, CA 95134-9883 We appreciate your comments.

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL: http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html From this site, you can perform these tasks: • Report security vulnerabilities in Cisco products. • Obtain assistance with security incidents that involve Cisco products. • Register to receive security information from Cisco. A current list of security advisories and notices for Cisco products is available at this URL: http://www.cisco.com/go/psirt If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL: http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT: • Emergencies—[email protected] An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies. • Nonemergencies—[email protected] In an emergency, you can also reach PSIRT by telephone: • 1 877 228-7302 • 1 408 525-6532

Cisco Craft Works Interface Configuration Guide OL-8540-01 ix Preface Obtaining Technical Assistance R3.3 Beta Draft—Cisco Confidential Information

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product to encrypt any sensitive information that you send to Cisco. PSIRT can work from encrypted information that is compatible with PGP versions 2.x through 8.x.

Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page has the current PGP key ID in use.

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, at this URL: http://www.cisco.com/techsupport Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL: http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Product Identification (CPI) tool to locate your product serial number before submitting a web or phone request for service. You can access the CPI tool from the Cisco Technical Support & Documentation website by clicking the Tools & Resources link under Documentation & Tools. Choose Cisco Product Identification Tool from the Alphabetical Index drop-down list, or click the Cisco Product Identification Tool link under Alerts & RMAs. The CPI tool offers three search options: by product ID or model name; by tree view; or for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before placing a service call.

Cisco Craft Works Interface Configuration Guide x OL-8540-01 Preface Obtaining Additional Publications and Information R3.3 Beta Draft—Cisco Confidential Information Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL: http://www.cisco.com/techsupport/servicerequest For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly. To open a service request by telephone, use one of the following numbers: Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227) EMEA: +32 2 704 55 55 USA: 1 800 553-2447 For a complete list of Cisco TAC contacts, go to this URL: http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions. Severity 1 (S1)—Your network is “down,” or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation. Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation. Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels. Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources. • Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL: http://www.cisco.com/go/marketplace/

Cisco Craft Works Interface Configuration Guide OL-8540-01 xi Preface Obtaining Additional Publications and Information R3.3 Beta Draft—Cisco Confidential Information

• Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL: http://www.ciscopress.com • Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL: http://www.cisco.com/packet • iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL: http://www.cisco.com/go/iqmagazine or view the digital edition at this URL: http://ciscoiq.texterity.com/ciscoiq/sample/ • Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL: http://www.cisco.com/ipj • Networking products offered by Cisco Systems, as well as customer support services, can be obtained at this URL: http://www.cisco.com/en/US/products/index.html • Networking Professionals Connection is an interactive website for networking professionals to share questions, suggestions, and information about networking products and technologies with Cisco experts and other networking professionals. Join a discussion at this URL: http://www.cisco.com/discuss/networking • World-class networking training is available from Cisco. You can view current offerings at this URL: http://www.cisco.com/en/US/learning/index.html

Cisco Craft Works Interface Configuration Guide xii OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

CHAPTER 1

About CWI Configuration Tools

Beta Draft Cisco Confidential Information

Craft Works Interface (CWI) configures and manages multiple routers elegantly and in real time. These sections describe CWI configuration tools: • CWI Introduction, page 1-13 • Logical Router Configuration, page 1-14 • Launching the CWI Configuration Desktop, page 1-15 • Navigating the Configuration Desktop, page 1-16 • Understanding CWI Configuration Options, page 1-19 For information about navigating CWI components, interface elements, and applications, see the Cisco Craft Works Interface User Interface Guide.

CWI Introduction

You can use CWI to perform and manage router configurations with speed, efficiency, and substantially fewer errors than typical command-line interface (CLI)-based configuration tools. The feature set for CWI exceeds established CLI capabilities, and simplifies the configuration and management of large scale routers. You can log in to multiple routers in a single CWI session. You can view information from multiple routers using the Alarm Viewer application and Inventory Viewer application. For more information about these applications, see the Cisco Craft Works Interface Quick Start Guide and Cisco Craft Works Interface User Interface Guide. For information about system configurations, see the Cisco IOS XR Getting Started Guide.

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-13 Chapter 1 About CWI Configuration Tools Logical Router Configuration R3.3 Beta Draft—Cisco Confidential Information Logical Router Configuration

Cisco provides one default logical router (LR). A logical router is a collection of modular service card (MSC) line cards, Route Processor (RP) cards, and other configurable resources that are specific to your network that together form a complete router within the network.

Note More than one LR can be viewed, monitored, and managed from CWI.

The LR is displayed in the left panel inventory tree on the CWI Desktop Main window (see Figure 1-1).

Figure 1-1 CWI Desktop Main Window

CWI Logical View

Figure 1-2 displays CWI desktop’s left-panel Logical View references of the router’s default LR, associated racks, slots, and cards.

Cisco Craft Works Interface Configuration Guide 1-14 OL-8540-01 Chapter 1 About CWI Configuration Tools Launching the CWI Configuration Desktop R3.3 Beta Draft—Cisco Confidential Information

Figure 1-2 CWI Logical View of Logical Router

For information about the default logical router, see the Cisco IOS XR Getting Started Guide.

Launching the CWI Configuration Desktop

You can use the CWI Configuration Desktop to interactively display and manage the configuration. The Configuration Desktop is the main point of access to all configuration applications. To launch the Configuration Desktop from the main CWI desktop, perform the following steps:

Step 1 Choose the logical router in the root node in the Physical View. Or press Ctrl and click the desired objects in the Inventory Tree to choose random multiple objects. Step 2 Invoke the Configuration Desktop. Choose one of the following options: a. Choose Tools > Configuration Desktop. b. Right-click the logical router node in the Physical View and choose Configuration Desktop. Figure 1-3 displays the Configuration Desktop window. You can select one of the configuration applications.

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-15 Chapter 1 About CWI Configuration Tools Navigating the Configuration Desktop R3.3 Beta Draft—Cisco Confidential Information

Figure 1-3 CWI Configuration Desktop

Navigating the Configuration Desktop

The CWI Configuration Desktop applications contain common elements and activities found in all configuration applications to provide consistency of usage. You can concurrently access multiple applications within the Configuration Desktop. These sections describe how to navigate the Configuration Desktop: • Configuration Applications Tree, page 1-17 • Configuration Applications Pane, page 1-18 You can use the Configuration Desktop for various configuration tasks. For information about navigating the CWI Configuration Desktop, see the Cisco Craft Works Interface Quick Start Guide. Table 1-1 lists the Configuration Desktop graphical applications.

Table 1-1 Configuration Desktop Graphical Applications

Name Configuration Administration Configuration Alarm Administration and User Administration Interface Configuration Common, Ethernet, and Packet over SONET/SDH1 (POS2) Controllers Configuration SONET Policy Configuration Access Control Lists

Cisco Craft Works Interface Configuration Guide 1-16 OL-8540-01 Chapter 1 About CWI Configuration Tools Navigating the Configuration Desktop R3.3 Beta Draft—Cisco Confidential Information

1. SONET = synchronous optional network 2. POS = Packet over SONET/SDH

Table 1-2 describes the primary panes for the Configuration Desktop.

Table 1-2 Primary Panes

Pane Description Configuration Applications tree Displays all applications available in the Configuration Desktop. Configuration Applications pane Displays all active configuration applications. Launch Context pane Displays the objects that were chosen when the Configuration Desktop was opened from the CWI Desktop. For interfaces, only the objects listed in the Launch Context pane are available for configuration.

Configuration Applications Tree

The Configuration Applications Tree is the primary interface to all configuration applications in the CWI. Figure 1-4 displays the symbols for a given application that are listed in the context-sensitive Configuration Applications tree.

Figure 1-4 Configuration Applications Tree Symbols

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-17 Chapter 1 About CWI Configuration Tools Navigating the Configuration Desktop R3.3 Beta Draft—Cisco Confidential Information

1 Not Permitted 4 Disabled 2 Unchanged Configuration 5 Incompatible Version 3 Uncommitted Configuration — —

Table 1-3 describes the Configuration Applications tree symbols.

Table 1-3 Configuration Applications Tree Symbols

Name Description Not Permitted symbol Indicates that the application is not available. This symbol (no entry symbol on a page) indicates that you do not have permission to start the application. Unchanged Configuration symbol Indicates that the application is available and there is no (blank page) uncommitted configuration for the application. Disabled symbol Indicates that the application has already been disabled. (dimmed page or not available) Uncommitted Configuration symbol Indicates that the application contains configuration changes (paper and pencil) that have not been committed and are in the target configuration. Incompatible Version symbol Indicates that the application is not available and there is a (a large red V) version mismatch between the software on the router and CWI graphical configuration (mismatches are not relevant to the Configuration Editor or CWI Telnet Plus configurations).

Configuration Applications Pane

The Configuration Applications pane (see Figure 1-5) is the area of the Configuration Desktop that contains the active configuration applications used to configure the router. You can open multiple applications concurrently in the Configuration Applications pane.

Cisco Craft Works Interface Configuration Guide 1-18 OL-8540-01 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

Figure 1-5 Example of an Application Window Open in the Configuration Desktop

Understanding CWI Configuration Options

These sections describe CWI configuration options: • CWI-Based Telnet Plus, Secure Shell, and Terminal Plus Configuration Sessions, page 1-19 • CWI Configuration Editor and Replace Configuration Editor, page 1-20 • CWI Graphical Configuration Features, page 1-21

CWI-Based Telnet Plus, Secure Shell, and Terminal Plus Configuration Sessions

CWI provides Telnet Plus, Secure Shell (SSH), and Terminal Plus connectivity. These applications manage the router through the CLI without launching external applications for Telnet, SSH, and Terminal Plus. Table 1-4 describes the applications used for Telnet Plus, SSH, and Terminal Plus configuration sessions.

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-19 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

Table 1-4 Applications Used for Telnet Plus, SSH, and Terminal Plus Configuration Sessions

Name Description CWI Telnet Plus Provides a terminal emulation client integrated within CWI that connects to the router, issues CLI commands, and receives responses without leaving CWI interface. CWI Terminal Plus Provides support for clients connected to the router through a console (serial) port, which can either be a direct serial connection or terminal server connection and enables the Terminal Plus application. CWI SSHv1 Plus Provides secure login sessions by encrypting the entire session for SSH. This application is the same as Telnet Plus. CWI SSHv2 Plus Provides a higher level of security for SSHv2. This application is also the same as Telnet Plus.

You can start the Telnet Plus, SSH Plus, and Terminal Plus applications from the following CWI locations: • Inventory tree. Note that a logical router must be chosen in the Inventory tree for the Telnet Plus, SSH, or Terminal Plus applications to be available. • CWI Desktop menu. After you start the Telnet Plus, SSH Plus, or Terminal Plus application, CWI logs in using the username and password provided during CWI login procedure.

Note If the authentication fails, you must manually enter the username and password.

You can perform the following functions: • Connect to a router through the Telnet Plus client application. • Use the SSH application. • Use the Terminal Plus application. • Launch multiple sessions to the same router. • Use full-length lines. • Store and recall commonly used commands. • Use the Clipboard function. • Launch a snapshot window of the Telnet Plus session that displays, prints, copies, or searches a chosen portion of the session while you are continuing your Telnet work. You can copy and paste between the snapshot and the Telnet Plus session. In addition, you can display important information that will not scroll off the screen while continuing with your Telnet Plus session. • Specify user batch files for batch-mode execution of commands.

CWI Configuration Editor and Replace Configuration Editor

CWI configuration editors display or modify configurations in CLI format. Table 1-5 describes the different types of configuration editors.

Cisco Craft Works Interface Configuration Guide 1-20 OL-8540-01 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

Table 1-5 Types of Configuration Editors

Name Description Configuration Editor Displays the target configuration (including RPL1) in editable CLI format. This text-editor application is available from the CWI Desktop. You can use the Configuration Editor when you want to edit a copy of the current configuration or display changes made to a configuration that has not yet been committed to the router. Note Unlike the graphical configuration, the Configuration Editor is not dependent on the Cisco IOS XR software operating system version.

The CLI tab command completion and question mark (?) help features are incorporated into the Configuration Editor. These are the same features available from the CLI. The configuration in the View All Uncommitted Configuration window cannot be modified. To modify the uncommitted configuration, you must use the Configuration Editor or graphical configuration applications to make changes. Replace Configuration Editor Replaces the entire running configuration on the router with the contents of the Replace Configuration Editor window. This text editor does not allow for modifications to the running configuration; it deletes what is running on the router and replaces it entirely with the contents of the Replace Configuration Editor window. This application is also available in the Configuration Desktop.

1. RPL = route policy language

For an overview of target configuration, running configuration, and the configuration commit process, see the Cisco IOS XR Getting Started Guide. For information about navigating the CWI Configuration Editor and the CWI Replace Configuration Editor, see the Cisco Craft Works Interface User Interface Guide.

CWI Graphical Configuration Features

CWI graphical interface provides a set of Common Application Features specific to tables of manageable objects used to facilitate bulk configurations and promote fast additions, deletions, and modifications. In other words, all configuration applications that use tables share the same common set of configuration features—searching, sorting, filtering, printing, exporting, and table column preferences. These sections describe the features for the graphical configuration: • Common Application Features, page 1-22 • Common Configuration Application Features, page 1-22 • CWI Configuration Controls, page 1-23

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-21 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

Common Application Features

Figure 1-6 displays the Configuration Desktop toolbar that contains many of the Common Application Features tools and the Configuration Controls tools. All Common Application Feature tools (except Refresh) are also available in the Configuration Desktop menu.

Figure 1-6 Common Application Features in the Configuration Toolbar

1 Print 7 Paste 2 Export 8 Refresh 3 Find 9 Preferences 4 Find Next 10 Help 5 Cut 11 Replace Configuration Editor 6 Copy — —

Note The Cut, Copy, and Paste buttons are enabled when the Configuration Editors are launched.

Common Configuration Application Features

CWI also offers a set of common configuration tools that include all of the common application features such as searching, sorting, filtering, printing, exporting, and table column preferences plus cloning, copying, and pasting for multirow editing. Figure 1-7 displays additional configuration tools that are represented by the corresponding button symbols.

Figure 1-7 Common Configuration Tools

Cisco Craft Works Interface Configuration Guide 1-22 OL-8540-01 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

1 Add Record 7 Row Paste 2 Clone Record 8 Row Paste Special 3 Clone Special 9 Undo Copy 4 Delete Record 10 Redo Copy 5 Set Defaults 11 Filter Table 6 Row Copy — —

Cloning creates an unlimited number of new rows of configuration information based on selectable content from existing rows. CWI allows for 100 new rows to be generated at one time, but then another 100 more can be created immediately thereafter, and another 100 rows after that, and so on, in unlimited fashion. Copying and pasting also uses information from existing configuration rows but does not generate new rows of configuration information. CWI’s common configuration tools are distinct from the CWI Configuration Controls tools. For more information, see the “CWI Configuration Controls” section on page 1-23. For information about navigating CWI and graphical configuration applications, see the Cisco Craft Works Interface User Interface Guide.

CWI Configuration Controls

You can use the configuration controls tools (see Figure 1-8) to manage the configuration files on the router. You can lock and unlock the running configuration on the router along with loading, saving, committing, clearing, or rolling back a configuration.

Cisco Craft Works Interface Configuration Guide OL-8540-01 1-23 Chapter 1 About CWI Configuration Tools Understanding CWI Configuration Options R3.3 Beta Draft—Cisco Confidential Information

Figure 1-8 Configuration Controls Tools

1 Lock/Unlock 5 View Uncommitted Configuration 2 Load 6 Clear 3 Save 7 Rollback 4 Commit — —

The Configuration Desktop toolbar contains the Configuration Controls tools listed in Table 1-6.

Table 1-6 Definitions for the Configuration Controls

Icon Definition Lock/Unlock Locks the running configuration on the router to prevent other users from committing a configuration while you are making changes. The status of the Lock/Unlock button indicates the current status. Load Allows you to enter the path and name of a configuration file to load. The Load button allows you to load a target configuration buffer that was previously saved on the router into the current target configuration. The loaded configuration merges with the current target configuration, with the items in the saved target buffer taking precedence over any items already in the target configuration. All active configuration applications are closed. Save Saves uncommitted configuration changes to a specified location on the router. Commit Commits the target configuration to the running configuration running on the router. The Commit button is enabled only after the parameters set in the configuration applications have been applied. Any errors resulting from a commit command are displayed in a read-only text window in CLI format. View Uncommitted Displays all the configuration changes that still need to be committed in CLI1 Configuration format. For a procedure, see the “Displaying an Uncommitted Configuration” section on page 2-34 of Chapter 2, “Managing Router Configuration with CWI.” Clear Clears the target configuration and closes all active configuration applications. Rollback Contains a list of available rollback checkpoints saved on the router. A checkpoint is a previous commit operation. You can choose the checkpoint to which to roll back the running configuration. The checkpoints provide the usernames, date, and time of the commit operation.

1. CLI = command-line interface

Cisco Craft Works Interface Configuration Guide 1-24 OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

CHAPTER 2

Managing Router Configuration with CWI

Beta Draft Cisco Confidential Information

This chapter discusses how to manage the router configuration with the Craft Works Interface (CWI). CWI configuration management involves working with the CWI Configuration Desktop configuration modes and handling uncommitted configurations. These sections describe how to manage the router configuration with CWI: • Opening a CLI Session Using the CWI Telnet Plus, page 2-25 • Modifying an Existing Configuration Using the CWI Configuration Editor, page 2-27 • Modifying an Existing Configuration Using the CWI Graphical Configuration, page 2-32 • Displaying an Uncommitted Configuration, page 2-34 • Replacing the Entire Configuration, page 2-35

Opening a CLI Session Using the CWI Telnet Plus

You can access the CWI Configuration Desktop to display and modify an existing configuration using the optional CWI configuration modes (see Table 2-1). For more information, see “Understanding CWI Configuration Options” section on page 1-19.

Table 2-1 Types Configuration Modes

Name Description Telnet Plus Configuration Mode Launches only from the main CWI desktop. For more information, see the “CWI-Based Telnet Plus, Secure Shell, and Terminal Plus Configuration Sessions” section on page 1-19. CWI Configuration Editor Launches from the CWI Desktop. CWI Graphical Configuration Launches from the CWI Configuration Desktop.

CWI provides Telnet Plus, Secure Shell (SSH), and Terminal Plus connectivity to manage a router using the command-line interface (CLI) directly from CWI without downloading separate applications for Telnet, SSH, and Terminal Plus.

Note • If you are connected to a serial port, the Terminal Plus application replaces the Telnet application.

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-25 Chapter 2 Managing Router Configuration with CWI Opening a CLI Session Using the CWI Telnet Plus R3.3 Beta Draft—Cisco Confidential Information

• When you launch Terminal Plus, you cannot launch any new applications or refresh existing ones.

To open a CLI session using CWI Telnet Plus or Terminal Plus, perform the following steps:

Step 1 Start CWI Telnet Plus from the CWI main desktop window (see Figure 2-1). Choose one of the following options: a. Choose Tools > Telnet. Or choose Tools > Terminal Plus. b. Right-click the logical router node and choose Telnet or Terminal Plus. Note that the Terminal Plus window is identical to the CWI Telnet Plus window. CWI Telnet Plus window (see Figure 2-1) is displayed. The existing configuration information from the CLI is displayed.

Figure 2-1 Configuring Interfaces with CLI Commands from the CWI-Based Telnet Plus

A logical router (LR) must be chosen in the Inventory Tree for the Telnet Plus or SSH application to be available. When the Telnet Plus or SSH Plus application is started, CWI logs in using the username and password provided during CWI login procedure. If the authentication fails, you must manually enter your username and password.

Note These steps describe how to modify the subnet mask on an interface, for example, MgmtEth0/RP0/CPU0/0.

Step 2 Enter show interface MgmtEth 0/RP0/CPU0/0 to display the interface details to verify the settings for the Ethernet management interface (see Figure 2-1). If prompted, you must enter username and password. Step 3 Enter CLI global configuration mode and modify the interface using the CLI commands as shown in the following example: RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface MgmtEth 0/RP0/CPU0/0 RP/0/RP0/CPU0:router(config)# ipv4 address 172.19.75.39 255.255.255.0

Cisco Craft Works Interface Configuration Guide 2-26 OL-8540-01 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Configuration Editor R3.3 Beta Draft—Cisco Confidential Information

Step 4 Enter the commit command to apply the changes to the running configuration as shown in the following example: RP/0/RP0/CPU0:router(config-if)# commit

Note CWI Telnet Plus application supports the explicit storage and recall of commands in the Telnet Plus window buffer.

You can also save all the commands in the buffer to a file, browse saved files, and retrieve and load commands saved to files in the buffer. Also, all CLI features are available from the CWI Telnet Plus application. You can press Tab for automatic command completion.

Note To obtain help, enter the ? for help with a particular command or enter the help command to access the information for CLI man page.

Modifying an Existing Configuration Using the CWI Configuration Editor

The Configuration Editor application is available from the CWI Desktop and displays any configuration on the router in CLI format. By using the CWI Configuration Editor, you can: • Randomly access configuration information. • Edit whichever portion you want to change without stepping through successive CLI configuration modes to enter CLI commands. Blocks of configuration are based on submodes, collapsed or expanded as required to allow a clear overview of the configuration. • Perform syntax checking of your configuration. • Display related areas of configuration that are hyperlinked to allow you to quickly see relationships and navigate among them. You can add or modify the hyperlink rules to specify additional rules to locate areas of configuration that are related. • Quickly navigate through the numbered lines of configuration. • Search, cut, copy, paste, and delete content within the editor. • Edit the configuration for the route policy language (RPL) as shown in Figure 2-2. The Configuration Editor associates indentations with CLI submodes. You can provide any indentation in the RPL code or any other Configuration Editor configurations. Blocks of RPL commands are verified for completeness and highlighted if not complete. If an incomplete block is found, the offending tags are highlighted in red for the constructs.

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-27 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Configuration Editor R3.3 Beta Draft—Cisco Confidential Information

Figure 2-2 CWI Configuration Editor RPL Configuration

Note Press Tab to access the CLI command-completion feature. You can also enter the ? for help with a particular command.

CWI Configuration Editor tools are enabled in the toolbar when the Configuration Editor is opened as shown in Figure 1-6. You can highlight text blocks. After you click Apply, the highlights are removed. Text in the Configuration Editor is color-coded to enhance the readability of the text. Table 2-2 lists the color definition of the text blocks.

Ta b l e 2 - 2 Color Definitions for the Configuration Editor

Color Definition Red A line of configuration that you chose to delete. After you click Apply, the line is deleted. Green A new line of configuration that you added since the last time you clicked Apply. Cyan An existing line of configuration that has been modified since the last time you clicked Apply.

Cisco Craft Works Interface Configuration Guide 2-28 OL-8540-01 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Configuration Editor R3.3 Beta Draft—Cisco Confidential Information

Figure 2-3 displays an example of the text editing color codes and popup help menu.

Figure 2-3 CWI Configuration Editor Text Editing Color Coding and “? Help” Features

To modify an existing configuration using the CWI Configuration Editor, perform the following steps:

Step 1 Start the Configuration Editor from the CWI desktop main window (see Figure 1-1): a. Choose the LR node. b. Choose Tools > Configuration Editor. Or right-click a network element from the Physical View tree and choose Configuration Editor. The Configuration Editor window displays the target configuration by default (see Figure 2-4).

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-29 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Configuration Editor R3.3 Beta Draft—Cisco Confidential Information

Figure 2-4 CWI Configuration Editor Configuration Information in CLI Format

The configuration editor displays the same configuration information as the CLI show run command. Step 2 Edit the subnet mask to make a configuration change in the target configuration. For example, change the subnet mask 255.255.0.0 to 255.255.255.0. Step 3 Click Apply. Syntax checking with inline error flagging is applied to the configuration information. Note that there is no semantic checking in the Configuration Editor during the syntax check.

Note After you apply changes to the target configuration but before you perform the commit operation, the symbol of a folder with a pencil on it appears in the root node of the Configuration tree to remind you that you have written changes to the target configuration that you still need to commit. This symbol is displayed when you make the configuration changes using the Configuration Editor or the graphical configuration windows.

The symbol with the paper and pencil is displayed on individual nodes in the Configuration tree when you make configuration changes for a given application area. This symbol is displayed only after configurations are made using one of the many graphical configuration windows.

Step 4 Click Commit. The target configuration becomes the active running configuration. This happens when semantic checking is performed. If there are errors, they are displayed inline in the Configuration Editor (see Figure 2-5).

Cisco Craft Works Interface Configuration Guide 2-30 OL-8540-01 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Configuration Editor R3.3 Beta Draft—Cisco Confidential Information

Figure 2-5 Configuration Errors Shown Inline in the Configuration Editor

Editing the Hyperlinks for an Existing Configuration

The hyperlink rules reside in the hyperlinkrules.txt text file. You can display a tool tip on the hyperlink that contains the anchored configuration block. Or click the hyperlink to scroll the text to display the anchor on the top of the screen. The following example displays the format of the hyperlink rules: < anchor expression > : < hyperlink expression >

An anchor or a hyperlink expression consists of a fixed string of text followed by a * to designate the word to be hyperlinked and is used as the keyword to match the hyperlink to the corresponding section of configuration. Anchor expressions must always point to top-level (nonsubmode) configuration. You can have only one rule definition for each line in the hyperlink rules file. In addition, only one anchor expression and one hyperlink expression are allowed for each line. For more operation examples of the default rules, see Cisco Craft Works Interface User Interface Guide. The procedure shows how to link references to interfaces to the corresponding interface definition. To edit the hyperlink rule for an existing configuration, perform the following steps:

Step 1 Click the Edit Hyperlink Rules button from the Configuration Editor toolbar. Or choose Tools > Hyperlink Rules to edit the hyperlink rules. Step 2 Edit the following hyperlink rule to link references to the corresponding interface definition: < interface * > : < interface * >

The following example shows the corresponding hyperlink configuration: interface POS0/1/0/0 description test123456 ipv4 address 1.2.3.4 255.255.0.0 !

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-31 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Graphical Configuration R3.3 Beta Draft—Cisco Confidential Information

mpls ldp interface POS0/1/0/0 discovery transport-address 1.2.3.4 !

Step 3 Click Apply to edit the hyperlink rule.

Modifying an Existing Configuration Using the CWI Graphical Configuration

CWI provides graphical representations of the physical and logical objects in a router, which simplifies the process of configuring and managing the router. A router can consist of an extensive hierarchy of racks, logical routers, shelves, cards, and ports. The primary benefit of CWI graphical configuration mode becomes evident when you are required to create or modify a large number of configurations. Instead of entering commands one at a time from the CLI, you can easily choose devices and change configurable items from a graphical configuration window. For information about the common configuration tools, see “Common Configuration Application Features” section on page 1-22. For information about the configuration control tools, see the “CWI Configuration Controls” section on page 1-23. To modify an existing configuration using the Graphical Configuration application, perform the following steps:

Step 1 Modify an existing Ethernet interface configuration. Choose one of the following options: a. Choose Tools > Interfaces > Ethernet b. Double-click the Ethernet node from the Interfaces configuration folder in the Configuration Applications tree. c. Right-click the Ethernet node and choose Launch. Figure 2-6 displays the Interface Ethernet Configuration Window.

Cisco Craft Works Interface Configuration Guide 2-32 OL-8540-01 Chapter 2 Managing Router Configuration with CWI Modifying an Existing Configuration Using the CWI Graphical Configuration R3.3 Beta Draft—Cisco Confidential Information

Figure 2-6 Interface Ethernet Configuration Window

Step 2 Choose an existing row of configuration. Step 3 Enter a new Ethernet interface subnet mask in the Mask field. For example, change 255.255.0.0. to 255.255.255.0 (or make any other change to the existing configuration).

Note For a value that is out of range (for example, if you entered an invalid subnet mask, a client-side error is detected and indicated) before the configuration is sent to the router.

Step 4 Click Apply. Step 5 Click the Commit button to send the target configuration information to the active, running configuration on the router

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-33 Chapter 2 Managing Router Configuration with CWI Displaying an Uncommitted Configuration R3.3 Beta Draft—Cisco Confidential Information Displaying an Uncommitted Configuration

For information about the differences between the symbol of a folder with a pencil and the symbol with the paper and pencil from the Configuration Applications tree, see the Modifying an Existing Configuration Using the CWI Configuration Editor, page 2-27. To display an uncommitted configuration, perform the following steps:

Step 1 Choose the pencil and folder symbol from the Configuration Applications tree. Step 2 Click the View Uncommitted Configuration icon from the Configuration Desktop toolbar. The All Uncommitted Configuration window (see Figure 2-7) displays all configuration changes that still need to be committed in CLI format.

Figure 2-7 Text Editor with Uncommitted Configuration

Step 3 Modify the configuration by using the Configuration Editor or the graphical configuration applications.

Note The configuration in the All Uncommitted Configuration display cannot be modified. You must use the Configuration Editor or the graphical configuration applications to modify configurations.

Cisco Craft Works Interface Configuration Guide 2-34 OL-8540-01 Chapter 2 Managing Router Configuration with CWI Replacing the Entire Configuration R3.3 Beta Draft—Cisco Confidential Information Replacing the Entire Configuration

The Replace Configuration Editor replaces the entire current configuration on the router with the configuration in the Replace Configuration Editor. To launch the Replace Configuration Editor application (see Figure 2-8) from the Configuration Desktop, click the Replace Configuration Editor icon. The target configuration is displayed in CLI format. The editing functions, which are used in the Configuration Editor, are also available in the Replace Configuration Editor.

Figure 2-8 CWI Replace Configuration Editor

Cisco Craft Works Interface Configuration Guide OL-8540-01 2-35 Chapter 2 Managing Router Configuration with CWI Replacing the Entire Configuration R3.3 Beta Draft—Cisco Confidential Information

Cisco Craft Works Interface Configuration Guide 2-36 OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

CHAPTER 3

Performing Bulk Configuration Using CWI

Beta Draft Cisco Confidential Information

This chapter describes the Craft Works Interface (CWI) bulk configuration features, also known as templating-without-templates. These sections describe how to perform the bulk configuration feature: • CWI Bulk Configurations Overview, page 3-37 • Using an Existing Configuration Record as a Template to Modify Records, page 3-38 • Using an Existing Configuration Record as a Template for Cloning, page 3-39 • Deleting Multiple Rows of Configuration, page 3-41 • Editing Multiple Rows of Configuration, page 3-41

CWI Bulk Configurations Overview

The bulk configuration of configurable entities, such as interfaces and Access Control Lists (ACLs), and many other objects for the router is accomplished only from CWI. Generating numerous configurations in bulk is a feature available from CWI that is known as templating-without-templates. CWI provides the functionality of templating without ever requiring you to manage or establish a template. You can use existing configuration information as a baseline “template” to generate various additional and large-scale configurations. When you create new configurable objects based on existing configuration objects, you are essentially cloning all configuration fields. You can also choose a subset of fields to clone. Key fields identify a configuration record. Examples of key fields are ACL name or ACL sequence number. Key fields are left blank for later configuration, or you can incorporate an algorithm that increments key fields by a specified value for bulk configurations. New records are generated from the original chosen records.

Note Cloning always involves the creation of new configuration records (rows). Copying and pasting always pastes configuration information into existing records (rows).

To manage data for bulk configuration, you can use the Configuration Desktop toolbar (see Figure 1-6). For more information, see the “Common Application Features” section on page 1-22 in Chapter 1, “About CWI Configuration Tools.”

Cisco Craft Works Interface Configuration Guide OL-8540-01 3-37 Chapter 3 Performing Bulk Configuration Using CWI Using an Existing Configuration Record as a Template to Modify Records R3.3 Beta Draft—Cisco Confidential Information

To manage bulk configuration, you can use the common configuration tools (see Figure 1-7). For more information, see the “Common Application Features” section on page 1-22 in Chapter 1, “About CWI Configuration Tools.”

Using an Existing Configuration Record as a Template to Modify Records

To use an existing configuration record as a template to modify additional records, such as applying an existing interface configuration for other interfaces, perform the following steps:

Note The Interface POS Configuration application is used as an example.

Step 1 Start the Interface POS Configuration Application (see Figure 3-1) from the Configuration Applications tree. Choose one of the following options: a. Double-click POS from the Interfaces configuration folder. b. Right-click POS from the Interfaces configuration folder and choose Launch.

Figure 3-1 Interface POS Configuration Application Window

Step 2 Review the attributes that are already established for an existing row of configuration information (record).

Cisco Craft Works Interface Configuration Guide 3-38 OL-8540-01 Chapter 3 Performing Bulk Configuration Using CWI Using an Existing Configuration Record as a Template for Cloning R3.3 Beta Draft—Cisco Confidential Information

Step 3 Choose the configured row. Click the Row Copy button. Step 4 Choose one or more interface records (rows) that contain attributes that need to be changed to the attributes established in Step 1. Step 5 Click the Row Paste button or Row Paste Special button. These options are defined as follows: • Row Paste option—Pastes all nonkey attributes and elements of a chosen row of configuration information. • Row Paste Special—Pastes a choosable subset of attributes and elements from the copied row of configuration information. If you want to paste only a new description and mask into the chosen rows: – Click the Row Paste Special button. – Choose the description and mask fields from the Paste Special window. – Click Apply. The chosen attributes from the copied configuration (in Step 1) are pasted to all chosen rows. Step 6 Click Apply to enter the configuration information into the target configuration. Step 7 Click the Commit button to commit the configuration to the active, running configuration on the router.

Using an Existing Configuration Record as a Template for Cloning

CWI Clone Special feature clones a chosen configuration record into multiple ACL configuration records. It also automatically generates and increments ACL sequence number values per cloned record. With the Clone Special feature, you can choose specific attributes to be applied to the series of cloned records. Cloning a configuration is not the same as copying a configuration. Cloning creates new rows in the configuration table instead of pasting a configuration into existing rows. To create a new ACL record as an example, then clone that record to generate additional configuration rows that are modified individually or as a group, perform the following steps:

Step 1 Launch the ACL configuration application (see Figure 3-2) from the Configuration Applications tree. Choose one of the following options: a. Double-click Access Control Lists from the Policy configuration folder. b. Right-click Access Control Lists from the Policy configuration folder and choose Launch.

Cisco Craft Works Interface Configuration Guide OL-8540-01 3-39 Chapter 3 Performing Bulk Configuration Using CWI Using an Existing Configuration Record as a Template for Cloning R3.3 Beta Draft—Cisco Confidential Information

Figure 3-2 Access Control Lists Window

Step 2 Choose an existing record. Step 3 With the new record chosen in the table, click the Clone Special Record button (see Figure 1-7). The Clone Special window is displayed. Step 4 Enter the number of records in the Number of Cloned Records field. If you enter 20, you are cloning 20 new records. Step 5 Click the Generate Key Fields radio button (see Figure 3-3). Step 6 In the Selected Algorithms column (see Figure 3-3), choose the Auto-Increment option from the drop down arrow. Step 7 Enter the base value of 20 in the Base Value column. Step 8 Enter the increment value of 10 in the Increment Value column. Each of the 20 clones’ ACL sequence numbers is incremented by 10. Step 9 Click OK.

Cisco Craft Works Interface Configuration Guide 3-40 OL-8540-01 Chapter 3 Performing Bulk Configuration Using CWI Deleting Multiple Rows of Configuration R3.3 Beta Draft—Cisco Confidential Information

Figure 3-3 CWI Clone Special Auto-Increment Option in the Generate Key Fields Window

The Access Control Lists window displays 20 cloned records with sequence numbers that has already incremented each row by 10. Step 10 Modify the cloned row of configuration attributes by making entries or changes within the record fields. Step 11 Click Apply to enter the configuration information into the target configuration. Step 12 Click the Commit button to commit the configuration to the active, running configuration on the router.

Deleting Multiple Rows of Configuration

To delete multiple rows of configuration, perform the following steps:

Note The ACL configuration application is used as an example.

Editing Multiple Rows of Configuration

To edit the attributes of multiple configured rows at the same time, perform the following steps:

Step 1 Choose the rows for which you want to change an attribute. If you want to change the MTU setting for 150 interfaces, choose the 150 rows for which the MTU attribute is to be modified. Step 2 Enter a new MTU value in the MTU field. The MTU value for all 150 chosen rows of configuration information is instantly updated.

Cisco Craft Works Interface Configuration Guide OL-8540-01 3-41 Chapter 3 Performing Bulk Configuration Using CWI Editing Multiple Rows of Configuration R3.3 Beta Draft—Cisco Confidential Information

Step 3 Click Apply. Step 4 Click the Commit button to send the target configuration information to the active, running configuration on the router.

Cisco Craft Works Interface Configuration Guide 3-42 OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

GLOSSARY

AAA authentication, authorization, and accounting. A network security service that provides the primary framework to set up access control on a Cisco CRS-1 Series Carrier Routing System (Cisco CRS-1 Series router) or access server. AAA is an architectural framework and modular means of configuring three independent, but closely related security functions in a consistent manner. It is flexible, scalable, and supports authentication methods including RADIUS, TACACS+, and Kerberos.

Access Control List See ACL.

ACL access control list. A list kept by routers to control access to or from the router for a number of services (for example, to prevent packets with a certain IP address from leaving a particular interface on the router). address family See AF.

AF address family. Set of related communication protocols in which all members use a common addressing mechanism to identify endpoints. Also called protocol family.

B bandwidth The amount of data that can be sent in a fixed amount of time. For digital services, the bandwidth is usually expressed in bits per second (bps) or bytes per second.

BGP Border Gateway Protocol. Interdomain routing protocol that replaces EGP. BGP exchanges reachability information with other BGP systems. It is defined by RFC 1163.

Border Gateway See BGP. Protocol

CDP Cisco Discovery Protocol. Runs on all Cisco devices so that these devices can learn about neighboring devices and exchange information. CDP uses a well-known multicast MAC address. During system initialization, the application-specific integrated circuit (ASIC) is configured to forward these packets to the Cisco IOS software CPU, which processes the packets.

Cisco Discovery See CDP. Protocol class map Used for matching packets to a specific class.

Cisco Craft Works Interface Configuration Guide OL-8540-01 GL-43 Glossary

R3.3 Beta Draft—Cisco Confidential Information

CLI command-line interface. A text-based user interface to an operating system. A CLI is a user interface to a computer’s operating system or an application in which the user responds to a visual prompt by typing in a command on a specified line, receives a response back from the system, and then enters another command, and so forth. Typically, most of today’s UNIX-based systems offer both a command-line interface and a graphical user interface. command-line See CLI. interface

Craft Works See CWI. Interface

CWI Craft Works Interface. A client-side, real-time, graphical tool used to configure, manage, and troubleshoot the router.

D distributed route See DRP. processor

DNS Domain Naming System. Mechanism used in the Internet and on private Intranets for translating names of host computers into addresses. The DNS also allows host computers not directly on the Internet to have registered names in the same style.

Domain Naming See DNS. System

DRP distributed route processor. The optional route processor board in the Cisco CRS-1 Series router, installed in the line card chassis to provide greater route update capacity.

E eBGP external Border Gateway Protocol. BGP sessions are established between routers in different autonomous systems. eBGPs communicate among different network domains.

Ethernet A baseband technology for LANs invented by Xerox Corporation and developed jointly by Xerox, Intel, and Digital Equipment Corporation. Ethernet networks use CSMA/CD and run over a variety of cables. Ethernet is similar to the IEEE 802.3 series of standards. extensible markup See XML. language external Border See eBGP. Gateway Protocol

Cisco Craft Works Interface Configuration Guide GL-44 OL-8540-01 Glossary

R3.3 Beta Draft—Cisco Confidential Information

F flooding Traffic passing technique used by switches and bridges in which traffic received on an interface is sent out all the interfaces of that device except the interface on which the information was received originally.

Frame Relay Industry-standard, switched data link layer protocol that handles multiple virtual circuits using High-Level Data Link Control (HDLC) encapsulation between connected devices. Frame Relay is more efficient than X.25, the protocol for which it generally is considered a replacement.

Gbps Gigabits per second. The amount of data that can be sent in a fixed amount of time. 1 gigabit = 230 bits, 1,073,741,824 bits.

Gigabit Ethernet An Ethernet technology that raises transmission speed to 1 Gbps. The standard for a high-speed Ethernet, approved by the IEEE 802.3z standards committee in 1996.

Gigabits per second See Gbps. graceful restart Restart that does not impact any router processes. graphical user See GUI. interface

GUI graphical user interface. Graphics-based user interface that incorporates windows, menus, buttons, and a mouse.

HDLC High-Level Data Link Controller. ISO communications protocol used in X.25 packet switching networks. HDLC provides error correction at the data link layer and contains the following subsets: LAP, LAPB, and SDLC.

High-Level Data Link See HDLC. Controller hold time Timing parameter.

I iBGP internal Border Gateway Protocol. BGP sessions are established between routers in the same autonomous system.

ICMP Internet Control Message Protocol. Network layer Internet (TCP/IP) protocol that reports errors and provides other information relevant to IP packet processing.

IEP IP explicit path. List of IP addresses, each representing a node or link in the explicit path.

Cisco Craft Works Interface Configuration Guide OL-8540-01 GL-45 Glossary

R3.3 Beta Draft—Cisco Confidential Information

IETF Internet Engineering Task Force.

IGMP Internet Group Management Protocol. Governs the management of multicast groups in a TCP/IP network. Used by IP hosts to report their multicast group memberships to an adjacent multicast router.

IGP Interior Gateway Protocol. Internet protocol used to exchange routing information within an autonomous system. Examples of common Internet IGPs include IGRP, OSPF, and RIP.

Intermediate See IS-IS. System-to- Intermediate System

Internet Control See ICMP. Message Protocol

Internet See IETF. Engineering Task Force

IP explicit path See IEP.

IP version 4 See IPv4.

IP version 6 See IPv6.

IPv4 IP Version 4. Network layer for the TCP/IP protocol suite. A connectionless, best-effort packet switching protocol.

IPv6 IP Version 6. Replacement for IPv4. A next-generation IP protocol. IPv6 is backward-compatible with and is designed to fix the shortcomings of IPv4, such as data security and maximum number of user addresses. IPv6 increases the address space from 32 to 128 bits, providing for an unlimited number of networks and systems. It also supports quality of service (QoS) parameters for real-time audio and video.

IS-IS Intermediate System-to-Intermediate System. OSI link-state hierarchical routing protocol based on DECnet Phase V routing, whereby ISs (routers) exchange routing information based on a single metric to determine network topology.

Label Distribution See LDP. Protocol

Layer 2 Layer 2 refers to the data link layer of the commonly referenced multilayered communication model, Open Systems Interconnection (OSI). The data link layer contains the address inspected by a bridge or switch. Layer 2 processing is faster than Layer 3 processing, because less analysis of the packet is required.

Layer 3 Layer 3 refers to the network layer of the commonly referenced multilayered communication model, OSI. The network layer is concerned with knowing the address of the neighboring nodes in the network, selecting routes and quality of service, and recognizing and forwarding to the transport layer incoming messages for local host domains.

Cisco Craft Works Interface Configuration Guide GL-46 OL-8540-01 Glossary

R3.3 Beta Draft—Cisco Confidential Information

LCP Link Control Protocol. Protocol that establishes, configures, and tests data-link connections for use by PPP.

LDP Label Distribution Protocol. A standard protocol between MPLS-enabled routers to negotiate the labels (addresses) used to forward packets. The Cisco proprietary version of this protocol is the Tag Distribution Protocol (TDP).

Link Control See LCP. Protocol logical router See LR. loopback Send the outgoing signals back to the receiving side for testing purposes.

LR logical router. A collection of line cards and Route Processors that form a complete router. Each router contains its own instance of dynamic routing, IP stack, system database, interface manager, and event notification system.

M mask Pattern of bits used to reject or accept bit patterns in another set of data. maximum See MTU. transmission unit

Mbps megabits per second. A bit rate expressed in millions of binary bits per second.

MPLS Multiprotocol Label Switching. A mechanism whereby packets are forwarded by reading and replacing a fixed-length label that is attached to the packet.

MPLS TE Multiprotocol Label Switching traffic engineering.

MTU maximum transmission unit. The size of the largest packet that can be processed by an interface.

Multiprotocol Label See MPLS. Switching

Multiprotocol Label See MPLS TE. Switching traffic engineering

Open Shortest Path See OSPF. First

Open Systems See OSI. Interconnection

Cisco Craft Works Interface Configuration Guide OL-8540-01 GL-47 Glossary

R3.3 Beta Draft—Cisco Confidential Information

OSI Open Systems Interconnection. International standardization program created by ISO and ITU-T to develop standards for data networking that facilitate multivendor equipment interoperability.

OSPF Open Shortest Path First. Link-state, hierarchical IGP routing algorithm proposed as a successor to RIP in the Internet community. OSPF features include least-cost routing, multipath routing, and load balancing. OSPF was derived from an early version of the IS-IS protocol.

P packet-over-SONET See POS. policy map Specifies the traffic policy name and configures a traffic policy.

POS packet-over-SONET. Enables core routers to send native IP packets directly over SONET or SDH frames.

QoS quality of service. A set of parameters that describe a flow of data, such as guaranteed bandwidth, delay, and delivery guarantee. quality of service See QoS.

RPL route policy language. RPL supports large scale routing configurations and reduces some of the redundancy that is inherent in route map configuration.

Route Processor See RP.

RP route processor. Processor module that contains the CPU, system software, and most of the memory components that are used in the router.

RSVP Resource Reservation Protocol. Network-control protocol that enables Internet applications to obtain special qualities of service for data flows. Applications running on IP end systems can use RSVP to indicate to other nodes the nature (bandwidth, jitter, maximum burst, and so on) of the packet streams they want to receive.

SONET Synchronous Optional Network. A broadband networking standard based on point-to-point optical fiber networks.

Cisco Craft Works Interface Configuration Guide GL-48 OL-8540-01 Glossary

R3.3 Beta Draft—Cisco Confidential Information

SRP spatial reuse protocol. Another name for Dynamic Packet Transport (DPT), which is a ring-based IP protocol.

Synchronous See SONET. Optical Network

U unicast When a message is sent to one receiver in a communications network, and multiple users request the same data from the same server at the same time, duplicate data streams are sent, one to each user.

XML extensible markup language. A standard maintained by the World Wide Web Consortium (W3C) that defines a syntax that lets you create markup languages to specify information structures. Information structures define the type of information (for example, subscriber name or address), not how the information looks (bold, italic, and so on). External processes can manipulate these information structures and publish them in a variety of formats. XML allows you to define your own customized markup language.

Cisco Craft Works Interface Configuration Guide OL-8540-01 GL-49 Glossary

R3.3 Beta Draft—Cisco Confidential Information

Cisco Craft Works Interface Configuration Guide GL-50 OL-8540-01 R3.3 Beta Draft—Cisco Confidential Information

INDEX

cloning A bulk configurations 3-37 Access Control List compared with copying 3-37 bulk sequence number increments 3-41 feature 1-22, 1-23 cloning 3-39 templating-without-templates 3-39 configuration 1-16 command-line interface ACL (Access Control List) 1-16, 3-39 See CLI 1-21 Administration Configuration Application 1-16 commit Alarm Administration 1-16 checkpoint 1-24 Applications tree, status symbols 1-17 definition 1-24 Apply button graphical configuration 2-30 syntax checking 2-30 icon 1-24 target configuration 2-30 target configuration 2-30 common application configurations 1-16 Common Application Features, tools 1-21, 1-22 B configurable resources 1-14 bulk configurations 1-21, 3-37 configuration management 2-25 multirow attributes editing 3-41 C uncommitted 2-25 checkpoint 1-24 Configuration Controls, tools 1-22 Cisco IOS XR software, CWI configuration editors 1-21 Configuration Desktop clear 1-24 application components CLI (command-line interface) application pane 1-18 capabilities, in CWI 1-13 application icon states 1-18 commit command 1-24 applications 1-16 Configuration Editor tab command completion and ? applications tree 1-17 help 1-21, 2-27, 2-28 common activities CWI-based 1-21, 2-30 opening the Configuration Desktop 1-15 configuration modifications 2-25 invoking 2-25 interface configuration 2-26 launching 1-15 global configuration mode 2-26 navigating 1-17 show run command 2-30 overview 1-15

Cisco Craft Works Interface Configuration Guide OL-8540-01 IN-51 Index

R3.3 Beta Draft—Cisco Confidential Information

Configuration Editor features 1-21 CLI format 1-20, 2-27 launching 2-25 color-coded editing 2-28 uncommitted configurations 1-21 inline error flagging example 2-31 launching 2-25 I modifying configurations 2-27 syntax checking 2-27 interface configuration target configuration 2-29 bulk 3-37 configuration modes 2-25 Ethernet 2-26 Controllers Configuration Application 1-16 Interface Configuration Applications 1-16 copy Inventory tree, logical router 1-20, 2-26 button 1-22 compared with cloning 3-37 K feature 2-27

Craft Works Interface key fields 3-37 See CWI 1-13 cut 1-22, 2-27 CWI (Craft Works Interface) L

Inventory tree 1-20 large-scale configurations 3-37 overview 1-13 Launch Context pane 1-17 Secure Shell (SSH) connectivity 1-19, 1-20 load 1-24 Telnet Plus CLI session 1-20, 2-27 lock 1-24 logical router E choosing 1-15 default 1-14 Ethernet, management interface 2-26 Inventory Tree 2-26 Ethernet Interface Configuration Application 1-16 Logical View 1-14 exporting 1-21, 2-28 LR (logical router) See logical router 2-26 F M filtering 1-21

multirow editing 1-22 G P graphical configuration bulk configuring 2-32 packet-over-SONET/SDH, interface configuration commit operation 2-30 application 1-16 pane

Cisco Craft Works Interface Configuration Guide IN-52 OL-8540-01 Index

R3.3 Beta Draft—Cisco Confidential Information

Configuration Desktop function 1-24 configuration applications 1-18 See also running configuration 1-24 pasting 1-22, 2-27, 3-39 Telnet Plus Policy Configuration Application 1-16 CWI-based 1-19, 2-25 POS (packet-over-SONET) modifying configurations with 2-25 See packet-over-SONET 1-16 CWI-based batch mode execution 1-20 preferences 2-28 option 1-19 printing 1-21 templating-without-templates 3-37, 3-38

R U refresh 1-22 uncommitted configuration 2-25 Replace Configuration Editor 1-21 unlock 1-24 rollback 1-24 User Administration 1-16 running configuration commit 1-24 V Replace Configuration Editor 1-21 rollback 1-24 View All Uncommitted Configuration window 1-21 See also target configuration 1-24

S save 1-24 searching 1-21, 2-27 Secure Shell (SSH) and modifying CRS-1 router configurations 2-25 connectivity 1-19 CWI-based batch mode execution 1-20 SONET configuration application 1-16 sorting 1-21 syntax checking 2-27

T table column preferences 1-21 target configuration commit operation 2-30 Configuration Editor 2-29

Cisco Craft Works Interface Configuration Guide OL-8540-01 IN-53 Index

R3.3 Beta Draft—Cisco Confidential Information

Cisco Craft Works Interface Configuration Guide IN-54 OL-8540-01