Configuring Server-Related Pools
This chapter includes the following sections:
Configuring IP Pools
IP Pools
IP pools are a collection of IP addresses. You can use IP pools in Cisco UCS Central in one of the following ways:
- For external management of Cisco UCS Manager servers.
- For iSCSI boot initiators.
- For both external management and iSCSI boot initiators in Cisco UCS Manager.
Note |
The IP pool must not contain any IP addresses that have been assigned as static IP addresses for a server or service profile. |
A fault is raised if the same IP address is assigned to two different Cisco UCS domains. If you want to use the same IP addresses, you can use the scope property to specify whether the IP addresses in the block are public or private:
- public—The IP addresses in the block can be assigned to one and only one registered Cisco UCS domain.
- private— The IP addresses in the block can be assigned to multiple Cisco UCS domains.
Cisco UCS Central creates public IP pools by default.
Global IP pools should be used for similar geographic locations. If the IP addressing schemes are different, the same IP pool can not be used for those sites.
Creating an IP Pool
The following example shows how to create an IP pool named GPool1, 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, set the pool to private, and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # create ip-pool GPool1 UCSC(policy-mgr) /org/ip-pool* # set descr "This is IP pool GPool1" UCSC(policy-mgr) /org/ip-pool* # create block 192.168.100.1 192.168.100.200 192.168.100.10 255.255.255.0 UCSC(policy-mgr) /org/ip-pool/block* # set primdns 192.168.100.1 secdns 192.168.100.20 UCSC(policy-mgr) /org/ip-pool/block* # set scope private UCSC(policy-mgr) /org/ip-pool/block* # commit-buffer UCSC(policy-mgr) /org/ip-pool/block #
Include the IP pool in a service profile and/or template.
Deleting an IP Pool
If you delete a pool, Cisco UCS Central does not reallocate any addresses from that pool that have been assigned to vNICs or vHBAs in Cisco UCS Manager. 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 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 3 | UCSC(policy-mgr) /org # delete ip-pool pool-name | Deletes the specified IP pool. |
||
Step 4 | UCSC(policy-mgr) /org # commit-buffer | Commits the transaction to the system configuration.
|
The following example shows how to delete the IP pool named GPool1 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # delete ip-pool GPool1 UCSC(policy-mgr) /org* # commit-buffer UCSC(policy-mgr) /org #
Configuring IQN Pools
IQN Pools
An IQN pool is a collection of iSCSI Qualified Names (IQNs) for use as initiator identifiers by iSCSI vNICs in a Cisco UCS domain. IQN pools created in Cisco UCS Central can be shared between Cisco UCS domains.
IQN pool members are of the form prefix:suffix:number, where you can specify the prefix, suffix, and a block (range) of numbers.
An IQN pool can contain more than one IQN block, with different number ranges and different suffixes, but sharing the same prefix.
Creating an IQN Pool
Note |
In most cases, the maximum IQN size (prefix + suffix + additional characters) is 223 characters. When using the Cisco UCS NIC M51KR-B adapter, you must limit the IQN size to 128 characters. |
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 3 | UCSC(policy-mgr) /org # create iqn-pool pool-name | Creates an IQN pool with the specified name, and enters organization IQN 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 4 | UCSC(policy-mgr) /org/iqn-pool # set iqn-prefix prefix | Specifies the prefix for the IQN block members. Unless limited by the adapter card, the prefix can contain up to 150 characters. |
||
Step 5 | UCSC(policy-mgr) /org/iqn-pool # set descr description | (Optional) Provides a description for the IQN pool. Enter up to 256 characters. You can use any characters or spaces except ` (accent mark), \ (backslash), ^ (carat), " (double quote), = (equal sign), > (greater than), < (less than), and ' (single quote).
|
||
Step 6 | UCSC(policy-mgr) /org/iqn-pool # create block suffix from to | Creates a block (range) of IQNs, and enters organization IQN pool block mode. You must specify the base suffix, the starting suffix number, and the ending suffix number. The resulting IQN pool members are of the form prefix:suffix:number. The suffix can be up to 64 characters.
|
||
Step 7 | UCSC(policy-mgr) /org/iqn-pool/block # commit-buffer | Commits the transaction to the system configuration.
|
The following example shows how to create an IQN pool named GPool1, provide a description for the pool, specify a prefix and a block of suffixes to be used for the pool, and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # create iqn-pool GPool1 UCSC(policy-mgr) /org/iqn-pool* # set iqn-prefix iqn.alpha.com UCSC(policy-mgr) /org/iqn-pool* # set descr "This is IQN pool GPool1" UCSC(policy-mgr) /org/iqn-pool* # create block beta 3 5 UCSC(policy-mgr) /org/iqn-pool/block* # commit-buffer UCSC(policy-mgr) /org/iqn-pool/block #
Include the IQN suffix pool in a service profile and/or template.
Deleting an IQN Pool
If you delete a pool, Cisco UCS Central does not reallocate any addresses from that pool that have been assigned to vNICs or vHBAs in Cisco UCS Manager. 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 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 3 | UCSC(policy-mgr) /org # delete iqn-pool pool-name | Deletes the specified IQN pool. |
||
Step 4 | UCSC(policy-mgr) /org # commit-buffer | Commits the transaction to the system configuration.
|
The following example shows how to delete the IQN pool named GPool1 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # delete iqn-pool GPool1 UCSC(policy-mgr) /org* # commit-buffer UCSC(policy-mgr) /org #
Configuring UUID Suffix Pools
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. Assigning global UUID suffix pools from Cisco UCS Central to service profiles in Cisco UCS Central or Cisco UCS Manager allows them to be shared across Cisco UCS domains.
Creating a UUID Suffix Pool
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 3 | UCSC(policy-mgr) /org # create uuid-suffix-pool pool-name | Creates a UUID suffix pool with the specified name, and enters organization UUID suffix pool mode. |
||
Step 4 | UCSC(policy-mgr) /org/uuid-suffix-pool # set descr description | (Optional) Provides a description for the UUID suffix pool.
|
||
Step 5 | UCSC(policy-mgr) /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 | UCSC(policy-mgr) /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 GPool1, provide a description for the pool, specify a block of UUID suffixes to be used for the pool, and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # create uuid-suffix-pool GPool1 UCSC(policy-mgr) /org/uuid-suffix-pool* # set descr "This is UUID suffix pool GPool1" UCSC(policy-mgr) /org/uuid-suffix-pool* # create block 1000-000000000001 1000-000000000010 UCSC(policy-mgr) /org/uuid-suffix-pool/block* # commit-buffer UCSC(policy-mgr) /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 Central does not reallocate any addresses from that pool that have been assigned to vNICs or vHBAs in Cisco UCS Manager. 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 | UCSC# connect policy-mgr | Enters policy manager mode. |
||
Step 2 | UCSC(policy-mgr)# scope org org-name | Enters organization mode for the specified organization. To enter the root organization mode, type / as the org-name. |
||
Step 3 | UCSC(policy-mgr) /org # delete uuid-suffix-pool pool-name | Deletes the specified UUID suffix pool. |
||
Step 4 | UCSC(policy-mgr) /org # commit-buffer | Commits the transaction to the system configuration.
|
The following example shows how to delete the UUID suffix pool named GPool1 and commit the transaction:
UCSC# connect policy-mgr UCSC(policy-mgr)# scope org / UCSC(policy-mgr) /org # delete uuid-suffix-pool GPool1 UCSC(policy-mgr) /org* # commit-buffer UCSC(policy-mgr) /org #