Cisco UCS Manager CLI Configuration Guide, Release 1.1(1)
Configuring Port Profiles
Downloads: This chapterpdf (PDF - 464.0KB) The complete bookPDF (PDF - 4.07MB) | Feedback

Configuring Port Profiles

Configuring Port Profiles

This chapter includes the following sections:

Port Profiles

Port profiles contain the properties and settings used to configure virtual interfaces in Cisco UCS for VN-Link in hardware. The port profiles are created and administered in Cisco UCS Manager. There is no clear visibility into the properties of a port profile from VMware vCenter.

In VMware vCenter, a port profile is represented as a port group. Cisco UCS Manager pushes the port profile names to vCenter, which displays the names as port groups. None of the specific networking properties or settings in the port profile are visible in VMware vCenter.

After a port profile is created, assigned to, and actively used by one or more DVSes, any changes made to the networking properties of the port profile in Cisco UCS Manager are immediately applied to those DVSes.

You must configure at least one port profile client for a port profile, if you want Cisco UCS Manager to push the port profile to VMware vCenter.

Port Profile Clients

The port profile client determines the DVSes to which a port profile is applied. By default, the port profile client specifies that the associated port profile applies to all DVSes in the vCenter. However, you can configure the client to apply the port profile to all DVSes in a specific datacenter or datacenter folder, or only to one DVS.

Configuring a Port Profile

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # create port-profile profile-name  

Creates the specified port profile and enters system VM management VMware profile set port profile mode.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set descr description   (Optional)

Provides a description for the port profile.

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 7 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set max-ports max-num  

Specifies the maximum number of ports the port profile can use.

The maximum number of ports that can be associated with a single distributed virtual switch (DVS) is 4096. If the DVS has only one associated port profile, that port profile can be configured with up to 4096 ports. However, if the DVS has more than one associated port profile, the total number of ports associated with all of those port profiles combined cannot exceed 4096.

 
Step 8 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set nw-control-policy policy-name  

Specifies the network control policy to use for the port profile.

 
Step 9 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set pin-group group-name  

Specifies the LAN pin group to use for the port profile.

 
Step 10 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set qos-policy policy-name  

Specifies the QoS policy to use for the port profile.

 
Step 11 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create client client-name  

Creates the specified port profile client and enters system VM management VMware profile set port profile client mode.

 
Step 12 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set descr description   (Optional)

Provides a description for the port profile client.

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 13 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set data-center data-center-name   (Optional)

Specifies the datacenter to which the port profile is applied.

 
Step 14 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set folder folder-name   (Optional)

Specifies the datacenter folder to which the port profile is applied.

 
Step 15 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set dvs folder-name   (Optional)

Specifies the DVS to which the port profile is applied.

 
Step 16 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # commit-buffer  

Commits the transaction.

 

The following example creates a port profile client named MyClient that applies the port profile to all DVSes in the datacenter named MyDatacenter and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware			
UCS-A /system/vm-mgmt/vmware # scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # create port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # set descr "This is my port profile"
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # set max-ports 24
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # set nw-control-policy ncp5
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # set pin-group PinGroup54
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # set qos-policy QosPolicy34
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # create client MyClient
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # set descr "This is the client for my port profile"
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # set data-center MyDatacenter
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # 

Deleting a Port Profile

You cannot delete a port profile if a VM is actively using that port profile.

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # delete port-profile profile-name  

Deletes the specified port profile.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set # commit-buffer  

Commits the transaction.

Cisco UCS Manager deletes the port profile and all associated port profile clients.

 

The following example deletes the port profile named MyProfile and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware			
UCS-A /system/vm-mgmt/vmware # scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # delete port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set # 

Adding a Named VLAN to a Port Profile

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile profile-name  

Enters system VM management VMware profile set port profile mode for the specified port profile.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create vlan vlan-name  

Specifies a named VLAN to use for the port profile.

 
Step 7 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/vlan # set native no   (Optional)

Sets the named VLAN as a non-native VLAN.

 
Step 8 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/vlan # commit-buffer  

Commits the transaction.

 

The following example adds the VLAN named accounting to the port profile named MyProfile, sets the VLAN as non-native, and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware
UCS-A /system/vm-mgmt/vmware# scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create vlan accounting 
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/vlan* # set native no
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/vlan* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/vlan #

Deleting a Named VLAN from a Port Profile

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile profile-name  

Enters system VM management VMware profile set port profile mode for the specified port profile.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete vlan vlan-name  

Deletes the specified named VLAN from the port profile.

 
Step 7 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # commit-buffer  

Commits the transaction.

 

The following example deletes the VLAN named accounting from the port profile named MyProfile and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware
UCS-A /system/vm-mgmt/vmware# scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete vlan accounting 
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile #

Adding a Port Profile Client to a Port Profile

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile profile-name  

Enters system VM management VMware profile set port profile mode for the specified port profile.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create client client-name  

Creates the specified port profile client and enters system VM management VMware profile set port profile client mode.

The port profile client determines the DVSes to which the port profile is applied. By default, a port profile applies to all DVSes in the vCenter; however, you can use the optional set data-center, set folder, and set dvs commands to apply the port profile to all DVSes in a specific datacenter or datacenter folder, or to a specific DVS.

 
Step 7 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set descr description   (Optional)

Provides a description for the port profile client.

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 8 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set data-center data-center-name   (Optional)

Specifies the datacenter to which the port profile is applied.

 
Step 9 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set folder folder-name   (Optional)

Specifies the datacenter folder to which the port profile is applied.

 
Step 10 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # set dvs folder-name   (Optional)

Specifies the DVS to which the port profile is applied.

 
Step 11 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # commit-buffer  

Commits the transaction.

 

The following example creates a port profile client named OtherClient that applies the port profile named MyProfile to all DVSes in the datacenter named OtherDatacenter and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware			
UCS-A /system/vm-mgmt/vmware # scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create client OtherClient
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # set descr "This is my other client for my port profile"
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # set data-center OtherDatacenter
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile/client # 

Deleting a Port Profile Client from a Port Profile

You cannot delete a port profile client if a VM is actively using the port profile with which the client is associated.

Procedure
  Command or Action Purpose
Step 1 UCS-A# scope system  

Enters system mode.

 
Step 2 UCS-A /system # scope vm-mgmt  

Enters system VM management mode.

 
Step 3 UCS-A /system/vm-mgmt # scope vmware  

Enters system VM management VMware mode.

 
Step 4 UCS-A /system/vm-mgmt/vmware # scope profile-set  

Enters system VM management VMware profile set mode.

 
Step 5 UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile profile-name  

Enters system VM management VMware profile set port profile mode for the specified port profile.

 
Step 6 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete client client-name  

Deletes the specified port profile client.

 
Step 7 UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # commit-buffer  

Commits the transaction.

 

The following example deletes the port profile client named OtherClient from the port profile named MyProfile and commits the transaction:

UCS-A# scope system
UCS-A /system # scope vm-mgmt
UCS-A /system/vm-mgmt # scope vmware			
UCS-A /system/vm-mgmt/vmware # scope profile-set
UCS-A /system/vm-mgmt/vmware/profile-set # scope port-profile MyProfile
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete client OtherClient
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile #