Cisco UCS Manager CLI Configuration Guide, Release 2.1
Configuring Server-Related Pools
Download this chapter
Configuring Server-Related PoolsConfiguring Server-Related Pools
Download the complete book
Cisco UCS Manager CLI Configuration Guide, Release 2.1Cisco UCS Manager CLI Configuration Guide, Release 2.1 (PDF - 8 MB)
 Feedback

Configuring Server-Related Pools

This chapter includes the following sections:

Server Pool Configuration

Server Pools

A server pool contains a set of servers. These servers typically share the same characteristics. Those characteristics can be their location in the chassis, or an attribute such as server type, amount of memory, local storage, type of CPU, or local drive configuration. You can manually assign a server to a server pool, or use server pool policies and server pool policy qualifications to automate the assignment.

If your system implements multi-tenancy through organizations, you can designate one or more server pools to be used by a specific organization. For example, a pool that includes all servers with two CPUs could be assigned to the Marketing organization, while all servers with 64 GB memory could be assigned to the Finance organization.

A server pool can include servers from any chassis in the system. A given server can belong to multiple server pools.

Creating a Server Pool

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 server-pool server-pool-name  

    Creates a server pool with the specified name, and enters organization server pool mode.

     
    Step 3UCS-A /org/server-pool # create server chassis-num/slot-num  

    Creates a server for the server pool.

    Note   

    A server pool can contain more than one server. To create multiple servers for the pool, you must enter multiple create server commands from organization server pool mode.

     
    Step 4UCS-A /org/server-pool # commit-buffer  

    Commits the transaction to the system configuration.

     

    The following example shows how to create a server pool named ServPool2, create two servers for the server pool, and commit the transaction:

    UCS-A# scope org /
UCS-A /org # create server-pool ServPool2
UCS-A /org/server-pool* # create server 1/1
UCS-A /org/server-pool* # create server 1/4
UCS-A /org/server-pool* # commit-buffer
UCS-A /org/server-pool #

    Deleting a Server Pool

    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 server-pool server-pool-name  

      Deletes the specified server pool.

       
      Step 3UCS-A /org # commit-buffer  

      Commits the transaction to the system configuration.

       

      The following example shows how to delete the server pool named ServPool2 and commit the transaction:

      UCS-A# scope org /
UCS-A /org # delete server-pool ServPool2
UCS-A /org* # commit-buffer
UCS-A /org #

      UUID Suffix Pool Configuration

      UUID Suffix Pools

      A UUID suffix pool is a collection of SMBIOS UUIDs that are available to be assigned to servers. The first number of digits that constitute the prefix of the UUID are fixed. The remaining digits, the UUID suffix, are variable. A UUID suffix pool ensures that these variable values are unique for each server associated with a service profile which uses that particular pool to avoid conflicts.

      If you use UUID suffix pools in service profiles, you do not have to manually configure the UUID of the server associated with the service profile.

      Creating a UUID Suffix Pool

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

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

         
        Step 2UCS-A /org # create uuid-suffix-pool pool-name  

        Creates a UUID suffix pool with the specified pool name and enters organization UUID suffix pool mode.

        This name can be between 1 and 32 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), _ (underscore), : (colon), and . (period), and you cannot change this name after the object has been saved.

         
        Step 3UCS-A /org/uuid-suffix-pool # set descr description   (Optional)

        Provides a description for the UUID suffix pool.

        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 4UCS-A /org/uuid-suffix-pool # set assignmentorder {default | sequential} 

        This can be one of the following:

        • default—Cisco UCS Manager selects a random identity from the pool.
        • sequential—Cisco UCS Manager selects the lowest available identity from the pool.
         
        Step 5UCS-A /org/uuid-suffix-pool # create block first-uuid last-uuid  

        Creates a block (range) of UUID suffixes, and enters organization UUID suffix pool block mode. You must specify the first and last UUID suffixes in the block using the form nnnn-nnnnnnnnnnnn, with the UUID suffixes separated by a space.

        Note   

        A UUID suffix pool can contain more than one UUID suffix block. To create multiple blocks, you must enter multiple create block commands from organization UUID suffix pool mode.

         
        Step 6UCS-A /org/uuid-suffix-pool/block # commit-buffer  

        Commits the transaction to the system configuration.

         

        The following example shows how to create a UUID suffix pool named pool4, provide a description for the pool, specify a block of UUID suffixes to be used for the pool, and commit the transaction: 

        UCS-A# scope org /
