Network ConÞguration Utilities

Transcription

1 Network ConÞguration Utilities SPECTRUM Enterprise Manager SPECTRUM Management

2 Summary of Changes Network ConÞguration Utilities Version Date Reason for Change of Change Mar 2000 New product. New document May 2000 Name change, technical accuracy Sept 2000 Technical accuracy, new functionality. - Product name changed from NetWide Utilities for Cabletron to Network Configuration Utilities. - Added MIB Objects. - Updated the information in Downloading Firmware and Modifying Community Strings. - Updated the information in Downloading Firmware and Modifying Community Strings.

3 Notice Aprisma Management Technologies, Inc. (Aprisma) reserves the right to make changes in speciþcations and other information contained in this document without prior notice. The reader should in all cases consult Aprisma to determine whether any such changes have been made. The hardware, Þrmware, or software described in this manual is subject to change without notice. IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Copyright September, 2000 by Aprisma Management Technologies, Inc. All rights reserved. Printed in the United States of America. Order Number: Aprisma Management Technologies, Inc. 121 Technology Way Durham NH SPECTRUM, the SPECTRUM IMT/VNM logo, DCM, IMT, and VNM are registered trademarks, and SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, and Virtual Network Machine are trademarks of Aprisma or its afþliates. C++ is a trademark of American Telephone and Telegraph, Inc. UNIX is a trademark of UNIX System Laboratories, Inc. OSF/Motif and Motif are trademarks of the Open Software Foundation, Inc. X Window System is a trademark of X Consortium, Inc. Ethernet is a trademark of Xerox Corporation. EMM-E6 and SmartSwitch are trademarks of Cabletron Systems, Inc. Windows and Windows NT are trademarks of Microsoft Corporation. Solaris is a trademark of Sun Microsystems, Inc. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the Licensed Software is virusfree. Aprisma 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 Network Configuration Utilities Page 3

4 Licensed Software, prior to installing it, is virus-free with an anti-virus system in which you have conþdence. Restricted Rights Notice (Applicable to licenses to the United States Government only.) 1. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS Aprisma Management Technologies, Inc., 121 Technology Way, Durham, New Hampshire (a) This computer software is submitted with restricted rights. It may not be used, reproduced, or disclosed by the Government except as provided in paragraph (b) of this Notice or as otherwise expressly stated in the contract. (b) This computer software may be: (1) Used or copied for use in or with the computer or computers for which it was acquired, including use at any Government installation to which such computer or computers may be transferred; (2) Used or copied for use in a backup computer if any computer for which it was acquired is inoperative; (3) Reproduced for archival or backup purposes; (4) Modified, adapted, or combined with other computer software, provided that the modified, combined, or adapted portions of the derivative software incorporating restricted computer software are made subject to the same restricted rights; (5) Disclosed to and reproduced for use by support service contractors in accordance with subparagraphs (b) (1) through (4) of this clause, provided the Government makes such disclosure or reproduction subject to these restricted rights; and (6) Used or copied for use in or transferred to a replacement computer. (c) Notwithstanding the foregoing, if this computer software is published copyrighted computer software, it is licensed to the Government, without disclosure prohibitions, with the minimum rights set forth in paragraph (b) of this clause. (d) Any other rights or limitations regarding the use, duplication, or disclosure of this computer software are to be expressly stated in, or incorporated in, the contract. (e) This Notice shall be marked on any reproduction of this computer software, in whole or in part. Network Configuration Utilities Page 4

5 Contents Preface 9 Prerequisites for Users... 9 How this Guide Is Organized... 9 Typographical Conventions Introduction 11 Network Configuration Utilities Firmware Download Tool Modify Community Strings Tool Security: Configuration Privileges Getting Started Network Configuration Utilities and Search Manager Accessing Network Configuration Utilities Applications Downloading Firmware 13 Firmware Download Overview Configuring the Download Before You Start Configuring and Starting the Download Performing Downloads to Selected Models Edit Information for Firmware Download Window Describing the Firmware Download Window Menus Toolbar Icons Model Information Panel Models List Panel Filter/Search Panel Connection Status Verifying the Operation/Exception Handling Invalid Models Error Messages Setting Preferences Network Configuration Utilities Page 5

6 Contents Contents Connection Preferences Firmware Download Preferences Display Preferences Preferences Dialog Buttons and Fields Clearing Preferences Modifying Community Strings 35 Community Strings Overview Configuring the Community String Change Before You Start Configuring and Starting the Change Performing Community String Changes to Selected Devices Edit Information for Community String Change Window Describing the Modify Community Strings Window Menus Toolbar Icons Model Information Panel Models List Panel Filter/Search Panel Connection Status Verifying the Operation/Exception Handling Invalid Models Error Messages Setting Preferences Connection Preferences Community Strings Preferences Display Preferences Preferences Dialog Buttons and Fields Clearing Preferences MIB Objects 56 Firmware Download MIB Objects Community Strings MIB Objects Index 58 Network Configuration Utilities Page 6

7 Figures Preface 9 Introduction 11 Downloading Firmware 13 Figure 1: Edit Information for Firmware Download Window...14 Figure 2: Firmware Download Window...18 Figure 3: Column Order Window...24 Figure 4: Invalid Models Window...26 Figure 5: Preferences Dialog Box...28 Modifying Community Strings 35 Figure 6: Edit Information for Community String Change Window...37 Figure 7: Modify Community Strings Window...41 Figure 8: Column Order Window...47 Figure 9: Invalid Models Window...49 Figure 10: Preferences Dialog Box...51 MIB Objects 56 Index 58 Network Configuration Utilities Page 7

