CPU: Adding and Deleting by Total

The basic syntax for adding and deleting CPUs is:

-a|d|m cpu::num

where:

-a|d|m: specifies adding, deleting, or modifying the total count of CPUs
num: specifies the number of CPUs

NOTE: CPU deletion fails when deletion by total and by CLP are given in the same vparmodify command.

In this situation, the CPU deletion by total fails with the error message “vPar does not own enough Monitor-assigned CPUs to satisfy the request” although there are enough monitor-assigned CPUs.

Instead, issue separate vparmodify commands to delete by total and delete by CLP.

For example instead of issuing the following command:

# vparmodify -p vpar1 -d cell:3:cpu::2 -d cpu::1

Issue two separate commands to delete by CLP and then by total:

# vparmodify -p vpar1 -d cell:3:cpu::2

# vparmodify -p vpar1 -d cpu::1

The virtual partition can be either up or down when using the cpu::num syntax.

When the virtual partition is active, CPUs that were added using the cpu::num syntax can be deleted only by using either:

cpu::num syntax (deletion by total), or
cpu:hw_path syntax (deletion by hardware path)

Deletion by total (cpu::num) is recommended over deletion by hardware path (cpu:hw_path).

Total increases or decreases by num when using the -a or -d options and is set to num when using the -m option.

vparcreate

With the vparcreate command, you would use the -a option and specify as num the number of CPUs to allocate to the virtual partition.

If no cpu syntax is given on the vparcreate command line, the default value for total is 1.

Example

To create the virtual partition keira2 with 3 CPUs, set num to 3:
keira1# vparcreate -p keira2 -a cpu::3 ...

vparmodify

With the vparmodify command, you can use the:

-a option to add num CPUs to the virtual partition,
-d option to delete num CPUs from the virtual partition,
-m option to modify (set) to num the number of CPUs assigned to the partition. The vPars Monitor automatically will add or delete CPUs to or from the virtual partition to reach num CPUs.

Examples

If an existing partition has 2 CPUs and you would like to set the number of CPUs to 3, you can modify the number of CPUs assigned to the partition by using the -m option and setting num to 3:
keira1# vparmodify -p keira2 -m cpu::3
To set the number of CPUs back to two, use the -m option and set num to 2:
keira1# vparmodify -p keira2 -m cpu::2
If you would like to add 1 CPU to an existing partition, regardless of its current CPU count, you can add 1 CPU by using the -a option and setting num to 1:
keira1# vparmodify -p keira2 -a cpu::1
To remove the added CPU from the partition, use the -d option and set num to 1:
keira1# vparmodify -p keira2 -d cpu::1

CPU: Adding and Deleting by Total

Technical documentation

» Table of Contents

» Glossary

» Index

vparcreate

Example

vparmodify

Examples