## ## AMCC jnic146x driver (Solaris SCSI) configuration file. ## ## jnic146x.conf ## ## For driver version: JNIC v5.3.1 ## ## Date last modified: 3/29/2004 ## ## For additional information, refer to the "readme.txt" file provided with ## the jnic146x driver installation package. ########################################################################### ## NOTE: When you change any of the parameter values, the changes must be ## activated or the system must be rebooted in order for the new settings ## to take effect. ## ## Changes can be made active without a system reboot by using the EZ ## Fibre configuration utility. ## ## Changes can also be made active by manually unloading the jnic146x ## driver using the jnic146x_busy and jnic146x_unload commands located in ## the /opt/JNIC146x directory. ## ########################################################################### ########################################################################### ## Per-Instance HBA Parameter Settings ## All configuration parameters can be done on a per-instance basis. To do ## this, add the interface name (jnic146x), driver instance (e.g., 0, 1, 2, ## 3, etc), and a hyphen ('-') before the configuration parameter. ## For example: ## To configure jnic146x0 instance to operate in Arbitrated Loop topology ## and jnic146x1 instance to operate in Fabric topology, type in: ## ## jnic146x0-FcLoopEnabled = 1; ## jnic146x0-FcFabricEnabled = 0; ## jnic146x1-FcLoopEnabled = 0; ## jnic146x1-FcFabricEnabled = 1; ## ## NOTE: EZ Fibre performs parameter configuration on a per-instance basis. ## NOTE: Per-instance configuration parameter settings override a global ## parameter setting for the instance specified. ## NOTE: When the same parameter is set multiple times in the configuration ## file, the system uses the first value specified in the file. ########################################################################### # # Configuration parameters: FcLoopEnabled, FcFabricEnabled # Type: boolean # Default: FcLoopEnabled = 0 # FcFabricEnabled = 0 # # These parameters are used to configure the HBA port topology. The HBA port # will be set up as specified in the following table: # # FcLoopEnabled FcFabricEnabled Topology # ------------- ---------------- -------------------------- # 0 0 Auto-topology detect # 0 1 N_Port mode (fabric) # 1 0 L_Port mode (private loop) # 1 1 NL_Port Mode (public loop) # #FcLoopEnabled = 0; #FcFabricEnabled = 0; #jnic146x0-FcLoopEnabled = 0; #jnic146x0-FcFabricEnabled = 0; # # Configuration parameter: FcEngHeartbeatInterval # Type: integer # Default: 5 (sec) # # When the AMCC adapter/driver detects that the Fibre Channel link is up (and # there is no I/O activity), it will send a "test frame" (or heartbeat) to # itself to verify link integrity. The test frame is sent at the interval # specified by this parameter. If the test frame does not complete, it is # assumed that there is a link problem. In this situation, the driver # initiates error recovery to re-establish a good link. # A value of "0" disables the heartbeat. # #FcEngHeartbeatInterval = 5; #jnic146x0-FcEngHeartbeatInterval = 5; # # Configuration parameter: FcLinkUpRecoveryTime # Type: integer # Default: 1000 (msec) # # Delay (msec) after the link is up before port discovery begins, allowing # the link to stabilize and protecting against a possible I/O surge. This timer # is reset every time the link comes up. The default value is adequate for most # configurations. # #FcLinkUpRecoveryTime = 1000; #jnic146x0-FcLinkUpRecoveryTime = 1000; # # Configuration parameter: BusyRetryDelay # Type: integer # Default: 5000 (msec) # # Delay (msec) before retrying after receipt of an I/O with a "SCSI Busy" # status from a target. The number of retries is based on the Solaris retry # count associated with the I/O. # #BusyRetryDelay = 5000; #jnic146x0-BusyRetryDelay = 5000; # # Configuration parameter: TargetOfflineEnable # Type: integer # Default: 1 (Enable) # # Flag for enabling target offline when target port fails # #jnic146x0-TargetOfflineEnable = 1; #TargetOfflineEnable= 1; #TargetOfflineEnable= 0; # # Configuration parameter: FailoverDelay # Type: integer # Default: 30 (sec) # # Delay (seconds) before failing all I/O for an offline target. If the delay # timer expires, all I/O for the failed target is returned to the application. # This parameter applies to non-FC-Tape targets; see also 'FailoverDelayFcTape'. # A value of zero disables failover. # #FailoverDelay = 30; #jnic146x0-FailoverDelay = 30; # # Configuration parameter: FailoverDelayFcTape # Type: integer # Default: 300 (sec) # # Delay (in seconds) before failing all I/O for an offline FC-Tape target. # If the delay timer expires, all I/O for the failed target is returned # to the application. This parameter affects only targets that support # the FCP-2 Error Recovery protocols; generally tape drives; see also # 'FailoverDelay'. # A value of zero disables failover. # #FailoverDelayFcTape = 300; #jnic146x0-FailoverDelayFcTape = 300; # # Configuration parameter: TimeoutResetEnable # Type: boolean # Default: 0 (false) # # Boolean parameter for enabling SCSI target resets for timed out I/O. When # the timer expires (usually 60 seconds, as specified by the upper layers), # the driver issues a target reset to attempt to clear the device (which might # be either too busy to respond or stuck). # #TimeoutResetEnable = 0; #jnic146x0-TimeoutResetEnable = 0; # # Configuration parameter: QfullRetryCount # Type: integer # Default: 5 # # Number of times an I/O is retried due to receipt of a "SCSI Queue Full" status # from a target. The delay between retries is based on the QfullRetryDelay # parameter. # #QfullRetryCount = 5; #jnic146x0-QfullRetryCount = 5; # # Configuration parameter: QfullRetryDelay # Type: integer # Default: 5000 (msec) # # Delay (msec) before retrying after receipt of an I/O with a "SCSI Queue Full" # status from a target. The number of retries is based on the QfullRetryCount # parameter. # #QfullRetryDelay = 5000; #jnic146x0-QfullRetryDelay = 5000; # # Configuration parameter: LunRecoveryInterval # Type: integer # Default: 50 (msec) # # Sets the LUN I/O recovery interval (in msec) after the driver reconnects to # a disk. It is a global parameter affecting all targets, and determines how # long the driver waits after a port is discovered until sending I/O to that # port. Some devices might require more time to flush I/O that was in progress # prior to a link going down; if this is the case, increase the value of this # parameter. # #LunRecoveryInterval = 50; #jnic146x0-LunRecoveryInterval = 50; # # Configuration parameter: FcLinkSpeed # Type: integer # Default: 3 (auto negotiate link speed) # # Specifies the desired Fibre Channel link speed as follows: # 0 - default to SEEPROM setting # 1 - force 1 Gbit/sec # 2 - force 2 Gbit/sec # 3 - auto negotiate link speed # #FcLinkSpeed = 3; #jnic146x0-FcLinkSpeed = 3; # # Configuration parameter: JniCreationDelay # Type: integer # Default: 1 (sec) # # Delay (seconds) after driver creation to allow the network to stabilize, # discover ports, and build the driver's database. Increase this value # if targets are being discovered too late in the boot process. # #JniCreationDelay = 1; #jnic146x0-JniCreationDelay = 1; # # Configuration parameter: FlogiRetryCount # Type: integer # Default: 3 # # Total number of Fabric Login (FLOGI) attempts before giving up logging in to # a switch. Failure prevents participation on a Fabric topology. # #FlogiRetryCount = 3; #jnic146x0-FlogiRetryCount = 3; # # Configuration parameter: FcFlogiTimeout # Type: integer # Default: 10 # # Specifies the amount of time (in seconds) that the driver waits for a Fabric # Login (FLOGI) accept. The value should be increased only if the switch to # which the HBA is connected requires more time to respond to a FLOGI. The # number of retries is configured with the FlogiRetryCount parameter. # #FcFlogiTimeout = 10; #jnic146x0-FcFlogiTimeout = 10; # # Configuration parameter: PlogiRetryCount # Type: integer # Default: 5 # # Total number of Port Login (PLOGI) attempts before giving up logging in to # a SCSI target. # #PlogiRetryCount = 5; #jnic146x0-PlogiRetryCount = 5; # # Configuration parameter: PlogiControlSeconds # Type: integer # Default: 30 # # Defines the number of seconds that the driver waits for a successful # port login (PLOGI) attempt. The maximum number of attempts is defined by # the PlogiRetryCount parameter. Some devices might take longer to respond # to PLOGIs; if this is the case, increase the value of this parameter. # #PlogiControlSeconds = 30; #jnic146x0-PlogiControlSeconds = 30; # # Configuration parameter: LunDiscoveryMethod # Type: integer # Default: 1 (Report LUN) # # Sets the LUN discovery method. A value of zero selects the SCSI Inquiry # method. A value of 1 (the default) enables LUN reporting. The SCSI Report # LUNs and Inquiry commands are employed by the driver to discover logical # units (LUNs). If the expected LUNs do not appear for the selected host bus # adapter, then the user can set the parameter to use the alternative method. # The change affects all targets connected to the selected host bus adapter. # # LunDiscoveryMethod = 1; # jnic146x0-LunDiscoveryMethod = 1; # # # Configuration parameter: CmdTaskAttr # Type: integer # Default: 0 (Simple Queue) # # Controls the task attribute field of Fibre Channel Protocol (FCP) SCSI # commands generated by the driver. A value of 0 sets the task attribute to # "Simple Queue" (which is the default). A value of 1 sets the task attribute # to "Untagged". This parameter must be set to Simple Queue to interoperate # with CLARiiON RAID controllers. # # CmdTaskAttr = 0; # jnic146x0-CmdTaskAttr = 0; # # # Configuration parameter: automap # Type: integer # Default: 0 (Disabled, static Binding) # # Set to: # 0 - Disabled - No dynamic binding occurs; only statically bound # devices are made available to the system. # 1 - Enabled - Dynamic binding occurs; all devices discovered are # made available to the system. # 2 - Loop Only - Dynamic binding occurs; only devices present on the # local fibre channel loop are made available to the system. # # This feature works by dynamically assigning target and LUN IDs as # devices come on line. Target IDs are dynamically assigned in private # loop via the ALPA to SCSI ID mapping table and in fabric via finding # the first unassigned target ID. All LUNs behind a port/target become # visible to the OS with their specific LUN ID. # # Warning: Without third party load balancing and/or failover software, # enabling dynamic binding on an HBA that has access to the same devices # as another HBA that has devices statically bound or that also has # dynamic binding enabled can lead to data corruption. This feature # should only be enabled in well understood/controlled SAN environments. # # Example usage: # automap = 0; # jnic146x0-automap = 0; # # # Configuration parameter: FcIpEnable # Type: integer # Default: 1 (enabled) # # Enables internet protocol traffic in addition to SCSI traffic. # Set to 1 to enable, 0 to disable. # # Example usage: # FcIpEnable = 0; # jnic146x0-FcIpEnable = 0; # # # Configuration parameter: OverrunFailoverCount # Type: integer # Default: 0 # # Specifies the number of I/O overruns required before the driver # fails the target that the I/O was sent to. # Set between 0 and 5. # # Example usage: # OverrunFailoverCount = 2; # jnic146x0-OverrunFailoverCount = 2; # # # Configuration parameter: PlogiRetryTime # Type: integer # Default: 50 # # Specifies the delay in ms between PLOGI retry attempts. # Set between 0 and 1000. # # Example usage: # PlogiRetryTime = 200; # jnic146x0-PlogiRetryTime = 200; # # # Configuration parameter: SwitchGidPtSyncEnable # Type: integer # Default: 0 (disabled) # # When enabled, after receiving an RSCN, causes the driver to send a # GID_PT request to the switch and wait for a response before starting # fabric port discovery. # # Set to 1 to enable, 0 to disable. # # Example usage: # SwitchGidPtSyncEnable = 1; # jnic146x0-SwitchGidPtSyncEnable = 1; # # # Configuration parameter: FcTapeEnabled # Type: boolean # Default: 1 (true) # # Enables FCP2 error recovery, commonly called FC Tape. When enabled, IO to # devices with FCP2 support (for example, Fibre Channel native tape drives) # will be recovered when the IO is disrupted by events such as RSCN, Link # bounce/cable pull, missing frames, etc. This feature also enables the driver's # ability to rediscover devices using ADISC instead of PLOGI. # # Example usage: # FcTapeEnabled = 1; # jnic146x0-FcTapeEnabled = 1; # ############################################################################### # # Configuration parameters for target to FC device mapping: # # targetX_hba, # targetX_lunY_hba, # targetX_wwnn, # targetX_wwpn, # targetX_port, # # Type: string # Default: # # Example usage: Replace the 'x' characters with actual WWNN, WWPN, or port ID. # # target0_hba = "jnic146x0"; # target0_lun0_hba = "jnic146x0"; # target0_wwnn = "xxxxxxxxxxxxxxxx"; # target0_wwpn = "xxxxxxxxxxxxxxxx"; # target0_port = "xxxxxx"; # jnic146x0-target0_lun0_hba="jnic146x0"; # jnic146x0-target0_wwnn="xxxxxxxxxxxxxxxx"; ############################################################################### # # Configuration parameters for target and LUN level throttling: # # target_throttle , - Default throttle for all targets # lun_throttle , - Default throttle for all LUNs # targetX_throttle , - Specific throttle for targetX # targetX_lun_throttle - Default throttle for all targetX LUNs # targetX_lunY_throttle - Specific throttle for each targetX LUN # # Type: integer # Default: # # Example usage: # # target_throttle = 256; # lun_throttle = 64; # target0_throttle = 256; # target0_lun_throttle = 64; # target0_lun1_throttle = 64; # jnic146x0-target0_lun0_throttle=64; ############################################################################### # # Configuration parameters for 3rd Party Target Drivers # # tape-device, # tape-changer, # enclosure-device # # Type: string # Default: # tape-device="st"; # tape-changer="st"; # enclosure-device="ses"; # # Example usage: # tape-device="fcst"; # jnic146x0-tape-device="IBMtape"; # tape-changer="fcst"; # jnic146x0-tape-changer="IBMtape"; # enclosure-device="HDSctl"; # jnic146x0-enclosure-device="HDSctl"; # # Please refer to the release note on "Using third party tape devices". # # The driver default automap setting is "0 - Disabled, static binding". # However, for default configuration backward compatibility with older # driver versions, the value of "2 - Loop Only" is explicitly set here. # Change or remove this setting as appropriate. # Note that per-instance automap configuration parameter settings will # override this setting for the instance specified. automap=2; jnic146x0-FcLoopEnabled=0; jnic146x0-FcFabricEnabled=1; jnic146x0-FcLinkSpeed=3; jnic146x0-JniCreationDelay=1; jnic146x0-FlogiRetryCount=3; jnic146x0-PlogiRetryCount=5; jnic146x0-PlogiControlSeconds=30; jnic146x0-FcTapeEnabled=1; jnic146x0-SwitchGidPtSyncEnable=0; jnic146x0-PlogiRetryTime=50; jnic146x0-BusyRetryDelay=5000; jnic146x0-FailoverDelay=30; jnic146x0-FailoverDelayFcTape=300; jnic146x0-TimeoutResetEnable=0; jnic146x0-QfullRetryCount=5; jnic146x0-QfullRetryDelay=5000; jnic146x0-LunRecoveryInterval=50; jnic146x0-LunThrottle=64; jnic146x0-LunDiscoveryMethod=1; jnic146x0-CmdTaskAttr=0; jnic146x0-OverrunFailoverCount=0; jnic146x0-FcIpEnable=0; jnic146x0-FcFlogiTimeout=10; jnic146x0-FcLinkUpRecoveryTime=1000; jnic146x0-FcEngHeartbeatInterval=5; jnic146x0-automap=0; jnic146x1-FcLoopEnabled=0; jnic146x1-FcFabricEnabled=1; jnic146x1-FcLinkSpeed=3; jnic146x1-JniCreationDelay=1; jnic146x1-FlogiRetryCount=3; jnic146x1-PlogiRetryCount=5; jnic146x1-PlogiControlSeconds=30; jnic146x1-FcTapeEnabled=1; jnic146x1-SwitchGidPtSyncEnable=0; jnic146x1-PlogiRetryTime=50; jnic146x1-BusyRetryDelay=5000; jnic146x1-FailoverDelay=30; jnic146x1-FailoverDelayFcTape=300; jnic146x1-TimeoutResetEnable=0; jnic146x1-QfullRetryCount=5; jnic146x1-QfullRetryDelay=5000; jnic146x1-LunRecoveryInterval=50; jnic146x1-LunThrottle=64; jnic146x1-LunDiscoveryMethod=1; jnic146x1-CmdTaskAttr=0; jnic146x1-OverrunFailoverCount=0; jnic146x1-FcIpEnable=0; jnic146x1-FcFlogiTimeout=10; jnic146x1-FcLinkUpRecoveryTime=1000; jnic146x1-FcEngHeartbeatInterval=5; jnic146x1-automap=0; jnic146x0-target95_wwnn="$50060e8000c3b0e0"; jnic146x0-target95_lun0_hba="jnic146x0"; jnic146x0-target95_lun0_throttle=64; jnic146x0-target95_lun1_hba="jnic146x0"; jnic146x0-target95_lun1_throttle=64; jnic146x0-target95_lun2_hba="jnic146x0"; jnic146x0-target95_lun2_throttle=64; jnic146x0-target95_lun3_hba="jnic146x0"; jnic146x0-target95_lun3_throttle=64; jnic146x0-target95_lun4_hba="jnic146x0"; jnic146x0-target95_lun4_throttle=64; jnic146x0-target95_lun5_hba="jnic146x0"; jnic146x0-target95_lun5_throttle=64; jnic146x0-target95_lun6_hba="jnic146x0"; jnic146x0-target95_lun6_throttle=64; jnic146x0-target95_lun7_hba="jnic146x0"; jnic146x0-target95_lun7_throttle=64; jnic146x0-target95_lun8_hba="jnic146x0"; jnic146x0-target95_lun8_throttle=64; jnic146x0-target95_lun9_hba="jnic146x0"; jnic146x0-target95_lun9_throttle=64; jnic146x0-target95_lun10_hba="jnic146x0"; jnic146x0-target95_lun10_throttle=64; jnic146x0-target95_lun11_hba="jnic146x0"; jnic146x0-target95_lun11_throttle=64; jnic146x0-target95_lun12_hba="jnic146x0"; jnic146x0-target95_lun12_throttle=64; jnic146x0-target95_lun13_hba="jnic146x0"; jnic146x0-target95_lun13_throttle=64; jnic146x0-target95_lun14_hba="jnic146x0"; jnic146x0-target95_lun14_throttle=64; jnic146x0-target95_lun15_hba="jnic146x0"; jnic146x0-target95_lun15_throttle=64; jnic146x0-target95_lun254_hba="jnic146x0"; jnic146x0-target95_lun254_throttle=64; jnic146x1-target95_wwnn="$50060e8000c3b0e4"; jnic146x1-target95_lun0_hba="jnic146x1"; jnic146x1-target95_lun0_throttle=64; jnic146x1-target95_lun1_hba="jnic146x1"; jnic146x1-target95_lun1_throttle=64; jnic146x1-target95_lun2_hba="jnic146x1"; jnic146x1-target95_lun2_throttle=64; jnic146x1-target95_lun3_hba="jnic146x1"; jnic146x1-target95_lun3_throttle=64; jnic146x1-target95_lun4_hba="jnic146x1"; jnic146x1-target95_lun4_throttle=64; jnic146x1-target95_lun5_hba="jnic146x1"; jnic146x1-target95_lun5_throttle=64; jnic146x1-target95_lun6_hba="jnic146x1"; jnic146x1-target95_lun6_throttle=64; jnic146x1-target95_lun7_hba="jnic146x1"; jnic146x1-target95_lun7_throttle=64; jnic146x1-target95_lun8_hba="jnic146x1"; jnic146x1-target95_lun8_throttle=64; jnic146x1-target95_lun9_hba="jnic146x1"; jnic146x1-target95_lun9_throttle=64; jnic146x1-target95_lun10_hba="jnic146x1"; jnic146x1-target95_lun10_throttle=64; jnic146x1-target95_lun11_hba="jnic146x1"; jnic146x1-target95_lun11_throttle=64; jnic146x1-target95_lun12_hba="jnic146x1"; jnic146x1-target95_lun12_throttle=64; jnic146x1-target95_lun13_hba="jnic146x1"; jnic146x1-target95_lun13_throttle=64; jnic146x1-target95_lun14_hba="jnic146x1"; jnic146x1-target95_lun14_throttle=64; jnic146x1-target95_lun15_hba="jnic146x1"; jnic146x1-target95_lun15_throttle=64; jnic146x1-target95_lun255_hba="jnic146x1"; jnic146x1-target95_lun255_throttle=64;