8 Tables Preface 9 Introduction 11 Downloading Firmware 13 Table 1: Edit Information for Firmware Download Window Fields & Buttons...16 Table 2: Menus and Options...19 Table 3: Toolbar Icons...21 Table 4: Model Information Panel...22 Table 5: Models List Panel...23 Table 6: Filter/Search Panel Buttons...25 Table 7: Invalid Models Window Buttons...27 Table 8: Invalid Models Error Messages...27 Table 9: Connection Preferences...29 Table 10: Firmware Download Preferences...31 Table 11: Display Preferences...32 Table 12: Preferences Dialog Buttons...33 Modifying Community Strings 35 Table 13: Edit Information for Community String Change Window Fields & Buttons...39 Table 14: Menus and Options...42 Table 15: Toolbar Icons...43 Table 16: Model Information Panel...44 Table 17: Models List Panel...45 Table 18: Filter/Search Panel Buttons...47 Table 19: Invalid Models Window Buttons...50 Table 20: Invalid Models Error Messages...50 Table 21: Connection Preferences...52 Table 22: Community Strings Preferences...54 Table 23: Display Preferences...54 Table 24: Preferences Dialog Buttons...54 MIB Objects 56 Index 58 Network Configuration Utilities Page 8

9 Preface Describes recommended prerequisites for Network ConÞguration Utilities users and this manualõs conventions and organizational structure. Welcome to SPECTRUM Network Configuration Utilities. Network Configuration Utilities is a set of configuration applications specifically designed for Cabletron Ssytems network devices. Prerequisites for Users Network Configuration Utilities users should be familiar with the following: SPECTRUM Search Manager The Cabletron devices you intend to configure with Network Configuration Utilities applications How this Guide Is Organized Introduction Section Downloading Firmware Modifying Community Strings MIB Objects Introduces Network Configuration Utilities device configuration tools. Describes how to use the Network Configuration Utilities Firmware Download Tool to configure and execute TFTP firmware image downloads to Cabletron devices. Describes how to use the Network Configuration Utilities Modify Community Strings Tool to modify community strings for Cabletron devices. This section describes the MIB objects used to initiate firmware downloads and community string changes with Network Configuration Utilities. Network Configuration Utilities Page 9

10 Preface Typographical Conventions Referenced publications appear in bold italics. Directory and file names appear in Courier. Typographical Conventions Section headings appear in italics (hypertext blue for online readers). User-supplied parameter names appear in angle brackets. For example, the parameter name for a password appears as <password>. The angle brackets indicate that you should type your password in the place of the generic parameter name. Action button operations and text to be entered by the user and appear in bold. Note: Calls your attention to information of special importance. Tip: Calls your attention to shortcuts or alternate procedures. Network Configuration Utilities Page 10

11 Introduction Introduces Network ConÞguration Utilities device conþguration tools. Network ConÞguration Utilities Network Configuration Utilities is a set of applications, accessible from SPECTRUM Search Manager, that enables you to perform the following device management tasks for Cabletron devices that are modeled in SPECTRUM: Configure and execute TFTP firmware image downloads using the Firmware Download Tool. Modify community strings using the Modify Community Strings Tool. Firmware Download Tool The Firmware Download tool enables you to configure and execute TFTP firmware image file (.fls format) downloads to Cabletron network devices that implement the Cabletron Private Enterprise ctdownload MIB. This tool supports online downloads only. It does not support offline downloads (.hex format). Modify Community Strings Tool The Modify Community Strings tool enables you to modify community strings for Cabletron network devices that support either the chassis (Rev , which supports global community strings) or ctchassis2 MIBs. Devices that support these MIBs contain up to three names, one for each of three privilege levels: read-only, read-write, and super-user. Network Configuration Utilities Page 11

12 Introduction Security: ConÞguration Privileges Security: Configuration Privileges To configure devices with Network Configuration Utilities applications, you must have the following SPECTRUM and device security privileges: A SPECTRUM user model with write privileges. See Security and User Maintenance for more information about SPECTRUM user privileges. Super User community name access to modify device community strings, and Read/Write community name access to download firmware. Getting Started This section describes how to access Network Configuration Utilities applications from SPECTRUM Search Manager. Network ConÞguration Utilities and Search Manager SPECTRUM Search Manager enables you to compile a list of the models for the devices you want to configure and provides access to Network Configuration Utilities applications. See the SPECTRUM Search Manager User s Guide for details on working with the Search Manager. Accessing Network ConÞguration Utilities Applications To access Network Configuration Utilities applications: 1 Open the Search Manager application and compile a models list. 2 Select one or more models, and then choose one of the following options from the Management menu: Download Firmware See the Downloading Firmware section for details. Modify Community Name See the Modifying Community Strings section for details. Network Configuration Utilities Page 12

13 Downloading Firmware Describes how to use the Network ConÞguration Utilities Firmware Download Tool to conþgure and execute TFTP Þrmware image downloads to Cabletron devices. Firmware Download Overview Firmware is the software instruction set saved to Flash EEPROM in a managed (or an intelligent ) network device. It provides the device with the capacity to be managed through in-band console management or outof-band, SNMP-compliant management applications such as SPECTRUM. The firmware download procedure involves specifying download parameters (e.g., the name and source of the firmware image file and the device(s) to which the file is to be downloaded) and then starting the download via TFTP (Trivial File Transfer Protocol). Note: SPECTRUM Network Configuration Utilities does not contain TFTP server software. You must install and configure a TFTP server in order to use the Firmware Download Tool. Several commercial, shareware, and freeware TFTP server software packages are available for Windows NT. Aprisma offers a free TFTP server for NT. For instructions on downloading and configuring the Aprisma TFTP server, point your Web browser to: TFTP server software is included with the standard Solaris distribution. For instructions on configuring a Solaris workstation as a TFTP server, point your Web browser to: See also the SPECTRUM Enterprise Configuration Manager User s Guide for more information. Network Configuration Utilities Page 13

14 Downloading Firmware ConÞguring the Download Configuring the Download Before You Start Before you start a download, make sure the models list compiled (or selected) in Search Manager and displayed in the Download Firmware window represents intelligent devices that support the firmware you intend to download. Devices of differing model types can be selected; however, you may need to start the download operation multiple times if the selected devices require different firmware images. To access the Firmware Download Tool: 1 Open the Search Manager application and compile a models list. 2 Select one or more models, and then choose Download Firmware from the Management menu. The Edit Information for Firmware Download Window appears (see Figure 1). Figure 1: Edit Information for Firmware Download Window Network Configuration Utilities Page 14

