The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter includes the following sections:
Configuring vHBA Templates
This template is a policy that defines how a vHBA on a server connects to the SAN. It is also referred to as a vHBA SAN connectivity template.
You need to include this policy in a service profile for it to take effect.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
Step 2 | UCS-A /org # create vhba-templ vhba-templ-name [fabric {a | b}] [fc-if vsan-name] | Creates a vHBA template and enters organization vHBA template mode. |
Step 3 | UCS-A /org/vhba-templ # set descr description | (Optional) Provides a description for the vHBA template. |
Step 4 | UCS-A /org/vhba-templ # set fabric {a | b} | (Optional) Specifies the fabric to use for the vHBA. If you did not specify the fabric when creating the vHBA template in Step 2, then you have the option to specify it with this command. |
Step 5 | UCS-A /org/vhba-templ # set fc-if vsan-name | (Optional) Specifies the Fibre Channel interface (named VSAN) to use for the vHBA template. If you did not specify the Fibre Channel interface when creating the vHBA template in Step 2, you have the option to specify it with this command. |
Step 6 | UCS-A /org/vhba-templ # set max-field-size size-num | Specifies the maximum size of the Fibre Channel frame payload (in bytes) that the vHBA supports. |
Step 7 | UCS-A /org/vhba-templ # set pin-group group-name | Specifies the pin group to use for the vHBA template. |
Step 8 | UCS-A /org/vhba-templ # set qos-policy mac-pool-name | Specifies the QoS policy to use for the vHBA template. |
Step 9 | UCS-A /org/vhba-templ # set stats-policy policy-name | Specifies the server and server component statistics threshold policy to use for the vHBA template. |
Step 10 | UCS-A /org/vhba-templ # set type {initial-template | updating-template} | Specifies the vHBA template update type. If you do not want vHBA instances created from this template to be automatically updated when the template is updated, use the initial-template keyword; otherwise, use the updating-template keyword to ensure that all vHBA instance are updated when the vHBA template is updated. |
Step 11 | UCS-A /org/vhba-templ # set wwpn-pool pool-name | Specifies the WWPN pool to use for the vHBA template. |
Step 12 | UCS-A /org/vhba-templ # commit-buffer | Commits the transaction to the system configuration. |
The following example configures a vHBA template and commits the transaction:
UCS-A# scope org / UCS-A /org* # create vhba template VhbaTempFoo UCS-A /org/vhba-templ* # set descr "This is a vHBA template example." UCS-A /org/vhba-templ* # set fabric a UCS-A /org/vhba-templ* # set fc-if accounting UCS-A /org/vhba-templ* # set max-field-size 2112 UCS-A /org/vhba-templ* # set pin-group FcPinGroup12 UCS-A /org/vhba-templ* # set qos-policy policy34foo UCS-A /org/vhba-templ* # set stats-policy ServStatsPolicy UCS-A /org/vhba-templ* # set type updating-template UCS-A /org/vhba-templ* # set wwpn-pool SanPool7 UCS-A /org/vhba-templ* # commit-buffer UCS-A /org/vhba-templ #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
Step 2 | UCS-A /org # delete vhba-templ vhba-templ-name | Deletes the specified vHBA template. |
Step 3 | UCS-A /org # commit-buffer | Commits the transaction to the system configuration. |
The following example deletes the vHBA template named VhbaTempFoo and commits the transaction:
UCS-A# scope org / UCS-A /org # delete vhba template VhbaTempFoo UCS-A /org* # commit-buffer UCS-A /org #
Configuring 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 an cluster configuration with two fabric interconnects
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.
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:
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 2 | UCS-A /org # create fc-policy policy-name | Creates the specified Fibre Channel adapter policy and enters organization Fibre Channel policy mode. |
||
Step 3 | UCS-A /org/fc-policy # set descr description | (Optional) Provides a description for the policy.
|
||
Step 4 | UCS-A /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 5 | UCS-A /org/fc-policy # set interrupt mode {intx | msi | msi-x}} | (Optional) Configures the driver interrupt mode. |
||
Step 6 | UCS-A /org/fc-policy # set port {io-throttle-count throttle-count | max-luns max-num} | (Optional) Configures the Fibre Channel port. |
||
Step 7 | UCS-A /org/fc-policy # set port-f-logi {retries retry-count | timeout timeout-msec} | (Optional) Configures the Fibre Channel port fabric login (FLOGI). |
||
Step 8 | UCS-A /org/fc-policy # set port-p-logi {retries retry-count | timeout timeout-msec} | (Optional) Configures the Fibre Channel port-to-port login (PLOGI). |
||
Step 9 | UCS-A /org/fc-policy # set recv-queue {count count | ring-size size-num} | (Optional) Configures the Fibre Channel receive queue. |
||
Step 10 | UCS-A /org/fc-policy # set scsi-io {count count | ring-size size-num} | (Optional) Configures the Fibre Channel SCSI I/O. |
||
Step 11 | UCS-A /org/fc-policy # set trans-queue ring-size size-num} | (Optional) Configures the Fibre Channel transmit queue. |
||
Step 12 | UCS-A /org/fc-policy # commit-buffer | Commits the transaction to the system configuration. |
The following example configures a Fibre Channel adapter policy and commits the transaction:
UCS-A# scope org / UCS-A /org* # create fc-policy FcPolicy42 UCS-A /org/fc-policy* # set descr "This is a Fibre Channel adapter policy example." UCS-A /org/fc-policy* # set error-recovery error-detect-timeout 2500 UCS-A /org/fc-policy* # set port max-luns 4 UCS-A /org/fc-policy* # set port-f-logi retries 250 UCS-A /org/fc-policy* # set port-p-logi timeout 5000 UCS-A /org/fc-policy* # set recv-queue count 1 UCS-A /org/fc-policy* # set scsi-io ring-size 256 UCS-A /org/fc-policy* # set trans-queue ring-size 256 UCS-A /org/fc-policy* # commit-buffer UCS-A /org/fc-policy #
Command or Action | Purpose | |
---|---|---|
Step 1 | UCS-A# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
Step 2 | UCS-A /org # delete fc-policy policy-name | Deletes the specified Fibre Channel adapter policy. |
Step 3 | UCS-A /org # commit-buffer | Commits the transaction to the system configuration. |
The following example deletes the Fibre Channel adapter policy named FcPolicy42 and commits the transaction:
UCS-A# scope org / UCS-A /org # delete fc-policy FcPolicy42 UCS-A /org* # commit-buffer UCS-A /org #