UCS-A /org # create uuid-suffix-pool pool4
UCS-A /org/uuid-suffix-pool* # set descr "This is UUID suffix pool 4"
UCS-A /org/uuid-suffix-pool* # create block 1000-000000000001 1000-000000000010
UCS-A /org/uuid-suffix-pool/block* # commit-buffer
UCS-A /org/uuid-suffix-pool/block #
        What to Do Next

        Include the UUID suffix pool in a service profile and/or template.

        Deleting a UUID Suffix Pool

        If you delete a pool, Cisco UCS Manager does not reallocate any addresses from that pool that have been assigned to vNICs or vHBAs. All assigned addresses from a deleted pool remain with the vNIC or vHBA to which they are assigned until one of the following occurs:

        • The associated service profiles are deleted.
        • The vNIC or vHBA to which the address is assigned is deleted.
        • The vNIC or vHBA is assigned to a different pool.
        Procedure
           Command or ActionPurpose
          Step 1UCS-A# scope org org-name 

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

           
          Step 2UCS-A /org # delete uuid-suffix-pool pool-name  

          Deletes the specified UUID suffix pool.

           
          Step 3UCS-A /org # commit-buffer  

          Commits the transaction to the system configuration.

           

          The following example shows how to delete the UUID suffix pool named pool4 and commit the transaction:

          UCS-A# scope org /
UCS-A /org # delete uuid-suffix-pool pool4
UCS-A /org* # commit-buffer
UCS-A /org #

          IP Pool Configuration

          IP Pools

          IP pools are a collection of IP addresses that do not have a default purpose. You can create IP pools in Cisco UCS Manager to do the following:

          • Replace the default iSCSI boot IP pool iscsi-initiator-pool. Cisco UCS Manager reserves each block of IP addresses in the IP pool that you specify.
          • Replace the default management IP pool ext-mgmt for servers that have an associated service profile. Cisco UCS Manager reserves each block of IP addresses in the IP pool for external access that terminates in the Cisco Integrated Management Controller (CIMC) on a server. If there is no associated service profile, you must use the ext-mgmt IP pool for the CIMC to get an IP address.
          • Replace both the management IP address and iSCSI boot IP addresses.

          Note

          The IP pool must not contain any IP addresses that have been assigned as static IP addresses for a server or service profile.

          Creating an IP Pool

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

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

             
            Step 2UCS-A /org # create ip-pool pool-name  

            Creates an IP pool with the specified name, and enters organization IP pool mode.

            This name can be between 1 and 32 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), _ (underscore), : (colon), and . (period), and you cannot change this name after the object has been saved.

             
            Step 3UCS-A /org/ip-pool # set descr description   (Optional)

            Provides a description for the IP pool.

            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 4UCS-A /org/ip-pool # set assignmentorder {default | sequential} 

            This can be one of the following:

            • default—Cisco UCS Manager selects a random identity from the pool.
            • sequential—Cisco UCS Manager selects the lowest available identity from the pool.
             
            Step 5UCS-A /org/ip-pool # create block first-ip-addr last-ip-addr gateway-ip-addr subnet-mask 

            Creates a block (range) of IP addresses, and enters organization IP pool block mode. You must specify the first and last IP addresses in the address range, the gateway IP address, and subnet mask.

            Note   

            An IP pool can contain more than one IP block. To create multiple blocks, enter multiple create block commands from organization IP pool mode.

             
            Step 6UCS-A /org/ip-pool/block # set primary-dns ip-address secondary-dns ip-address 

            Specifies the primary DNS and secondary DNS IP addresses.

             
            Step 7UCS-A /org/ip-pool/block # commit-buffer  

            Commits the transaction to the system configuration.

             

            The following example shows how to create an IP pool named Pool1, provide a description for the pool, specify a block of IP addresses and a primary and secondary IP address to be used for the pool, and commit the transaction: 

            UCS-A# scope org /