15 Downloading Firmware Configuring the Download Note: If for any reason some or all of the device(s) in your list are invalid (e.g., devices not supported by the Firmware Download application, devices unable to be contacted, device models for which you do not have write access, etc.), an Invalid Models Window appears first. For more information about the Invalid Models Window, see Verifying the Operation/Exception Handling. ConÞguring and Starting the Download 1 In the Edit Information for Firmware Download Window, set the following parameters (or accept default settings) to configure the download: TFTP Server Address Gateway Address (default value is ), if necessary Image File Name Parallel Downloads (default value is 2) Force Reboot (default state is disabled), if necessary Community String to use instead of the default (default state is disabled), if necessary See Table 1 for more information about the Edit Information for Firmware Download Window and these parameters. 2 Click the OK button to dismiss the Edit Information for Firmware Download Window, save any changes made, and edit the Firmware Download models list. or, 3 Click the Cancel button to dismiss the Edit Information for Firmware Download Window, discard any changes made, and edit the Firmware Download models list. Network Configuration Utilities Page 15

16 Downloading Firmware Configuring the Download Performing Downloads to Selected Models To perform downloads to selected models: 1 Edit the Firmware Download models list by selecting device(s) for the download from the list of devices in the display panel. This list may be identical to the list compiled in Search Manager, or you can select a subset of devices. 2 Select Download Information from the Edit menu. 3 Follow the instructions in Configuring and Starting the Download. Edit Information for Firmware Download Window The Edit Information for Firmware Download Window provides a means of entering information required for a successful firmware download. It is invoked automatically when the Firmware Download application is started, or can be invoked from within the Firmware Download application by selecting Download Information from the Edit menu. Table 1: Edit Information for Firmware Download Window Fields & Buttons Field/Button Text Input Fields and Toggle Buttons TFTP Server Address Gateway Address Image File Name The IP address of the download server. This address must be specified for the download to succeed. The IP address for the first router on the network path between the TFTP server and the managed device that is required if Proxy ARP is disabled for the router. (Proxy ARP allows a router to forward ARP requests on behalf of a device connected to its attached segment.) The default value is The path for the firmware image file you want to download. You must specify a.fls file. You can specify either the image filename or the full path to the image filename, depending upon the configuration of the TFTP server. Network Configuration Utilities Page 16

17 Downloading Firmware Describing the Firmware Download Window Field/Button Parallel Downloads The number of devices to which firmware is simultaneously downloaded. This value must be greater than or equal to 1. The default value is 2. Force Reboot If enabled, the device reboots and loads the downloaded image from EEPROM to memory immediately after the download. If disabled, the device does not reboot, and the image remains in EEPROM until the device is rebooted. The default state is disabled. Community String to use instead of the default OK Cancel If enabled, a community string other than the default must be provided. If disabled, the default SPECTRUM community string(s) configured for each individual model(s) is/are used. The default state is disabled. When provided, this community string will be used for all models. Action Buttons Becomes active when you enter any information into the text fields or click any check boxes. Clicking the OK button dismisses the Edit Information for Firmware Download Window so you can edit the Firmware Download models list prior to executing the download, and saves any information entered in the Download Information Window. Selecting the Cancel button dismisses the Edit Information for Firmware Download Window so you can edit the Firmware Download models list and discards any information entered in the Download Information Window. Describing the Firmware Download Window This section describes the sections of the Firmware Download window (see Figure 2). The window enables you to start and stop the download and monitor the download s progress. Once you initiate a download, and then dismiss the Edit Information for Firmware Download Window by clicking the OK button as described in Configuring and Starting the Download (or do both by clicking the Start All button), the Firmware Download Window is enabled (see Figure 2). Network Configuration Utilities Page 17

18 Downloading Firmware Figure 2: Describing the Firmware Download Window Firmware Download Window Menus Toolbar Icons Model Information Panel Models List Panel Filter/Search Panel Connection Status Menus This section describes menus and menu options (see Table 2). Underscored letters in menu options indicate keyboard shortcuts. Network Configuration Utilities Page 18

19 Downloading Firmware Table 2: Describing the Firmware Download Window Menus and Options Menu File Edit View Model bc Options Print Opens a submenu providing page setup and printing options. Close (or Alt + F4) Closes the Firmware Download window. Select All (or Ctrl + A) Selects all device models. Disabled if all are selected already. Download Information Opens a dialog box providing firmware download options. a Remove Selected Device(s) (or Ctrl + D) Permanently removes selected device models from the models list. b Show Toolbar When enabled, the window displays toolbar icons. Show Toolbar Labels When enabled, the window displays text labels under the toolbar icons. Show Tool Tips When enabled, the window displays pop-up windows providing icon usage tips when the mouse pointer is held over toolbar icons. Show Status Help When enabled, the window displays information at the bottom of the window about window elements where the mouse pointer is held. Connection Status Opens a submenu providing information about the connection to servers and services in the landscape. Sort (or Ctrl + S) Opens a window that enables you to use sort criteria to specify the order that device models are listed in the Models List panel. Column Order (or Ctrl + C) Opens a window that enables you to specify the order of device model information columns in the Models List Panel. Navigate Enables you to Navigate In or Navigate Up to SpectroGRAPH views. Alarms Opens the Alarm View for the selected model(s). Performance Displays the SpectroGRAPH Performance View for the selected model. Notes Opens the Notes dialog box. Utilities Mirrors the Icon Submenu from the device model icon. Information Displays the Information dialog box. Acknowledge Acknowledges an alarm. Network Configuration Utilities Page 19

