Example of operating VM groups

The example below illustrates how the VM2000 administrator operates a VM group with two VMs on an SU /390.

/show-vm-resources information=*std ———————————————————————————————————   (1)
             CPU-POOL(P)
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO
 1 MONITOR   *STDPOOL(P)  30.00  100.00  2(+1)       512  (100)
 2 C1SYS1    *STDPOOL(P)  20.00   20.00  2(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV
 1 MONITOR   RUNNING         V21.0B  NO  YES   AS
 2 C1SYS1    RUNNING         V20.0B  NO  NO    AS
F R E E      VM: 13          LARGEST-DOMAIN(MB):   14832
/create-vm-group vm-group-name=gcust1,cpu-quota=20,
                 max-cpu-utilization=20,cpu-pool-name=*stdpool ————————   (2)
VMS4401 VM GROUP 'GCUST1' CREATED
VMS4625 VM GROUP 'GCUST1' ASSIGNED TO CPU POOL '*STDPOOL'
/add-vm-to-vm-group vm-id=c1sys1,vm-group-name=gcust1,
                    member-cpu-quota=1 ————————————————————————————————   (3)
VMS4425 VIRTUAL MACHINE (2,C1SYS1) ASSIGNED TO VM GROUP 'GCUST1'
/create-vm memory-size=512,vm-name=c1sys2,processor=*bi,
  cpu-quota=*by-vm-group(vm-group-name=gcust1,member-cpu-quota=1)  —————  (4)
VMS3050 VIRTUAL MACHINE (3,C1SYS2) CREATED
VMS4425 VIRTUAL MACHINE (3,C1SYS2) ASSIGNED TO VM GROUP 'GCUST1'
VMS4615 VIRTUAL MACHINE (3,C1SYS2) ASSIGNED TO CPU POOL '*STDPOOL'
/show-vm-group vm-group-name=gcust1,information=*all  ——————————————————  (5)
VM-GROUP CPU-POOL  CPU-Q   MAX-U
GCUST1   *STDPOOL  20.00   20.00
VM-GROUP CPU-POOL VM-ID       CPU-Q / EFF-Q   MAX-U / EFF-U
GCUST1   *STDPOOL  2 C1SYS1    1.00 / 10.00   20.00 / 20.00
                   3 C1SYS2    1.00 / 10.00  100.00 / 20.00
...
/modify-vm-group-attributes vm-group-name=gcust1,cpu-quota=30,
                            max-cpu-utilization=30  ————————————————————  (6)
/show-vm-group vm-group-name=gcust1,information=*attributes
VM-GROUP CPU-POOL  CPU-Q   MAX-U
GCUST1   *STDPOOL  30.00   30.00
/modify-vm-attributes vm-id=c1sys1,
  cpu-quota=*by-vm-group(member-cpu-quota=2),max-cpu-utilization=30  ———  (7)
/show-vm-resources information=*cpu,
                   vm-id=*by-vm-group(vm-group-name=gcust1) ———————————   (8)
VM-ID        CPU-POOL  GR-CPU-Q  CPU-Q/ EFF-Q  MAX-U/ EFF-U  PROC
 2 C1SYS1    *STDPOOL    30.00    2.00/ 20.00  30.00/ 30.00  2(+1)
 3 C1SYS2    *STDPOOL    30.00    1.00/ 10.00 100.00/ 30.00  2(+1)
VM-ID        SCHED ACT-I  VIRT CPUS
 2 C1SYS1     TS    NO    00(RUN),01(RUN),02(OFF)
 3 C1SYS2     TS    NO    00(RUN),01(RUN),02(OFF)
...
/delete-vm vm-id=c1sys2 ———————————————————————————————————————————————   (9)
VMS4429 VIRTUAL MACHINE (3,C1SYS2) REMOVED FROM VM GROUP 'GCUST1'
VMS4619 VIRTUAL MACHINE (3,C1SYS2) REMOVED FROM CPU POOL '*STDPOOL'
VMS4024 VIRTUAL MACHINE (3,C1SYS2) TERMINATED
/remove-vm-from-vm-group vm-id=c1sys1,vm-group-name=gcust1,
                         cpu-quota=30 —————————————————————————————————  (10)
VMS4429 VIRTUAL MACHINE (2,C1SYS1) REMOVED FROM VM GROUP 'GCUST1'
/show-vm-group vm-group-name=gcust1,information=*members ——————————————  (11)
VM-GROUP CPU-POOL VM-ID       CPU-Q / EFF-Q   MAX-U / EFF-U
GCUST1   *STDPOOL    NONE
/delete-vm-group vm-group-name=gcust1 —————————————————————————————————  (12)
VMS4629 VM GROUP 'GCUST1' REMOVED FROM CPU POOL '*STDPOOL'
VMS4405 VM GROUP 'GCUST1' DELETED
/show-vm-resources information=*std ———————————————————————————————————  (13)
             CPU-POOL(P)
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO
 1 MONITOR   *STDPOOL(P)  30.00  100.00  2(+1)       512  (100)
 2 C1SYS1    *STDPOOL(P)  30.00   30.00  2(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV
 1 MONITOR   RUNNING         V21.0B  NO  YES   AS
 2 C1SYS1    RUNNING         V20.0B  NO  NO    AS
F R E E      VM: 13          LARGEST-DOMAIN(MB):   14832

-----------------------------------------------------------------------------------------------------------------

(1)	The command shows the initial situation for this example: A customer has agreed on a certain CPU capacity with the data center which corresponds to 20% of the CPU capacity on this Server Unit. The VM2000 administrator has therefore equipped the customer VM C1SYS1 with a CPU quota and a maximum CPU utilization of 20. The VM2000 administrator also operates the customer VM. The meaning of the output columns is described in more detail in the section "Planning distribution of the CPU capacity to the VMs".
(2)	The customer would now like to use a second VM. However, the specified CPU capacity should remain unchanged. For this purpose the VM2000 administrator creates the VM group GCUST1 and assigns it a CPU quota and a maximum CPU utilization of 20. The VM group is assigned to the standard CPU pool.
(3)	The customer VM C1SYS1 is added to the VM group GCUST1. The member CPU quota selected is 1; the CPU quota which the VM was given when it was created (20) is relinquished.
(4)	The customer VM C1SYS2 is created. It is added to the VM group GCUST1 when it is created (and consequently to the standard CPU pool) and is also assigned a member CPU quota of 1.
(5)	The information output for the VM group shows the status now achieved: The two customer VMs C1SYS1 and C1SYS2 share the specified CPU capacity (same CPU quota, i.e. 10% each (planned values)). The maximum CPU utilization of C1SYS2 was set to 100 by the default value in the command, but is reduced to 20 by the relevant value for the group.
(6)	After a certain time the customer requires higher CPU capacity and agrees with the data center on a CPU capacity of 30% of the Server Unit capacity. For this purpose the VM2000 administrator increases the relevant values for the VM group GCUST1.
(7)	In addition, the defined CPU capacity should be distributed to the customer VMs in such a way that C1SYS1 is assigned twice as much CPU capacity as C1SYS2. For this purpose the VM2000 administrator doubles the CPU quota of the VM CSYS1 and increases its maximum CPU utilization (from 20) to the specified share (30).
(8)	The information output for the VM group shows the status now achieved: The two customer VMs C1SYS1 and C1SYS2 share the specified CPU capacity in a ratio of 2:1, i.e. 20% and 10% of the Server Unit's CPU capacity (planned values). The maximum CPU utilization of C1SYS2 also corresponds to the specified CPU capacity because of the settings for the VM group.
(9)	After a certain time the customer no longer requires the additionally created VM C1SYS2. The VM2000 administrator terminates the VM.
(10)	The VM C1SYS1 is removed from the VM group. It (again) becomes an autonomous VM with a CPU quota of 30 as the customer still wishes to use the newly defined CPU capacity. The member CPU quota is relinquished.
(11)	The VM group GCUST1 thus no longer has any members and can be deleted.
(12)	The VM group GCUST1 is deleted.
(13)	The information output shows that the required status has been achieved.