UCS-A /org # create ip-pool Pool1
UCS-A /org/ip-pool* # set descr "This is IP pool Pool1"
UCS-A /org/ip-pool* # create block 192.168.100.1 192.168.100.200 192.168.100.10 255.255.255.0
UCS-A /org/ip-pool/block* # set primary-dns 192.168.100.1 secondary-dns 192.168.100.20
UCS-A /org/ip-pool/block* # commit-buffer
UCS-A /org/ip-pool/block #
            What to Do Next

            Include the IP pool in a service profile and/or template.

            Adding a Block to an IP Pool

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

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

               
              Step 2UCS-A /org # scope ip-pool pool-name  

              Enters organization IP pool mode for the specified pool.

               
              Step 3UCS-A /org/ip-pool # create block first-ip-addr last-ip-addr gateway-ip-addr subnet-mask 

              Creates a block (range) of IP addresses, and enters organization IP pool block mode. You must specify the first and last IP addresses in the address range, the gateway IP address, and subnet mask.

              Note   

              An IP pool can contain more than one IP block. To create multiple blocks, enter multiple create block commands from organization IP pool mode.

               
              Step 4UCS-A /org/ip-pool/block # set primary-dns ip-address secondary-dns ip-address 

              Specifies the primary DNS and secondary DNS IP addresses.

               
              Step 5UCS-A /org/ip-pool/block # commit-buffer  

              Commits the transaction to the system configuration.

               

              This example shows how to add a block of IP addresses to an IP pool named pool4 and commit the transaction: 

              UCS-A# scope org /
UCS-A /org # scope ip-pool pool4
UCS-A /org/ip-pool # create block 192.168.100.1 192.168.100.200 192.168.100.10 255.255.255.0
UCS-A /org/ip-pool/block* # commit-buffer
UCS-A /org/ip-pool/block #

              Deleting a Block from an IP Pool

              If you delete an address block from a pool, Cisco UCS Manager does not reallocate any addresses in that block that have been assigned to vNICs or vHBAs. All assigned addresses from a deleted block remain with the vNIC or vHBA to which they are assigned until one of the following occurs:

              • The associated service profiles are deleted.
              • The vNIC or vHBA to which the address is assigned is deleted.
              • The vNIC or vHBA is assigned to a different pool.
              Procedure
                 Command or ActionPurpose
                Step 1UCS-A# scope org org-name 

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

                 
                Step 2UCS-A /org # scope ip-pool pool-name  

                Enters organization IP pool mode for the specified pool.

                 
                Step 3UCS-A /org/ip-pool # delete block first-ip-addr last-ip-addr  

                Deletes the specified block (range) of IP addresses.

                 
                Step 4UCS-A /org/ip-pool # commit-buffer  

                Commits the transaction to the system configuration.

                 

                This example shows how to delete an IP address bock from an IP pool named pool4 and commit the transaction: 

                UCS-A# scope org /
UCS-A /org # scope ip-pool pool4
UCS-A /org/ip-pool # delete block 192.168.100.1 192.168.100.200
UCS-A /org/ip-pool* # commit-buffer
UCS-A /org/ip-pool #

                Deleting an IP Pool

                If you delete a pool, Cisco UCS Manager does not reallocate any addresses from that pool that have been assigned to vNICs or vHBAs. All assigned addresses from a deleted pool remain with the vNIC or vHBA to which they are assigned until one of the following occurs:

                • The associated service profiles are deleted.
                • The vNIC or vHBA to which the address is assigned is deleted.
                • The vNIC or vHBA is assigned to a different pool.
                Procedure
                   Command or ActionPurpose
                  Step 1UCS-A# scope org org-name 

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

                   
                  Step 2UCS-A /org # delete ip-pool pool-name  

                  Deletes the specified IP pool.

                   
                  Step 3UCS-A /org # commit-buffer  

                  Commits the transaction to the system configuration.

                   

                  The following example shows how to delete the IP pool named pool4 and commit the transaction:

                  UCS-A# scope org /
UCS-A /org # delete ip-pool pool4
UCS-A /org* # commit-buffer
UCS-A /org #