20 Downloading Firmware Table 2: Describing the Firmware Download Window Menus and Options (Continued) Menu Options Download Options Help a b c d e Start Download for all items Starts firmware download to all device models displayed in the Models List Panel. ad Start Download for selected item(s) Starts firmware download to selected device models. abd Stop Firmware Download Stops a PENDING firmware download, and prevents rebooting of devices whose downloads are IN PROGRESS. e Preferences (or Ctrl + V) Opens a window that enables you to modify user preferences. Clear User Preferences Resets user preferences to default status. What s This? Transforms the mouse pointer into a context-sensitive help pointer. About Firmware Download Opens a copyright window. Online Manuals Opens online SPECTRUM documentation. This option is only available when no download is in progress. This option is only available when one or more models are selected in the models list. More options may be available depending upon the model type. This option is only available when download information has been entered. This option is only available when a download is in progress. Toolbar Icons The toolbar below the Menu enables you to access menu choices quickly by clicking a toolbar icon. These icons are described below (see Table 3). Tip: When you place the cursor over a toolbar icon, a pop-up Tool Tip identifying the icon displays. Further descriptive text is provided when you select the What s This? help option and then click the toolbar icon. Network Configuration Utilities Page 20

21 Downloading Firmware Describing the Firmware Download Window Table 3: Toolbar Icons Icon Select All Remove Sort Order Start All Start Selected Stop Download Ping Telnet Mib Tools Selects all device models. Disabled if all are selected already. Permanently removes selected device models from the models list. a Opens a window that enables you to use sort criteria to specify the order that device models are listed in the Models List panel. Opens a window that enables you to specify the order of device model information columns in the Models List Panel. Starts firmware download to all device models displayed in the Models List Panel. bc Starts firmware download to selected device models. abc Stops a PENDING firmware download, and prevents rebooting of devices whose downloads are IN PROGRESS. d Pings the selected device. Telnets to the selected device. Opens the MIB Tools application What s This? Changes the cursor to a question mark which, when you click on any area of the Firmware Download window, displays a short description. a This option is only available when one or more models are selected in the models list. b This option is only available when no download is in progress. c This option is only available when download information has been entered. d This option is only available when a download is in progress. Model Information Panel The Model Information Panel displays detailed information about the last model selected in the Models List. If multiple models are selected, the information pertains to the last one clicked. The panel includes a device icon and four tabbed panels, described below (see Table 4). Network Configuration Utilities Page 21

22 Downloading Firmware Table 4: Describing the Firmware Download Window Model Information Panel Icon/Panel Device Icon System System Name Network Address IP Address Contact Location Operation Status Location Device Notes The icon associated with the last selected device. Displays several fields of detailed system information. These are described below. The fully qualified domain name of the managed node. The address SPECTRUM is using to communicate with the device s SNMP agent. The port Internet address of the interface. This information is only available on interface ports. A written description of the selected device. The person to contact when device problems occur. This is specified when the device is created and can be modified in certain SpectroGRAPH views. The physical location of the selected device. Displays informational messages concerning the status of the operation currently being performed. Device location listed in SpectroGRAPH s hierarchical format. For example, Topological Location: ÔcokeÕ of type ÔLandscapeÕ ; ÔUniverseÕ of type ÔUniverseÕ. User-created notes for the selected device. Models List Panel The Models List Panel lists device model attributes and download status information. The panel includes eight columns (two hidden), described below (see Table 5). Network Configuration Utilities Page 22

23 Downloading Firmware Table 5: Describing the Firmware Download Window Models List Panel Column Model Name Network Address Status Start Time End Time Model Type Block Count The name of the SPECTRUM model that represents the selected device. A short description of the selected device. The address SPECTRUM is using to communicate with the device s SNMP agent. Indicates the status of a download: PENDING The download is waiting to begin. IN PROGRESS The download is in progress. SUCCESS The download completed successfully. FAILURE The download failed. REBOOTING The device is rebooting following download. REBOOTED The device successfully rebooted following download. ABORTED The download has been aborted by the user. The time the download started. The time the download finished. The name of the SPECTRUM model type that represents the selected device. Hidden by default. The number of blocks transferred. Not supported by all devices. Hidden by default. To rearrange columns and display hidden columns in the Models List Panel: 1 Access the Column Order dialog box (see Figure 3) by either: a b c Clicking the Order toolbar icon, or Selecting Column Order from the View menu, or Typing Alt+V+O (Alt, V, then O) on the keyboard. 2 In the Shown Order list, highlight the column names you wish to hide, then click the button. The selected column names move to the Hidden list. Network Configuration Utilities Page 23

24 Downloading Firmware Describing the Firmware Download Window 3 In the Hidden list, highlight the column names you wish to show, then click the button. The selected column names move to the Shown Order list. a To move all items from one list to the other, click the or button. 4 To rearrange columns, highlight the column name(s), then click the or arrow to move the column(s) up or down in the current list. Figure 3: Column Order Window Filter/Search Panel Located below the Models List Panel s horizontal scroll bar, this panel includes four buttons and a text field you can use for filtering and searching the Models List (see Table 6). Network Configuration Utilities Page 24

25 Downloading Firmware Table 6: Describing the Firmware Download Window Filter/Search Panel Buttons Button Search Shown Prev Next Toggles between Filter and Search function. Default is Search. Specifies which column to filter/search in. Default is Shown. Finds the previous entry matching the search criteria you enter in the text field. Enabled only when you select the Search option. Finds the next entry matching the search criteria you enter in the text field. Enabled only when you select the Search option. Connection Status Clicking the button at the bottom right of the Firmware Download window displays the Connection Status dialog box, which shows the connection status and type of service of all servers accessible by the application. Possible types of service include Landscape and View. The color of the status icon indicates the condition of the connection. Color-coded conditions include green (complete service), yellow (degraded service), and red (total loss of service). The Connection Log provides date/time information and status messages for the service selected in the dialog box. Possible messages include, Connection lost, and Connection re-established. Verifying the Operation/Exception Handling The Firmware Download Window s Models List Panel gives you several visual cues as to the status of a download via text displayed in the following columns: Status Start Time End Time See Table 5 for more information. Network Configuration Utilities Page 25

