Cisco UCS Manager CLI Configuration Guide, Release 1.4
Configuring Port Profiles
Downloads: This chapterpdf (PDF - 481.0KB) The complete bookPDF (PDF - 7.24MB) | The complete bookePub (ePub - 1.16MB) | 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 #