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:
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
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:
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 #
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. |
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 #
Connectivity policies determine the connections and the network communication resources between the server and the LAN or SAN on the network. These policies use pools to assign MAC addresses, WWNs, and WWPNs to servers and to identify the vNICs and vHBAs that the servers use to communicate with the network.
Note | We do not recommend that you use static IDs in connectivity policies, because these policies are included in service profiles and service profile templates and can be used to configure multiple servers. |
Connectivity policies enable users without network or storage privileges to create and modify service profiles and service profile templates with network and storage connections. However, users must have the appropriate network and storage privileges to create connectivity policies.
Connectivity policies require the same privileges as other network and storage configurations. For example, you must have at least one of the following privileges to create connectivity policies:
After the connectivity policies have been created, a user with ls-compute privileges can include them in a service profile or service profile template. However, a user with only ls-compute privileges cannot create connectivity policies.
Command or Action | Purpose | |
---|---|---|
Step 1 | UCSC# connect policy-mgr |
Enters policy manager mode. |
Step 2 | UCSC(policy-mgr) # scope org org-name | Enter organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. |
Step 3 | UCSC(policy-mgr) /org # create san-connectivity-policy policy-name |
Creates the specified SAN connectivity policy, and enters organization network control policy mode. This name can be between 1 and 16 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), _ (underscore), : (colon), and . (period) and you cannot change this name after the object has been saved. |
Step 4 | UCSC(policy-mgr) /org/san-connectivity-policy # set descr policy-name | (Optional)
Adds a description to the policy. We recommend that you include information about where and how the policy should be used. Enter up to 256 characters. you can use any characters or spaces except ' (accent mark), \ (backslash), ^ (carat), " (double quote), = (equal sign), > (greater than), < (less than), or ' (single quote). |
Step 5 | UCSC(policy-mgr) /org/service-profile # set identity {dynamic-uuid {uuid | derived} | dynamic-wwnn {wwnn | derived} | uuid-pool pool-name | wwnn-pool pool-name} |
Specifies how the server acquires a UUID or WWNN. You can do one of the following:
|
Step 6 | UCSC(policy-mgr) /org/san-connectivity-policy # commit-buffer |
Commits the transaction to the system configuration. |
The following example shows how to create a SAN connectivity policy named SanConnect242 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org* # create san-connectivity-policy SanConnect242 UCSC(policy-mgr) /org/san-connectivity-policy* # set descr "SAN connectivity policy" UCSC(policy-mgr) /org/san-connectivity-policy* # set identity wwnn-pool SanPool7 UCSC(policy-mgr) /org/san-connectivity-policy* # commit-buffer UCSC(policy-mgr) /org/san-connectivity-policy #
Add one or more vHBAs and/or initiator groups to this SAN connectivity policy.
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, enter / as the org-name. |
Step 3 | UCSC(policy-mgr) /org # scope san-connectivity-policy policy-name |
Enters SAN connectivity policy mode for the specified SAN connectivity policy. |
Step 4 | UCSC(policy-mgr) /org/san-connectivity-policy # create vhba vhba-name [fabric {a | b}] [fc-if fc-if-name] |
Creates a vHBA for the specified SAN connectivity policy and enters vHBA mode. This name can be between 1 and 16 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), _ (underscore), : (colon), and . (period), and you cannot change this name after the object has been saved. |
Step 5 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set adapter-policy policy-name |
Specifies the adapter policy to use for the vHBA. |
Step 6 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set identity {dynamic-wwpn {wwpn | derived} | wwpn-pool wwn-pool-name} |
Specifies the WWPN for the vHBA. You can set the storage identity using one of the following options:
|
Step 7 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set max-field-size size-num |
Specifies the maximum size of the Fibre Channel frame payload (in bytes) that the vHBA supports. Enter an integer between 256 and 2112. The default is 2048. |
Step 8 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set order {order-num | unspecified} |
Specifies the PCI scan order for the vHBA. |
Step 9 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set pers-bind {disabled | enabled} |
Disables or enables persistent binding to Fibre Channel targets. |
Step 10 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set pin-group group-name |
Specifies the SAN pin group to use for the vHBA. |
Step 11 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set qos-policy policy-name |
Specifies the QoS policy to use for the vHBA. |
Step 12 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set stats-policy policy-name |
Specifies the statistics threshold policy to use for the vHBA. |
Step 13 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set template-name policy-name |
Specifies the vHBA template to use for the vHBA. If you choose to use a vHBA template for the vHBA, you must still complete all of the configuration not included in the vHBA template, including Steps 4, 7, and 8. |
Step 14 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # set vcon {1 | 2 | 3 | 4 | any} |
Assigns the vHBA to one or all virtual network interface connections. |
Step 15 | UCSC(policy-mgr) /org/san-connectivity-policy/vhba # commit-buffer |
Commits the transaction to the system configuration. |
The following example shows how to configure a vHBA for a SAN connectivity policy named SanConnect242 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org* # scope san-connectivity-policy SanConnect242 UCSC(policy-mgr) /org/san-connectivity-policy* # create vhba vhba3 fabric a UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set adapter-policy AdaptPol2 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set identity wwpn-pool SanPool7 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set max-field-size 2112 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set order 0 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set pers-bind enabled UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set pin-group FcPinGroup12 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set qos-policy QosPol5 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set stats-policy StatsPol2 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set template-name SanConnPol3 UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # set vcon any UCSC(policy-mgr) /org/san-connectivity-policy/vhba* # commit-buffer UCSC(policy-mgr) /org/san-connectivity-policy/vhba #
If desired, add another vHBA or an initiator group to the SAN connectivity policy. If not, include the policy in a service profile or service profile template.
If you are continuing from Creating a SAN Connectivity Policy, begin this procedure at Step 3.
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, enter / as the org-name. | ||
Step 3 | UCSC(policy-mgr) /org # scope san-connectivity-policy policy-name |
Enters SAN connectivity policy mode for the specified SAN connectivity policy. | ||
Step 4 | UCSC(policy-mgr) /org/san-connectivity-policy # create initiator-group group-name fc | Creates the specified initiator group for Fibre Channel zoning and enters initiator group mode. This name can be between 1 and 16 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), _ (underscore), : (colon), and .(period), and you cannot change this name after the object has been saved. | ||
Step 5 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group # create initiator vhba-name | Creates the specified vHBA initiator in the initiator group. If desired, repeat this step to add a second vHBA initiator to the group. | ||
Step 6 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group # set storage-connection-policy policy-name | Associates the specified storage connection policy with the SAN connectivity policy.
| ||
Step 7 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def # create storage-target wwpn | Creates a storage target endpoint with the specified WWPN, and enters storage target mode. | ||
Step 8 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def/storage-target # set target-path {a | b} | Specifies which fabric interconnect is used for communications with the target endpoint. | ||
Step 9 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def/storage-target # set target-vsan vsan |
Specifies which VSAN is used for communications with the target endpoint. | ||
Step 10 | UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group # commit-buffer |
Commits the transaction to the system configuration. |
The following example shows how to configure an initiator group named initGroupZone1 with two initiators for a a SAN connectivity policy named SanConnect242, configure a local storage connection policy definition named scPolicyZone1, and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org* # scope san-connectivity-policy SanConnect242 UCSC(policy-mgr) /org/san-connectivity-policy # create initiator-group initGroupZone1 fc UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group* # set zoning-type sist UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group* # create initiator vhba1 UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group* # create initiator vhba2 UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group* # create storage-connection-def scPolicyZone1 UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def* # create storage-target 20:10:20:30:40:50:60:70 UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def/storage-target* # set target-path a UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group/storage-connection-def/storage-target* # set target-vsan default UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group* # commit-buffer UCSC(policy-mgr) /org/san-connectivity-policy/initiator-group #
If desired, add another initiator group or a vHBA to the SAN connectivity policy. If not, include the policy in a service profile or service profile template.
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, enter / as the org-name. |
Step 3 | UCSC(policy-mgr) /org # scope san-connectivity-policy policy-name |
Enters SAN connectivity policy mode for the specified SAN connectivity policy. |
Step 4 | UCSC(policy-mgr) /org/san-connectivity-policy # delete vHBA vhba-name |
Deletes the specified vHBA from the SAN connectivity policy. |
Step 5 | UCSC(policy-mgr) /org/san-connectivity-policy # commit-buffer |
Commits the transaction to the system configuration. |
The following example shows how to delete a vHBA named vHBA3 from a SAN connectivity policy named SanConnect242 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # scope san-connectivity-policy SanConnect242 UCSC(policy-mgr) /org/san-connectivity-policy # delete vHBA vHBA3 UCSC(policy-mgr) /org/san-connectivity-policy* # commit-buffer UCSC(policy-mgr) /org/san-connectivity-policy #
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, enter, / as the org-name. |
Step 3 | UCSC(policy-mgr) /org # scope san-connectivity-policy policy-name |
Enters SAN connectivity policy mode for the specified SAN connectivity policy. |
Step 4 | UCSC(policy-mgr) /org/san-connectivity-policy # delete initiator-group group-name |
Deletes the specified initiator group from the SAN connectivity policy. |
Step 5 | UCSC(policy-mgr) /org/san-connectivity-policy # commit-buffer |
Commits the transaction to the system configuration. |
The following example shows how to delete an initiator group named initGroup3 from a SAN connectivity policy named SanConnect242 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # scope san-connectivity-policy SanConnect242 UCSC(policy-mgr) /org/san-connectivity-policy # delete initiator-group initGroup3 UCSC(policy-mgr) /org/san-connectivity-policy* # commit-buffer UCSC(policy-mgr) /org/san-connectivity-policy #
The storage connection policy contains a collection of target storage ports on storage array that you use to configure fibre channel zoning.
From Cisco UCS Central you can create a storage connection policy in an organization.
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 storage-connection-policy profile-name |
Creates the specified storage connection policy and enters organization storage connection policy mode. |
Step 4 | UCSC(policy-mgr) /org/storage-connection-policy # set zoning type {none | simt | sist} |
Select the zoning type. This can be one of the following:
|
Step 5 | UCSC(policy-mgr) /org/storage-connection-policy # create storage-target WWPN_ID |
Creates a target on the selected WWPN. |
Step 6 | UCSC(policy-mgr) /org/storage-connection-policy/storage-target # set target-path {a | b} |
Sets the target fabric interconnect. By default, fabric interconnect A is used for communications with the target endpoint. |
Step 7 | UCSC(policy-mgr) /org/storage-connection-policy/storage-target # set target-vsan VSAN_name |
Select the VSAN associated with the FI Port and the target endpoint. |
Step 8 | UCSC(policy-mgr) /org/storage-connection-policy # commit-buffer |
Commits the transaction to the system configuration. |