Cisco UCS Manager CLI Configuration Guide, Release 1.0(2)
Configuring Network-Related Policies
Download this chapter
Configuring Network-Related PoliciesConfiguring Network-Related Policies
Download the complete book
CLI_Config_Guide_1.0.2.pdfCLI_Config_Guide_1.0.2.pdf (PDF - 3 MB)
 Feedback

Configuring Network-Related Policies

This chapter includes the following sections:

Configuring vNIC Templates

vNIC Template

This policy defines how a vNIC on a server connects to the LAN. This policy is also referred to as a vNIC LAN connectivity policy.

You need to include this policy in a service profile for it to take effect.

Configuring a vNIC Template

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org org-name  

Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name.

 
Step 2UCS-A /org # create vnic-templ vnic-templ-name [eth-if vlan-name] [fabric {a | b}] [target [adapter | vm]]  

Creates a vNIC template and enters organization vNIC template mode.

 
Step 3UCS-A /org/vnic-templ # set descr description   (Optional)

Provides a description for the vNIC template.

 
Step 4UCS-A /org/vnic-templ # set fabric {a | b}   (Optional)

Specifies the fabric to use for the vNIC. If you did not specify the fabric when creating the vNIC template in Step 2, then you have the option to specify it with this command.

 
Step 5UCS-A /org/vnic-templ # set mac-pool mac-pool-name  

Specifies the MAC pool to use for the vNIC.

 
Step 6UCS-A /org/vnic-templ # set nw-control-policy policy-name  

Specifies the network control policy to use for the vNIC.

 
Step 7UCS-A /org/vnic-templ # set pin-group group-name  

Specifies the LAN pin group to use for the vNIC.

 
Step 8UCS-A /org/vnic-templ # set qos-policy policy-name  

Specifies the QoS policy to use for the vNIC.

 
Step 9UCS-A /org/vnic-templ # set stats-policy policy-name  

Specifies the server and server component statistics threshold policy to use for the vNIC.

 
Step 10UCS-A /org/vnic-templ # set type {initial-template | updating-template}  

Specifies the vNIC template update type. If you do not want vNIC 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 vNIC instance are updated when the vNIC template is updated.

 
Step 11UCS-A /org/vnic-templ # commit-buffer  

Commits the transaction to the system configuration.

 

The following example configures a vNIC template and commits the transaction: 

UCS-A# scope org /
UCS-A /org* # create vnic template VnicTempFoo
UCS-A /org/vnic-templ* # set descr "This is a vNIC template example."
UCS-A /org/vnic-templ* # set fabric a
UCS-A /org/vnic-templ* # set mac-pool pool137
UCS-A /org/vnic-templ* # set nw-control-policy ncp5
UCS-A /org/vnic-templ* # set pin-group PinGroup54
UCS-A /org/vnic-templ* # set stats-policy ServStatsPolicy
UCS-A /org/vnic-templ* # set type updating-template
UCS-A /org/vnic-templ* # commit-buffer
UCS-A /org/vnic-templ #

Deleting a vNIC Template

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org org-name  

Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name.

 
Step 2UCS-A /org # delete vnic-templ vnic-templ-name  

Deletes the specified vNIC template.

 
Step 3UCS-A /org # commit-buffer  

Commits the transaction to the system configuration.

 

The following example deletes the vNIC template named VnicTempFoo and commits the transaction: 

UCS-A# scope org /
UCS-A /org* # delete vnic template VnicTempFoo
UCS-A /org* # commit-buffer
UCS-A /org #

Configuring Ethernet 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 an Ethernet Adapter Policy

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org org-name  

Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name.

 
Step 2UCS-A /org # create eth-policy policy-name  

Creates the specified Ethernet adapter policy and enters organization Ethernet profile mode.

 
Step 3UCS-A /org/eth-policy # set comp-queue count count   (Optional)

Configures the Ethernet completion queue profile.

 
Step 4UCS-A /org/eth-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 5UCS-A /org/eth-policy # set ext-ipv6-rss-hash {ip-hash {disabled | enabled} | tcp-hash {disabled | enabled}}   (Optional)

Configures the external IPv6 RSS hash profile.

 
Step 6UCS-A /org/eth-policy # set failover timeout timeout-sec   (Optional)

Configures the Ethernet failover profile.

 
Step 7UCS-A /org/eth-policy # set interrupt {coalescing-time sec | coalescing-type {idle | min} | count count}   (Optional)

Configures the Ethernet interrupt profile.

 
Step 8UCS-A /org/eth-policy # set ipv4-rss-hash {ip-hash {disabled | enabled} | tcp-hash {disabled | enabled}}   (Optional)

