Sun Microsystems, Inc.  Oracle System Handbook - ISO 7.0 May 2018 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1583187.1
Update Date:2017-10-11
Keywords:

Solution Type  Technical Instruction Sure

Solution  1583187.1 :   How to enable QLC link down error, extended logging  


Related Items
  • Sun SPARC Enterprise M4000 Server
  •  
  • Sun SPARC Enterprise M9000-32 Server
  •  
  • Sun SPARC Enterprise M9000-64 Server
  •  
  • Sun SPARC Enterprise M5000 Server
  •  
  • Sun SPARC Enterprise M8000 Server
  •  
  • Qlogic FC HBA
  •  
Related Categories
  • PLA-Support>Sun Systems>SPARC>Enterprise>SN-SPARC: Mx000
  •  




In this Document
Goal
Solution
References


Created from <SR 3-7783476811>

Applies to:

Sun SPARC Enterprise M9000-64 Server - Version All Versions to All Versions [Release All Releases]
Sun SPARC Enterprise M4000 Server - Version All Versions to All Versions [Release All Releases]
Sun SPARC Enterprise M5000 Server - Version All Versions to All Versions [Release All Releases]
Sun SPARC Enterprise M8000 Server - Version All Versions to All Versions [Release All Releases]
Sun SPARC Enterprise M9000-32 Server - Version All Versions to All Versions [Release All Releases]
Information in this document applies to any platform.

Goal

How to Enable Oracle Qlogic Fibre Channel (FC) HBA "qlc" Driver to Collect a Dump when a "MAILBOX TIMEOUT" Occurs
 

Solution


Enable extended logging and firmware dump:

in /kernel/drv/qlc.conf:

#Name: Link down error
#Type: Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
#Usage: This field disables the driver error reporting during link down
# conditions.
enable-link-down-error=1;

#Name: Enable extended logging
#Type: Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
#Usage: This field enables logging of driver detected events occurring
# either in the driver or fibre channel bus. Events are logged
# in Solaris /var/adm/messages file.
extended-logging=1;

#Name: Firmware Dump Flags
#Type: Integer, flag bits; Range: 0 (disable), 1 (enable); Default: 0
#Usage: These flags are used to force a firmware dump when the flag
# condition occurs. More than one flag bit can be combined to
# obtain the desired result.
# TAKE_FW_DUMP_ON_MAILBOX_TIMEOUT 1
# TAKE_FW_DUMP_ON_ISP_SYSTEM_ERROR 2
# TAKE_FW_DUMP_ON_DRIVER_COMMAND_TIMEOUT 4
# TAKE_FW_DUMP_ON_LOOP_OFFLINE_TIMEOUT 8
firmware-dump-flags=1;

This will also cause a dump to be created when a Mailbox error occurs.

An OS reboot is required for the above logging to take effect.

 

 

 

ParametersRecommended settings
adapter-hard-loop-ID This parameter is valid only when adapter hard loop ID is enabled (enable-adapter-hard-loop-ID=0;). You can specify a value of 0 - 125.
connection-options When you are connecting the HBA to a switch port with auto-mode sensing capability (a G port), it is recommended that this parameter be set to either 0 or 1. Setting this parameter to 2 when connected to a G port on a switch, can result in device-lost or system-hang conditions. For other configurations, the default value is recommended.
Specifies the connection mode that the driver firmware uses:
  • 0: Loop only
  • 1: Point-to-point only
  • 2: Loop preferred, otherwise point-to-point (default)
enable-adapter-hard-loop-ID 0(Default)
Enables or disables the setting of the hard loop ID for adapters on the Fibre Channel bus:
  • 0: Enabled
  • 1: Disabled
The default value is recommended and might be necessary on some bus configurations where devices fail to appear.
enable-FCP-2-error-recovery 1(Default)
Enables or disables the Fibre Channel FCP 2 error recovery support:
  • 0: Disabled
  • 1: Enabled
enable-link-down-error 1(Default)
Enables or disables driver error reporting during a link-down condition:
  • 0: Disabled
  • 1: Enabled
enable-LIP-full-login-on-bus-reset 1(Default)
Enables or disables the adapter to issue a LIP full login reset during Fibre Channel reset:
  • 0: Disabled
  • 1: Enabled
