Brocade Communications Systems 804 debug

Brocade Adapters Administrator’s Guide 135

53-1001583-01

debug B

debug

The debug commands gather support information on Fibre Channel components.

Synopsis bcu debug --portlog <port_id>

bcu debug --portlogclear <port_id>

bcu debug --portlogctl <port_id> <enable | disable>

Description Captures all the support information needed to diagnose suspected system issues.

Operands --portlog Displays the log of FC frames and other main control messages that were

sent out and received.

If the port log is disabled, the following message displays as the first line:

Refer to the portlogctl comma nd for more in formation: WARNING: port log is

disabled.

port_id Specifies the ID of the port for which you want to display the FC frame logs

and other control messages.

--portlogclear Clears the port’s frame log.

port_id Specifies the ID of the port for which you want to clear the port’s frame log.

--portlogctl Enables or disables the portlog.

port_id Specifies the ID of the port for which you want to enable or disable the

portlog.

enable Enables the portlogclear command.

disable Disables the portlogclear command.

Example

bcu debug --portlog 10/0

Total records present = 14

---------------------------------------------------------------------------

time event port code args

---------------------------------------------------------------------------

08:35:28.430 fwm 10/0 00 00001234, 00050001

08:35:28.431 mbox 10/0 01 00001234, 00050001

08:35:28.433 ioctl 10/0 90 101d9910,0

08:35:28.433 Tx 10/0 164 02fffffd, 00fffffd, 0005ffff, 10000000

08:35:28.433 Rx 10/0 0 c0fffffd, 00fffffd, 00050006

08:35:28.433 Rx 10/0 164 03fffffd, 00fffffd, 00050006, 02000000

08:35:28.433 Tx 10/0 0 c0fffffd, 00ffffd, 00050006

08:35:28.433 ioctl 10/0 91 103646d8, 0

08:35:28.466 ioctl 10/0 a7 3c, 1

08:35:28.483 Tx 10/0 96 02fffffd, 00fffffd, 0006ffff, 11100060

08:35:28.483 Rx 10/0 0 c0fffffd, 00fffffd, 00060007

08:35:28.483 Rx 10/0 96 03fffffd, 00fffffd, 00060007, 02100060

08:35:28.483 Tx 10/0 0 c0fffffd, 00fffffd, 00060007

08:35:28.483 ioctl 10/0 a1 0,0

---------------------------------------------------------------------------

# bcu debug --portlog 1/1

Total records present = 26

---------------------------------------------------------------------------

Contents