Configures the IPv4 RSS hash profile.

 
Step 9UCS-A /org/eth-policy # set ipv6-rss-hash {ip-hash {disabled | enabled} | tcp-hash {disabled | enabled}}   (Optional)

Configures the IPv6 RSS hash profile.

 
Step 10UCS-A /org/eth-policy # set offload {large-receive | tcp-rx-checksum | tcp-segment | tcp-tx-checksum} {disabled | enabled}   (Optional)

Configures the Ethernet offload profile.

 
Step 11UCS-A /org/eth-policy # set recv-queue {count count | ring-size size-num}   (Optional)

Configures the Ethernet receive queue profile.

 
Step 12UCS-A /org/eth-policy # set rss receivesidescaling {disabled | enabled}   (Optional)

Configures the RSS profile.

 
Step 13UCS-A /org/rth-profile # set work-queue {count count | ring-size size-num}   (Optional)

Configures the Ethernet work queue profile.

 
Step 14UCS-A /org/eth-policy # commit-buffer  

Commits the transaction to the system configuration.

 

The following example configures an Ethernet adapter policy: 

UCS-A# scope org /
UCS-A /org* # create eth-policy EthPolicy19
UCS-A /org/eth-policy* # set comp-queue count 16
UCS-A /org/eth-policy* # set descr "This is an Ethernet adapter policy example."
UCS-A /org/eth-policy* # set ext-ipv6-rss-hash ip-hash disabled
UCS-A /org/eth-policy* # set failover timeout 300
UCS-A /org/eth-policy* # set interrupt count 64
UCS-A /org/eth-policy* # set ipv4-rss-hash ip-hash disabled
UCS-A /org/eth-policy* # set ipv6-rss-hash ip-hash disabled
UCS-A /org/eth-policy* # set offload large-receive disabled
UCS-A /org/eth-policy* # set recv-queue count 32
UCS-A /org/eth-policy* # set rss receivesidescaling enabled
UCS-A /org/eth-policy* # set work-queue
UCS-A /org/eth-policy* # commit-buffer
UCS-A /org/eth-policy #

Deleting an Ethernet Adapter Policy

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org org-name  

Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name.

 
Step 2UCS-A /org # delete eth-policy policy-name  

Deletes the specified Ethernet adapter policy.

 
Step 3UCS-A /org # commit-buffer  

Commits the transaction to the system configuration.

 

The following example deletes the Ethernet adapter policy named EthPolicy19: 

UCS-A# scope org /
UCS-A /org* # delete eth-policy EthPolicy19
UCS-A /org* # commit-buffer
UCS-A /org #

Configuring Network Control Policies

Network Control Policy

This policy configures the network control settings for the Cisco UCS instance, including the following:


  • Whether the Cisco Discovery Protocol (CDP) is enabled or disabled

  • How the VIF behaves if no uplink port is available in end-host mode

Configuring a Network Control Policy

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org /  

Enters the root organization mode.

 
Step 2UCS-A /org # create nwctrl-policy policy-name  

Creates a network control policy with the specified policy name, and enters organization network control policy mode.

 
Step 3UCS-A /org/nwctrl-policy # {disable | enable} cdp  

Disables or enables Cisco Discovery Protocol (CDP).

 
Step 4UCS-A /org/nwctrl-policy # set uplink-fail-action {link-down | warning}  

Specifies the action to be taken when no uplink port is available in end-host mode.

Use the link-down keyword to change the operational state of a vNIC to down when uplink connectivity is lost on the fabric interconnect, and facilitate fabric failover for vNICs. Use the warning keyword to maintain server-to-server connectivity even when no uplink port is available, and disable fabric failover when uplink connectivity is lost on the fabric interconnect. The default uplink failure action is link-down.

 
Step 5UCS-A /org/nwctrl-policy # commit-buffer  

Commits the transaction to the system configuration.

 

The following example creates a network control policy named ncp5, enables CDP, sets the uplink fail action to link-down, and commits the transaction:

UCS-A# scope org /
UCS-A /org # create nwctrl-policy ncp5
UCS-A /org/nwctrl-policy* # enable cdp
UCS-A /org/nwctrl-policy* # set uplink-fail-action link-down   
UCS-A /org/nwctrl-policy* # commit-buffer
UCS-A /org/nwctrl-policy #

Deleting a Network Control Policy

Procedure
 Command or ActionPurpose
Step 1UCS-A# scope org /  

Enters the root organization mode.

 
Step 2UCS-A /org # delete nwctrl-policy policy-name  

Deletes the specified network control policy.

 
Step 3UCS-A /org # commit-buffer  

Commits the transaction to the system configuration.

 

The following example deletes the network control policy named ncp5:

UCS-A# scope org /
UCS-A /org # delete nwctrl-policy ncp5
UCS-A /org* # commit-buffer
UCS-A /org #