enable-LIP-reset-on-bus-reset 0(Default)
Enables or disables the adapter to issue a LIP reset during Fibre Channel reset:
  • 0: Disabled
  • 1: Enabled
enable-target-reset-on-bus-reset 0(Default)
Enables or disables the adapter to issue a target reset during Fibre Channel reset:
  • 0: Disabled
  • 1: Enabled
The default value is recommended.
execution-throttle 32(Default)
Specifies the maximum number of commands sent per LUN by the ISP2xxxfirmware. You can specify a value of 1 - 65535.
Note: Exceeding device capabilities causes unnecessary command retries that impact performance.
extended-logging 0(Default)
Enables or disables the logging of driver-detected events that occur in the driver or Fibre Channel bus:
  • 0: Disabled
  • 1: Enabled
Events are usually logged in the/var/adm/messagesfile.
fc-data-rate 2(Default)
Specifies the Fibre Channel data rate which the driver uses:
  • 0: 1 gigabit/second
  • 1: 2 gigabits/second
  • 2: Automatically negotiate
  • 3: 4 gigabits/second
firmware-dump-flags 0(Default)
Specifies whether to force a firmware dump when one or more flag conditions occur:
  • 0: Disabled
  • 1: Enabled
Flag conditions:
1: TAKE_FW_DUMP_ON_MAILBOX_TIMEOUT
2: TAKE_FW_DUMP_ON_ISP_SYSTEM_ERROR
4: TAKE_FW_DUMP_ON_DRIVER_COMMAND_TIMEOUT
8: TAKE_FW_DUMP_ON_LOOP_OFFLINE_TIMEOUT
link-down-timeout 0(Default)

Specifies the number of seconds that the driver waits for a Fibre Channel loop to come up before reporting the failure. You can specify a value of 0 - 240.

login-retry 4(Default)

Specifies the maximum number of retry attempts for the firmware when the login into a device fails. You can specify a value of 0 - 255.

login-timeout 3(Default)
Specifies the maximum number of seconds that the driver waits for the login of a device to complete. You can specify a value of 0 - 255.
Note: Large values can cause long delays during initialization and device reconfiguration.
max-frame-length 2048(Default)

Specifies the frame payload length, in bytes, that is used by the ISP2xxx firmware. Other possible values are 1024 and 2048.

pci-max-read-request 2048(Default)
Specifies the number of bytes to be used for the PCI maximum read request, and overrides the value programmed by the system. Other possible values are 128, 256, 512, 1024, and 4096.
Note: If this value is not specified or is not equal to 128, 256, 512, 1024, 2048 or 4096, the ISP2xxx defaults to the value specified by the system.
port-down-retry-count 8(Default)
Specifies the number of command retries when devices are not responding on the Fibre Channel bus. You can specify a value of 0 - 255.
Note: Large values can cause long delays for failover software to detect a failing device.
port-down-retry-delay 2(Default)
Specifies the number of seconds to delay between port-down retries. You can specify a value of 0 - 255.
Note: Large values can cause long delays for failover software to detect a failing device, and can also cause upper layer drivers or applications to time out IO operations.
queue-full-retry-count 16(Default)

Specifies the number of times to retry an SCSI queue-full error. You can specify a value of 0 - 255.

queue-full-retry-delay 2(Default)

Specifies the number of seconds to delay, after an SCSI queue-full error, before starting any new I/O commands. You can specify a value of 0 - 255.

reset-delay 5(Default)

Specifies the number of seconds to delay after a reset before sending commands to the devices on the Fibre Channel bus. You can specify a value of 1 - 255.

 

 

References

<NOTE:1282491.1> - How to Identify Oracle[TM] Branded Fibre Channel (FC) HBA and CNA Cards and Their Slot Locations
<NOTE:1671480.1> - How to Enable the Logging of Extended (debug) Troubleshooting Messages for Oracle Emulex Fibre Channel (FC) HBA card(s) on a Solaris Server

Attachments
This solution has no attachment
  Copyright © 2018 Oracle, Inc.  All rights reserved.
 Feedback