26 Downloading Firmware Describing the Firmware Download Window In addition, more detailed information concerning the download is logged in the fwdownload.log file, located in the /tmp directory on UNIX, and in the directory specified by the TEMP environment variable on Windows NT. Note: On Windows NT, if you change the directory specified by the TEMP environment variable, you must re-initialize processd in order for Firmware Download to correctly place the log file. For instructions on re-initializing processd, see the SPECTRUM manual, Database Management. Invalid Models If some selected model(s) are invalid, the Invalid Models Window indicates the following relevant information: Model name Model Type name Explanation associated with the error condition (see Figure 4) Figure 4: Invalid Models Window Network Configuration Utilities Page 26

27 Downloading Firmware Describing the Firmware Download Window You can filter/search the models displayed in the Invalid Models list for specific criteria, similar to using the Filter/Search Panel in the Models List Panel. Models displayed in this window will be discarded prior to performing the operation, and will not appear in the Models list. Table 7: Invalid Models Window Buttons Button Continue Print Cancel Continues the download operation for valid devices and dismisses the Invalid Models Window. Invokes a dialog box providing print options for sending screen output to a printer. Dismisses the Invalid Models Window and exits the download operation. Error Messages Examples of possible error messages displayed in the Invalid Models Window, and possible explanations, are shown in Table 8. Table 8: Invalid Models Error Messages Error Message Possible Explanations Cannot process model. - The model handle of the selected device does not belong to a valid landscape. - The model handle could not be found, either because it doesn t exist in the given landscape, or the user does not have sufficient privileges to view it. Cannot contact device. - The model condition indicates that the device cannot be contacted. Unsupported device. Invalid permissions. - The model represents a device that is not currently supported by the application. - The current user does not have write privileges for the given model within the SPECTRUM environment. Network Configuration Utilities Page 27

28 Downloading Firmware Setting Preferences Setting Preferences You can change Firmware Download startup default settings to best suit your needs by using the Preferences dialog box. The dialog box enables you to customize and save preference settings, which provides persistence from one Firmware Download session to another. You can access the Preferences dialog box by either of the following methods: Select Options>Preferences from the Firmware Download Window s Menu bar. Press Ctrl+y on the keyboard with the Firmware Download Window in the foreground (doing so with the Search Manager window in the foreground will launch the Search Manager Preferences dialog box). The Firmware Download Preferences dialog box appears (see Figure 5). Figure 5: Preferences Dialog Box d Network Configuration Utilities Page 28

29 Downloading Firmware Setting Preferences The Preferences Dialog Box contains three tabbed panels: Connection preferences enables you to change the way the SpectroSERVER communicates with the Firmware Download Tool. This panel is displayed first. Firmware Download preferences enables you to change default settings used by the Firmware Download Tool. Display preferences enables you to change the way the Firmware Download Tool GUI behaves at startup and exit. Connection Preferences This panel enables you to modify request and response information between the SpectroSERVER and the Firmware Download Tool. Table 9 describes the connection preferences. Table 9: Connection Preferences Preference Connection Confirmation Interval Connection Confirmation Timeout Connection Retry Timeout Number of milliseconds a server waits for a confirmation response before sending another request. The default is ms (60 seconds). Number of milliseconds the SpectroSERVER waits for a confirmation response from the node. The default is ms (60 seconds). Number of milliseconds a client waits before attempting to re-establishing a connection to the SpectroSERVER. The default is ms (20 seconds). Connection Time Limit The time limit for connecting to the server before the connection attempt is terminated. The default is 5000 ms (5 seconds). Disable Queue Send Mail Queue Size The default value of selected disables the queue for sending requests to the SpectroSERVER. Maximum number of outstanding Mail Service requests that an application can make. The default is 128. Network Configuration Utilities Page 29

30 Downloading Firmware Setting Preferences Table 9: Connection Preferences Preference Mail Response Timeout Max Send Batch Size Route Message Timeout Show SpectroSERVER Selection Dialog At Start-up SpectroGRAPH Machine SpectroGRAPH Machine Port Minimum time the Mail Service waits for a response from the SpectroSERVER before a request is cancelled. The default is ms (60 seconds). Maximum number of requests that are batched together. The default is 512. Waiting time for landscape updates before cancelling requests that cannot be routed. Default is 1000 ms (1 second). The default value of deselected indicates a connection to the default SpectroSERVER machine will always be present. If selected, shows the Select SpectroSERVER dialog at startup where you choose which server you initially connect to. If there is only one server in the landscape map, the selection dialog will not appear regardless of the setting. Host name on which the target SPECTRUM UI is running. TCP port number on which the target SPECTRUM UI is accepting connections. Unsolicited Queue Size Maximum number of unsolicited registrations supported. The default is 512. Firmware Download Preferences This panel enables you to modify default download configuration settings used by the Firmware Download Tool. Table 10 describes the Firmware Download preferences. Network Configuration Utilities Page 30

31 Downloading Firmware Preference Table 10: Firmware Download Preferences Setting Preferences Community Name Force Reboot Gateway IP Address Log Filename Parallel Downloads Reboot Poll Interval Reboot Poll Timeout If used, a community string other than the default must be provided. This community string will be then used for all models. If left blank, the default SPECTRUM community string(s) configured for each individual model(s) is/are used. The default value is blank. If enabled, the device reboots and loads the downloaded image from EEPROM to memory immediately after the download. If disabled, the device does not reboot, and the image remains in EEPROM until the device is rebooted. The default state is disabled. The IP address for the first router on the network path between the TFTP server and the managed device that is required if Proxy ARP is disabled for the router. (Proxy ARP allows a router to forward ARP requests on behalf of a device connected to its attached segment.) The default value is The path for the Firmware Download log file. Defaults are: UNIX: /tmp/fwdownload.log NT: <directory specified by the TEMP environment variable>/fwdownload.log The number of devices to which firmware is simultaneously downloaded. This value must be greater than or equal to 1. The default value is 2. Number of milliseconds between polls of a device rebooted following a download. Polling continues until the successfully rebooted device answers polls, or when the Reboot Poll Timeout threshhold has been reached. The default is 3000 ms (3 seconds). Number of milliseconds the SpectroSERVER waits for a response from a device rebooted following a download before reporting a failure. The default is ms (2 minutes). Status is reported as REBOOTING until either a successful reboot (status refreshes to REBOOTED), or the timeout threshold has been reached (FAILURE). Network Configuration Utilities Page 31

