Creates a vHBA template and enters organization vHBA template
mode.
Step 3
UCS-A /org/vhba-templ #
set descrdescription
(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-ifvsan-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-sizesize-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-groupgroup-name
Specifies the pin group to use for the vHBA template.
Step 8
UCS-A /org/vhba-templ #
set qos-policymac-pool-name
Specifies the QoS policy to use for the vHBA template.
Step 9
UCS-A /org/vhba-templ #
set stats-policypolicy-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 theinitial-template keyword;
otherwise, use the
updating-template keyword to ensure that all
vHBA instances are updated when the vHBA template is updated.
Step 11
UCS-A /org/vhba-templ #
set wwpn-poolpool-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 #
Deleting a vHBA Template
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-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-templvhba-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:
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
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.
Operating System Specific Adapter Policies
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.
Important:
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:
Interrupt Count = (Completion Queues + 2) rounded up to nearest power of 2
For example, if Transmit Queues = 1 and Receive Queues = 8 then:
Completion Queues = 1 + 8 = 9
Interrupt Count = (9 + 2) rounded up to the nearest power of 2 = 16
Configuring a Fibre Channel Adapter Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-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-policypolicy-name
Creates the specified Fibre Channel adapter policy and enters
organization Fibre Channel policy mode.
Step 3
UCS-A /org/fc-policy #
set descrdescription
(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.
Default vHBA behavior policy allow you to configure how vHBAs are created for a service profile. You can choose to create vHBAs manually, or you can allow them to be created automatically.
You can configure the default vHBA behavior policy to define how vHBAs are created. This can be one of the following:
None—Cisco UCS Manager does not create default vHBAs for a service profile. All vHBAs must be explicitly created.
HW Inherit—If a service profile requires vHBAs and none have been explicitly defined, Cisco UCS Manager creates the required vHBAs based on the adapter installed in the server associated with the service profile.
Note
If you do not specify a default behavior policy for vHBAs, none is used by default.
Configuring a Default vHBA Behavior Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope org /
Enters the root organization mode.
Step 2
UCS-A/org # scope vhba-beh-policy
Enters default vHBA behavior policy mode.
Step 3
UCS-A/org/vhba-beh-policy # set action {hw-inherit [template_namename] | none}
Specifies the default vHBA behavior policy. This can be one of the following:
hw-inherit—If a service profile requires vHBAs and none have been explicitly defined, Cisco UCS Manager creates the required vHBAs based on the adapter installed in the server associated with the service profile.
If you specify hw-inherit, you can also specify a vHBA template to create the vHBAs.
none—Cisco UCS Manager does not create default vHBAs for a service profile. All vHBAs must be explicitly created.
Step 4
UCS-A/org/vhba-beh-policy # commit-buffer
Commits the transaction to the system configuration.
This example shows how to set the default vHBA behavior policy to hw-inherit.
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.
Privileges Required for LAN and SAN Connectivity Policies
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.
Privileges Required 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:
admin—Can create LAN and SAN connectivity policies
ls-server—Can create LAN and SAN connectivity policies
ls-network—Can create LAN connectivity policies
ls-storage—Can create SAN connectivity policies
Privileges Required to Add Connectivity Policies to Service Profiles
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.
Interactions between Service Profiles and Connectivity Policies
You can configure the LAN and SAN connectivity for a service profile through either of the following methods:
LAN and SAN connectivity policies that are referenced in the service profile
Local vNICs and vHBAs that are created in the service profile
Local vNICs and a SAN connectivity policy
Local vHBAs and a LAN connectivity policy
Cisco UCS maintains mutual exclusivity between connectivity policies and local vNIC and vHBA configuration in the service profile. You cannot have a combination of connectivity policies and locally created vNICs or vHBAs. When you include a LAN connectivity policy in a service profile, all existing vNIC configuration is erased, and when you include a SAN connectivity policy, all existing vHBA configuration in that service profile is erased.
Creating a SAN Connectivity Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-name
Enters organization mode for the specified organization. To enter
the root organization mode, enter
/ as the
org-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 3
UCS-A /org/lan-connectivity-policy #
set descrpolicy-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).
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 4
UCS-A /org/san-connectivity-policy/vhba # set adapter-policypolicy-name
You can set the storage identity using one of the following options:
Create a unique WWPN in the form hh:hh:hh:hh:hh:hh:hh:hh.
You can specify a WWPN in the range from
20:00:00:00:00:00:00:00 to 20:FF:FF:FF:FF:FF:FF:FF or from 50:00:00:00:00:00:00:00 to 5F:FF:FF:FF:FF:FF:FF:FF.
If you want the WWPN to be compatible with Cisco MDS Fibre Channel switches, use the WWPN template 20:00:00:25:B5:XX:XX:XX.
Derive the WWPN from one burned into the hardware at manufacture.
Assign a WWPN from a WWN pool.
Step 6
UCS-A /org/san-connectivity-policy/vhba # set max-field-sizesize-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 7
UCS-A /org/san-connectivity-policy/vhba # set order {order-num | unspecified}
Specifies the PCI scan order for the vHBA.
Step 8
UCS-A /org/san-connectivity-policy/vhba # set pers-bind {disabled | enabled}
Disables or enables persistent binding to
Fibre Channel targets.
Step 9
UCS-A /org/san-connectivity-policy/vhba # set pin-groupgroup-name
Specifies the SAN pin group to use for the vHBA.
Step 10
UCS-A /org/san-connectivity-policy/vhba # set qos-policypolicy-name
Specifies the QoS policy to use for the vHBA.
Step 11
UCS-A /org/san-connectivity-policy/vhba # set stats-policypolicy-name
Specifies the statistics threshold policy to use for the vHBA.
Step 12
UCS-A /org/san-connectivity-policy/vhba # set template-namepolicy-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.
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:
UCS-A# scope org /
UCS-A /org* # scope san-connectivity-policy SanConnect242
UCS-A /org/san-connectivity-policy* # create vhba vhba3 fabric a
UCS-A /org/san-connectivity-policy/vhba* # set adapter-policy AdaptPol2
UCS-A /org/san-connectivity-policy/vhba* # set identity wwpn-pool SanPool7
UCS-A /org/san-connectivity-policy/vhba* # set max-field-size 2112
UCS-A /org/san-connectivity-policy/vhba* # set order 0
UCS-A /org/san-connectivity-policy/vhba* # set pers-bind enabled
UCS-A /org/san-connectivity-policy/vhba* # set pin-group FcPinGroup12
UCS-A /org/san-connectivity-policy/vhba* # set qos-policy QosPol5
UCS-A /org/san-connectivity-policy/vhba* # set stats-policy StatsPol2
UCS-A /org/san-connectivity-policy/vhba* # set template-name SanConnPol3
UCS-A /org/san-connectivity-policy/vhba* # set vcon any
UCS-A /org/san-connectivity-policy/vhba* # commit-buffer
UCS-A /org/san-connectivity-policy/vhba #
What to Do Next
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.
Deleting a vHBA from a SAN Connectivity Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-name
Enters organization mode for the specified organization. To enter
the root organization mode, enter
/ as the
org-name.
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.
Creates the specified vHBA initiator in the initiator group.
If desired, repeat this step to add a second vHBA initiator to the group.
Step 5
UCS-A /org/san-connectivity-policy/initiator-group #
set storage-connection-policypolicy-name
Associates the specified storage connection policy with the SAN connectivity policy.
Note
This step assumes that you want to associate an existing storage connection policy to associate with the SAN connectivity policy. If you do, continue with Step 10. If you want to create a local storage definition for this policy instead, continue with Step 6.
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:
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.
Deleting an Initiator Group from a SAN Connectivity Policy
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-name
Enters organization mode for the specified organization. To enter
the root organization mode, enter
/ as the
org-name.
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:
If you delete a SAN connectivity policy that is included in a service profile, you will delete all vHBAs from that service profile and disrupt SAN data traffic for the server associated with the service profile.
Procedure
Command or Action
Purpose
Step 1
UCS-A#
scope orgorg-name
Enters organization mode for the specified organization. To enter
the root organization mode, enter
/ as the
org-name.