## fcaw.conf - JNI FCA DRIVER (Solaris SCSI-IP HBA) CONFIGURATION FILE

# Configuration variable scsi-initiator-id
# Type: integer, 0-125; default: none (must be explicitly set for PCI driver)
# Defines the adapters SCSI ID (and hence FC AL_PA) on the loop
scsi-initiator-id = 0x7d;

# Configuration flag fca_nport
# Type: boolean; default: 0 (false)
# If false (0), then fca initializes on a loop
# If true (1), then fca initializes as an N_Port
#    and fabric operation is enabled
# fca_nport = 0;
fca_nport = 1;

# Configuration flag public_loop
# Type: boolean; default: 0 (false)
# If false (0), then fcaw initializes according to what fca_nport is set to 
# If true (1), then fca initializes as an NL_Port on a public loop
# 	 and fabric operation is enabled via the FLPort of the switch
# if public_loop = 1, then fca_nport is overridden to be 0
public_loop = 0;

# Configuration target_controllers
# Type: integer, count; default: 126
# Defines the number of target controllers to support.
# The absolute maximum is 5000.  
# If set to greater than 5000, the driver will reset to 5000.
target_controllers = 126;
 
# Configuration flag ip_disable
# Type: boolean; defalt; 0 (false)
# if false (0), then the IP side of the driver is enabled
# if true (1), the the IP side of the driver is completely disabled
ip_disable = 1;

# Configuration variable qfull_retry_count
# Type: integer, count; defalt: 0
# Defines the number of times a command is retried by the HBA if a target
# rejects it with a queue full status.
# if 0, then the HBA will retry forever
# if > 0, then the HBA tries at least qfull_retry_count times  
# if qfull_retry_count exceeded, then the HBA returns the command to the target
# driver with reason set to transport error.
qfull_retry_count = 0;

# Configuration variable qfull_retry_interval
# Type: integer, milliseconds; default: 1000
# Time the HBA waits before retrying a rejected command due to queue full
qfull_retry_interval = 1000; 

# Configuration variable failover
# Type: integer, seconds; default: 30
# Defines the number of seconds after target is declared "offline" 
# before target is declared "failed" and all pending commands 
# are flushed back to the application.
# See failover_extension for additonal info. 
# failover = 0;
failover = 60;

# Configuration variable failover_extension
# Type: integer, seconds; default: 0
# Extends a target's failover period by this number of seconds to perform target rediscovery.
# If defined and the target has pending commands at the time it is declared "failed",
# the target will first be declared "missing" for this period before being declared "failed". 
# When a target is declared "missing" the link will be reset once and targets will be rediscovered. 
# This provides a "last chance" opportunity for the target to go "online" before 
# the target is declared "failed" and all pending commands are flushed.
# See failover for additonal info. 
failover_extension = 0;

# Configuration variable recovery_attempts
# Type: integer, count; default: 5
# Defines the number of times login_recovery is attempted before failed
recovery_attempts = 5;

# Configuration flag class2_enable
# Type: boolean; default: 0
# If set to 1 (true), then FC Class 2 exchanges (ACK_1 model) are enabled for
# devices which support it [even when connected to a loop].
class2_enable = 0;

# Configuration variable fca_heartbeat
# Type: value, microseconds; default: 0
# Defines the number of microseconds between "heartbeat" frames.
# Only used for debugging.
fca_heartbeat = 0;

# Configuration flag reset_glm
# Type: boolean; default: 0
# If non-zero, then the Gigabit Link Module will be reset before
# adapter initialization. This is a workaround for specific boot-up
# conditions.
reset_glm = 0;

# Configuration flag timeout_reset_enable
# Type: boolean; default: 0
# When a command times out to a target, the driver can attempt to clear the problem in two ways:
#   1. (timeout_reset_enable = 1)  Reset the target.
#   2. (timeout_reset_enable = 0)  Send an abort exchange (ABTS_LS) request to the target.
timeout_reset_enable = 0;

# Configuration flag busy_retry_delay
# Type: unsigned int; default: 100
# Sets delay between retries after a SCSI device returns a BUSY response for a command.
# The delay is in milliseconds with a 10 millisecond resolution.
busy_retry_delay = 500;

# Configuration flag link_recovery_delay
# Type: unsigned int; default: 1000
# Sets delay between link up state and login recovery.
# This delay helps ensure link stability before recovery of communications to ports.
# The delay is in milliseconds with a 10 millisecond resolution.
# for combined SCSI/IP operation, this should be set to at least 1000
link_recovery_delay = 1000;

# Configuration flag scsi_probe_delay
# Type: unsigned int, milliseconds; default: 500
# Sets delay before SCSI probes are allowed to occur during boot.
# This allows time for the driver to build a network port list for target binding.
# The delay is in milliseconds with a 10 millisecond resolution.
scsi_probe_delay = 5000;

# Configuration flag def_hba_binding
# Type: string; default: "fcaw*" (means all target/lun instances will be initialized by all fcaw instances)
# Sets the default HBA binding for every target/lun instance which does not explicitly define one.
#       - A "*" following an hba name indicates all instances of that hba driver
# *See technote for details on hba bindings
# def_hba_binding  = "fcaw*";
def_hba_binding  = "fas";

# Configuration flag def_wwXn_binding where X is either n for node or p for port.
# Type: string; default: "$xxxxxxxxxxxxxxxx" (means WWXN is "static don't care")
# Sets the 16 digit hexidecimal default wwXn binding for every target/lun instance which does not 
# explicitly define one.
#      - A "$" preceding the string indicates static binding enabled
#      - A "x" in place of a digit indicates "don't care" for that digit
# *See technote for details on wwn bindings
def_wwpn_binding  = "$xxxxxxxxxxxxxxxx";
def_wwnn_binding  = "$xxxxxxxxxxxxxxxx";

# Configuration flag def_port_binding
# Type: string; default: "xxxxxx" (means PORT is "non-static don't care")
# Sets the 6 digit hexidecimal default port binding for every target/lun instance which does not 
# explicitly define one.
#      - A "$" preceding the string indicates static binding enabled
#      - A "x" in place of a digit indicates "don't care" for that digit
# *See technote for details on port bindings
def_port_binding = "xxxxxx";

# Configuration flag fca_verbose
# Type: boolean; default: 1
# Determines how many messages are displayed directly to the console. 
#      - A "0" will quiet the driver messages to the console, but still print them to the 
#        system message log. 
#        (NOTE: a "boot -v" will override this setting and make the driver verbose again)
#      - A "1" will make the driver print all messages to the console and to the system 
#        message log.
fca_verbose = 1;