® Enterprise Configuration Manager User’s Guide
Summary of Changes Version 5.0 beta 3 preliminary version Date Reason/Rational 12/8/97 For differences between ECM 4.0 rev 3 and ECM 5.0, see New Features section. Nature of Changes 5.
Notice Cabletron Systems reserves the right to make changes in specifications and other information contained in this document without prior notice. The reader should in all cases consult Cabletron Systems to determine whether any such changes have been made. The hardware, firmware, or software described in this manual is subject to change without notice.
Virus Disclaimer Cabletron has tested its software with current virus checking technologies. However, because no anti-virus system is 100% reliable, we strongly caution you to write protect and then verify that the Licensed Software, prior to installing it, is virus-free with an anti-virus system in which you have confidence. Restricted Rights Notice (Applicable to licenses to the United States Government only.) 1.
Contents Preface Product Description ........................................................................................................... xvii Who Should Read This Guide ........................................................................................... xvii Prerequisites for Users...................................................................................................... xvii Guide’s Organization ......................................................................................
Devices Section ...........................................................................................................2-11 Configuration Name Section ......................................................................................2-12 Configuration Information Section ............................................................................2-16 Configuration Detail Section and Status Field .........................................................2-17 Search/Filter Section and Search Icon .....
Creating a Configuration with a Template ..................................................................... 4-27 Checking for Appropriate Template .......................................................................... 4-28 Creating a Template................................................................................................... 4-28 Creating a Configuration with a Template — Procedure Process ........................... 4-31 Creating a Configuration with a Template — Procedure Summary ...
Changing the Configuration.......................................................................................5-21 Loading the Converted Configuration .......................................................................5-22 Loading Shared Configurations .......................................................................................5-23 Procedure Summary ...................................................................................................5-23 Procedure Details ....................
Exporting Templates .................................................................................................... 7-8 Exporting All Templates .............................................................................................. 7-8 Using the File-Selection Dialog Boxes............................................................................... 7-9 If You Accept the Default Directory... ..........................................................................
Chapter 10 Examples of Ways to Use ECM In this Chapter ....................................................................................................................... 1 How to Download Firmware.................................................................................................. 2 Downloading Firmware to a Cabletron MicroMMAC.................................................... 2 Requirement ................................................................................................
Appendix C Running ECM from the Command Line In This Appendix ................................................................................................................C-1 Using ECM Commands ......................................................................................................C-2 Invoking ECM.....................................................................................................................C-3 Capturing a Configuration from a Model ...................................
x Enterprise Configuration Manager User’s Guide
Figures Chapter 1 Figure 1-1. Chapter 2 Figure 2-1. Figure 2-2. Figure 2-3. Figure 2-4. Figure 2-5. Figure 2-6. Figure 2-7. Figure 2-8. Figure 2-9. Figure 2-10. Figure 2-11. Figure 2-12. Figure 2-13. Figure 2-14. Figure 2-15. Figure 2-16. Figure 2-17. Figure 2-18. Chapter 3 Figure 3-1. Figure 3-2. Figure 3-3. Figure 3-4. Figure 3-5. Figure 3-6. Figure 3-7. Figure 3-8. Figure 3-9. Figure 3-10. Figure 3-11. Figure 3-12. Introduction ECM Template and Related Configuration ...................................
Chapter 4 Figure 4-1. Figure 4-2. Figure 4-3. Figure 4-4. Figure 4-5. Figure 4-6. Figure 4-7. Figure 4-8. Figure 4-9. Figure 4-10. Figure 4-11. Figure 4-12. Figure 4-13. Figure 4-14. Figure 4-15. Figure 4-16. Figure 4-17. Figure 4-18. Figure 4-19. Figure 4-20. Figure 4-21. Figure 4-22. Figure 4-23. Figure 4-24. Figure 4-25. Figure 4-26. Figure 4-27. Figure 4-28. Figure 4-29. Chapter 5 Figure 5-1. Figure 5-2. Figure 5-3. Figure 5-4. Figure 5-5. Figure 5-6. Figure 5-7. Figure 5-8. Figure 5-9. Figure 5-10.
Figure 5-15. Figure 5-16. Figure 5-17. Chapter 6 Figure 6-1. Figure 6-2. Figure 6-3. Figure 6-4. Figure 6-5. Figure 6-6. Figure 6-7. Figure 6-8. Figure 6-9. Figure 6-10. Figure 6-11. Chapter 7 Figure 7-1. Figure 7-2. Figure 7-3. Figure 7-4. Chapter 8 Figure 8-1. Figure 8-2. Figure 8-3. Figure 8-4. Figure 8-5. Figure 8-6. Figure 8-7. Chapter 9 Figure 9-1. Figure 9-2. Figure 9-3. The Load Detail Window for Rolled Back Load Status ....................................
Appendix A Figure A-1. Figure A-2. Figure A-3. Figure A-4. Figure A-5. xiv Installation/Deinstallation Installation Configuration Dialog Box ................................................................ A-5 Component Selection Dialog Box ........................................................................ A-7 Installation Monitor Dialog Box .......................................................................... A-8 ECM Custom Installation Prompts ................................................
Tables Chapter 2 Table 2-1. Table 2-2. Table 2-3. Table 2-4. Table 2-5. Table 2-6. Table 2-7. Table 2-8. Getting Started Fields in the Configuration Name Section ......................................................... 2-14 Fields in the Configuration Information Section ............................................... 2-16 Fields in Configuration Detail Section ............................................................... 2-17 Icons and Buttons for Use when Searching or Filtering a List ................
xvi Enterprise Configuration Manager User’s Guide
Preface This preface describes the purpose this guide, ECM user prerequisites, new and changed ECM features, how the guide is organized, and how to get additional information on SPECTRUM products. Product Description Welcome to the Enterprise Configuration Manager User’s Guide. This guide shows you how to use Enterprise Configuration Manager (ECM) to manage the configuration of network devices from a central location.
Guide’s Organization Guide’s Organization The user’s guide is organized as follows. Part Description Chapter 1 Gives an overview of the configuration management process. Chapter 2 Shows how to access ECM and work with ECM windows. Chapter 3 Shows how to create and use templates. Chapter 4 Describes how to create configurations. Chapter 5 Describes how to load a configuration to one or more devices. Chapter 6 Shows how to verify the configuration of one or more devices.
New Features This section describes new ECM features for Spectrum 5.0. New Feature Summary The following features have been added to ECM 5.0: • Ability to create whole device configurations In ECM 5.0, configurations can include all components of the device. In ECM 4.0, for a complex device like a hub/chassis, the user had to maintain separate configurations for each component of the device. In ECM 5.0, the same configuration can be used to include attributes from all components of the device.
New Feature Summary • Filtering of attributes based on flags In ECM 5.0, access to attributes has been made flag-selectable. You can define flags for insertable attributes. You can choose any combination of readable/writable and internal/external flag settings. • Access to all attributes (including READ only as well as WRITE only) In ECM 5.0, by selecting appropriate flags for insertable attributes, you have access to all the attributes, including READ only and WRITE only.
New Feature Detail New Feature Detail The following sections describe in more detail (than the preceding new feature summary) four of the enhancements made to ECM in Spectrum 5.0. Configuring an Entire Device In ECM 4.0, if a device had subcomponents, you had to configure each component one at a time. With ECM 5.0, you can capture, load, and verify a configuration for an entire device with all its subcomponents without having to do it separately for each subcomponent.
New Feature Detail Ways to Capture, Load, and Verify Configurations Ways to Capture, Load, and Verify Configurations New In ECM 5.0, you can capture, load, and verify configurations, each task in one procedure, in the following ways. The first two ways are the same as in the previous version of ECM. The third way is new: Same • One device specific configuration to one specific device — a one-toone capture, load, and verification (same as in the previous ECM release).
New Feature Detail New Device Specific Configuration View New Device Specific Configuration View You can now see in the ECM main window for device specific configurations all device specific configurations for each device of the same type in the pre-selected landscape. For example, suppose your selected landscape contains three CISCO routers, all of the same model type, type Rtr_Cisco, with router 1 having a CISCO 70, router 2 having a CISCO 75, and router 3 having a CISCO 80.
New Feature Detail Similar Shared Configuration View type in the selected landscape. In the situation illustrated in the preceding diagram, for example, you would see A, B, C, and D.
Chapter 1 Introduction This chapter is an overview of ECM and the configuration management process.
How You Can Use ECM ECM is designed so you can divide the tasks of network management between the network experts who set policy and create the configurations for the network and the system administrators who manage day-to-day operations. The network expert can use ECM in the following ways: • To create templates with the attribute lists that ECM provides. • To create configurations by capturing attribute values from existing devices and then modifying them, if necessary.
The Configuration Management Process The Configuration Management Process Configuration Management involves identifying, controlling, and monitoring the “managed objects” that make up a communication network. A managed object is any device that is modeled in the SPECTRUM database. These include not only hardware devices such as PCs, workstations, hubs, and routers, but also software applications on these devices.
The Configuration Management Process About ECM Templates Figure 1-1.
The Configuration Management Process About ECM Configurations About ECM Configurations Enterprise Configuration Manager allows you to create configurations in two ways — either with templates or manually without templates. During both processes ECM captures attribute values and instance IDs, if any, from the selected device. The ECM capture process provides an efficient way to “populate” a configuration, reducing the chances of human error.
Security Issues Security Issues Enterprise Configuration Manager is a powerful tool. Because it gives users the ability to reconfigure any number of devices on a network, the administrator should use extreme caution when setting up user-privileges. ECM is designed so that network administrators can restrict the types of operations that a user can perform.
Security Issues SNMP Security The following table shows the privileges that are given by ECM community strings. Community String ECM Privileges Windows Accessed ECM,0 - 1 View, Verify, and Load Configurations Create/Edit Templates and Configurations The user can access all operations in all ECM windows. ECM,2 View and Verify Configurations Create/Edit Templates and Configurations The user can access all ECM operations except Load.
Database Storage Constraints Database Storage Constraints Because of SPECTRUM’s database storage requirements, there are limitations on the size of ECM configurations and templates and the number of devices to which you should load a configuration. When you work with ECM, do not exceed the maximums indicated below.
Special Features for Cisco Routers Cisco Host Configuration File With Which ECM Can Work Special Features for Cisco Routers Cisco Host Configuration File With Which ECM Can Work When you are configuring Cisco routers, you have the option of working with both device attributes and Cisco host configuration commands.
Special Features for Cisco Routers Location of Cisco Router Information Location of Cisco Router Information Several chapters in this manual include instructions about working with routers. In general, if you want to quickly locate information about Cisco routers, go to the end of the chapter. You will find the Cisco router information there. The sections on Cisco routers are as follows: Introduction 1-10 • Special Options for Cisco Router Templates in Chapter 3.
Chapter 2 Getting Started This chapter describes basic ECM functionality. In This Chapter • Accessing ECM in SPECTRUM How to access ECM from SPECTRUM. • Specifying ECM Preferences/Settings How to specify the landscapes for configurations and devices, the way the landscapes are displayed, Save and Safe Load options, and attribute flag settings • Navigating to Device Components How to navigate to device components.
Accessing ECM in SPECTRUM Accessing ECM in SPECTRUM Before you can begin working with ECM, you must have SpectroGRAPH up and running. For instructions, see the SPECTRUM System Administrator’s Guide. To access Enterprise Configuration Manager, follow these steps: 1. Open a view window in SpectroGRAPH. ECM is accessible from any view window—Topology view, DevTop view, or Device view, for example. 2. Select the device you want to work with. When selected, the border of the device is highlighted. 3.
Accessing ECM in SPECTRUM Figure 2-1.
Specifying ECM Preferences/Settings Specifying ECM Preferences/Settings The ECM Preferences dialog box allows you to specify the landscapes that will be included in various ECM windows, the way these landscapes will be displayed, and various Safe Load and Save settings. Just remember that these settings apply only to the current ECM session. If you want to define preferences permanently, you must modify the ECM resource file. See Appendix C for these procedures.
Specifying ECM Preferences/Settings Figure 2-2. Specifying Preferences ECM: Main -Shared Configurations for cisco78 from iron File δφσδ ηκ ϕδ γ γϕκλ φδ View Options χον χον νφιγδσ ηϕ ηα ηκτ ριγ ✔ xkxk ✘ eredr ✔uowst ✘ nzcs Setup Help Navigate Components... ◆ April 15 Load... κξκε γηγ ρεδ ηϕκ οωσο ζχτ Search Case Sensitive Verify...
Navigating to Device Components 7. Click on the Search tab and then specify in the resulting dialog box whether you wish to activate (button recessed) the Enable Extended Search option. When active, this feature automatically selects the first match of either the Device name or the Attribute name found in the list; otherwise, the search is done only on Device Name entries. 8. To apply the settings and close the Preferences dialog box, either click OK or else click on Apply and then Cancel.
Navigating to Device Components Figure 2-4. The Components Dialog Box — Scrolled from Top to Bottom ECM: Components - Device Emme1 Main Device (Hub) Device Name Device Typea HubEmme_1 EMME 1 TPRMIM22 2 GenRptrR4Port 2.1 GenRptrR4Port 2.10 GenRptrR4Port 2.11 GenRptrR4Port 2.12 GenRptrR4Port 2.13 GenRptrR4Port 2.14 GenRptrR4Port 2.15 GenRptrR4Port 2.16 GenRptrR4Port 2.2 GenRptrR4Port 2.3 GenRptrR4Port 2.4 GenRptrR4Port 2.5 GenRptrR4Port 2.6 GenRptrR4Port 2.7 GenRptrR4Port 2.8 GenRptrR4Port 2.
Selecting Devices Within ECM • All sub-components of a component appear indented under the component. 2. Select the component that you want to work with and then click on Apply. ECM updates the ECM Main window. You can keep both the ECM Main window and the Components dialog box open at the same time — just arrange them on the screen so both are visible. Then click on various components in the Components dialog box and click on Apply.
ECM Main Window ECM Main Window When you work with ECM, you perform most operations in three windows— the ECM Main, Configurations, and Templates windows. Although these windows differ in some ways, they still have many similarities. Common Features The following pages describe in detail the various sections of the ECM Main window. Features that are explained in detail in this chapter are not described again in other chapters.
ECM Main Window Figure 2-5.
ECM Main Window Devices Section Figure 2-6.
ECM Main Window Configuration Name Section Figure 2-7. Devices Section in Shared Configurations Window Devices Choose... cisco78, cisco70 Click oning the Choose button from the ECM Main window brings up the Select Devices dialog box (Figure 2-8), providing a multi-select device list with a 2-level hierarchy of landscapes containing devices of the same type. Figure 2-8.
ECM Main Window Configuration Name Section Shared Configurations Window If your window is in Shared Configurations window, this Configuation Name section shows a two-level hierarchy of landscapes containing configurations, as shown Figure 2-9, following. Beneath the Configuration section is a button enabling a device-selection window by which you can apply the shared configurations to one or more devices.
ECM Main Window Configuration Name Section Table 2-1 describes the fields in the Configuration Name section. Table 2-1. Fields in the Configuration Name Section Field Function Overview Window The Overview window is a navigational aid that helps you see exactly where you are when you scroll through the Configuration list. Notice that as you scroll down through the configuration list, the rectangular box in the Overview window also moves downward.
ECM Main Window Configuration Name Section Table 2-1. Fields in the Configuration Name Section (Continued) Field Function Configuration Name This field contains the names of configurations created for devices of the same type as the device you selected in SpectroGRAPH or in the ECM Components dialog box. In the device specific window, configurations are indented under the devices they configure. In this window, you can see all the device specific configurations in the selected landscape(s).
ECM Main Window Configuration Information Section Configuration Information Section Figure 2-11 shows the components of the Configuration Information section, which appears in both the ECM Main and Configurations windows. This section contains historical information about the selected configuration. The Template information section contains similar information. Table 2-2 describes the fields in this section. Figure 2-11.
ECM Main Window Configuration Detail Section and Status Field Table 2-2. Fields in the Configuration Information Section (Continued) Field Function Description Field This field contains comments entered by users. To view the complete text, click on the button to the right of the field. This opens a Description dialog box. Because the ECM Main window is a view window, you cannot edit or enter text in the Description dialog box if you open it from this window.
ECM Main Window Configuration Detail Section and Status Field Table 2-3. Fields in Configuration Detail Section (Continued) Field Function Attribute Field Contains the list of attributes in the configuration and their instance IDs, if any. Flags Field Contains the flags of the attributes. Possible flags are: External: The value for the attribute is set outside the SpectroSERVER. Readable: A client or other application can read the attribute value from the SpectroSERVER database.
ECM Main Window Search/Filter Section and Search Icon want to see general configuration information, such as if a configuration was modified, click this button off. Configuration Detail Fields Various ECM windows include Detail sections. However, because you perform different operations in the various windows, the Detail sections differ slightly. The following table describes the fields in the Main window Configuration Detail section.
ECM Main Window Search/Filter Section and Search Icon ECM Search and Filter buttons help you locate a configuration, a template, or an attribute, or a device displayed in a list. Search finds a word that starts with a specific letter or letters. Filter, available only for attribute lists, reduces the list down to those words containing the specified letter or letters. These letters can occur anywhere in the word. To search or filter a list, use the icons and buttons described in the following table.
ECM Main Window Window View — Shared or Device Specific Window View — Shared or Device Specific You can display two ECM windows — Main and Configurations — in either Shared Configurations or Device Specific Configurations window. If you want to change the view, select the appropriate option — Shared Configurations or Device Specific Configurations — from the View menu, as shown in Figure 2-14. Figure 2-14.
ECM Main Window Quick-Access PoP-Up Menus NOTE Once you select the window view in the ECM Main window, this view applies to both the ECM Main and Configurations windows. However, if you change the view in the Configurations window, that view becomes independent of the view in the Main window. In either window, you can select the view. Quick-Access PoP-Up Menus Some ECM windows, including the Main window, have menu short cuts that eliminate the need to reposition the mouse pointer to select an option.
ECM Main Window Pull-Down Menus & Buttons Figure 2-15. File and View Menus in the ECM Main Window File Print... Close Table 2-5.
ECM Main Window Pull-Down Menus & Buttons Table 2-6. View Menu Options and Their Functions (Continued) Option Function Sort Options Click on the various View options to sort the configurations listed in the Configurations field: either by Name (alphabetically), Create Time, Modify Time, Load Time, Attribute, Flags, or Sequence. In the Main window, the View by Sequence option displays the sequence in which attributes are loaded.
ECM Main Window Pull-Down Menus & Buttons Table 2-7. Options Menu and Tool Bar Button Functions Option/Button Function Navigate Components... Opens the Components dialog box where you see all the components of the device you selected in SpectroGRAPH. If your device is a hub, for example, you see the applications, interfaces, and boards in the hub and also the sub-components of the boards and applications. The sub-components could include ports and secondary applications. Load...
ECM Main Window Pull-Down Menus & Buttons Table 2-7. Options Menu and Tool Bar Button Functions (Continued) Option/Button Function View Host Displays the host configuration. Configuration... If the letters on the button/option are visible, the configuration includes the Cisco host configuration. If the letters are grayed-out, the selected View Host Configuration... configuration does not include the host configuration.
Tips for Working with ECM Windows Figure 2-17. File View Setup & Help Menus ECM: Main - Shared Configurations for Device Cisco 78 from iron Options Setup Help Templates... About Enterprise Configuration Manager Configurations... Table 2-8. Setup and Help Menu Options Menu Option Function Setup Templates Opens the Template window where you create, edit, delete, save, print, import, and export templates. See Chapter 3 for details.
Tips for Working with ECM Windows If you create a long list of configurations, you may want to enlarge the upper part of the window so that you can view the list more easily. After you enlarge the panel, drag the Sash button upward to return the panel to its original size. 3. Drag on the bottom edge (or corner) of the Main window to resize the lower panel of the window. When you want to view many attributes in the attribute list, you may need to expand this section of the window.
Tips for Working with ECM Windows appropriate underlined letter in the menu name. Then, to select a menu option, simply press the key corresponding to the appropriate underlined letter in the option label. NOTE If the ALT-enabled sequence does not open the pull-down menu, check the documentation for your particular keyboard to determine whether a different key has been coded to perform this Meta function on your keyboard. 4.
Tips for Working with ECM Windows Selecting One or Multiple Items at a Time ECM allows you to use single-selection or multi-selection methods to select attributes, configurations, templates, or devices that occur in lists. The multi-selection methods make it easy to add many attributes to a configuration or to quickly delete configurations.
Chapter 3 Creating and Managing Templates This chapter shows how to create, edit, save, delete, and print templates. In This Chapter 9030944 E10 • When to Use Templates Why use templates. • Accessing the Templates View How to access templates. • Templates View Features of the Templates view. • Creating a New Template How to create a template. • Editing a Template How to edit a template. • Creating a Template from a Configuration How to create a template from a configuration.
When to Use Templates When to Use Templates When you work with Enterprise Configuration Manager (ECM) you can create configurations with templates and without templates. In both processes ECM captures attribute values, flags, and instance IDs, if any, from the device. Even though both processes are similar, you need to use templates at certain times. Templates are convenient in these situations: • To create configurations quickly.
Templates View • Import and export templates (refer to Chapter 7). The Templates view is similar to the ECM Main view except that it provides information about templates rather than configurations. This chapter describes the features that are unique to the Templates view —specifically, the menu options, buttons, Template and Detail sections, and the Include Host Configuration field. Figure 3-1.
Templates View Template Section Template Section Figure 3-2 identifies the major components making up the Template Sections area. Table 3-1 provides descriptions explaining the purpose and use of each such component. Figure 3-2. Template Section Details Landscape Name Overview Window Table 3-1.
Templates View Template Information Section Table 3-1. Function of Template Section Components (Continued) Field Function Version Number Helps you track the modifications of templates.When you modify an existing template and then click on Save, ECM always increments the version number of the template regardless of whether you are overwriting the existing template or creating a new template.
Templates View Template Detail Section of the Templates View Table 3-2. Function of Fields in Template Information Section Field Function Time Created Time Modified These fields contain the last date and time the template was created and modified. If the template has not been modified, the Time Modified field says Not MODIFIED. Created By Modified By These fields contain the login name of the person who created or modified the template.
Templates View Template Detail Section of the Templates View Table 3-3. Function of Components in Template Detail Section Field/Button Function Template Detail label The Template Detail label itself constitutes an on/off selector, showing a conventional check box radio button at its left end (actuated by clicking anywhere in the shaded portion of the label area). When this button is recessed, the window shows attribute details of the selected template, along with the insertable attribute list details.
Templates View Template Detail Section of the Templates View Table 3-3. Function of Components in Template Detail Section (Continued) Field/Button Function Include Host Configuration Field Has two functions: (1) shows you whether the selected template will capture the host configuration, and (2) enables you to create templates that will capture the host configuration. To do the latter, select the template name; then click on the Yes button in the Include Host Configuration field and save the template.
Templates View File Menu Options & Associated Buttons File Menu Options & Associated Buttons Figure 3-5 identifies the options in the Template View’s File Menu. Table 3-4 provides descriptions explaining the purpose and use of each option. Figure 3-5. File Menu Options for Templates View File Edit ECM: Templates - Templates for Device Type Rtr_CiscoIGS View Options New Save Save As... Delete Print Close Alt+F4 Table 3-4.
Templates View Edit, View, and Options Menus Table 3-4. Function of File Menu Options and Associated Tool Bar Buttons (Continued) Option/ Button Function Print Prints the selected template. Specify the printer name and type in the Printer dialog box that appears. Close Closes the Templates view. Edit, View, and Options Menus Figure 3-6 identifies the options available in the Edit, View, and Options menus as they would appear if all three could be displayed at once.
Templates View Edit, View, and Options Menus Table 3-5. Option Function of Edit/View/Options Selections (Continued) Function Cut Ctrl+X Removes any currently selected (highlighted) entry or entries in the Template Detail scroll list, returning them to the Insertable Attribute list. You can use the Ctrl+X keyboard shortcut in place of this Edit > Cut option; alternatively, you can accomplish the same result by clicking on the Cut button in the lower left corner of the view.
Creating a New Template Creating a New Template Overview The ECM Templates view provides you with a list of attributes that you use to create templates. Specifically, the attribute list includes all the readable/ writable and non shared attributes for the selected type of device. When you use the template to capture a configuration, ECM captures the values of the attributes specified in the template and includes the captured attribute/value pairs in the new configuration.
Creating a New Template Figure 3-7. Creating a Template ECM: Main - Shared Configurations for cisco78 from iron File View δφσδ ηκ ϕδ ✔ xkxk ✘ eredr Options χον con νφιγδσ ηϕ ηα ηκτ rig ◆ April 15 1 Setup kxk e Help Templates... Case Sensitive Search Configurations...
Creating a New Template ECM moves the selected attribute(s), with their flags, to the Attribute field. As a result, the Insertable Attribute field following this operation contains only those attributes that have not been added to the template. 5.
Creating a New Template Figure 3-8. Saving the New Template ECM: Save As 8a ECM: Creation Landscape Landscapes Creation Landscape... New Name: OK iron flight acorn iron vacation 9 Handles 0x006c0000 0x006c0021 0x006c0022 8b Cancel OK Cancel ECM: Information i Template saved successfully. OK 10 8. Make sure the Creation Landscape field specifies the landscape where you want to store the template. If you want to store the template elsewhere, follow these steps: a.
Editing a Template Editing a Template Once you have created templates, you can edit the templates by adding or cutting attributes. Follow these steps to edit your template: 1. Select the template that you want to edit in the Templates view. The Attribute field now displays all the attributes in that template. If you are working with a Cisco router device, the Yes/No buttons in the Include Host Configuration field indicate whether the template includes the host configuration. 2.
Creating a Template from a Configuration Creating a Template from a Configuration You can also create a template from an existing configuration. The Convert to Template option located in the Options menu of the Configurations view allows you to do this. When you use this option, ECM takes the attributes listed in the configuration, creates a template from them, and gives the template the same name as the configuration. Then ECM saves the template to the landscape that you specify.
Deleting a Template 4. Click on OK in the message box. 5. Click on File, Close to close the Configurations view. When you open the Templates view again, you can see the template listed under the landscape that you specified. The template has the same name as the configuration. Deleting a Template To delete one or more templates: 1. Select the templates you want to delete. To select multiple entries, hold down the CONTROL key while you click on entries. 2. Click on the Delete option in the File menu.
Printing a Template 3. Specify the name of your printer and the printer type — either ASCII or PostScript — and confirm your selection by clicking on OK. (The order of these steps differs slightly depending on the machine that you are working with.) You have to enter the printer name and type only once during an ECM session because ECM saves the information for the duration of the session. You can still change the printer name and type any time.
Special Options for Cisco Router Templates Special Options for Cisco Router Templates When you work with a Cisco router belonging to a device type listed in the CISCO_MTYPES file, the Templates view contains an additional field at the bottom called Include Host Configuration (see Figure 3-12). This field provides two functions. First, it enables you to specify whether you want to capture the Cisco host configuration with a new or edited template.
Chapter 4 Creating and Managing Configurations This chapter shows you how to create, edit, compare, delete, and print configurations. In this Chapter 9030944 E10 • About Creating/Editing Configurations Information you should know before starting to create and edit configurations. • Why Create Configurations from Templates When to use templates to create configurations. • Why Create Configurations without Templates When not to use templates to create configurations.
About Creating/Editing Configurations • Creating and Editing the Cisco Host Configuration How to create and edit the Cisco Host Configuration file. • Viewing and Editing the Host Configuration Passwords How to view and edit Cisco Host Configuration passwords. About Creating/Editing Configurations You should know the following about creating or editing configurations in ECM: • You must be in the Configurations window to create or edit a configuration.
Why Create Configurations from Templates To change a device specific configuration to a shared one, (1) select the configuration, and (2) from the Options menu, select Move to Shared. - Shared among devices of the same type If you are in shared view when you create a configuration, the configuration will be shared. Otherwise it will be device specific. To change a shared configuration to a device specific one, (1) select the configuration and from the Options menu, (2) select Move to Specific Device.
Configurations Window Configurations Window The Configurations window — Shared View and Device Specific View — enables you to perform all the functions that are necessary for creating and editing configurations. See Figure 4-1. You access this window from the Main window Setup, Configurations... men bar option. Figure 4-1.
Configurations Window File Menu and Related Buttons Initial View If you have just installed ECM, you will find the fields in the Configurations window empty because ECM does not provide any default configurations. Since there are no configurations for you to select, the buttons and options are disabled. When you or other users create configurations, however, the configurations that are available to the selected device appear in Configurations window. Then the buttons and options also become enabled.
Configurations Window File Menu and Related Buttons Figure 4-2. File Menu Options for the Configuration Window ECM: Configurations - Shared Configurations for Device cisco78 from iron File Edit View Options New Save Save As... Delete Print... Close Alt+F4 Table 4-1. File Menu Options and Associated Tool Bar Buttons Option Function New Creates a new configuration. When you click on the New option/button, ECM adds the name to the Configuration list.
Configurations Window Edit Menu Edit Menu Figure 4-3 shows the Edit menu options of the Configuration window. Table 4-2 describes the functions of each option in that menus. Figure 4-3. Edit Menu ECM: Configurations- Shared Configurations for Device cisco78 from iron File Edit View Options Undo Discard All Changes Cut Copy Paste Update Wild Attr. Wild Comp. Table 4-2.
Configurations Window View Menu Table 4-2. Functions of Edit Menu Options (Continued) Option Function Paste Places the attribute(s) that were most recently put in the paste buffer into the configuration in the order selected by the sort option. For example, if the selected sort option is by attribute name, the attributes will be inserted alphabetically. If the selected sort option is by sequence, the attributes will be inserted beneath the attribute you have selected.
Configurations Window Options Menu & Related Buttons Table 4-3. Functions of View Menu Options Option Function Shared Configurations Displays shared configurations in the Configurations and Main windows. Device Specific Configurations Displays device specific configurations in the Configurations and Main windows.
Configurations Window Options Menu & Related Buttons Figure 4-5. File Option Menu Options Edit ECM: Configurations - Shared Configurations for Device cisco78 from iron View Options Import... Export... Export All... Convert to Template Capture... Schedule... Move to Specific Device… Edit Host Configuration... Table 4-4. Use Configuration’s Landscape Use Creation Landscape Choose Landscape... Option Menu Options and Associated Tool Bar Buttons Option/Button Function Import...
Configurations Window Options Menu & Related Buttons Table 4-4. Option Menu Options and Associated Tool Bar Buttons (Continued) Option/Button Function Capture... Captures the configuration of the selected device(s). δφσδηκ ϕδ ϕκ κλ γ γ δ δηφϕη δϕκ δκε ικ δϕκλδλϕφ λ; κϕ λ κϕ δ Schedule... When you click on the Capture option/button, a Capture Configuration dialog box appears.
Configurations Window Options Menu & Related Buttons Table 4-4. Option Menu Options and Associated Tool Bar Buttons (Continued) Option/Button Function Edit/Add Host Configuration... Allows you to view, add, or edit the host configuration. ECM displays this button only if your device is a Cisco router and its type is included in the CISCO_MTYPES file. SRefer to Special Features for Cisco Routers, on Page 1-9, 1 for more details about the CISCO_MTYPES file.
Configurations Window Configuration Information Section and Description Dialog Box Configuration Information Section and Description Dialog Box Figure 4-6 shows details of the Configuration Information Section and the associated Description dialog box that appears when you click on the button to the right of the descriptions field. Figure 4-6.
Configurations Window Configuration Detail Section Use the Description dialog box to provide configuration information for subsequent users. The text can include up to 256 characters. Configuration Detail Section Figure 4-7 shows details of the Configuration Detail section of the Configuration window. Table 4-5 describes the functions of each option in that menus. Figure 4-7.
Configurations Window Configuration Detail Section Table 4-5. Function of Components in Configuration Detail Section (Continued) Field/Button/ List Function Insertable Attribute List A generic list of all the readable/writable and non shared attributes for the type of device selected — a specific device might not have some of these attributes. A question mark next to the attribute name indicates that the attribute has more than one instance ID.
Configurations Window Configuration Detail Section Table 4-5. Field/Button/ List Function of Components in Configuration Detail Section (Continued) Function Copies the selected attribute(s) with instance IDs. Copy To copy an attribute: 1. Select View by Sequence from the View menu. 2. Select the attribute in the configuration attribute list. 3. Click on Copy. ECM adds a duplicate attribute to the paste buffer. 4. Select the attribute under which you want the copied attribute placed. 5. Click on Paste.
Configurations Window Configuration Detail Section Table 4-5. Field/Button/ List Function of Components in Configuration Detail Section (Continued) Function Edit Buttons (continued) Wild Attr. Wildcards (applies wildcard capability to) a list attribute, an attribute that can have more than one instance in the configuration. List attributes are identified in the Insertable Attribute list by a question mark to the right of the attribute name. The Wild Attr.
Configurations Window Configuration Detail Section Table 4-5. Field/Button/ List Function of Components in Configuration Detail Section (Continued) Function Edit Buttons (continued) Wild Comp. Wildcards (applies wildcard capability to) a device component having more than one instance (for example, two or more repeater ports) in a configuration. Device components are identified in the Insertable Attribute list by a question mark to the right of the device name. The Wild Comp.
Configurations Window Configuration Detail Section Table 4-5. Field/Button/ List Function of Components in Configuration Detail Section (Continued) Function Edit Buttons (continued) Modifies the values or instance IDs of the attributes in your configuration. Update Notice that when you select a single attribute in the Configuration Attribute list, the value appears in the Value text box and, if present, the instance ID appears in the Instance ID text box.
Configurations Window Configuration Detail Section Table 4-5. Field/Button/ List Value Text Box Function of Components in Configuration Detail Section (Continued) Function Allows you to edit an attribute’s value. To edit an attribute’s value: 1. Select the attribute in the configuration attribute list to display the attribute’s value in the Value text box. 2. Enter the correct value in the Value text box. 3. Click on Update to add the value to the attribute in the configuration list.
Creating a Configuration without a Template Creating a Configuration without a Template When you create configurations without a template, you can insert any attribute in the configuration even if ECM cannot capture its value from the device. ECM notifies you when it cannot capture attribute values. Then, after notifying you, ECM enters a default value (either a number, text string, or blank) as the attribute’s value and, if applicable, a question mark as a placeholder for the instance IDs.
Creating a Configuration without a Template Procedure Details The Configurations window, the window where you can create and edit configurations, appears. 4. In the Configurations window, select the New button or menu option. • If you are in device specific view, the Select Devices window appears. In this case, select the device whose configuration you want to create or edit. You can only select one device. Then click on OK.
Creating a Configuration without a Template Procedure Details If necessary, select Shared or Device Specific Configurations from the View menu of the Main window. You can also select the type of configuration (device specific or shared) in the Configurations window (Step 4).
Creating a Configuration without a Template Procedure Details • To select a single attribute, simply click on the attribute entry line. • To select a single group of multiple consecutive attributes, either click on the first attribute, hold down the shift key and then click on the last attribute you want to select, or else simply drag the cursor over the desired group of attributes. • To select multiple nonconsecutive attributes, hold down the Control key as you select entries.
Creating a Configuration without a Template Procedure Details selected conditions, select (highlight) the attribute(s) in the left-hand Attribute list that you want to remove, and then click on the Cut button to move the selected attribute(s) from the left-hand list to the right-hand list. Selection of multiple attributes is accomplished in the same way as described above.
Creating a Configuration without a Template Procedure Details Later (see Step 8), you can manually enter values for the uncaptured attribute values or delete the attributes from the configuration. 8. If you want to edit or manually add commands to a Cisco router host configuration, click on the Edit/Add Host Configuration button in the Configurations window. Then edit or enter the commands in the Edit/Add Host Configuration dialog box that appears.
Creating a Configuration with a Template Figure 4-9. Saving the New Configuration ECM: Creation Landscape ECM: Save As Landscapes 12 Creation Landscape... New Name: 13 iron flight acorn iron vacation OK 0x006c0000 0x006c0021 0x006c0022 Cancel 12 OK Cancel ECM: Information i Configuration saved successfully. 14 OK 13. Type the configuration name in the name field of the Save As dialog box. Then click on OK (or click on the Return key) to close the dialog box. 14.
Creating a Configuration with a Template Checking for Appropriate Template Checking for Appropriate Template Before you create a configuration with a template, make sure you have the appropriate template(s) to use in the capture process. To check the available templates, select Setup, Templates from the Main window menu bar. Then select device specific or shared from the View menu. ECM captures the values of those attributes specified in the template.
Creating a Configuration with a Template Creating a Template TIP You must release the Control key when you want to scroll up or down to an out-of-sight attribute, in order to avoid moving all the way to the end of the scroll list, and then hold down the Control key down again before clicking on any further selections. • To select all the attributes, click on the right side of the Select All button.
Creating a Configuration with a Template Creating a Template NOTE You can create templates for configurations that require some attributes to be configured before other attributes. If you create multiple templates and then multiple configurations for a single device, you can load the configurations to the device in the required order. 6. When you have finished, click on File, Save As in the menu bar. The Save option is grayed-out because this is a new template that needs a name.
Creating a Configuration with a Template Creating a Configuration with a Template — Procedure Process Creating a Configuration with a Template — Procedure Process The ECM Templates window provides you with a list of attributes that you use to create templates. This list includes all the readable/writable and non shared attributes for the selected type of device. When you use a template to capture a configuration: 1.
Creating a Configuration with a Template Creating a Configuration with a Template — Procedure Summary 6. Make sure the Creation Landscape field specifies the landscape where you want to save the configuration. If you want to store the configuration elsewhere, follow these steps: a. In the Capture Configuration window, click on the Creation Landscape button to bring up the Creation Landscape dialog box.
Creating a Configuration with a Template Creating a Configuration — Procedure Details Creating a Configuration — Procedure Details 1. From the Main window menu bar, select Setup, Configurations.... This displays the Configurations Window. 2. Click on the Capture button or menu option. δφσδη κ ϕδ ϕκ κλ γ γ δ δηφϕη Figure 4-10. A Capture Configuration dialog box is displayed. It includes the templates that you created for this device type. See Figure 4-10.
Creating a Configuration with a Template Creating a Configuration — Procedure Details Clicking on the Choose button brings up the Select Devices dialog box Refer to (see Figure 4-11), which presents a list box with a 2-level hierarchy of landscapes containing devices of the same type. The list box is single-select if you want to create shared configurations (that is of the shared configuration type) and multiselect if you want to create device specific configurations. Figure 4-11.
Creating a Configuration with a Template Creating a Configuration — Procedure Details a. In the Capture Configuration window, click on the Creation Landscape button to bring up the Creation Landscape dialog box. The Creation Landscape dialog box lists landscapes that are reachable and also have the ECM server component installed on them. b. In the Creation Landscape dialog box, select the new landscape and click on OK.
Creating a Configuration with a Template Creating a Configuration — Procedure Details Figure 4-12. Capture Result and Capture Detail Windows ECM:ECM: Question Question Some attributes were not captured. ? Therefore, those attributes will not appear in the configuration. Do you wish to view these attributes? 9 Yes No ECM: Capture Detail - all_attr on iron 10 File Print...
Editing a Configuration Editing a Configuration You can edit a configuration at any time: • After you capture the configuration with a template. • While you are creating a configuration without a template. • After you save a configuration. The following sections describe the various editing procedures.
Editing a Configuration A Quick Method to Add Attributes with Instance IDs 2. Select a single attribute. When you select a single attribute, the attribute’s instance ID, if any, and value appear in the Instance ID and Value field, respectively. If these fields remain empty, you may have multiple entries selected. In this case, click on the left side of the Deselect All button and then select the attribute again. 3. Type the correct information in the Instance ID and Value text fields.
Editing a Configuration A Quick Method to Add Attributes with Instance IDs possible) all instances of this attribute. Although you may add one entry from the Insertable Attribute list, many instances of the attribute may appear in the Attribute/Value list. Some configurations require only a few instances of an attribute rather than all the instances that ECM inserts.
Editing a Configuration A Quick Method to Add Attributes with Instance IDs Figure 4-14. Selecting, Adding, and Cutting Attributes with Instance IDs Device Attribute Flags Value Flags Deselect All 2 RW RW RW RW RW RW RW RW Add Select All Copy Paste Update Wild Attr. Wild Comp. Edit Host Configuration Cut Instance ID ? Value Device Insertable Attributes Rtr_Cisco Rtr_Cisco Rtr_Cisco Rtr_Cisco Rtr_Cisco Rtr_Cisco Rtr_Cisco Rtr_Cisco AAtest_attrib ATIfIndex. ? ATNetAddr. ? ATPhysAddr.
Editing a Configuration Applying Wildcard Capability to Attributes Applying Wildcard Capability to Attributes You can wildcard (apply wildcard capability to) list attributes and devicecomponent attributes in a configuration. List Attributes A configuration can have attributes with more than one instance in a device component. These are called list attributes. In the Insertable Attributes list, a list attribute is identified by a question mark after its name.
Editing a Configuration Applying Wildcard Capability to Attributes Figure 4-16. List Attributes in the Configuration Attribute List Device Attribute Flags Value UDP2_App UDP2_App UDP2_App UDP2_App udpLocalPort. 0.0.0.0.160 udpLocalPort. 0.0.0.0.161 udpLocalPort. 0.0.0.0.162 udpLocalPort. 0.0.0.0.7 R R R R 160 161 162 7 Device-Component Attributes A configuration can have the same attribute (though a different instance of it) for each instance of a device component (for example, device ports).
Editing a Configuration Applying Wildcard Capability to Attributes Figure 4-18. Device-Component Attributes in the Configuration Attribute List Device Attribute Flags Value CSIIFPort.1 CSIIFPort.1 CSIIFPort.1 UDP2_App ip_address ifSpeed Message_Size udpLocalPort. 0.0.0.0.160 RW R RW R 0.0.0.0 10000000 1500 160 List and Device-Component Attribute Combinations Some attributes can be both a list attribute and a device-component attribute.
Editing a Configuration Applying Wildcard Capability to Attributes • Wildcarding reduces the number of instances of an attribute that you may need in a configuration. A wildcarded attribute in a configuration enables you to use one instance of the attribute in a configuration to load the same value into many instances of the attribute in a device. This reduces the number of instances of a device-component attribute you may need in a configuration.
Editing a Configuration Applying Wildcard Capability to Attributes 5. If needed, edit the value of the selected, wildcarded attribute in the Value text box, and click on Update. After you have wildcarded a list attribute instance, an asterisk appears to the right of the attribute instance name in the attribute configuration list, indicating that it is now a wildcarded attribute. In Figure 4-20, udpLocalPort is an example of a wildcarded attribute. 6.
Editing a Configuration Applying Wildcard Capability to Attributes 3. Select an instance of the attribute in the configuration attribute list after the instances whose values you want to remain unique. Selecting an attribute having a device component instance in the configuration attribute list enables the Wild Comp. button. 4. Click on Wild Comp., or put an asterisk in the Value text box and click on Update.
Editing a Configuration How to Duplicate Attributes with Instance IDs Figure 4-22. A Verify Detail of a Wildcarded Attribute ECM: Verify Detail - Device frog4 from iron File View Device Setup Attribute Device Value Configuration Value ✓CSIIfPort.1 Message_Size Device Value: 1500 Configuration Value: 1500 ✓CSIIfPort.2 Message_Size Device Value: 1500 Configuration Value: 1500 ✓ CSIIfPort.
Editing a Configuration Converting Hexadecimal Values to ASCII or Decimal ECM puts an exact duplicate of the attribute (including a duplicate instance ID) in the list. (When you perform a Paste operation, the Undo option in the Edit menu becomes renamed as Undo Paste. Until you perform some other operation, you can undo this duplication action by clicking on that Undo Paste option.) 4. Modify the duplicate attribute’s value as necessary ty typing the new value into the Value field in the lower left corner.
Editing a Configuration Making a Configuration Device Specific To edit the values of Octet or Tagged Octet attributes, follow these steps: 1. Select the Octet or Tagged Octet attribute that you want to modify. When you select one of these attributes, the Values button becomes enabled. 2. Click on the Values button. A Convert dialog box, similar to that in Figure 4-24, appears. 3.
Comparing Two Configurations If your configuration includes attributes that are unique to the device — an IP address, for example — you should make the configuration device specific. How To Tell a Configuration Type You can see the different type of configurations by changing the view mode of the window. The title bar in the Main and Configurations windows indicates whether the configurations in that window are shared or device specific.
Comparing Two Configurations 2. Select the two configurations that you want to compare. (Hold down the CONTROL key and click on the two entries.) The Compare option and button become enabled at this time. confi g67 confi hkl; g67 config67 78 hkl; 78 3. Click on the Compare option or button. A Comparison Detail window, similar to that in Figure 4-25, appears. Attributes are displayed with either ✘s or ✓s in front of them. An ✘ indicates that the values of the two attributes do not match.
Deleting a Configuration Deleting a Configuration To delete one or more configurations, follow these steps: 1. Select one or more configurations. To select multiple configurations, hold down the CONTROL key and click on the configurations. 2. Click on Delete in the File menu. ECM displays a message box asking you to confirm the deletion. 3. Click on Yes in the message box. ECM deletes the configuration(s). Printing a Configuration ECM saves the most recent version of each configuration.
Printing a Configuration Figure 4-27. 09:50 AM Wed Jan 29 1997 Sample Printouts of ECM Configurations Enterprise Configuration Manager Page 1 Configuration Listing for Cisco_config (ver.2) from acorn Attribute ____________ Value ___________ Community_Name ContactPerson Contact_Status DeviceType public Maple 1 CiscoMIM 09:55 AM Wed Jan 29 1997 Enterprise Configuration Manager Page 1 Configuration Listing for EMME_config (ver.
Creating and Editing the Cisco Host Configuration Creating and Editing the Cisco Host Configuration If you are working with a Cisco router, the Configurations window enables you to capture the Cisco host configuration with a template, then view, edit, and print the host configuration. Remember the following points when creating configurations for Cisco routers: • You can create a configuration that includes the entire Cisco host configuration by capturing the host configuration with a template.
Creating and Editing the Cisco Host Configuration 3. Click the mouse in the text field so that you see the blinking cursor, and then insert or edit text. • If the host configuration exists, simply delete or add text. • If the Edit Host Configuration window is empty, type in the appropriate commands. (Make sure that you use the correct syntax for Cisco commands; (ECM does not check the syntax.
Creating and Editing the Cisco Host Configuration Figure 4-29. PostScript Printout of a Cisco Host Configuration 09:24 AM Wed Feb 26 1997 Enterprise Configuration Manager Page 1 Host Configuration Listing for cisco_host_config (ver.2) from iron This password enables users to configure the router in an interactive terminal session. This community name must match the community name of the device.
Viewing and Editing the Host Configuration Passwords Viewing and Editing the Host Configuration Passwords In both the Configurations and ECM Main windows, there are Host Configuration buttons that give you access to the Cisco host configuration. However, you can view and edit the host configuration password only when you access the host configuration from the Configurations window.
Viewing and Editing the Host Configuration Passwords Creating and Managing Configurations 4-58 Enterprise Configuration Manager User’s Guide
Chapter 5 Loading a Configuration This chapter explains how to load a configuration in one procedure to one or more devices of the same type. In This Chapter 9030944 E10 • Selecting Devices and Configurations Ways to specify configuration(s) to load and devices to be loaded. • Load Procedure — Summary A quick view of the load procedure for all types of configurations and devices. • Load Options — Summary A list of all options when you load a configuration.
Selecting Devices and Configurations Selecting Devices and Configurations How to Select Devices of Different Types In ECM, you can load configurations in one procedure to one or more devices of the same type in the selected landscape(s). This means: • To chose a different type of device from the one selected in SPECTRUM, you must exit ECM, select a device of the type you want in SPECTRUM, and return to ECM. For example: 1.
Selecting Devices and Configurations Three Ways to Specify Devices to be Loaded How to Change a Device Specific Configuration to a Shared One, on Page 5-21).
Load Procedure — Summary Load Procedure — Summary Though the load procedure differs slightly depending on whether the configuration is device specific or shared, the basic steps are the same: 1. Select the configuration you want to load. If you are loading device specific configurations, you can select more than one configuration at a time. 2. Select the devices to which you want to load. With device specific configurations, this step is unnecessary if a configuration(s) was previously loaded to a device.
Load Options — Summary - The default window is Shared unless you change the default. Viewing the types separately helps prevent confusion. - You can change a device specific configuration to shared or a shared one to device specific. These are options in the ECM Main window Options menu. You load a configuration from the window in which you see it: Device Specific or Shared (see Loading Device Specific Configurations, on Page 5-15 and Loading Shared Configurations, on Page 5-23).
Load Options — Summary attribute cannot be loaded, the configuration will be R (rolled back). That is, the original configuration will be replaced in the device. • Doing a One-to-One or a Many-to-Many Device Specific Load In a device specific load, you can load a configuration to one specific device or load many device specific configurations to many devices of the same type, on a one to one basis in the selected landscape(s).
Device Landscapes, Buttons, Codes, and Settings attributes did not load. By printing out this list you can save it for further analysis so that you can fix the problem. • Viewing Load Results After a load, you can view the load summary results in the Load Results window and the load detail results (the attributes and the load status of each) in the Load Detail and Rollback Failure windows. For a device specific configuration example, see Figure 5-4 on Page 5-19 and Figure 5-5 on Page 5-20.
Device Landscapes, Buttons, Codes, and Settings Device Landscapes - “Rollback on Load Failure (Safe Load)” - “Store Device Configuration Before Load” Device Landscapes If the preselected landscapes are not what you want, from the Options menu in the Main window, select the Preferences option to specify the device landscapes.
Device Landscapes, Buttons, Codes, and Settings Load Button Load Button δφσδηκ ϕδ ϕκ κλ γ γ δ δηφϕη δϕκ δκε This menu option/button begins the load process. Load Status Codes The Load Status column in the ECM Main and Configurations windows indicates the load status of your configurations. See Figure 5-2. When you create and load configurations, ECM dynamically updates their Load Status in both the Main and Configurations windows. The Load Status column contains the following status codes.
Device Landscapes, Buttons, Codes, and Settings Load Status Codes Figure 5-2. Load Button, Load Status, and Load Settings Load Button Page 5-15 to 5-23 Load Status Page 5-9 ECM: Main - Shared Configurations for Cisco78 from iron File View δφσδ ηκ ϕδ γ γϕκλ φδ ✔ xkxk ✘ eredr ✔uowst ✘ nzcs Options χον χον νφιγδσ ηϕ ηα ηκτ ριγ ◆ Setup κξκε γηγ ρεδ ηϕκ οωσο ζχτ Help Navigate Components... April 15 Case Sensitive Search Load... Verify... Compare Configuration Name Schedule...
Device Landscapes, Buttons, Codes, and Settings Clear Load-Status Button Clear Load-Status Button kxkee k gh gh There are times when you might want to clear (reset) the load status of a configuration displayed in the Main and Configurations windows to get a more accurate picture of the configurations that are loaded on your network.
Device Landscapes, Buttons, Codes, and Settings • Resource file (see Resource File, on Page B-1) • Load Confirmation dialog box (see Figure 5-3 on Page 5-17) The following sections explain how the options work. Store Before Load The “Store Device Configurations Before Load” option captures the device configuration before loading it and then saves it if the load fails. This option compares the backed up configuration with the one that you subsequently loaded to the device.
Device Landscapes, Buttons, Codes, and Settings When Safe Load is off, on the other hand, ECM continues loading attributes even if some or all of the attributes cannot be loaded until it has tried loading them all. Although Safe Load cannot make the load process fail-safe, it does make the process safer. At most, with Safe Load on, you may have to manually restore the configuration of one device if the rollback fails.
Device Landscapes, Buttons, Codes, and Settings • If the rollback is successful, ECM displays a Load Results window, which shows you the results of the safe load. In this case, the result says Rolled Back. From the Load Results window, you can open the Load Detail window, which shows you the Load status of each attribute. The attribute that caused the rollback might have a status of “Can’t write attribute value” or “No such attribute,” indicating the error condition that triggered the rollback.
Loading Device Specific Configurations Procedure Summary what happened. Device 1 has a load result of Successful. Device 2 has a load result of Rolled Back. Device 3 has a load result of Rollback Failed. Device 4 has a load result of Not Loaded. 5. If you open the Load Detail windows for the different devices, you can see the load status of each attribute. In the case of Device 3, you can open an additional Rollback Load Failure Detail window that displays the attributes that you must manually restore.
Loading Device Specific Configurations Procedure Details • Press the Load Detail button or click on the Load Detail option under the Options menu. • Or double click on a device name. • Or select a device and press Return. A Load Detail window is displayed. 7. Click on the View All or the View Unsuccessful button to see all the attributes or just the ones that were not successfully loaded. (You can toggle between these windows.) 8.
Loading Device Specific Configurations Procedure Details Figure 5-3.
Loading Device Specific Configurations Procedure Details Thresholds and Community_Name are selected to be loaded to Cisco78 and the configuration CommunityName is selected to be loaded to Cisco80. 4. Select one or more device specific configurations for each device: • If you want one configuration, select that configuration. It will be loaded to the device listed above it.
Loading Device Specific Configurations Procedure Details Figure 5-4. Load Results Window: Two Versions ECM: Load Results - PM_weekends (ver. 4) from iron File Options 8a Load Detail... Device Name Result iron Cisco78 Board Status Safe Load is off. Partially Loaded ECM: Load Results - PM_weekends (ver. 4) from iron - Load Detail... File Options Device Name Result iron Cisco78 Safe Load is on. Rolled Back means that the original configuration was restored to the device.
Loading Device Specific Configurations Procedure Details Figure 5-5. Load Detail Window: Two Versions 9 ECM: Load Detail - Device Cisco78 from iron File View View by Attribute Attribute View by Sequence Load Status mdl_modfy_time Load not attempted model_mismatch Load not attempted rel_handle Can’t write attribute value rout_attr Success rout_num Success router_redundancy Success In both windows, the Load Status of attributes indicates that Safe Load is on.
How to Change a Device Specific Configuration to a Shared One option. This arrangement lists the entries by alphabetical order of attribute for each device. If you wish to change from the alphabetic arrangement back to the sequence in which attributes are loaded, select the View by Sequence option from that same pull-down menu. File Print... Close 10. If desired, you can print load results for your records. You might especially want to do this if some attributes in the configuration could not be loaded.
How to Change a Device Specific Configuration to a Shared One Loading the Converted Configuration The configuration is converted and a message box informs you of the conversion. To load the configuration, use the procedure for loading shared configurations. Figure 5-6. Changing a Device Specific Configuration to Shared ECM: Configurations - Device Specific Configurations for type Rtr_CiscoIGS from iron File Edit View φλϕ λ κϕχσ δ Options Navigate Components... Case Sensitive Search Move to Shared...
Loading Shared Configurations If you have any questions regarding the load procedure, check the more detailed version of the following procedure, Loading Shared Configurations. Loading Shared Configurations You can load a shared configuration to one or to multiple devices of the same type. The following is the procedure summary. If you have questions, check the more detailed procedure following the summary. Procedure Summary To load a shared configuration to one or more devices of the same type: 1.
Loading Shared Configurations Procedure Details c. When you have specified all the IP ranges, click on OK. (or Apply and then Cancel.) This returns you to the ECM Main window for shared configurations. When you return to the ECM Main window, you will notice that the devices (or range of devices) you entered are listed in the device selection section of that window. δφσδηκ ϕδ ϕκ κλ γ γ δ δηφϕη δϕκ δκε 4. Click on the Load button or menu option.
Loading Shared Configurations Procedure Details If device specific configurations are selected, from the View menu, select shared configurations. This window (see Figure 5-7) shows a 2-level hierarchy of configurations under landscapes. The selected device(s) are displayed separately in the Devices portion of the screen display. Figure 5-7.
Loading Shared Configurations Procedure Details • To check the load status of a shared configuration, select that configuration and the device you want to check and do a verification of the configuration. If the configuration is loaded on the device, the verification of the configuration in ECM with that on the device will match. 2. If the preselected device is not what you want, click on the Choose button. This displays the Select Devices window. See Figure 5-8.
Loading Shared Configurations Procedure Details Figure 5-9. Two Filter Options ECM: Filters Topology ECM: Filters IP Address Filter by Topology Topology Device Filters IP Address Filter by IP Address iron Universe From: World Case Sensitive To: 132.177.54.1 132.177.54.20 From: 132.177.54.1 To: Search Add OK Apply 132.177.54.20 Delete Cancel OK Apply Cancel 4.
Loading Shared Configurations Procedure Details NOTE You cannot use the Filter button when you work with ports, boards, interfaces, and applications—the components you select in the ECM Components dialog box. Notice that the Filter button is grayed-out in the window for these devices. 6. In the ECM Main window, select the configuration. (You can switch Steps 5 and 6 if you prefer. Their order does not matter.) 7. Click on the Load button or menu option.
Loading Shared Configurations Procedure Details If you select Yes, ECM loads the configuration to the specified device(s) and displays a Load Results window. See Figure 5-11. This window shows the load results for each device: Figure 5-11. • If the Safe Load option is turned off, the possible load results are: “Partially Loaded,” “Fully Loaded,” or “Not Loaded.” • If the Safe Load option is on, the possible load results are: “Fully Loaded,” “Rolled Back,” “Rollback Failed,” or “Not Loaded.
Loading Shared Configurations Procedure Details 10. Check each device to see the status of its attributes. To do this, in the Load Results window, do one of the following: • Press the Load Detail button or click on the Load Detail option under the Options menu. • Or double click on a device name. • Or select a device and press Return. A Load Detail window, similar to those in Figure 5-12, is displayed. 11.
Logging, Finding, and Printing Load Results Logging Load Results attribute for each device, listing first in order of upper-case letters and then in order of lower-case letters. If you wish to change from the alphabetic arrangement to the sequence in which attributes are loaded, select the View by Sequence option from that same pull-down menu. File Print... Close 13. If desired, you can print load results for your records.
Logging, Finding, and Printing Load Results Printing Load Results Printing Load Results You can print Load results from the following windows: • Load Results. • Load Detail (for listing of attributes and for Cisco host configuration). • Rollback Load Failure Detail. To print load results or load details: 1. Click on the Print option in the File menu of the appropriate window. The Printer dialog box appears. 2.
Logging, Finding, and Printing Load Results Printing Load Results Figure 5-13. Sample Printouts of Load Results and Load Details 11:30 AM Wed April 2 1997 Enterprise Configuration Manager Page 1 Load Results for Configuration all_attr_config (ver.
Logging, Finding, and Printing Load Results Printing Load Results Figure 5-14. Sample Printouts of Rollback Load Failure Details & Cisco Load Details 09:30 AM Wed April 2 1997 Enterprise Configuration Manager Page 1 Rollback Load Failure Details for Configuration vacation_config (ver.
What to Do When a Load Fails ECM Load-Failure Alarms in SPECTRUM What to Do When a Load Fails ECM Load-Failure Alarms in SPECTRUM By default, in addition to displaying the load-failure details in the ECM Load Details message window, all ECM Load failures generate an alarm in SpectroGRAPH. SpectroGRAPH indicates a “Load Failure” alarm condition in the following way: • The device flashes yellow in the Topology View. • An alarm entry appears in the Alarms window.
What to Do When a Load Fails What Can Cause a Safe-Load Backup Capture to Fail What Can Cause a Safe-Load Backup Capture to Fail When you have Safe Load on, ECM captures the device’s configuration before beginning the load process. If this initial capture fails, ECM displays the error message “Capture for Safe Load failed” and stops the load. To find out why the backup capture failed: 1. Convert the configuration to a template—if you do not already have it. 2.
What to Do When a Load Fails Understanding the Events that Precede a Safe-Load Rollback Understanding the Events that Precede a Safe-Load Rollback When a Rollback occurs, check the Load Results Detail window to see the events that preceded the initiation of a rollback. The Load Detail window shows you all the events that occurred before ECM began the procedure to roll back the original configuration to the device, including the specific attribute that triggered the rollback. See Figure 5-15. Figure 5-15.
What to Do When a Load Fails What to Do When Rollback for Safe Load Fails What to Do When Rollback for Safe Load Fails In most cases, ECM will be able to roll back the configuration when it fails to load an attribute to a device. However, in those cases when it cannot, ECM notifies you with a Rollback Failure message box in front of the Load Results window. When rollback fails, follow these steps: 1. Click OK in the Rollback Failure message box. A Rollback Load Failure Detail window appears.
What to Do When a Load Fails What to Do When Rollback for Safe Load Fails 2. While you have the window open, select the Print option in the File menu to print the Rollback Load Failure Detail so that you can refer to it when you restore the configuration. 3. Select the Close option in the File menu to close the Rollback Load Failure Detail window. When you close the window, you are returned to the Load Results window where you see that the device has a load result of Rollback Failed.
Special Load Information for Cisco Routers Load Results for Cisco Host Configurations Special Load Information for Cisco Routers Load Results for Cisco Host Configurations If your Cisco router configuration includes a host configuration, you will see the host configuration load results in the ECM Load Detail window and in the printout. This includes the name in the Attribute field and the status (Success, Failure, or other error messages) in the Load Status field.
Chapter 6 Verifying a Configuration This chapter shows you how to verify the configuration(s) of the selected device(s). In This Chapter 9030944 E10 • Verification Procedure A summary of the verification procedure. • Verification Process What the system does when you verify a configuration. • Verification Options A list of verification options. • Verifying Device Specific Configurations How to verify a device specific configuration.
Verification Procedure Verification Procedure The ECM verification procedure enables you to compare loaded configurations with expected configurations, the configurations as they are defined in ECM. Though the verification procedure differs slightly depending on whether the configuration is device specific or shared, the basic steps are the same. To verify a configuration: 1. Select the configuration you want to verify. If the configuration is device specific, you can select more than one configuration.
Verification Options Verification Options The verification process tells you whether your selected configuration matches that of the selected device or other devices of the same type. If it doesn’t match, it tells you in what way. In addition, you have the following options when you verify a configuration. You can: • View the results of the verification in two ways: A View All button shows you both matching and non-matching attributes, a View Unsuccessful button shows you only non-matching attributes.
Verifying Device Specific Configurations Figure 6-1.
Verifying Device Specific Configurations Figure 6-2. The Verify Results Window ECM: Verify Results - Device Specific Verifications File Options Verify Detail... 5 Configuration Name Result iron Cisco78 Thresholds Matched CommunityName Matched Cisco80 PM_weekends Did not match Verify Detail... 5. To see the verification details of a configuration verified, select it in the Verify Results window and click on the Verify Detail button or select the Verify Detail option under the Options menu.
Removing Non-Matching Attributes 7. Print verification results for your records. Refer to Printing Verification Results, on Page 6-11, for more details. 8. If necessary, remove non-matching attributes from the configuration. See the next section, Removing Non-Matching Attributes, for more details. Figure 6-3.
Verifying Shared Configurations • Although the Verify Results and Verify Details windows do not reflect the change, the Configurations and Main windows show you that the attributes have been removed. Follow these steps to delete non-matching attributes from the configuration: 1. In the Verify Detail window, click on the Remove Non-Matching Attributes option under the Setup menu. See Figure 6-4. 2.
Verifying Shared Configurations When you click on Verify, ECM asks you to confirm the verification. 5. If you want to continue, click on Yes in the prompt box. If you don’t want to continue, click No. Figure 6-5.
Verifying Shared Configurations Figure 6-6. Verify Results Window ECM: Verify Results - Port_config (ver.1) from iron File Options Verify Detail... Device Name Result iron Cisco70 Matched Cisco78 Did not match 3 Verify Detail... 6. Check each device to see the status of its attributes. To do this: • Select a device in the Verify Results window and press the Verify Detail button or click on the Verify Detail option in the Options menu. • Or double click on a device name.
Verifying Shared Configurations Figure 6-7.
Viewing and Modifying Verify-Failure Alarms Viewing and Modifying Verify-Failure Alarms By default, all ECM verification failures generate an alarm in SpectroGRAPH. SpectroGRAPH indicates a “Verify Failure” alarm in the following way: the device flashes orange in the Topology View, an alarm entry appears in the Alarms window, and an alarm event appears in the Event Log. ECM alarm defaults are set at installation.
Printing Verification Results Figure 6-8. Sample Printouts of Verify Results and Verify Detail 11:30 AM Mon May 5 1997 Enterprise Configuration Manager Page 1 Verify Results for Configuration all_attr (ver. 4) from iron Device Name ____________ Result ______ cisco70 cisco78 cisco68 cisco62 Matched Did not match Did not match Matched 12:24 AM Mon May 5 1997 Enterprise Configuration Manager Page 1 Verify Details for Configuration all_attr (ver.
Verifying the Cisco Host Configuration Verifying the Cisco Host Configuration ECM allows you to verify the Cisco host configuration commands when you are verifying the configuration of devices. ECM verifies a Cisco host configuration by comparing each line in the router file to the configuration file. It displays both files, line by line, in the Verify Detail window. Any line that does not match appears in a red band. To verify a Cisco router host configuration: 1.
Verifying the Cisco Host Configuration When you click on the Host Configuration option, a Verify Detail window for the Cisco host configuration appears. See Figure 6-10. Instead of attributes, this window displays, side by side, the command lines of the Configuration file and the Router file. Any line that does not match appears in a red band. Notice that host configuration passwords appear as password . 4.
Verifying the Cisco Host Configuration 5. Print verification results for your records. Click on the Print option in the File menu of either the View All or View Differences window. Figure 6-11 is a sample Verify Detail printout of the Cisco host configuration. Figure 6-11. Verify Detail Results of Host Configuration (View All) 2:24 AM Mon Aug 4 1996 Enterprise Configuration Manager Page 1 Verify Details for Configuration cisco_attr_A (ver.
Viewing Hidden Host Configuration Passwords Viewing Hidden Host Configuration Passwords In the Host Configuration Verify Details windows, Cisco host configuration passwords always appear as . To view passwords you have to return to the Configuration window. However, even when passwords are hidden in the Verify Details window, you can still see if the passwords in the configuration match those on the router.
Chapter 7 Importing and Exporting This chapter shows you how to import and export ECM templates and configurations. In This Chapter • Why Import or Export Configurations and Templates Reasons for importing or exporting configurations and templates. • How the Import/Export Options Work A detailed description of the import/export operations. • Importing/Exporting Configurations how to import or export configurations. • Importing/Exporting Templates How to import or export templates.
How the Import/Export Options Work • When you want to share configurations and templates with other users on the network. Exporting/importing configurations and templates saves you time since you do not have to create the standard templates and configurations again and again. Other ECM users can import the template and configuration files stored on your workstation or you can transfer the files over the network to their workstations.
How the Import/Export Options Work Export Updates Version Number When you import templates or configurations, you should understand how ECM versioning works. ECM interprets the imported template or configuration as the next version of the template or configuration if previous versions exist. To illustrate this, let us assume that you exported a configuration called Weekday Version 3. Then you created two more versions of this configuration so that the Weekday configuration in ECM has become Version 5.
How the Import/Export Options Work Export NOTE Figure 7-1. The version numbers in Figure 7-1 represent the version numbers of the configuration when it was exported. If you import these configurations into ECM, these version numbers may change. ECM assumes the imported configuration is the next version of the configuration if others exist in the ECM database.
Importing/Exporting Configurations Export All Exporting to an Existing File You can also export templates and configurations to an existing file. When you do this, ECM prompts you to see if you want to overwrite the file or simply append the configuration or template to the existing file. If you append to an existing file, ECM adds the new configuration or template with START and END markers to indicate where each template or configuration begins and ends. Figure 7-1 on Page 7-4 shows a sample export file.
Importing/Exporting Configurations Importing Configurations options alternate. If the window displays shared configurations, you can move to device specific ones, and vice versa. 3. Depending on the operation you want, do one of the following procedures. Figure 7-2. Import/Export Options for Configurations View ECM: Configurations - Shared Configurations for Model Cisco78 from iron File Edit View Options Import... Export... Export All... Convert to Template Capture... Schedule...
Importing/Exporting Templates Exporting all configurations 2. Click on the Options, Export option in the menu bar. The Export Configuration file selection dialog box appears. 3. In the file selection dialog box, specify the destination directory and file. (You can type the file name before the optional suffix .cfg, which ECM provides.) 4. Click on OK. ECM copies the configuration to the specified file. Exporting all configurations To export all configurations: 1.
Importing/Exporting Templates Importing Templates The Templates window appears. 2. Depending on the operation you want, do one of the following procedures. Importing Templates To import templates: 1. In the Templates window, click on the Options, Import option in the menu bar. The Import Template file selection dialog box appears. 2. Using the file selection dialog box, select the file containing the templates you want to import. 3. Click on OK.
Using the File-Selection Dialog Boxes Using the File-Selection Dialog Boxes The file-selection dialog boxes that you use with the import/export options open to a default directory and provide a filename suffix for your convenience. If You Accept the Default Directory... If you are going to export files to or import files from the default directory /ecm/eximport, follow these steps: 1. Make sure the desired landscape is specified in the Creation Landscape field.
Using the File-Selection Dialog Boxes If You Want Another Directory… Figure 7-4. The File-Selection Dialog Box — Export Template Please Select a File Filter /user1/data/Spectrum/ecm/eximport/*.tpl Directions Files spectrum/ecm/eximport/. spectrum/ecm/eximport/.. [ ] Notice that the default directory is eximport and that the file name has .tpl appended to it. 1 Creation Landscape Iron (0x006c0000) Selection /user1/data/Spectrum/ecm/eximport/*.
Chapter 8 Scheduling Tasks This chapter shows you how to schedule automatic captures, loads, and verifications of configurations and describes the ECM Log file, which stores the results of scheduled operations. In This Chapter 9030944 E10 • Why Schedule Operations in ECM? Reasons for scheduling operations in ECM. • NT Scheduler Requirements Requirements for scheduling operations on NT. • Accessing the Scheduler How to access the scheduler.
Why Schedule Operations in ECM? Why Schedule Operations in ECM? ECM provides administrators with the option of scheduling the time and frequency of automatic captures, loads, and verifications. This feature has many benefits. Specifically, the administrator can: • Schedule loads, captures, and verifications during low-traffic hours. • Maintain more stable configurations by scheduling automatic loads at regular intervals.
Accessing the Scheduler Even when these Schedule Service parameters are incorrect, you can schedule ECM operations. The Scheduler, however, will not be able to perform the operations. See Windows NT Help for Schedule Service for more information. Accessing the Scheduler To access the scheduler, first select what you want to schedule then click on the Schedule button/option.
Scheduler Dialog Box Figure 8-1. Scheduler Dialog Box ECM: Scheduler 3 2 Aug 22 Verify Scheduled Entries 16:42 1 Command 4 5 Once Frequency September Sun Mon Tue 1998 Wed Thu Fri 1 Sat 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 At 16 : 42 Add Save NOTE Table 8-1. Modify Reset Remove Close When you use the Add, Modify, or Remove button, ECM saves the information temporarily in the buffer.
Scheduler Dialog Box Table 8-1. Functions of Scheduler Dialog Box Controls (Continued) Button Function Modify Modifies the highlighted entry in the Scheduled Entries field. To modify an entry: highlight the entry in the Scheduled Entries field, click on the appropriate buttons in the Schedule and Frequency sections, and then click on Modify, and finally Save to schedule the modified entry. Remove Removes an entry in the Scheduled Entries field or in the scheduled queue itself.
Selecting a Task to Schedule Table 8-1. Functions of Scheduler Dialog Box Controls (Continued) Button Function 3 Command Displays the scheduled command. When you specify the task—Capture, Verify, or Load — the Scheduler enters the information in the Command field. 4 Frequency Enables you to specify the frequency of captures, loads, or verifications. Frequency options are: Once, Hourly, Daily, Weekly, Monthly. You can schedule the Once frequency any time between the current date and one year later.
Scheduling Loads and/or Verifications Device Specific Configurations Scheduling Loads and/or Verifications Device Specific Configurations To schedule one or more Loads or Verifications for device specific configurations: 1. Open the ECM Main window for device specific configurations. If shared configurations are displayed, from the menu bar, click on View, Device Specific Configurations. 2. In the Configurations Name field, select the configuration(s) that you want to load or verify.
Scheduling Captures 4. Select the Schedule button or menu option. 5. In the scheduler dialog box (see Figure 8-1 on Page 8-4), select the task (load or verify), frequency, date, and time. Then click on the Add button. If you have questions, refer to Scheduling a Task — Procedure Details, starting on Page 8-10. 6. Check the newly displayed scheduled entry. If you made a mistake, select the entry, click on the appropriate schedule and frequency buttons, and then select Modify.
Scheduling Captures Figure 8-2. Capture Configuration and Creation Landscape Dialog Boxes a ECM: Capture Configuration Configuration Type Shared b Devices: Device Specific emme77 Choose...
Scheduling a Task — Procedure Details If you have questions, see Scheduling a Task — Procedure Details, following, beginning with Step 4. 6. Check the newly displayed scheduled entry. If you made a mistake, select the entry, click on the appropriate schedule and frequency buttons, and then select Modify. When satisfied, click on Save and Close. To delete the entry, select it, click on Delete, Save, and Close.
Scheduling a Task — Procedure Details Figure 8-3. The Frequency Options: Hourly, Daily, Once, Weekly, Monthly Frequency At Hourly 00 minutes after the hour.
Editing a Schedule Table 8-2. Frequency Options Option Description Once Specifies the month, day, and start-time of a single operation: • On a unix system, this option allows you to schedule the task on any day between the current date and one year later. • On an NT system, this option allows you to schedule the task only between the current date and one month later. Other dates appear grayed-out. NOTE Hourly Specifies the minute at which the hourly task will be performed.
Viewing the Results of Scheduled Operations To learn about modifying the schedule, experiment with the options. If you enlarge the Scheduler dialog box by dragging on the corners, you can view the whole entry. See Figure 8-4. A Scheduled Entry consists of two parts: the scheduled time at the beginning of the line and the command, enclosed in quotes, in the rest of the line. Figure 8-4.
Viewing the Results of Scheduled Operations SPECTRUM Event Log Event Log, it contains a listing of attribute names and the status of attributes, if appropriate. NOTE Both the manual ECM operations and the scheduled ECM operations are logged in the SPECTRUM Event Log. However, only scheduled operations are logged in the ECM Log file. The following two subsections describe these two log files in more detail.
Viewing the Results of Scheduled Operations ECM Log File Figure 8-5. Scheduled Operations in the SPECTRUM Event Log Event Log: Main File View Event Options Help ? Event Message Event Page Time Extra Data frog2 Tue 05 Aug, 1997 - 10:47:23 - Enterprise Start Tue 05 Aug 1997 10 : 18 : 47 ... End Tue 05 Aug 1997 10 : 51 : 41 .. Configuration Manager - configuration frog2.cfg (ver.1) from landscape prism loaded to device frog2 from landscape prism of type frog2 by jebaker.
Viewing the Results of Scheduled Operations ECM Log File If the configuration includes a Cisco host configuration, the words appear in the Attribute list and the load status of the host configuration appears in the Error list. See Figure 8-6 on Page 8-17. • For a scheduled verification, the file contains only those attribute/value pairs that do not match. The attributes/values pairs from the configuration and the device appear in adjacent lines so that you can easily compare the two.
Viewing the Results of Scheduled Operations ECM Log File NOTE Figure 8-6. The ECM log file is a standard text file and can also be viewed with your favorite editor.
Viewing the Results of Scheduled Operations ECM Log File Figure 8-7. Example ECM Log File With Host Configuration Information ECM Background Task Log Date: Mon 24 Feb, 1997 - 10:29:23 Verify of configuration all_w_host from iron with device Cisco-dev1 from oak was unsuccessful The following attributes did not match: AT_Net_Addr.2.1.132.171.143.107 Device's Value: Config Value: < No Value > 86.8D.8F.
Chapter 9 Using ECM with External Applications This chapter describes how to use external applications with ECM and how to modify, turn off, or clear ECM alarms in SPECTRUM. In This Chapter • Accessing External Applications From Within ECM. External Apps, an ECM option, allows you to create a menu of customized options. You can use these options to execute tasks or to access other applications from within ECM. • Understanding and Accessing the SPECTRUM Event Log.
Accessing External Applications From Within ECM Define/Edit External-Applications Dialog Box Accessing External Applications From Within ECM The Main window External Apps (Applications) option is a convenience feature. It allows you to create a submenu within ECM of those commands and applications that you use frequently. You create the application options for the External Apps menu in the External Apps dialog box, illustrated in Figure 9-1.
Accessing External Applications From Within ECM Edit/Define Field and Button Descriptions Edit/Define Field and Button Descriptions The External Applications Edit/Define dialog box contains the following fields and buttons. Field Description Applications Contains the list of menu picks that you create. When you define the Menu Pick/ Command pair and then press Add, ECM adds the information to the buffer and adds the Menu Pick temporarily to the Applications section.
Accessing External Applications From Within ECM Creating Entries In the External Applications Menu Creating Entries In the External Applications Menu Follow these steps to create entries in the External Apps menu: 1. Open the ECM Main window. 2. In the Options menu click on External Apps and then the Define, Edit option. An External Applications dialog box appears. See Figure 9-1 on Page 9-2. 3. In the Menu Pick field, type the name that you want to add to the External Apps submenu. 4.
Accessing External Applications From Within ECM Editing Entries in the External Applications Menu Editing Entries in the External Applications Menu The following is a list of editing tasks and the procedures for accomplishing the tasks. To Delete an Entry 1. Highlight the entry in the Applications section of the External Applications dialog box. 2. Click on the Delete button. Then press the Update button to enter information in the system. To Modify an Entry 1.
Understanding and Accessing the SPECTRUM Event Log Understanding and Accessing the SPECTRUM Event Log SPECTRUM maintains a log of events that occur on the network. These events can range from routine ones (such as who establishes a session with SPECTRUM) to critical ones (such as the change in status of a configuration). Network administrators should check the SPECTRUM Event Log to track changes to network configurations.
Understanding and Accessing the SPECTRUM Event Log Accessing the SPECTRUM Event Log Accessing the SPECTRUM Event Log To access the SPECTRUM Event Log: 1. Open SpectroGRAPH to any View window — Topology View, DevTop View, for example. 2. In the View menu select New View, Events. The SPECTRUM Event Log appears. See Figure 9-3. You can identify ECM events because the words “Configuration Manager” appear after the date and time. Notice that every entry in the SPECTRUM Event Log has an event code number.
Understanding and Accessing the SPECTRUM Event Log Interpreting ECM Event Code Numbers Interpreting ECM Event Code Numbers Every entry in the Event Log ends with an event code number that identifies the operation performed. ECM event codes also indicate the success or failure of the operation. Use these ECM event code numbers when you perform searches in the SPECTRUM Event Log. Event Codes Type of ECM Event Event00820000 Configuration created. Event00820001 Creation of configuration failed.
Understanding and Modifying ECM Alarms in SPECTRUM ECM Events that Trigger Alarms in SPECTRUM Understanding and Modifying ECM Alarms in SPECTRUM ECM Events that Trigger Alarms in SPECTRUM Two events in ECM trigger alarms in SpectroGRAPH: • Load Failure (Event Code 00820003). • Verify Failure (Event Code 00820007).
Understanding and Modifying ECM Alarms in SPECTRUM How to Modify, Turn off, or Clear ECM Alarms How to Modify, Turn off, or Clear ECM Alarms ECM alarm features are added to SPECTRUM when you install ECM. Although you cannot change the types of alarms that are generated, you can modify the color of the alarm, turn off the alarms altogether, or clear them. To modify colors or turn off ECM alarms: 1. Navigate to the /SS/CsVendor/Ctron_ECM directory in your SPECTRUM directory. 2.
Using ECM with ARS Gateway Using ECM with ARS Gateway ECM can also be used in conjunction with the SPECTRUM ARS Gateway and Remedy’s Action Request System (ARS). ECM generates alarms in SPECTRUM whenever a load failure or verification failure occurs. Therefore, users who have the ARS Gateway and Remedy ARS on their system can have trouble tickets generated whenever these ECM alarms occur. For more details, see the SPECTRUM ARS Gateway User’s Guide.
Using ECM with SpectroPHONE Using ECM with External Applications 9-12 Enterprise Configuration Manager User’s Guide
Chapter 10 Examples of Ways to Use ECM This appendix shows you specific ways to use ECM to configure network devices. The procedures in these examples assume you are familiar with basic ECM operations such as creating, saving, and loading configurations. In this Chapter • How to Download Firmware How to download firmware, using first a MicroMMAC and then using Cisco routers as examples. • How to Configure Ports How to configure ports, using a CSIRptr as an example.
How to Download Firmware How to Download Firmware ECM does not provide a direct GUI level support for downloading firmware to devices. But what ECM provides is a very rich and flexible interface for creating and downloading of customized configurations. Users can use these customized configurations to do firmware download on most types of devices. Downloading Firmware to a Cabletron MicroMMAC This section shows you how to download firmware to the MicroMMAC.
How to Download Firmware Downloading Firmware to a Cabletron MicroMMAC Step 2: Select Device and Open ECM In SpectroGRAPH, select the appropriate device icon — in this example, a MicroMMAC — and invoke ECM from it: 1. Open a View window in SpectroGRAPH. 2. Select the device you want to work with. When selected the border of the device is highlighted. 3. Invoke ECM. To to so: place the cursor on the device and press the right mouse button to display the Icon Subview menu.
How to Download Firmware Downloading Firmware to a Cabletron MicroMMAC This opens a new unnamed file called in your display window. 5. From the Configurations Menu bar, select View/Sort-By-Sequence to ensure the proper ordering of the attributes in the configuration. 6.
How to Download Firmware Downloading Firmware to Cisco Routers 9. From the Configurations Menu bar, select File/Close to close the Configurations window. Step 4: Load Configuration 1. In the ECM Main window, select the configuration and click on the Options/Load option from the menu bar or the first button, the load button in the button bar. δφσδηκ ϕδ ϕκ κλ γγδ δηφϕη δϕκ δκε ECM loads the configuration to the device you selected and displays a Load Results window saying “DownLoad App Fully Loaded.
How to Download Firmware Downloading Firmware to Cisco Routers Requirements Before you attempt this procedure, please read the following requirements and make sure you have them all: • ECM 5.0 Needs ECM features that were added only with Spectrum 5.0. • Cisco IOS 10.2+ Cisco devices running IOS 10.2 or higher (needs the new CISCO-FLASH-MIB). • Read/Write community string The corresponding Cisco models in Spectrum should be created with the read/write SNMP community string.
How to Download Firmware Downloading Firmware to Cisco Routers 3. Invoke ECM. To to so: place the cursor on the device and press the right mouse button to display the Icon Subview menu. Then select Utilities/ EnterpriseConfigManager. Step 3: Create Configuration You need to create a configuration, the loading of which will create an appropriate entry in the ciscoFlashCopyTable.
How to Download Firmware Downloading Firmware to Cisco Routers Attribute (Continued) ciscoFlashCopySourceName Instance ID 52052 Value Description The filename of the firmware image that needs to be downloaded. ciscoFlashCopyEntryStatus 52052 1 To Activate(1) this entry. c. Chose a name (for example, ToFlashWErase) for this configuration and save it.
How to Configure Ports To do this: a. Use the same index that was used in the configuration. b. Capture with this template periodically. Since these entries are aged out automatically from this table by the routers, make sure that you capture this template before the entries are aged out. Refer to the MIB for the details of aging. Another possibility is to use the Cisco MM in Spectrum to get the status: a. Go to the CiscoFlashApp Application model for a Cisco router. b.
How to Change Community Names 3. In the Configurations window, manually create a configuration called Ports1_2_OFF. When completed, the configuration should have the following attributes, instance IDs, and values: Attribute rptrPortMgmtAdminState 2.1 rptrPortMgmtAdminState 2.2 rptrPortMgmtAdminState 2.3 rptrPortMgmtAdminState 2.4 . . . Value 1 1 2 2 . . . The instance IDs (2.1,2.2, 2.3,2.4...) indicate that this board is located in slot 2 and that there are 4+ ports on the board.
How to Turn Interfaces or Channels On and Off How to Turn Interfaces or Channels On and Off ECM allows you to turn on or off the interfaces on a device. The procedures in this section, show you how to create a configuration that turns on interface 1 and turns off interfaces 2 and 3 on an EMME. 1. In SpectroGRAPH, select an EMME icon and invoke ECM from it. 2. Manually create a configuration called Interface1_ON.
How to Turn Cisco Router Protocols On and Off Examples of Ways to Use ECM 10-12 Enterprise Configuration Manager User’s Guide
Appendix A Installation/Deinstallation This appendix describes the procedures for installing Enterprise Configuration Manager. The appendix also includes additional installation procedures required for managing Cisco routers.
About the Installation Process About the Installation Process Enterprise Configuration Manager is installed with the program Install. During the installation process you will have to answer prompts in various dialog boxes. After you type the ./Install command, these are some of the dialog boxes that appear: • The SpectroINSTALL dialog box — which prompts you to confirm the installation.
Custom or Auto Installation? Custom or Auto Installation? Before you begin the installation, determine whether you should perform a custom or auto installation.
Installation Procedure Installation Procedure Do the following procedure to perform either an auto or a custom installation of Enterprise Configuration Manager. If you have SpectroGRAPH and SpectroSERVER on different machines, install ECM on both machines. Specify the ECM component (SG or SS) that you are installing in Step 6. 1. Before you install ECM, install SPECTRUM according to the instructions in the SPECTRUM Installation Guide. 2. Log on to the workstation and become root (superuser). 3.
Installation Procedure Figure A-1. Installation Configuration Dialog Box molasses: Installation Configuration Installation Type Choices Install Re-link previously Installed components Validate previously installed SpectroSERVER Location Configuration Source Directory: Target Directory: Target Ownership : /cdrom/Install japan:/usr/data/Spectrum/5.0 Click on Select all SpectroGRAPH components for both custom and auto install.
Installation Procedure 6. Enter the appropriate information in the Installation Configuration dialog box. The fields change depending on your selections. a. In the Component Configuration section, notice that the two options, Select all SpectroSERVER components and Select all SpectroGRAPH components, are already selected. Select the component that you want to install as follows: - If you have both SpectroSERVER and SpectroGRAPH on your machine, make sure the two options remain selected.
Installation Procedure Figure A-2. Component Selection Dialog Box Component Selection Components Available for Installation: F Part Name Status Part Type Descriptive Name Version SS SG - SA-CSI1008 DIST ManMod Enterprise Config Mgr for SPRM 5.0rev0 Y Y EXT KB 10742 Component DescriptionTotal KB of Disk Space Required: 10742 This application allows a network administrator to change and monitor the configuration of an extensive array of network elements from a central location.
Installation Procedure After you click on OK, an Installation Monitor dialog box next appears. See Figure A-3. The Progress Meter in the Installation Monitor shows you how much of the installation has taken place. Figure A-3. Installation Monitor Dialog Box Installation Monitor Target path:japan: /user/data/Spectrum/5.0 Status Phase Running Media Extract Progress Meter Free Disk Space 422275 Log:LOGS_042696/inst_log.11.
Installation Procedure Figure A-4. ECM Custom Installation Prompts ******* Begin Installing Enterprise Configuration Manager (ecmsprm.cus) ******* Installing Enterprise Configuration Manager to /usr/data/Spectrum/5.
Installation Procedure In the Installation Monitor, the Status field and the Progress Meter now indicate that the installation has been completed. A message box also appears saying, “Install has completed successfully.” 13. Click OK in the message box. 14. Close the Installation Monitor dialog box by clicking on the Exit button. Figure A-5. Installation Monitor and Install Completed Message Box Installation Monitor Target path: japan: /user/data/Spectrum/5.
Deinstallation Deinstallation When you install Enterprise Configuration Manager, Install deinstalls any previous version of ECM. Therefore, you do not need to perform a deinstallation before you install the application. However, if you just want to remove ECM from your workstation (that is, perform a stand-alone deinstallation), use the following procedure: 1. Log on as root to the workstation where SpectroGRAPH is installed. 2.
How to Manually Remove ECM Models How to Manually Remove ECM Models If you perform a deinstallation and SpectroSERVER is not running, you can remove the ECM models manually. Follow these steps: 1. If you are not already on the machine where SpectroSERVER is located, log on as root to this machine. 2. Navigate to the SS-Tools directory by typing: cd //SS-Tools 3.
Installation Procedures Required by Cisco Routers Installation Procedures Required by Cisco Routers If you are planning to work with Cisco routers, you must perform additional steps after you install the Enterprise Configuration Manager. Cisco routers use TFTP, Trivial File Transfer Protocol, to transfer configuration files. Therefore, if you want to configure Cisco routers, you have to make sure your workstation is set up as a TFTP server.
Installation Procedures Required by Cisco Routers For UNIX Machines 5. Find the inetd process ID and reinitialize the process. a. Type the following command to get the inetd process ID: ps -aux | grep inetd b. Notice the process ID number—the first number in the line. Then type: kill -1 The kill command with the -1 (minus one) option reinitializes the process. 6.
Installation Procedures Required by Cisco Routers For NT Machines For NT Machines Follow these steps to set up your NT machine to support TFTP. 1. Go to the TFTPBOOT directory. It is a main directory on the drive you choose when you installed ECM. For example: C:/TFTPBOOT 2. By double clicking on it, run the file TFTPSERVE.EXE This starts the TFTP server and displays a dialog box similar to the following.
Installation Procedures Required by Cisco Routers For NT Machines Installation/Deinstallation A-16 Enterprise Configuration Manager User’s Guide
Appendix B ECM Resource File This appendix describes the parameter values in the Enterprise Configuration Manager resource file Ecm. In This Appendix • Resource File The file containing the parameters used by ECM. These parameters are divided into the following categories described in the next sections.
Timeout and Pathname Parameters Timeout and Pathname Parameters During a custom install, you can enter your own values for the Timeout and Pathname parameters. If you perform an auto install, however, the resource file will contain the default values listed below.
Operational Parameters Ecm Parameter Description & Default Value FindLandscapes Landscape(s) used for locating configurations and templates (Value can be a comma separated list) Default: 0x400000 or local landscape handle CreateLandscape Landscape to which configurations and templates are saved (Only a single value is allowed) Default: 0x400000 or local landscape handle OtherDevicesLandscapes Landscape(s) used for locating device models (Value can be a comma separated list) Default: 0x400000 or loca
Display Parameters Display Parameters These parameters define the fonts and colors used in ECM windows. You can specify these parameter values only in the resource file .
Display Parameters Ecm Parameter Description & Default Value ListFont Font used in lists Default: -*-courier-medium-r-normal--*-120-75-75-m-*-iso8859-1 MenuFont Font used in menus Default: -*-helvetica-medium-r-normal--*-140-75-75-p-*-iso8859-1 TextFont Font used in text entry fields Default: -*-helvetica-medium-r-normal--*-140-75-75-p-*-iso8859-1 dragInitiatorProtocolStyle Drag & Drop parameter, disabled because it causes problems Default: XmDRAG_NONE dragReceiverProtocolStyle Drag & Drop param
Display Parameters ECM Resource File B-6 Enterprise Configuration Manager User’s Guide
Appendix C Running ECM from the Command Line This appendix describes how to perform ECM operations from the command line. The appendix displays the commands in a modified man page format.
Using ECM Commands Using ECM Commands ECM commands require information such as model names and model type handles, which you retrieve through the Command Line Interface (CLI) commands. Therefore, unless you are an experienced CLI user, do not attempt to run ECM with the commands in this appendix. To run ECM from the command line: 1. Make sure the SpectroSERVER is up and running. 2. Navigate to the directory where the ECM command is located. See the Location category under each command. 3.
Invoking ECM Invoking ECM Ecm -- Start Configuration Manager Location: Syntax: Ecm \ -vnm \ -vnmsocket \ -mh Input: -mh Model handle of the device you are going to work with -vnm SpectroSERVER to which you are connecting -vnmsocket Socket number on the SpectroSERVER Capturing a Configuration from a Model ecmbg -f capture -- capture a configuration from a model Location: /bckgrnd Syntax: ecmbg -f cap
Loading a Configuration to One or More Models Loading a Configuration to One or More Models ecmbg -f load -- load a configuration to model(s) Location: /bckgrnd Syntax: ecmbg -f load \ -vnm \ -file \ -ds (load in device specific mode) -sf ON|OFF \ -as ON|OFF \ -ch Input: -as Automatic Save setting, either ON or OFF -ch Model handle of the ECM configuration -ds Load device specific configuration -file Data f
Verifying a Configuration to One or More Models Verifying a Configuration to One or More Models ecmbg -f verify -- verify one or more models Location: /bckgrnd Syntax: ecmbg -f verify \ -vnm \ -file \ -ds (verify in device specific mode) -ch Input: -ch Model handle of ECM configuration -ds Verify device specific configuration -file Data file containing the following parameters and their values: Vnmsocket, Def
Importing Templates and Configurations Importing Templates and Configurations import -- import configurations and/or templates Location: /bckgrnd Syntax: import \ -vnm \ -port \ [-clh ] \ -file \ [-ecmpath ] \ [-time ] Input: Options: -file The file created by export -port VNM socket number -vnm SpectroSERVER to which you are connecting -ecmpath Optional ECM dir
Exporting Templates and Configurations Exporting Templates and Configurations export -- retrieve templates/configurations, print output to the screen NOTE The export command directs output to your screen. Therefore, whenever you use the export command, be sure to redirect the output to a file. To do this, use the redirection symbol (>) and specify the destination filename. Later you can import configurations and templates from this file.
Exporting Templates and Configurations For specifying one ECM configuration name and model type name: export \ -vnm \ -elh \ -port \ -mtn \ -cn \ [-ecmpath ] \ [-time ] For specifying one ECM template name and model type handle: export \ -vnm \ -elh \ -port \ -mth \ -tn
Exporting Templates and Configurations For specifying all ECM template models: export \ -vnm \ -elh \ -port \ -at \ [-ecmpath ] \ [-time ] For specifying all ECM models: export \ -vnm \ -elh -port \ -a \ [-ecmpath ] \ [-time ] Input: Options: -a All templates and configurations (no value needed)
Deleting ECM Models Deleting ECM Models rm_ecm_models -- remove ECM models Location: /deinstall /SS-Tools (If only the ECM Server component is installed on the system.) Syntax: rm_ecm_models \ -vnm \ -port \ [-time ] Input: -port VNM socket number -vnm SpectroSERVER to which you are connecting -time Optional VNM timeout value (Minimum value is 5,000. Defaults to 100,00.
Appendix D Customizing An IP Address for Cisco Router Operations This appendix describes how to customize an IP address for CISCO router operations.
How Customize an IP Address for ECM How Customize an IP Address for ECM To customize which IP address you would like ECM to use, do the following: 1. Using a text editor, create a file in the ECM directory and name it CUSTOM. 2. Place the following line, indicating your desired IP address in the file: TFTP_SERVER_ADDR 111.222.333.444 For example: TFTP_SERVER_ADDR 132.177.110.
Index Symbols Sash 2-26 Save 3-8, 4-6 Schedule 2-24, 4-10 Search 2-19 Select All 4-12 Update 4-16 Values 4-46 Verify 2-23 View Host Configuration 2-24 Wild Attr. 4-14 Wild Comp. 4-15 .
Configuration Management overview of 1-3 configurations about the size of 1-8 capturing 4-25 changing type 4-47 command line capture C-3 comparing 4-48 comparing two 2-28 creating 4-2 creating with a template 4-25 creating without a template 4-18 deleting 4-49 description field 4-11 device specific 1-5 editing 4-34 how to back up 7-2 how to import/export 7-2, 7-7 how to manually restore 5-41 how to save on floppy disk 7-2 loading device specific 5-17 loading multiple, to one device 1-5 loading shared 5-25 l
Writable 2-17 fonts for ECM windows B-4 Frequency options 8-11 H Help menu in ECM 2-25 hexadecimal values 4-46 host configuration 4-51, 6-14 capturing with template 3-18 community name in 4-54 comparing 4-48 editing an empty 4-52 editing commands in 4-51 passwords 6-16 size constraints 1-8 Host Configuration option 6-13 I Import option 7-3 importing configurations 7-3 from command line C-6 that are model-specific 7-4 with version numbers 7-3 installation custom or auto A-3, A-8 default parameters A-3, B-2
Host Configuration 6-13 Import 7-3 Load 2-23 Load Detail 5-41 menu 2-23, 4-9 Navigate Components 2-6, 2-23 Remove Non-Matching Attribute 6-7 Rollback Load Detail 5-41 Schedule 4-10 Update 4-52 Verify 2-23 P passwords Cisco router 4-53 hidden 4-53, 6-16 Paste button 4-13 pop-up menus 2-21, 2-28 ports, how to configure 9 printing verification results 6-11 pull-down menus 2-21 Q question marks 4-20, 4-36 R Readable attribute flag 2-17 Remove Non-Matching Attributes 6-7 resource file operational parameters B
TFTP 2, A-13 setting up NT for A-15 Trademarks i U Update option 4-52 V Verify button 2-23 Verify Failure alarms 9-9 Verify results printing 6-11 printout of host configuration 6-15 sample printout 6-12 viewing 6-5, 6-6, 6-9 Verify-Failure alarms 6-11 verifying the configuration for device specific configurations 6-4 for shared configurations 6-8 from command line C-5 of Cisco routers 6-11 of host configuration 6-13 of selected device 6-4 options 6-3 procedure 6-2 process 6-2 version numbers how import af
