Configuring Port Profiles
This chapter includes the following sections:
- Port Profiles
- Port Profile Clients
- Configuring a Port Profile
- Deleting a Port Profile
- Adding a Named VLAN to a Port Profile
- Deleting a Named VLAN from a Port Profile
- Adding a Port Profile Client to a Port Profile
- Deleting a Port Profile Client from a Port Profile
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
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.
|
||
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.
|
||
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.
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
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
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
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.
|
||
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.
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 #