32 Downloading Firmware Table 10: Firmware Download Preferences Setting Preferences Preference TFTP Server IP Address TFTP Filename The IP address of the download server. This address must be specified for the download to succeed. The path for the firmware image file you want to download. You must specify a.fls file. You can specify either the image filename or the full path to the image filename, depending upon the configuration of the TFTP server. Display Preferences This panel allows you to change preferences that can be used in the presentation of the Firmware Download Window (see Figure 2). Table 11 describes the Display Preferences. Table 11: Display Preferences Preference Iconify at Startup Save Settings at Exit Controls iconification of the Firmware Download Window at startup. The default value is deselected, and shows the window as not minimized. Enables you to save any settings made to the View menu (Show Toolbar, Show Toolbar Labels, Show Tool Tips, and Show Status Help), when the Firmware Download Tool is exited. The default value is selected. Network Configuration Utilities Page 32

33 Downloading Firmware Preferences Dialog Buttons and Fields Setting Preferences Table 12: Preferences Dialog Buttons Button/Field OK Cancel Apply Defaults What s This? Make Changes Permanent Current User Click the OK button to save any changes made on the tabbed page(s). This also closes the Firmware Download Preferences dialog box. Click the Cancel button to exit the Firmware Download Preferences dialog box and return to the Firmware Download Window without making any changes. Click the Apply button to save any changes. The Firmware Download Preferences dialog box remains open so you can make other changes. If these changes are for future use, click the Make Changes Permanent button before clicking OK to exit. Click the Defaults button to revert back to the default values for the current tabbed panel. Invokes What s This? help. Once you make changes within any Preferences dialog, click the Make Changes Permanent check box to save your changes. This non-editable field shows the current user name. In order for any saved changes to take affect, restart the Firmware Download Tool. Clearing Preferences If you want to clear user preferences that you set in the Preferences tabbed panels: 1 Select Clear User Preferences in the Firmware Download Window s Options menu. 2 In the Clear User Preferences dialog box that displays, click the OK button to clear preferences. Network Configuration Utilities Page 33

34 Downloading Firmware Setting Preferences 3 Exit the Firmware Download Tool. This will destroy your preference settings and restore all default preference settings once you restart the Firmware Download Tool. Network Configuration Utilities Page 34

35 Modifying Community Strings Describes how to use the Network ConÞguration Utilities Modify Community Strings Tool to modify community strings for Cabletron devices. Community Strings Overview For all of Cabletron s newer intelligent devices including all SmartSwitch modules MIB information is organized into a series of components, each of which controls a defined set of logically grouped objects. For example, the EMM-E6 s bridging information is organized into its own component and repeater information resides in three separate components, one for each of the EMM-E6 s internal repeater channels. In the original versions of these devices, each MIB component is protected by its own set of user-configurable read only, read/write, and superuser community strings. These strings determine the level of access (read only, read/write, or superuser) that will be granted to the information controlled by each component. Newer versions of devices with this component-based MIB architecture have been simplified somewhat. These devices support a single, global set of community strings, with small modifications added automatically to accommodate multiple instances of the same MIB component (as occurs in multi-channel Ethernet repeaters or multi-ring Token Ring devices). The Modify Community Strings Tool supports those Cabletron devices which implement global community strings, whether the devices support the chassis MIB (Rev or later), or the ctchassis2 MIB. The Modify Community Strings Tool enables you to modify the community strings of multiple devices in a single step. You can also modify the community string of the SPECTRUM model representing each device. Network Configuration Utilities Page 35

36 Modifying Community Strings Configuring the Community String Change ConÞguring the Community String Change Before You Start Before you start a community string change, make sure the models list compiled (or selected) in Search Manager and displayed in the Modify Community Strings window represents intelligent devices that implement global community strings. Devices of differing model types can be selected as long as they support the chassis MIB (Rev or later), or the ctchassis2 MIB. To access the Modify Community Strings Tool: 1 Open the Search Manager application and compile a models list. 2 Select one or more models, and then choose Modify Community Strings from the Management menu. The Edit Information for Community String Change Window appears. Note: If for any reason some or all of the device(s) in your list are invalid (e.g., devices not supported by the Modify Community Strings application, devices unable to be contacted, device models for which you do not have write access, etc.), an Invalid Models Window appears first. For more information about the Invalid Models Window, see Verifying the Operation/Exception Handling. Network Configuration Utilities Page 36

37 Modifying Community Strings Configuring the Community String Change Figure 6: Edit Information for Community String Change Window ConÞguring and Starting the Change 1 In the Edit Information for Community String Change Window, you can edit community string information for either or both of the following: a Device Information: - Read Only community string - Read Write community string - Super User community string b SPECTRUM Model Information: - New Community String Network Configuration Utilities Page 37

38 Modifying Community Strings Configuring the Community String Change Tip: If you wish to edit any of the New Community String values you must first enter the Current Super User community string in order to gain access to them. See Table 13 for more information about these parameters. 2 Click the OK button to dismiss the Edit Information for Community String Change Window, save any changes made, and edit the Modify Community Strings models list or, 3 Click the Cancel button to dismiss the Edit Information for Community String Change Window, discard any changes made, and edit the Modify Community Strings models list. Performing Community String Changes to Selected Devices To perform community string changes to selected models: 1 Edit the Modify Community Strings models list by selecting device(s) for the change from the list of devices in the display panel. This list may be identical to the list compiled in Search Manager, or you can select a subset of devices. 2 Select Modify Community Strings from the Edit menu. Follow the instructions in Configuring and Starting the Change Edit Information for Community String Change Window The Edit Information for Community String Change Window provides a means of entering various community strings for Cabletron s intelligent networking hardware devices. Table 13 lists all fields and buttons in this window and describes their functions. Network Configuration Utilities Page 38

