Contents

• Configuring Storage-Related Policies
• vHBA Template
• Configuring a vHBA Template
• Deleting a vHBA Template
• Ethernet and Fibre Channel Adapter Policies
• Configuring a Fibre Channel Adapter Policy
• Deleting a Fibre Channel Adapter Policy

Configuring Storage-Related Policies

---

This chapter includes the following sections:

• vHBA Template
• Configuring a vHBA Template
• Deleting a vHBA Template
• Ethernet and Fibre Channel Adapter Policies
• Configuring a Fibre Channel Adapter Policy
• Deleting a Fibre Channel Adapter Policy

Configuring vHBA Templates

vHBA Template

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.

Configuring a vHBA Template

Procedure

	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 # 

Deleting a vHBA Template

Procedure

	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

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 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.

Note

For Fibre Channel adapter policies, the values displayed by Cisco UCS Manager 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 Cisco UCS Manager: Max LUNs Per Target—SANsurfer has a maximum of 256 LUNs and does not display more than that number. Cisco UCS Manager supports a higher maximum number of LUNs. Link Down Timeout—In SANsurfer, you configure the timeout threshold for link down in seconds. In Cisco UCS Manager, you configure this value in milliseconds. Therefore, a value of 5500 ms in Cisco UCS Manager displays as 5s in SANsurfer. Max Data Field Size—SANsurfer has allowed values of 512, 1024, and 2048. Cisco UCS Manager allows you to set values of any size. Therefore, a value of 900 in Cisco UCS Manager displays as 512 in SANsurfer.

Configuring a Fibre Channel Adapter Policy

Procedure

	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. Note    If your description includes spaces, special characters, or punctuation, you must begin and end your description with quotation marks. The quotation marks will not appear in the description field of any show command output.
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 # 

Deleting a Fibre Channel Adapter Policy

Procedure

	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 #