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. If you did not specify the Fibre Channel interface when creating the vHBA template in Step 2, then you have the option to specify it with this command. |
Step 6 | UCS-A /org/vhba-templ # set mac-pool mac-pool-name | Specifies the MAC pool to use for the vHBA. |
Step 7 | UCS-A /org/vhba-templ # set pin-group group-name | Specifies the pin group to use for the vHBA. |
Step 8 | UCS-A /org/vhba-templ # set stats-policy policy-name | Specifies the server and server component statistics threshold policy to use for the vHBA. |
Step 9 | 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 10 | 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 mac-pool pool137 UCS-A /org/vhba-templ* # set pin-group FcPinGroup12 UCS-A /org/vhba-templ* # set stats-policy ServStatsPolicy UCS-A /org/vhba-templ* # set type updating-template 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.
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 profile 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 {error-detect-timeout timeout-msec | fcp-error-recovery {disabled | enabled} | link-down-timeout timeout-msec | port-down-io-retry-count retry-count | port-down-timeout timeout-msec | resource-allocation-timeout timeout-msec} | (Optional) Configures the Fibre Channel error recovery profile. |
||
Step 5 | UCS-A /org/fc-policy # set port {io-throttle-count throttle-count | max-field-size size-num | max-luns max-num} | (Optional) Configures the Fibre Channel port profile. |
||
Step 6 | UCS-A /org/fc-policy # set port-f-logi {retries retry-count | timeout timeout-sec} | (Optional) Configures the Fibre Channel port fabric login (FLOGI) profile. |
||
Step 7 | UCS-A /org/fc-policy # set port-p-logi {retries retry-count | timeout timeout-secs} | (Optional) Configures the Fibre Channel port-to-port login (PLOGI) profile. |
||
Step 8 | UCS-A /org/fc-policy # set recv-queue {count count | ring-size size-num} | (Optional) Configures the Fibre Channel receive queue profile. |
||
Step 9 | UCS-A /org/fc-policy # set scsi-io {count count | ring-size size-num} | (Optional) Configures the Fibre Channel SCSI I/O profile. |
||
Step 10 | UCS-A /org/fc-policy # set trans-queue ring-size size-num} | (Optional) Configures the Fibre Channel transmit queue profile. |
||
Step 11 | UCS-A /org/fc-policy # commit-buffer | Commits the transaction to the system configuration. |
The following example configures a Fibre Channel adapter policy:
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:
UCS-A# scope org / UCS-A /org* # delete fc-policy FcPolicy42 UCS-A /org* # commit-buffer UCS-A /org #