Cisco UCS Manager CLI Configuration Guide, Release 1.0(2)
Configuring Storage-Related Policies
Downloads: This chapterpdf (PDF - 462.0KB) The complete bookPDF (PDF - 3.18MB) | Feedback

Configuring Storage-Related Policies

Configuring Storage-Related Policies

This chapter includes the following sections:

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 #