Ethernet and Fibre Channel Adapter Policies
These policies govern the host-side behavior of the adapter, including how the adapter handles traffic. For example, you can use these policies to change default settings for the following:
-
Queues
-
Interrupt handling
-
Performance enhancement
-
RSS hash
-
Failover in a cluster configuration with two fabric interconnects
Note |
For Fibre Channel adapter policies, the values displayed by may not match those displayed by applications such as QLogic SANsurfer. For example, the following values may result in an apparent mismatch between SANsurfer and :
|
Operating System Specific Adapter Policies
By default, Cisco UCS provides a set of Ethernet adapter policies and Fibre Channel adapter policies. These policies include the recommended settings for each supported server operating system. Operating systems are sensitive to the settings in these policies. Storage vendors typically require non-default adapter settings. You can find the details of these required settings on the support list provided by those vendors.
Important |
We recommend that you use the values in these policies for the applicable operating system. Do not modify any of the values in the default policies unless directed to do so by Cisco Technical Support. However, if you are creating an Ethernet adapter policy for a Windows OS (instead of using the default Windows adapter policy), you must use the following formulas to calculate values that work with Windows:
For example, if Transmit Queues = 1 and Receive Queues = 8 then:
|
Configuring a Fibre Channel Adapter Policy
Procedure
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
UCSC# connect policy-mgr |
Enters policy manager mode. |
||
Step 2 |
UCSC(policy-mgr)# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name . |
||
Step 3 |
UCSC(policy-mgr) /org # create fc-policy policy-name |
Creates the specified Fibre Channel adapter policy and enters organization Fibre Channel policy mode. |
||
Step 4 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set descr description |
(Optional)
Provides a description for the policy.
|
||
Step 5 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set error-recovery {fcp-error-recovery {disabled | enabled} | link-down-timeout timeout-msec | port-down-io-retry-count retry-count | port-down-timeout timeout-msec} |
(Optional)
Configures the Fibre Channel error recovery. |
||
Step 6 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set interrupt mode {intx | msi | msi-x}} |
(Optional)
Configures the driver interrupt mode. |
||
Step 7 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set port {io-throttle-count throttle-count | max-luns max-num} |
(Optional)
Configures the Fibre Channel port. |
||
Step 8 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set port-f-logi {retries retry-count | timeout timeout-msec} |
(Optional)
Configures the Fibre Channel port fabric login (FLOGI). |
||
Step 9 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set port-p-logi {retries retry-count | timeout timeout-msec} |
(Optional)
Configures the Fibre Channel port-to-port login (PLOGI). |
||
Step 10 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set recv-queue {count count | ring-size size-num} |
(Optional)
Configures the Fibre Channel receive queue. |
||
Step 11 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set scsi-io {count count | ring-size size-num} |
(Optional)
Configures the Fibre Channel SCSI I/O. |
||
Step 12 |
(Optional) UCSC(policy-mgr) /org/fc-policy # set trans-queue ring-size size-num} |
(Optional)
Configures the Fibre Channel transmit queue. |
||
Step 13 |
UCSC(policy-mgr) /org/fc-policy # commit-buffer |
Commits the transaction to the system configuration. |
Example
The following example configures a Fibre Channel adapter policy and commits the transaction:
UCSC# connect policy-mgr
UCSC(policy-mgr)# scope org /
UCSC(policy-mgr) /org* # create fc-policy FcPolicy42
UCSC(policy-mgr) /org/fc-policy* # set descr "This is a Fibre Channel adapter policy example."
UCSC(policy-mgr) /org/fc-policy* # set error-recovery error-detect-timeout 2500
UCSC(policy-mgr) /org/fc-policy* # set port max-luns 4
UCSC(policy-mgr) /org/fc-policy* # set port-f-logi retries 250
UCSC(policy-mgr) /org/fc-policy* # set port-p-logi timeout 5000
UCSC(policy-mgr) /org/fc-policy* # set recv-queue count 1
UCSC(policy-mgr) /org/fc-policy* # set scsi-io ring-size 256
UCSC(policy-mgr) /org/fc-policy* # set trans-queue ring-size 256
UCSC(policy-mgr) /org/fc-policy* # commit-buffer
UCSC(policy-mgr) /org/fc-policy #
Deleting a Fibre Channel Adapter Policy
Procedure
Command or Action | Purpose | |
---|---|---|
Step 1 |
UCSC# connect policy-mgr |
Enters policy manager mode. |
Step 2 |
UCSC(policy-mgr)# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name . |
Step 3 |
UCSC(policy-mgr) /org # delete fc-policy policy-name |
Deletes the specified Fibre Channel adapter policy. |
Step 4 |
UCSC(policy-mgr) /org # commit-buffer |
Commits the transaction to the system configuration. |
Example
The following example deletes the Fibre Channel adapter policy named FcPolicy42 and commits the transaction:
UCSC# connect policy-mgr
UCSC(policy-mgr)# scope org /
UCSC(policy-mgr) /org # delete fc-policy FcPolicy42
UCSC(policy-mgr) /org* # commit-buffer
UCSC(policy-mgr) /org #