Fabric Watch Administrator’s Guide Supporting Fabric OS v5.2.
Copyright © 2006 Brocade Communications Systems, Inc. ALL RIGHTS RESERVED. Brocade, the Brocade B weave logo, Fabric OS, File Lifecycle Manager, MyView, Secure Fabric OS, SilkWorm, and StorageX are registered trademarks and Tapestry is a trademark of Brocade Communications Systems, Inc., in the United States and/or in other countries. FICON is a registered trademarks of IBM Corporation in the U.S. and other countries.
Document History Title Publication Number Summary of Changes Date Fabric Watch User’s Guide 53-0001559-02 n/a May 2000 Fabric Watch User’s Guide 53-0000198-02 n/a January 2002 Fabric Watch User’s Guide 53-0000186-02 n/a March 2002 Fabric Watch User’s Guide 53-0000504-02 n/a April 2003 Fabric Watch User’s Guide 53-0000524-02 n/a April 2003 Fabric Watch User’s Guide 53-0000524-03 Updated default values and restructured the document.
Contents About This Document Chapter 1 How This Document Is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Supported Hardware and Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x What’s New in This Document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Document Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Text Formatting. . . . . . . . . . . . . . . . . . . .
Configuring Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 Event Behavior Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 Data Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Threshold Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Time Bases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16 Configuring Alarm Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16 Configuring SNMP Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17 Configuring API Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17 Configuring Port Log Lock Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B Basic Fabric Watch Configuration Guidelines Appendix C Using Fabric Watch with Configuration Files Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1 Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About This Document This document is an administrator’s guide to help you use the Fabric Watch product to monitor and improve fabric health. This document is specific to Brocade Fabric OS version 5.2.0 and all switches running Fabric OS v5.2.0. For a list of supported hardware for this release, see “Supported Hardware and Software” on page -x.
Supported Hardware and Software This document is specific to Brocade Fabric OS version 5.2.0 and all switches running Fabric OS version 5.2.0, including: • • • • • • • • • SilkWorm 200E SilkWorm 3250 SilkWorm 3850 SilkWorm 3900 SilkWorm 4100 SilkWorm 4900 SilkWorm 7500 SilkWorm 24000 SilkWorm 48000 Although many different software and hardware configurations are tested and supported by Brocade Communications Systems, Inc. for the Brocade Fabric OS v5.2.
Document Conventions This section describes text formatting conventions and important notices formats.
Key Terms For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary. For definitions of SAN-specific terms, visit the Storage Networking Industry Association online dictionary at http://www.snia.org/education/dictionary. Additional Information This section lists additional Brocade and industry-specific documentation that you might find helpful.
SilkWorm 24000/48000 • • • • • • • • • Port Blade and Filler Panel Replacement Procedure Control Processor Blade Replacement Procedure Blower Assembly Replacement Procedure Cable Management Tray and Guide Replacement Procedure Chassis Door Replacement Procedure WWN Bezel and Card Replacement Procedure Power Supply and Filler Panel Replacement Procedure 14U Rack Mount Kit Installation Procedure Mid-Mount Rack Kit Installation Procedure SilkWorm 7500 • • • • SilkWorm 7500 Hardware Reference Manual SilkWo
For practical discussions about SAN design, implementation, and maintenance, you can obtain Building SANs with Brocade Fabric Switches through: http://www.amazon.com For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource Library location: http://www.brocade.com Release notes are available on the Brocade Connect Web site and are also bundled with the Fabric OS firmware.
FCIP Tunneling The optional Fibre Channel over Internet protocol (FCIP) Tunneling Service enables Fibre Channel frames to “tunnel” through IP networks by dividing frames, encapsulating the result in IP packets on entering the tunnel, and then reconstructing them as they leave the tunnel. Fabric OS supports eight FCIP interswitch links between two SilkWorm switches (SilkWorm 7500 or SilkWorm 48000 with a FR4-18i blade) or routes.
2. Switch Serial Number The switch serial number and corresponding bar code are provided on the serial number label, as shown here: : *FT00X0054E9 FT00X0054E9 The serial number label is located as follows: • • • • 3. SilkWorm 2000-series switches: Bottom of chassis. SilkWorm 200E, 3200, and 3800 switches: nonport side of chassis. SilkWorm 3250, 3850, 3900, 4100, 4900, and 7500 switches: Bottom of chassis.
Chapter Fabric Watch Concepts 1 This chapter contains the following sections: • • • • • • • • “Fabric Watch Overview,” next “Introduction to Fabric Health” on page 1-3 “Fabric Watch Components” on page 1-3 “Configuring Events” on page 1-12 “Port Persistence” on page 1-20 “Notification Methods” on page 1-20 “Switch Policies” on page 1-23 “Interpreting Event Messages” on page 1-23 Fabric Watch Overview Fabric Watch is an optional storage area network (SAN) health monitor software for Brocade SilkWorm sw
1 Fabric Watch Overview Fabric Watch lets you define how often to measure each switch and fabric element and to specify notification thresholds. Whenever fabric elements exceed these thresholds, Fabric Watch automatically provides notification using several methods, including e-mail messages, SNMP traps, and log entries.
Introduction to Fabric Health 1 Introduction to Fabric Health Fabric health refers to the capability of the fabric to support data being routed through it. A healthy fabric enables effective data transmission between networked devices. Although the concept of fabric health initially seems fairly simple, it can be a deep and complex topic due to the number of factors that are involved. One of the more obvious criteria for fabric health is the condition of the network hardware.
1 Fabric Watch Components Table 1-1 describes the classes into which Fabric Watch groups all switch and fabric elements. Table 1-1 Fabric Watch Classes Class Description Environment Includes information about the physical environment in which the switch resides and the internal environment of the switch. For example, an Environment-class alarm alerts you to problems or potential problems with temperature, fans, and power.
Fabric Watch Components 1 Areas While classes represent large groupings of information, areas represent the information that Fabric Watch monitors. For example, switch temperature, one of the values tracked by Fabric Watch, is an area within the class Environment. The tables in this section describe all of the areas monitored by Fabric Watch, organized by their associated classes. Environment Class Areas Table 1-2 lists and describes the Fabric Watch areas in the Environment class.
1 Fabric Watch Components Fabric Class Areas Table 1-3 lists Fabric Watch areas in the Fabric class and describes each area. Table 1-3 Fabric Class Areas Area Description Domain ID Changes Monitors forced domain ID changes. Forced domain ID changes occur when there is a conflict of domain IDs in a single fabric and the principal switch has to assign another domain ID to a switch. Fabric Logins Occurs when ports and devices initialize with the fabric.
Fabric Watch Components 1 FRU Class Areas Table 1-4 lists Fabric Watch areas in the FRU class and describes each area. Possible states for all FRUclass areas are absent, faulty, inserted, on, off, ready, and up. Table 1-4 FRU Class Areas Area Indicates Slot State of a slot has changed. Power Supply State of a power supply has changed. Fan State of a fan has changed. WWN State of a WWN card has changed. Supported FRU areas depend on the type of Brocade switches.
1 Fabric Watch Components Table 1-6 Port Class Areas Area Indicates Invalid Cyclic Redundancy Checks (CRCs) A frame is invalid and cannot be transmitted. Invalid CRCs can represent noise on the network. Such frames are recoverable by retransmission. Invalid CRCs indicate a potential hardware problem. These errors occur mostly in aging fabrics. Invalid Transmission Word A word did not transmit successfully. Invalid word messages usually indicate a hardware problem.
Fabric Watch Components 1 Resource Class Area Table 1-7 describes the Fabric Watch resource class area. Table 1-7 Resource Class Area Area Description Flash Monitor Monitors the compact flash space available by calculating the percentage of flash space consumed and comparing it with the configured high threshold value. Security Class Areas Table 1-8 lists Fabric Watch areas in the security class and describes what each area indicates.
1 Fabric Watch Components Table 1-8 Security Class Areas (Continued) Area Indicates SCC Violation An SCC violation occurs when an unauthorized switch tries to join a secure fabric. The WWN of the unauthorized switch appears in the ERRLOG. Serial Violation A serial violation occurs when a secure switch detects an unauthorized serial port connection request. SES Violation An SES violation occurs when an SES (SCSI Enclosed Services) request reaches a secure switch from an unauthorized WWN.
Fabric Watch Components Table 1-9 1 SFP Class Areas Area Description Temperature The temperature area measures the physical temperature of the SFP, in degrees Celsius. A high temperature indicates that the SFP might be in danger of damage. Receive Power The receive power area measures the amount of incoming laser, in µwatts, to help determine if the SFP is in good working condition. If the counter often exceeds the threshold, the SFP is deteriorating.
1 Configuring Events Configuring Events The following area attributes are used to define and detect events in Fabric Watch: • • • • • “Event Behavior Types,” next “Data Values” on page 1-13q “Threshold Values” on page 1-13 “Time Bases” on page 1-15 “Event Settings” on page 1-17 You can customize the information reported by Fabric Watch by configuring event behavior types, threshold values, time bases, and event settings.
Configuring Events 1 Data Values A data value represents three aspects of a fabric: counter value, measured value, or state value. Data values are updated by Fabric Watch approximately every six seconds, an interval that you cannot change. Counter value is the total number of times that a given event has occurred. For each monitored event during the time period, the value is incremental.
1 Configuring Events Buffer Values Figure 1-1 shows an example in which each time a signal crosses the high limit, an event occurs. The arrows indicate the points at which the event criteria is met. In this case, there is a great deal of fluctuation. Even when the monitor is set to triggered, a number of messages are sent. Figure 1-1 Threshold Monitoring You can use buffer values to reduce the occurrence of events due to data fluctuation.
Configuring Events 1 Time Bases Time bases are time periods within Fabric Watch. This configurable field impacts the comparison of sensor-based data with user-defined threshold values. Setting Time Base to None If you set a time base to none, Fabric Watch compares a data value against a threshold boundary level. When the absolute value of the measuring counter exceeds the threshold boundary, an event is triggered.
1 Configuring Events The following examples illustrate each point. Example1: Triggering an Event Figure 1-4 shows a sample graph of data obtained by Fabric Watch (the type of data is irrelevant to the example). A high threshold of 2 is specified to trigger an event. A time base of minute is defined. An event occurs only if the rate of change in the specific interval (one minute in this example) is across the threshold boundary.
Configuring Events 1 Example 2: Not Triggering an Event Figure 1-5 uses the same data to illustrate a case in which a threshold is exceeded without triggering an event. In this case, the calculated rate of change in the data value is always less than or equal to the high threshold of 2. At the tenth sample, the rate of change is one per minute. At the fourteenth, twenty-first, and twenty-fifth sample, the rate of change remains equal to the high threshold of 2.
1 Configuring Events Above Event Triggers Use the Above event trigger for an element that requires only high threshold monitoring. In the Above event trigger, Fabric Watch triggers an event immediately after the data value becomes greater than the high threshold. Define a buffer zone within the operational limit of an area to suppress multiple events when the counter value goes above the high threshold and fluctuates around it.
Configuring Events Figure 1-7 1 Changed Threshold Use Changed event triggers with discretion. They are most useful when a change in value is expected to be rare. Monitoring a fabric element that is subject to frequent change generates so many events that it can render it virtually useless. For example, this trigger type is appropriate for FRU failures. It is not appropriate for temperature monitoring.
1 Port Persistence Fabric Watch Alarm Behavior Fabric Watch alarm behavior depends on the threshold states associated with the Above, Below and Changed thresholds. Threshold states can be INFORMATIVE, IN_RANGE, and OUT_OF_RANGE.
Notification Methods 1 Switch Event (Error) Log Entry The switch event (error) log holds up to 1024 entries. This error log stores event information but does not actively send alerts. Use the errShow command to view the log. Log entries can also trigger SNMP traps if the SNMP agent is configured. When the SNMP agent is configured to a specific error message level, then error messages at that level trigger SNMP traps.
1 Notification Methods E-mail Alert E-mail alert sends information about a switch event to a specified e-mail address. E-mail alert can send information about any error from any element, area, and class. The e-mail specifies the threshold and describes the event, much like an error message. Use the fwMailCfg command to configure e-mail alerts. Note To send e-mail alerts, the switch must be connected to a DNS server. Use the dnsConfig command to configure DNS settings.
Switch Policies 1 Switch Policies Switch policies are a series of rules that define specific states for the overall switch. Fabric OS interacts with Fabric Watch using these policies. Each rule defines the number of types of errors that transitions the overall switch state into a state that is not healthy. For example, you can specify a switch policy so that if a switch has two port failures, it is considered to be in a marginal state; if it has four failures, it is in a down state.
1 1-24 Interpreting Event Messages Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
Chapter Activating and Accessing Fabric Watch 2 This chapter contains the following sections: • • “Activating Fabric Watch,” next “Accessing Fabric Watch” on page 2-3 Activating Fabric Watch Fabric Watch must be activated on each switch individually before use.
2 Activating Fabric Watch Activating with Telnet To activate Fabric Watch using telnet commands: 1. Log in as admin. 2. Type licenseShow at the prompt to view a list of activated licenses. swd21:admin> licenseshow SedQyzdQbdTfeRzZ: Web license Zoning license bedR9dyyzzcfeSAW: Fabric license Scy9SbRQd9VdzATb: Fabric Watch license If the Fabric Watch license is not listed, continue to step 3; otherwise, you are ready to use Fabric Watch. 3.
Accessing Fabric Watch 2. 2 Click the Options button to expand the window, as displayed in Figure 2-1. Figure 2-1 Web Tools Log In Window 3. Type your user name and password. 4. Click the User Specified Domain radio button and type 255 in the text field. 5. Click OK. The Switch Explorer launches. 6. Click the Admin button on the switch panel. The Switch Admin view displays. 7. Click the License tab. 8. Click the Add button on the License tab. The Add License dialog displays. 9.
2 Accessing Fabric Watch Telnet Use a telnet session to: • • Observe the current monitors on a switch with the fwShow command. • • View and configure the FRU module with the fwFruCfg command. Query and modify threshold and alarm configurations (whether default or customized) with the fwConfigure command. View and configure the e-mail addresses to which event messages are sent with the fwMailCfg command.
Accessing Fabric Watch 2 SNMP-Based Enterprise Managers Use SNMP-based enterprise managers to: • • • • Query the MIB variable for individual fabric and switch elements. Query and modify threshold and alarm configurations. Receive alarm notification via SNMP traps. View and configure the mail database. Note The following instructions apply to the AdvantNet MIB browser. There may be some variation in the procedures when other MIB browsers are used.
2 Accessing Fabric Watch 5. Navigate down through the tree on the left until you find the Fabric Watch OID information:. Configuration File Use a configuration file to: • • Upload and download the configuration file and make changes in a text editor. Upload and download the configuration file through a telnet session or with Web Tools. Uploading and downloading a configuration file to multiple switches efficiently populates your SAN with consistent Fabric Watch settings.
Accessing Fabric Watch Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01 2 2-7
2 2-8 Accessing Fabric Watch Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
Chapter Configuring Fabric Watch 3 This chapter describes the procedures used to configure Fabric Watch and contains the following sections: • • • • • • “Configuring Fabric Watch Thresholds,” next “Configuring Notifications” on page 3-16 “Configuring Switch Status Policy” on page 3-20 “Configuring FRUs” on page 3-22 “Configuring Fabric Watch Using Web Tools” on page 3-24 “Configuring Fabric Watch Using SNMP” on page 3-24 This chapter does not explain Fabric Watch terminology and concepts; see Chapter
3 Configuring Fabric Watch Thresholds Step 1: Select the Class and Area to Configure During your planning activities, you should determine exactly what elements or monitors you want to configure, and in which class they reside. After you have made this decision, you need to identify the classes. To navigate to a specific class and area, use the fwConfigure command from a telnet prompt: 1. Log in to the switch as the administrator. 2. Type fwConfigure at the command prompt. 3.
Configuring Fabric Watch Thresholds 3 For each class that you select, Fabric Watch provides a list of the areas of the class available for configuration. The final item in the list, which is always the default, returns you to the previous selection screen. 5. Type the number corresponding to the area that you want to configure, such as 7 for RXPerformance. Fabric Watch displays a list of monitored elements in this area. Figure 3-3 shows the monitored elements in the RXPerformance area menu.
3 Configuring Fabric Watch Thresholds Step 2: Configure Thresholds After you have identified and selected the appropriate class and areas, you can configure thresholds for those classes and areas. If you want a basic configuration, accept the default configuration settings. Unless you want to accept the basic (default) configuration, or first disable, enable, or refresh all existing thresholds, proceed to option 4, advanced configuration. Note There are a variety of reasons.
Configuring Fabric Watch Thresholds 3 Fabric Watch redraws the element table with the selected element disabled. The second row of information about the selected element does not appear any more, and the status of the element is set to disabled (see Figure 3-4). Select threshold index => : (216..
3 Configuring Fabric Watch Thresholds 2. Type the index number of the element for which Fabric Watch should enable monitoring. Fabric Watch redraws the element table with the selected element enabled. A second row of information about the selected element appears, and the status of the element is set to enabled. Select threshold index => : (216..
Configuring Fabric Watch Thresholds 3 See Chapter 1, “Fabric Watch Concepts” for more details about threshold and buffer values. 1 : refresh 2 : disable a threshold 3 : enable a threshold 4 : advanced configuration 5 : return to previous page Select choice => : (1..
3 Configuring Fabric Watch Thresholds Table 3-6 describes the event behavior of each element in the Advanced Configuration menu.
Configuring Fabric Watch Thresholds 3 Figure 3-2 shows how to change the threshold boundary level to custom so that the new custom value of 80 is the new trigger point. Figure 3-3 shows how to apply the custom value; unless you apply the value, it does not take effect.
3 Configuring Fabric Watch Thresholds Table 3-8 describes the event behavior of each element in the Threshold Boundary menu.
Configuring Fabric Watch Thresholds 2. 3 Enter the total at the prompt. 1 : change behavior type 11 : 2 : change behavior interval 12 : 3 : change threshold boundary level 13 4 : change custom unit 14 : 5 : change custom timebase 15 : 6 : change custom low 16 : 7 : change custom high 17 : 8 : change custom buffer 18 : 9 : apply threshold boundary changes 10 : cancel threshold boundary changes Select choice => : (1..
3 Configuring Fabric Watch Thresholds Figure 3-4 shows how to select the custom settings for the threshold alarm level for the RXPerformance area. The options are either to accept the default settings or provide custom settings.
Configuring Fabric Watch Thresholds 3 Figure 3-5 shows how to apply the custom value for the threshold alarm changes; unless you apply the value, it does not take effect.
3 Configuring Fabric Watch Thresholds Table 3-10 3-14 Advanced Configuration Options (Continued) Option Effect Input Information change custom time base Changes the time base for the area, but only affects the custom column. The required time base change custom low Changes the low setting for the threshold, but only affects the custom column.
Configuring Fabric Watch Thresholds Table 3-10 3 Advanced Configuration Options (Continued) Option Effect Input Information change below alarm Changes the notification method for below event occurrences for this method, but only affects the custom column. The required notification methods change inBetween alarm Changes the notification method for inBetween event occurrences for this method, but only affects the custom column.
3 Configuring Notifications To enable all the thresholds for a port, at the command prompt enter: swd77:admin> fwconfigure --enable --port 9 Configuring Notifications You can be notified of an alarm condition through a notification.
Configuring Notifications 3 Configuring SNMP Notifications In environments in which you have a high number of messages (for example, hundreds per day) coming from a variety of switches, you might want to receive them in a single location and view them using a graphical user interface (GUI). In this type of scenario, SNMP notifications might be the most efficient notification method. You can avoid having to log on to each switch individually as you would have to do for error log notifications.
3 Configuring Notifications The following sections describe how to use the fwMailCfg menu options. Show Mail Configuration Information 1. Type 1 in the fwMailCfg menu (shown in Figure 3-11) to view the current e-mail configuration classes. The Config Show menu (shown in Figure 3-6) displays.
Configuring Notifications 3 Enable E-mail Alert 1. Type 3 in the fwMailCfg menu (shown in Figure 3-11) to enable e-mail alert for a specific class. The Config Show menu (shown in Figure 3-6) displays. 2. Select a class for which Fabric Watch should enable e-mail alerts.
3 Configuring Switch Status Policy The following prompt displays: Mail To: [NONE] Enter the e-mail address of the person responsible for the specific class of alerts. Fabric Watch uses the default value, located between the brackets in the prompt, as the current email address for the class. A value of NONE indicates that no e-mail address has been provided. Note E-mail addresses must not exceed 128 characters. The system displays a confirmation message and returns to the main fwMailCfg menu.
Configuring Switch Status Policy 3 See the Web Tools Administrator’s Guide for more details about configuring status events using Web Tools. Step 1: Plan and Define Your Switch Status Policy Before entering the switchStatusPolicySet command, plan your switch status policy. How many fans must fail before you consider a switch Marginal? Look at the needs of your system along with the factors that affect its monitors.
3 Configuring FRUs Step 2: Implement Your Switch Status Policy After planning and defining your switch status policy, enter the switchStatusPolicySet command to configure each policy. Each policy has two parameters that can be configured: Marginal and Down. Set the number of units Marginal or Down based on your system requirements for each policy/parameter. The following example shows a switch status policy for Temperature: Bad Temperatures contributing to DOWN status: (0..
Configuring FRUs 3 The fwFruCfg command displays your current FRU configuration, as shown in Figure 3-13. The types of FRUs are different for the various platforms. In the prompt that follows your current FRU configuration, you are asked to provide values for each FRU alarm state and alarm action. To accept the default value for each FRU (as shown in Figure 3-13), press Return. After you have configured a FRU alarm state and alarm action, the values apply to all FRUs of that type.
3 Configuring Fabric Watch Using Web Tools Configuring Fabric Watch Using Web Tools To configure Fabric Watch using Web Tools, see the Web Tools Administrator’s Guide. Configuring Fabric Watch Using SNMP Note The instructions given in this procedure apply to the AdventNet MIB browser. The procedure might vary if you use other MIB browsers. To configure Fabric Watch using SNMP: 1. Open a MIB browser. 2. Load the appropriate MIB files. First, load the Brocade common MIB file (BRCD_v5_0.
Configuring Fabric Watch Using SNMP 3. 3 Start a telnet session with the switch, and enter the snmpMibCapSet command at the prompt; this enables you to send Fabric Watch traps to an SNMP management station (see Figure 3-15). Then enter the agtCfgSet command to configure the SNMP management host IP address (see Figure 316).
3 Configuring Fabric Watch Using SNMP swd77:admin> agtcfgset Customizing MIB-II system variables ... At each prompt, do one of the following: o to accept current value, o enter the appropriate new value, o to skip the rest of configuration, or o to cancel any change. To correct any input mistake: erases the previous character, erases the whole line, sysDescr: [Fibre Channel Switch.] sysLocation: [End User Premise.] sysContact: [Field Support.
Configuring Fabric Watch Using SNMP 3 4. Enter the IP address for the switch in the Host field in the MIB browser. Enter the community string in the Community field. To perform set operations, enter the write community into the Write Community field. 5. Click View from the MIB browser menu, then select Trap Viewer. The Trap Viewer is launched. Click Start in the Trap Viewer to start listening for traps (see Figure 3-17).
3 Configuring Fabric Watch Using SNMP Any changes related to Fabric Watch, like changing the status of the Temperature sensor, (snapshot of whose details has been provided) traps, will generate traps. To view trap details, click Trap Details. Figure 3-18 displays the Trap Detail view.
Configuring Fabric Watch Using SNMP 6. 3 Expand the tree on the left to find the Fabric Watch OID information. To find the OID, use the following hierarchy: SW-MIB, bcsi, commDev, fibrechannel, fcSwitch, sw, swFwSystem. Fabric Watch displays a screen similar to the one shown in Figure 3-7. Figure 3-7 7. Example OID Tree Obtain the specific identifier for the element that will be modified.
3 Configuring Fabric Watch Using SNMP For detailed descriptions of the SNMP fields in both telnet and Web Tools, see the Fabric OS MIB Reference. Figure 3-8 Example swFwName Screen In this example, 83.1 is numeric identifier for the element referenced as resFlash000. 8. Traverse the fields beneath swFwClassAreaTable and swFwThresholdTable, appending the numeric identifier from the previous step to each field before performing a get or write operation.
Chapter Generating Fabric Watch Reports 4 This chapter describes the basic Fabric Watch reports that you can generate through a telnet connection or by using Advanced Web Tools. This chapter contains the following sections: • • “Types of Fabric Watch Reports,” next “Viewing Fabric Watch Reports” on page 4-8 Types of Fabric Watch Reports You can run reporting commands in Fabric Watch to get instant access to switch information.
4 Types of Fabric Watch Reports Example: SAM Report Total Total Down Total Up Time Down Time Occurrence Offline Time (Percent) (Percent) (Times) (Percent) ============================================================================= 1/0 U 0 0 0 100 1/1 U 0 0 0 100 1/2 U 0 0 0 100 1/3 U 0 0 0 100 1/4 U 0 0 0 100 1/5 U 0 0 0 100 1/6 U 0 0 0 100 1/7 U 0 0 0 100 1/8 U 0 0 0 100 1/9 U 0 0 0 100 1/10 U 0 0 0 100 1/11 U 0 0 0 100 1/12 EX 100 0 0 0 1/13 EX 100 0 0 0 1/14 EX 100 0 0 0 1/15 EX 100 0 0 0 2/0 U 0 0 0
Types of Fabric Watch Reports 4 Table 4-1 describes the fields in the SAM report. Table 4-1 SAM Report Information Heading Meaning Total Up Time (Percent) The percentage of time that the port is active Total Down Time (Percent) The percentage of time that the port experiences faults Down Occurrence (Count) The number of faults experienced on the port Total Offline Time (Percent) The percentage of time that the port is inactive for reasons other than a fault.
4 Types of Fabric Watch Reports Example: Switch Health Report cp0 login: admin Password: Sat 240 :admin> switchstatusshow Switch Health Report Switch Name: Sat 240 IP address: 10.32.177.
Types of Fabric Watch Reports 4 Switch Status Policy Report The switch status policy report lets you see the current policy parameters. Run the switchStatusPolicyShow command to generate a switch status policy report. The following example of the switchStatusPolicyShow command output is for modular switches such as the Brocade SilkWorm 24000. For modular switches, the switch status policy report also contains information on the WWN, Blade, and CP.
4 Types of Fabric Watch Reports Example: Port Detail Report Port Detail Report Report time: 10/24/2005 03:40:10 AM Switch Name:geo_hi IP address:10.32.97.
Types of Fabric Watch Reports 4 Table 4-2 lists and describes each item in the port detail report.
4 Viewing Fabric Watch Reports Viewing Fabric Watch Reports You can view Fabric Watch reports in the following ways: • • “Viewing Fabric Watch Reports Using Telnet,” next “Viewing Fabric Watch Reports Using Web Tools” on page 4-8 Viewing Fabric Watch Reports Using Telnet To view Fabric Watch reports using telnet, start a telnet session and enter the command (from Table 4-3) corresponding to the report you want to view.
Viewing Fabric Watch Reports 4 A report view window (shown in Figure 4-2) displays. Figure 4-2 Report View Window The Web Tools report view window contains choices to view the switch health, port detail, or SAM report. Note The switch status policy report is not available through Web Tools. Viewing Reports To view a report, click its name on the left of the report view window. You can use this interface to filter the port detail report based on the current state of the port.
4 Viewing Fabric Watch Reports Customizing Reports To customize reports, click the Action button above the report tree in the window. The menu, shown in Figure 4-3, displays. Figure 4-3 Action Menu The following section explains the options in the Action menu. Refresh Report Use this option to update the current report with the new data. Customize Report Use this option to modify the report design.
Viewing Fabric Watch Reports 4 The report customization window contains the following: • • Name—Enter the report name in this field. The name you enter appears at the top of the report. Options—Select the type of report to generate by clicking one of the following options: - Switch Health SAM Port Detail If you select the Port Detail option, you can filter the ports for which the report is generated based on port number or port state.
4 4-12 Viewing Fabric Watch Reports Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
Appendix Default Threshold Values A This appendix lists Fabric Watch default threshold values for all classes except the FRU class, which has none. The following tables list all of the default values used for the default Fabric Watch configuration settings when running Fabric OS v5.2.
A Default Threshold Values Environment Class Table A-1 provides default settings for areas in the Environment class. These defaults are hardwaredependent. Check the appropriate hardware reference manual for differences in environmental requirements. Note For the SilkWorm 200E, there is no fan default threshold because the fans are not monitored by Fabric Watch. You can use the fanShow command to view the SilkWorm 200E fan status (OK or NOT OK).
Default Threshold Values Table A-1 A Environment Class Threshold Defaults (Continued) Area Description Default Threshold Settings Default Alarm Settings Threshold State Power Supply Monitors power supply condition Unit: 1/0 (OK/ FAULTY) Time Base: none Changed: 0 Below: 3 Above: 3 In-Between: 0 Informative Out_of_range In_range Informative The default threshold settings for all platforms are: Low: 1 High: 0 Buffer:0 Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01 A-3
A Default Threshold Values Table A-1 Environment Class Threshold Defaults (Continued) Area Description Default Threshold Settings Temperature Monitors switch Unit: degrees C temperature in Celsius Time Base: none SilkWorm 200E Low: 0 High: 60 Buffer: 10 Default Alarm Settings Threshold State Changed: 0 Below: 3 Above: 3 In-Between: 3 Informative Out_of_range Out_of_range In_range SilkWorm 3850 and 3250 Low: 0 High: 64 Buffer: 10 SilkWorm 3900 Low: 0 High: 67 Buffer: 10 SilkWorm 4100 Low:0 High:
Default Threshold Values A Fabric Class Table A-2 provides default settings for areas in the Fabric class. These defaults are hardware-dependent. Check the appropriate Hardware Reference Manual for differences in environmental requirements.
A Default Threshold Values Table A-2 Fabric Class Threshold Defaults (Continued) Area Description Default Threshold Settings Default Alarm Settings Threshold State Fabric Reconfiguration Monitors configuration changes Unit: Reconfig(s) Time Base: none Low: 0 High: 0 Buffer: 0 Changed: 0 Below: 0 Above: 0 In-Between: 0 Informative Informative Informative Informative Segmentation Changes Monitors segmentation changes Unit: Segmentation(s) Time Base: none Low: 0 High: 0 Buffer: 0 Changed: 0 Be
Default Threshold Values A Table A-4 provides default settings for areas in the Customer-Defined Performance Monitor class.
A Default Threshold Values Port Class Table A-6 provides default settings for areas in the Port class.
Default Threshold Values Table A-6 Area A Port Class Threshold Defaults (Continued) Default Threshold Settings Default Alarm Settings Threshold State Primitive Sequence Monitors the Protocol Error number of primitive sequence errors Unit: Error(s) Time Base: minute Low: 0 High: 5 Buffer: 0 Changed: 0 Below: 0 Above: 0 In-Between: 0 Informative Informative Out_of_range In_range Receive Performance Monitors receive rate, by percentage Unit: Percentage(%) Time Base: minute Low: 0 High: 100 Buffer:
A Default Threshold Values Table A-7 provides default settings for areas in the E-Port class.
Default Threshold Values Table A-7 A E-Port Class Threshold Defaults (Continued) Area Description Default Threshold Settings Default Alarm Settings Threshold State Primitive Sequence Protocol Error Monitors the number of primitive sequence errors Unit: Error(s) Time Base: minute Low: 0 High: 5 Buffer: 0 Changed: 0 Below: 0 Above: 0 In-Between: 0 Informative Informative Out_of_range In_range Receive Performance Monitors the receive rate, by percentage Unit: Percentage(%) Time Base: minute Low
A Default Threshold Values Table A-8 provides default settings for areas in the F/FL_Port class.
Default Threshold Values Table A-8 A F/FL_Port Class Threshold Defaults (Continued) Area Default Alarm Settings Threshold State Invalid Monitors the Unit: Error(s) Transmission Word number of invalid Time Base: minute words transmitted Low: 0 High: 5 Buffer: 0 Changed: 0 Below: 0 Above: 0 In-Between: 0 Informative Informative Out_of_range In_range Link Failure Count Monitors the number of link failures Unit: Error(s) Time Base: minute Low: 0 High: 5 Buffer: 0 Changed: 0 Below: 0 Above: 0 In-Betw
A Default Threshold Values Security Class Table A-10 provides default settings for areas in the Security class.
Default Threshold Values Table A-10 A Security Class Threshold Defaults (Continued) Area Description Default Threshold Settings Default Alarm Threshold Settings State Invalid Signatures Monitors invalid signatures Unit: Violation(s) Time Base: minute Low: 1 High: 2 Buffer: 0 Changed: 0 Below: 0 Above: 3 In-Between: 0 Informative Informative Out_of_range In_range Invalid Timestamp Monitors invalid timestamps Unit: Violation(s) Time Base: minute Low: 1 High: 2 Buffer: 0 Changed: 0 Below: 0 Abo
A Default Threshold Values Table A-10 A-16 Security Class Threshold Defaults (Continued) Area Description Default Threshold Settings Default Alarm Threshold Settings State SES Violations Monitors SES violations Unit: Violation(s) Time Base: minute Low: 1 High: 2 Buffer: 0 Changed: 0 Below: 0 Above: 3 In-Between: 0 Informative Informative Out_of_range In_range SLAP Bad Packets Monitors SLAP bad packets Unit: Violation(s) Time Base: minute Low: 1 High: 2 Buffer: 0 Changed: 0 Below: 0 Above: 3
Default Threshold Values A SFP Class Table A-11 provides default settings for areas in the SFP class. Note SFPs connected to GbE ports are not monitored.
A A-18 Default Threshold Values Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
Appendix Basic Fabric Watch Configuration Guidelines B A default Fabric Watch configuration is available for the purpose of saving setup time. As you gain familiarity with Advanced Fabric Watch features, they can be tailored to suit the fabric environment. The custom settings available in Fabric Watch provide an advanced user much needed flexibility of redefining boundary thresholds and alarm notification methods.
B B-2 Basic Fabric Watch Configuration Guidelines Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
Appendix Using Fabric Watch with Configuration Files C When you activate Fabric Watch, the software starts using the default settings described in Appendix B, “Basic Fabric Watch Configuration Guidelines”. You cannot alter these default settings; if the default values do not suit your specific needs, configure Fabric Watch to use more appropriate settings. When you configure the new settings for Fabric Watch, your switch stores the settings in the configuration file.
C Profiles Profiles Brocade provides partial configuration files, or profiles, that help you configure Fabric Watch in a way that is most appropriate to your particular SAN needs. To configure Fabric Watch with a profile: 1. Upload the configuration file to the host by typing configUpload. 2. Open one of the profiles that appears on the Brocade Web site at http://www.brocade.com/support/mibs_rsh/index.jsp 3. Open your configuration file in a text editor. 4.
Index A above event triggers 1-18 activating with advanced web tool 2-2 with telnet 2-2 activating Fabric Watch 2-1 to 2-3 Admin View 2-2 advanced configuration options 3-13 alarms configuring 3-10 continuous 1-2, 1-12, 3-10 notifications 3-16 triggered 1-2, 1-12, 3-10 areas 1-5 assigning notification methods commands configdownload C-1 configupload C-1 fwclassinit 2-2 fwconfigreload C-1 fwconfigure 2-4 fwfrucfg 2-4 fwmailcfg 2-4 configdownload C-1 configupload C-1 configuration advanced 3-7 configu
2-4 fwclassinit 2-2 fwconfigreload C-1 fwfrusfg 2-4 fwmailcfg 2-4 port log lock 1-21, 3-17 port persistence 1-20 prerequisites 2-1 H RapiTrap fsconfigure R 1-21 resource class area 1-9 high and low thresholds 1-13 S I security class areas 1-9 in-between triggers 1-19 installing Fabric Watch interface types setting time base to none 1-15 1-1 SFP class areas 2-3 interpreting event messages 1-23 1-10 SNMP 1-2 capabilities 2-5 SNMP trap 1-21 specifying a time base L switch event (error) lo
U V user interfaces 2-3 values, default using Fabric Watch configuration file C-1 A-1 W Web Tools capabilities 2-4 Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01 Index-3
Index-4 Fabric Watch Administrator’s Guide Publication Number: 53-1000243-01
