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 must include this policy in a service profile for it to take effect.
Configuring a vHBA Template
Procedure
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 vhba-templ vhba-templ-name [fabric {a | b}] [fc-if vsan-name] |
Creates a vHBA template and enters organization vHBA template mode. |
Step 4 |
(Optional) UCSC(policy-mgr) /org/vhba-templ # set descr description |
(Optional)
Provides a description for the vHBA template. |
Step 5 |
(Optional) UCSC(policy-mgr) /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 6 |
(Optional) UCSC(policy-mgr) /org/vhba-templ # set fc-if vsan-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 7 |
UCSC(policy-mgr) /org/vhba-templ # set max-field-size size-num |
Specifies the maximum size of the Fibre Channel frame payload (in bytes) that the vHBA supports. |
Step 8 |
UCSC(policy-mgr) /org/vhba-templ # set pin-group group-name |
Specifies the pin group to use for the vHBA template. |
Step 9 |
UCSC(policy-mgr) /org/vhba-templ # set qos-policy mac-pool-name |
Specifies the QoS policy to use for the vHBA template. |
Step 10 |
UCSC(policy-mgr) /org/vhba-templ # set stats-policy policy-name |
Specifies the server and server component statistics threshold policy to use for the vHBA template. |
Step 11 |
UCSC(policy-mgr) /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 instances are updated when the vHBA template is updated. |
Step 12 |
UCSC(policy-mgr) /org/vhba-templ # set wwpn-pool pool-name |
Specifies the WWPN pool to use for the vHBA template. |
Step 13 |
UCSC(policy-mgr) /org/vhba-templ # commit-buffer |
Commits the transaction to the system configuration. |
Example
The following example configures a vHBA template and commits the transaction:
UCSC# connect policy-mgr
UCSC(policy-mgr)# scope org /
UCSC(policy-mgr) /org* # create vhba template VhbaTempFoo
UCSC(policy-mgr) /org/vhba-templ* # set descr "This is a vHBA template example."
UCSC(policy-mgr) /org/vhba-templ* # set fabric a
UCSC(policy-mgr) /org/vhba-templ* # set fc-if accounting
UCSC(policy-mgr) /org/vhba-templ* # set max-field-size 2112
UCSC(policy-mgr) /org/vhba-templ* # set pin-group FcPinGroup12
UCSC(policy-mgr) /org/vhba-templ* # set qos-policy policy34foo
UCSC(policy-mgr) /org/vhba-templ* # set stats-policy ServStatsPolicy
UCSC(policy-mgr) /org/vhba-templ* # set type updating-template
UCSC(policy-mgr) /org/vhba-templ* # set wwpn-pool SanPool7
UCSC(policy-mgr) /org/vhba-templ* # commit-buffer
UCSC(policy-mgr) /org/vhba-templ #
Deleting a vHBA Template
Procedure
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 vhba-templ vhba-templ-name |
Deletes the specified vHBA template. |
Step 4 |
UCSC(policy-mgr) /org # commit-buffer |
Commits the transaction to the system configuration. |
Example
The following example deletes the vHBA template named VhbaTempFoo and commits the transaction:
UCSC# connect policy-mgr
UCSC(policy-mgr)# scope org /
UCSC(policy-mgr) /org # delete vhba template VhbaTempFoo
UCSC(policy-mgr) /org* # commit-buffer
UCSC(policy-mgr) /org #
Default vHBA Behavior Policy
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— 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, 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 |
UCSC# connect policy-mgr |
Enters policy manager mode. |
Step 2 |
UCSC(policy-mgr)# scope org / |
Enters the root organization mode. |
Step 3 |
UCSC(policy-mgr)/org # scope vhba-beh-policy |
Enters default vHBA behavior policy mode. |
Step 4 |
UCSC(policy-mgr)/org/vhba-beh-policy # set action {hw-inherit [template_name name] | none} |
Specifies the default vHBA behavior policy. This can be one of the following:
|
Step 5 |
UCSC(policy-mgr)/org/vhba-beh-policy # commit-buffer |
Commits the transaction to the system configuration. |
Example
This example shows how to set the default vHBA behavior policy to hw-inherit .
UCSC# connect policy-mgr
UCSC(policy-mgr) # scope org /
UCSC(policy-mgr)/org # scope vhba-beh-policy
UCSC(policy-mgr)/org/vhba-beh-policy # set action hw-inherit
UCSC(policy-mgr)/org/vhba-beh-policy* # commit-buffer
UCSC(policy-mgr)/org/vhba-beh-policy #