- Preface
-
- Configuring the Fabric Interconnects
- Configuring Ports and Port Channels
- Configuring Communication Services
- Configuring Authentication
- Configuring Organizations
- Configuring Role-Based Access Control
- Configuring DNS Servers
- Configuring System-Related Policies
- Managing Licenses
- Managing Virtual Interfaces
- Registering Cisco UCS Domains with Cisco UCS Central
- Index
Cisco UCS Manager CLI Configuration Guide, Release 2.1
- Updated:
- November 23, 2017
Chapter: Configuring Server-Related Pools
Contents
- Configuring Server-Related Pools
- Server Pool Configuration
- Server Pools
- Creating a Server Pool
- Deleting a Server Pool
- UUID Suffix Pool Configuration
- UUID Suffix Pools
- Creating a UUID Suffix Pool
- Deleting a UUID Suffix Pool
- IP Pool Configuration
- IP Pools
- Creating an IP Pool
- Adding a Block to an IP Pool
- Deleting a Block from an IP Pool
- Deleting an IP Pool
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 multitenancy 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
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
| Command or Action | Purpose | |
|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
| Step 2 | UCS-A /org # delete server-pool server-pool-name |
Deletes the specified server pool. |
| Step 3 | UCS-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
| Command or Action | Purpose | |||
|---|---|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. | ||
| Step 2 | UCS-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 3 | UCS-A /org/uuid-suffix-pool # set descr description | (Optional)
Provides a description for the UUID suffix pool.
| ||
| Step 4 | UCS-A /org/uuid-suffix-pool # set assignmentorder {default | sequential} | This can be one of the following: | ||
| Step 5 | UCS-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.
| ||
| Step 6 | UCS-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 #
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:
| Command or Action | Purpose | |
|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. |
| Step 2 | UCS-A /org # delete uuid-suffix-pool pool-name |
Deletes the specified UUID suffix pool. |
| Step 3 | UCS-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
| Command or Action | Purpose | |||
|---|---|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. | ||
| Step 2 | UCS-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 3 | UCS-A /org/ip-pool # set descr description | (Optional)
Provides a description for the IP pool.
| ||
| Step 4 | UCS-A /org/ip-pool # set assignmentorder {default | sequential} | This can be one of the following: | ||
| Step 5 | UCS-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.
| ||
| Step 6 | UCS-A /org/ip-pool/block # set primary-dns ip-address secondary-dns ip-address | Specifies the primary DNS and secondary DNS IP addresses. | ||
| Step 7 | UCS-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 #
Include the IP pool in a service profile and/or template.
Adding a Block to an IP Pool
| Command or Action | Purpose | |||
|---|---|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. | ||
| Step 2 | UCS-A /org # scope ip-pool pool-name |
Enters organization IP pool mode for the specified pool. | ||
| Step 3 | UCS-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.
| ||
| Step 4 | UCS-A /org/ip-pool/block # set primary-dns ip-address secondary-dns ip-address | Specifies the primary DNS and secondary DNS IP addresses. | ||
| Step 5 | UCS-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:
| Command or Action | Purpose | |
|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. |
| Step 2 | UCS-A /org # scope ip-pool pool-name |
Enters organization IP pool mode for the specified pool. |
| Step 3 | UCS-A /org/ip-pool # delete block first-ip-addr last-ip-addr |
Deletes the specified block (range) of IP addresses. |
| Step 4 | UCS-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:
| Command or Action | Purpose | |
|---|---|---|
| Step 1 | UCS-A# scope org org-name |
Enters organization mode for the specified organization. To enter the root organization mode, enter / as the org-name. |
| Step 2 | UCS-A /org # delete ip-pool pool-name |
Deletes the specified IP pool. |
| Step 3 | UCS-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 #