Configuring Port Profiles

This chapter includes the following sections:

Port Profiles

Port profiles contain the properties and settings that you can use to configure virtual interfaces in Cisco UCS for VM-FEX. The port profiles are created and administered in Cisco UCS Manager. 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.

In VMware vCenter, a port profile is represented as a port group. Cisco UCS Manager pushes the port profile names to VMware 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. 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.

Creating a Port Profile

Procedure
     Command or ActionPurpose
    Step 1UCS-A# scope system  

    Enters system mode.

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

    Enters system VM management mode.

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

    Enters VMware mode.

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

    Enters system VM management VMware profile set mode.

     
    Step 5UCS-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 6UCS-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 do not appear in the description field of any show command output.

     
    Step 7UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set host-nwio-perf {high-performance | none}  
    You can choose one of the following options:

    • high-performance

    • none

     
    Step 8UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # set max-ports max-num  

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

    The maximum number of ports that can be associated to a port profile is 4096. The default is 64 ports. If the DVS has more than one associated port profile, each port profile client can be set to use a maximum of 4096 ports.

     
    Step 9UCS-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 10UCS-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 11UCS-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 12UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # commit-buffer  

    Commits the transaction.

     

    The following example shows how to create and configure a port profile named MyProfile and commit 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 host-nwio-perf high-performance
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* # commit-buffer
UCS-A /system/vm-mgmt/vmware/profile-set/port-profile #
    What to Do Next

    Add a port profile client to the port profile.

    Deleting a Port Profile

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

    Procedure
       Command or ActionPurpose
      Step 1UCS-A# scope system  

      Enters system mode.

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

      Enters system VM management mode.

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

      Enters VMware mode.

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

      Enters system VM management VMware profile set mode.

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

      Deletes the specified port profile and its associations.

       
      Step 6UCS-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 shows how to delete the port profile named MyProfile and commit 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 VLAN to a Port Profile

      Procedure
         Command or ActionPurpose
        Step 1UCS-A# scope system  

        Enters system mode.

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

        Enters system VM management mode.

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

        Enters VMware mode.

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

        Enters system VM management VMware profile set mode.

         
        Step 5UCS-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 6UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # create vlan vlan-name  

        Specifies a VLAN to use for the port profile.

        Note   

        You can create multiple VLANs for guest VLAN trunking.

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

        Sets the default-net VLAN as the native VLAN in UCS Manager.

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

        Commits the transaction.

         

        The following example shows how to add the VLAN named accounting to the port profile named MyProfile, set the VLAN as non-native, and commit 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 default-net 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 VLAN from a Port Profile

        Procedure
           Command or ActionPurpose
          Step 1UCS-A# scope system  

          Enters system mode.

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

          Enters system VM management mode.

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

          Enters VMware mode.

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

          Enters system VM management VMware profile set mode.

           
          Step 5UCS-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 6UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete vlan vlan-name  

          Deletes the specified VLAN from the port profile.

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

          Commits the transaction.

           

          The following example shows how to delete the VLAN named accounting from the port profile named MyProfile and commit 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 #

          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 VMware 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.

          Adding a Port Profile Client to a Port Profile

          Procedure
             Command or ActionPurpose
            Step 1UCS-A# scope system  

            Enters system mode.

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

            Enters system VM management mode.

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

            Enters VMware mode.

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

            Enters system VM management VMware profile set mode.

             
            Step 5UCS-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 6UCS-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, datacenter folder, or to a specific DVS.

             
            Step 7UCS-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 do not appear in the description field of any show command output.

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

            Specifies the DVS to which the port profile is applied.

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

            Commits the transaction.

             

            The following example shows how to create a port profile client named OtherClient that applies the port profile named MyProfile to all DVSes in the datacenter named OtherDatacenter and commit 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 MyClient
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 ActionPurpose
              Step 1UCS-A# scope system  

              Enters system mode.

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

              Enters system VM management mode.

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

              Enters VMware mode.

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

              Enters system VM management VMware profile set mode.

               
              Step 5UCS-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 6UCS-A /system/vm-mgmt/vmware/profile-set/port-profile # delete client client-name  

              Deletes the specified port profile client.

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

              Commits the transaction.

               

              The following example shows how to delete the port profile client named OtherClient from the port profile named MyProfile and commit 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 #