39 Modifying Community Strings Configuring the Community String Change Table 13: Edit Information for Community String Change Window Fields & Buttons Field/Button Current Super User Read Only Read Write Super User New Community String OK Device Community String Information The Super User community string for the selected reachable device(s), which is used to perform write operations to each device. The text fields in the New Community String Values area become active as soon as you enter something in the Current Super User field. The new read-only community string for the selected reachable device(s). This value is written to the devices. The new read/write community string for the selected reachable device(s). This value is written to the devices. The new super-user community string for the selected reachable device(s). This value is written to the devices. SPECTRUM Model Community String Information The new internal SPECTRUM model community string. Written to the model (not the device), this value determines the level of access that SPECTRUM has for each device. It should match either the read-only, read/write, or super-user community strings on the selected reachable device(s). Action Buttons Becomes active when you enter a Current Super User community string, and at least one community string value to be modified, or the SPECTRUM community string. Clicking the OK button dismisses the Edit Information for Community String Change Window so you can edit the Modify Community Strings models list, and saves any information entered in the Edit Information for Community String Change Window. Network Configuration Utilities Page 39

40 Modifying Community Strings Describing the Modify Community Strings Window Table 13: Edit Information for Community String Change Window Fields & Buttons Field/Button Cancel Selecting the Cancel button dismisses the Edit Information for Community String Change Window so you can edit the Modify Community Strings models list and discards any information entered in the Edit Information for Community String Change Window. Note: If a field is left blank, no modification is made to that current community string. Describing the Modify Community Strings Window This section describes the sections of the Modify Community Strings Window (see Figure 7). The window enables you to configure community string change parameters, start the change, and monitor the change s progress. Network Configuration Utilities Page 40

41 Modifying Community Strings Describing the Modify Community Strings Window Figure 7: Modify Community Strings Window Menus Toolbar Icons Model Information Panel Models List Panel Filter/Search Panel Connection Status Menus This section describes menus and menu options (see Table 14). Underscored letters in menu options indicate keyboard shortcuts. Network Configuration Utilities Page 41

42 Modifying Community Strings Describing the Modify Community Strings Window Table 14: Menus and Options Menu File Edit View Model bc Options Print Opens a submenu providing page setup and printing options. Close (or Alt + F4) Closes the Modify Community Strings window. Select All (or Ctrl + A) Selects all device models. Community String Change Information Opens a dialog providing community string change options. a Remove Selected Device(s) (or Ctrl + D) Permanently removes selected device model(s) from the models list. b Show Toolbar When enabled, the window displays toolbar icons. Show Toolbar Labels When enabled, the window displays text labels under the toolbar icons. Show Tool Tips When enabled, the window displays pop-up windows providing icon usage tips when the mouse pointer is held over toolbar icons. Show Status Help When enabled, the window displays information at the bottom of the window about window elements where the mouse pointer is held. Connection Status Opens a submenu providing information about the connection to servers and services in the landscape. Sort (or Ctrl + S) Opens a window that enables you to use sort criteria to specify the order that device models are listed in the Models List panel. Column Order (or Ctrl + C) Opens a window that enables you to specify the order of device model information columns in the Models List Panel. Navigate Enables you to Navigate In or Navigate Up to SpectroGRAPH views. Model Alarms Opens the Alarm View for the selected model(s). Performance Displays the SpectroGRAPH Performance View for the selected model. Notes Opens the Notes dialog box. Utilities Mirrors the Icon Submenu from the device model icon. Information Displays the Information dialog box. Acknowledge Acknowledges an alarm. Network Configuration Utilities Page 42

43 Modifying Community Strings Describing the Modify Community Strings Window Table 14: Menus and Options (Continued) Menu Options Community String Options Help a b c Start Community String Change for all items Starts community string change to all device models displayed in the Models List Panel. a Start Change for selected item(s) Starts community string change to selected device model(s). ab Preferences (or Ctrl + V) Opens a window that enables you to modify user preferences. Clear User Preferences Resets user preferences to default status. What s This? Transforms the mouse pointer into a context-sensitive help pointer. About Modify Community Strings Opens a copyright window. Online Manuals Opens online SPECTRUM documentation. This option is only available when a community string change is not in progress. This option is only available when one or more models are selected in the models list. More options may be available depending upon the model type. Toolbar Icons The toolbar below the Menu enables you to access menu choices quickly by clicking a toolbar icon. These icons are described below (see Table 15). Tip: When you place the cursor over a toolbar icon, a pop-up Tool Tip identifying the icon displays. Further descriptive text is provided when you select the What s This? help option and then click the toolbar icon. Table 15: Toolbar Icons Icon Select All Remove Selects all device models. Disabled if all are selected. Permanently removes selected device models from the models list. a Network Configuration Utilities Page 43

44 Modifying Community Strings Describing the Modify Community Strings Window Table 15: Toolbar Icons Icon Sort Order Start All Start Selected Ping Telnet Mib Tools What s This? a b Opens a window that enables you to use sort criteria to specify the order that device models are listed in the Models List panel. Opens a window that enables you to specify the order of device model information columns in the Models List Panel. Starts community string change to all device models displayed in the Models List Panel. b Starts community string change to selected device models. ab Pings the selected device. Telnets to the selected device. Opens the MIB Tools application Changes the cursor to a question mark which, when you click on any area of the Modify Community Strings window, displays a short description. This option is only available when one or more models are selected in the models list. This option is only available when a community string change is not in progress. Model Information Panel The Model Information Panel displays detailed information about the last model selected in the Models List. If multiple models are selected, the information pertains to the last one clicked. The panel includes a device icon and four tabbed panels, described below (see Table 16). Table 16: Model Information Panel Icon/Panel Device Icon System System Name The icon associated with the last selected device. Displays several fields of detailed system information. These are described below. The fully qualified domain name of the managed node. Network Configuration Utilities Page 44