Main Brocade Communications Systems, Incorporated Document History June 2010 Title Publication number Summary of changes Date Brocade Adapters Administrators Guide Supporting HBA models 415, 425, 815, 825 Contents About This Document Chapter 1 Host Management Overview Chapter 2 Getting Started with HCM Software Chapter 3 Host Configuration Chapter 4 Monitoring Chapter 5 Diagnostics Appendix A HCM Dialog Boxes Appendix B Brocade Command Utility Page Page About This Document In this section How this document is organized Document conventions Text formatting ATTENTION Notes, cautions, and warnings Key terms Notice to the reader Additional information Brocade resources Other industry resources Getting technical help Related documentation Page Page Host Management Overview Host bus adapters TABLE 1 HCM software HCM features Tree node pop-up menus 1 Tree node pop-up menus TABLE 2 SAN component Pop-up menu feature Adapter support TABLE 3 Getting Started with HCM Software HCM software launch Launching the application on Windows platforms Launching the application on Linux platforms Remember password Skip login Changing an HCM application password Changing an HCM agent password FIGURE 3 Software downgrade using Adapter Software Installer Downgrading HCM and driver or HCM only Downgrading driver only HCM configuration data Backing up data after an uninstall Data restoration Restoring backed up data FIGURE 4 HCM main window FIGURE 5 Legend Help menu HCM product icons TABLE 4 Event severity icons Discovery TABLE 5 Setting up out-of-band discovery for an adapter FIGURE 6 Logging off HCM Host Configuration Host security authentication Configuring security authentication using HCM (Host and HBA) FIGURE 7 Configuring security authentication using the BCU Buffer credits Basic port configuration TABLE 6 Opening the Basic Port Configuration dialog box FIGURE 8 Port logging level Configuring the port logging level using HCM Configuring the port logging level using the BCU Port speed Configuring the port speed using HCM Configuring the port speed using the BCU Frame data field size Specifying the maximum frame size using HCM Configuring the frame data field size using the BCU Persistent binding Enabling and disabling persistent binding using HCM Enabling and disabling persistent binding using the BCU QoS Configuring QoS on the switch side using the BCU Configuring QoS on the HBA side using the BCU Path time out Specifying path time out using HCM Specifying path time out using the BCU Target rate limiting Enabling and disabling rate limiting on the adapter side using HCM Enabling and disabling rate limiting on the adapter side using the BCU Boot over SAN Configuring Boot over SAN Page Pre-boot configuration Configuring fabric-based boot LUN discovery Boot image update Uploading the boot image using HCM Updating the boot image using the BCU Virtual port configuration Virtual port restrictions Creating a virtual port FIGURE 10 Deleting a virtual port HCM logging levels Configuring the HCM logging level using HCM Advanced port configuration Opening the Advanced Port Configuration dialog box FIGURE 13 TABLE 7 Interrupt Control Coalesce Configuring the Interrupt Control Coalesce using HCM Name configuration Dual role changes Name validation Defining a name FIGURE 14 Editing the name fields FIGURE 15 Adding name entries Removing a name entry Exporting the properties for a WWN Importing the properties for a WWN Importing properties in EFCM format Importing properties in DCFM or FM format Importing duplicated names FIGURE 16 NPIV Monitoring Performance monitoring Polling frequency rate Controlling the polling frequency rate Resetting statistics FIGURE 17 Master log Page Filtering event log entries FIGURE 18 Application log Syslog support Opening the Syslog Server Configuration dialog box FIGURE 20 Registering a host server Removing a host server Syslog host configuration using VMware Diagnostics Diagnostics using the BCU diag commands fcdiag commands TABLE 10 TABLE 11 Diagnostics using HCM Running a hardware-level test using HCM FIGURE 21 Diagnostics using HCM Hardware-level test parameters TABLE 12 Hardware-level test Parameter Test Options NOTE: During the test, IOC will be disabled. NOTE: For an External Loopback test, you must plug in the loopback connector. Running a Fibre Channel protocol-level test using HCM FIGURE 22 Displaying test log details FIGURE 23 Beaconing Configuring beaconing using HCM Configuring beaconing using the BCU SFP management Displaying SFP information using the BCU Displaying SFP information using HCM FIGURE 24 Debugging supportSave TABLE 13 supportSave collection sources Automatic statistics collection TABLE 14 supportSave collection using HCM supportSave collection on a port crash event supportSave collection using a command prompt supportSave collection using a browser A HCM Dialog Boxes Page Authentication Statistics dialog box A Authentication Statistics dialog box Page Backup dialog box Base Port Properties panel Change HCM Password dialog box Change HCM Agent Password dialog box Configure Names dialog box A Configure Names dialog box NOTE: You can also search for a name by typing the name into the text box and clicking OK. Page Define Name dialog box Duplicated Names dialog box Event Properties dialog box Fabric Statistics dialog box FCP IM Statistics dialog box Page FCP IM Module Statistics dialog box A FCP IM Module Statistics dialog box Select Monitor > Statistics > FCP IM Module Statistics from the Host Connectivity Manager. Right-click a port from the device tree and select Statistics > FCP IM Module Statistics. Page Fibre Channel Security Protocol Configuration dialog box Page Hardware Tests Diagnostics dialog box HBA Properties panel HBA Properties panel 1. Select an HBA in the device tree. 2. Click the Properties tab in the right pane. HBA Properties panel A IOC Statistics dialog box IOC Statistics dialog box IOC Statistics dialog box A IOC Statistics dialog box IOC Statistics dialog box A Page Logical Port Statistics dialog box A Logical Port Statistics dialog box Select Monitor > Statistics > Logical Port Statistics from the Host Connectivity Manager Right-click a logical port (LPORT) from the device tree and select Logical Port Statistics. Logical Port Statistics dialog box Refer to the following topics for specific procedures using this dialog box: LPORT Properties panel Master Log tab Opening the Master Log Using the Master Log Master Log Filter dialog box Persistent Binding dialog box Port Properties panel A Port Properties panel 1. Select a port in the device tree. 2. Click the Properties tab in the right pane. Using the property panel Port Statistics dialog box A Port Statistics dialog box Select Monitor > Statistics > Port Statistics from the Host Connectivity Manager. Page Protocol Tests dialog box QoS Statistics dialog box Remote Port Properties panel Restore dialog box SFP Properties panel SFP Properties panel Syslog Server Configuration dialog box Target Statistics dialog box Target Statistics dialog box Right-click a remote port and select Target Sta tist ics. Target Statistics dialog box A Target Statistics dialog box Page Test Log Details dialog box Virtual Port Creation dialog box Virtual Port Deletion dialog box Virtual Port Properties panel Virtual Port Statistics dialog box Virtual Port Statistics dialog box Page Page B Brocade Command Utility About the BCU - - BCU commands BCU commands B BCU commands BCU commands B adapter adapter B Example bcu adapter --list See Also ioc, port auth Page Page bios Page boot Page debug debug diag drvconf fabric fcdiag Page fcpim fcpim See Also ioc vport ioc Page log lport lport B The following are examples of a Brocade 1020 expansion card versus a Brocade 825 adapter: pbind port port B Example # bcu port --list port See Also adapter ioc qos ratelim rport rport Example bcu rport --list 2/0 rport B vport Page Page C HCM Troubleshooting HCM tab navigation C HCM does not restrict duplicate WWNs if BCU is used to create V_Ports RHEL4 U7 x86/x64 OS crashes after invalid operand from hcmagent D Glossary and Acronyms Page Page Index C E F H I L M Q R S T V