Contents
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
Procedure | 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 # create server-pool
server-pool-name
|
Creates a server pool with the specified name, and enters organization server pool mode.
|
Step 3 | UCS-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 4 | UCS-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 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
Procedure | 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.
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 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.
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 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 #
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 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
Procedure | 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.
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 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.
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 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 #
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 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.
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 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:
-
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 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:
-
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 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 #