45 Modifying Community Strings Describing the Modify Community Strings Window Table 16: Model Information Panel Icon/Panel Network Address IP Address Contact Location Operation Status Location Device Notes The address SPECTRUM is using to communicate with the device s SNMP agent. The port Internet address of the interface. This information is only available on interface ports. A written description of the selected device. The person to contact when device problems occur. This is specified when the device is created and can be modified in certain SpectroGRAPH views. The physical location of the selected device. Displays informational messages concerning the status of the operation currently being performed. Device location listed in SpectroGRAPH s hierarchical format. For example, Topological Location: ÔcokeÕ of type ÔLandscapeÕ ; ÔUniverseÕ of type ÔUniverseÕ. User-created notes for the selected device. Models List Panel The Models List Panel lists device model attributes and change status information. The panel includes five columns, described below (see Table 17). Table 17: Models List Panel Column Model Name Network Address The name of the SPECTRUM model that represents the selected device. A short description of the selected device. The address SPECTRUM is using to communicate with the device s SNMP agent. Network Configuration Utilities Page 45

46 Modifying Community Strings Describing the Modify Community Strings Window Table 17: Models List Panel (Continued) Column Status Model Type Indicates the status of a community string change: PENDING The community string change is waiting to begin. IN PROGRESS The community string change is in progress. SUCCESS The community string change completed successfully. FAILURE The community string change failed. The name of the SPECTRUM model type that represents the selected device. To rearrange or hide columns in the Models List Panel: 1 Access the Column Order dialog box (see Figure 8) by either: a b c Clicking the Order toolbar icon, or Selecting Column Order from the View menu, or Typing Alt+V+O (Alt, V, then O) on the keyboard. 2 In the Shown Order list, highlight the column names you wish to hide, then click the button. The selected column names move to the Hidden list. 3 In the Hidden list, highlight the column names you wish to show, then click the button. The selected column names move to the Shown Order list. a To move all items from one list to the other, click the or button. 4 To rearrange columns, highlight the column name(s), then click the or arrow to move the column(s) up or down in the current list. Network Configuration Utilities Page 46

47 Modifying Community Strings Describing the Modify Community Strings Window Figure 8: Column Order Window Filter/Search Panel Located below the Models List Panel s horizontal scroll bar, this panel includes four buttons and a text field you can use for filtering and searching the Models List (see Table 18). Table 18: Filter/Search Panel Buttons Button Search Shown Prev Toggles between Filter and Search function. Default is Search. Specifies which column to filter/search in. Default is Shown. Finds the previous entry matching the search criteria you enter in the text field. Enabled only when you select the Search option. Network Configuration Utilities Page 47

48 Modifying Community Strings Describing the Modify Community Strings Window Table 18: Filter/Search Panel Buttons Button Next Finds the next entry matching the search criteria you enter in the text field. Enabled only when you select the Search option. Connection Status Clicking the button at the bottom right of the Modify Community Strings Window displays the Connection Status dialog box, which shows the connection status and type of service of all servers accessible by the application. Possible types of service include Landscape and View. The color of the status icon indicates the condition of the connection. Color-coded conditions include green (complete service), yellow (degraded service), and red (total loss of service). The Connection Log provides date/time information and status messages for the service selected in the dialog box. Possible messages include, Connection lost, and Connection re-established. Verifying the Operation/Exception Handling The Modify Community Strings window s Models List Panel provides visual cues as to the status of a community string change via text displayed in the Status column. Also, clicking on the Operations Status tab in the Model Information Panel displays relevant information concerning the status of the community string change. See Table 17 for more information. In addition, more detailed information concerning the change is contained in log files, located in the /tmp directory on UNIX, and in the directory specified by the TEMP environment variable on Windows NT. Network Configuration Utilities Page 48

49 Modifying Community Strings Describing the Modify Community Strings Window Note: On Windows NT, if you change the directory specified by the TEMP environment variable, you must re-initialize processd in order for Modify Community Strings to correctly place the log files. For instructions on re-initializing processd, see the SPECTRUM manual, Database Management. Invalid Models If some selected model(s) are invalid, the Invalid Models Window indicates the following relevant information: Model name Model Type name Explanation associated with the error condition (see Figure 9) Figure 9: Invalid Models Window Network Configuration Utilities Page 49

50 Modifying Community Strings Describing the Modify Community Strings Window You can filter/search the models displayed in the Invalid Models list for specific criteria, similar to using the Filter/Search Panel in the Models List Panel. Button Table 19: Invalid Models Window Buttons Continue Print Cancel Continues the change operation for valid devices and dismisses the Invalid Models Window. Invokes a dialog box providing print options for sending screen output to a printer. Dismisses the Invalid Models Window and cancels the change operation. Error Messages Examples of possible error messages displayed in the Invalid Models Window, and possible explanations, are shown in Table 20. Table 20: Invalid Models Error Messages Error Message Possible Explanations Cannot process model. - The model handle of the selected device does not belong to a valid landscape. - The model handle could not be found, either because it doesn t exist in the given landscape, or the user does not have sufficient privileges to view it. Cannot contact device. - The model condition indicates that the device cannot be contacted. Unsupported device. Invalid permissions. - The model represents a device that is not currently supported by the application. - The current user does not have write privileges for the given model within the SPECTRUM environment. Network Configuration Utilities Page 50

51 Modifying Community Strings Setting Preferences Setting Preferences You can change Modify Community Strings startup default settings to best suit your needs by using the Preferences dialog box. The dialog box enables you to customize and save preference settings, which provides persistence from one Modify Community Strings session to another. You can access the Preferences dialog box by either of the following methods: Select Options>Preferences from the Modify Community Strings Window s Menu bar. Press Ctrl+y on the keyboard with the Modify Community Strings Window in the foreground (doing so with the Search Manager window in the foreground will launch the Search Manager Preferences dialog box). The Modify Community Strings Preferences dialog box appears (see Figure 10). Figure 10: Preferences Dialog Box d Network Configuration Utilities Page 51