diff --git a/xCAT-client/pods/man1/chvm.1.pod b/xCAT-client/pods/man1/chvm.1.pod index a765ff094..bd9b49a44 100644 --- a/xCAT-client/pods/man1/chvm.1.pod +++ b/xCAT-client/pods/man1/chvm.1.pod @@ -1,6 +1,6 @@ =head1 NAME -B - Changes HMC- and IVM-managed partition profiles. For Power 775, chvm could be used to change the octant configuration values for generating LPARs; change the I/O slots assignment to LPARs within the same CEC. +B - Changes HMC-, IVM-, and zVM-managed partition profiles or virtual machines. For Power 775, chvm could be used to change the octant configuration values for generating LPARs; change the I/O slots assignment to LPARs within the same CEC. =head1 SYNOPSIS @@ -26,6 +26,56 @@ B I B<-i id> [B<-m> I] B<-r> I I [B<-a> I] [B<-d> I] [B<-p> I] [B<--resize> B=I] [B<--cpus> I] [B<--mem> I] +=head2 zVM specific: + +B I [B<--add3390> I I I I I I I] + +B I [B<--add3390active> I I] + +B I [B<--add9336 I I I I I I I I] + +B I [B<--adddisk2pool> I I I I] + +B I [B<--addnic I
I I] + +B I [B<--addprocessor I
] + +B I [B<--addprocessoractive> I
I] + +B I [B<--addvdisk> I I I] + +B I [B<--connectnic2guestlan> I
I I] + +B I [B<--connectnic2vswitch> I
I] + +B I [B<--copydisk> I I I] + +B I [B<--dedicatedevice> I I I] + +B I [B<--deleteipl>] + +B I [B<--formatdisk> I I] + +B I [B<--disconnectnic> I
] + +B I [B<--grantvswitch> I] + +B I [B<--removedisk> I] + +B I [B<--resetsmapi>] + +B I [B<--removediskfrompool> I I I] + +B I [B<--removenic> I
] + +B I [B<--removeprocessor> I
] + +B I [B<--replacevs> I] + +B I [B<--setipl> I I I] + +B I [B<--setpassword> I] + =head1 DESCRIPTION =head2 PPC (with HMC) specific: @@ -46,6 +96,10 @@ The administrator should use lsvm to get the profile content, and then edit the The chvm command modifes the vm specified in noderange. Calling with deregister or purge options at the same time as the resize option is not recommended. +=head2 zVM specific: + +The chvm command modifes the virtual machine's configuration specified in noderange. + =head1 OPTIONS =head2 Common: @@ -148,6 +202,104 @@ Change the size of the Hard disk. The disk can never be set to less than it's c =back +=head2 zVM specific: + +=item B<--add3390> I I I I I I I + +Adds a 3390 (ECKD) disk to a virtual server's directory entry. + +=item B<--add3390active> I I + +Adds a 3390 (ECKD) disk that is defined in a virtual server's directory entry to that virtual server's active configuration. + +=item B<--add9336 I I I I I I I I + +Adds a 9336 (FBA) disk to a virtual server's directory entry. + +=item B<--adddisk2pool> I I I I + +Add a disk to a disk pool defined in the EXTENT CONTROL. Function type can be either: (4) Define region as full volume and add to group OR (5) Add existing region to group. The disk has to already be attached to SYSTEM. + +=item B<--addnic I
I I + +Adds a network adapter to a virtual server's directory entry (case sensitive). + +=item B<--addprocessor I
+ +Adds a virtual processor to a virtual server's directory entry. + +=item B<--addprocessoractive> I
I + +Adds a virtual processor to a virtual server's active configuration (case sensitive). + +=item B<--addvdisk> I I I + +Adds a v-disk to a virtual server's directory entry. + +=item B<--connectnic2guestlan> I
I I + +Connects a given network adapter to a GuestLAN. + +=item B<--connectnic2vswitch> I
I + +Connects a given network adapter to a VSwitch. + +=item B<--copydisk> I I I + +Copy a disk attached to a given virtual server. + +=item B<--dedicatedevice> I I I + +Adds a dedicated device to a virtual server's directory entry. + +=item B<--deleteipl> + +Deletes the IPL statement from the virtual server's directory entry. + +=item B<--formatdisk> I I + +Formats a disk attached to a given virtual server (only ECKD disks supported). The disk should not be linked to any other virtual server. This command is best used after add3390(). + +=item B<--disconnectnic> I
+ +Disconnects a given network adapter. + +=item B<--grantvswitch> I + +Grant VSwitch access for given virtual server. + +=item B<--removedisk> I + +Removes a minidisk from a virtual server's directory entry. + +=item B<--resetsmapi> + +Reset z/VM SMAPI, assuming the SMAPI worker machines to reset are: VSMWORK1, VSMWORK2, VSMWORK3, VSMREQIN, and VSMREQIU. + +=item B<--removediskfrompool> I I I + +Remove a disk from a disk pool defined in the EXTENT CONTROL. Function type can be either: (1) Remove region, (2) Remove region from group, (3) Remove region from all groups, OR (7) Remove entire group. + +=item B<--removenic> I
+ +Removes a network adapter from a virtual server's directory entry. + +=item B<--removeprocessor> I
+ +Removes a processor from an active virtual server's configuration. + +=item B<--replacevs> I + +Replaces a virtual server's directory entry. + +=item B<--setipl> I I I + +Sets the IPL statement for a given virtual server. + +=item B<--setpassword> I + +Sets the password for a given virtual server. + =head1 RETURN VALUE 0 The command completed successfully. @@ -268,6 +420,64 @@ Output is similar to: vm1: node successfully changed +=head2 zVM specific: + +1. To adds a 3390 (ECKD) disk to a virtual server's directory entry: + + chvm gpok3 --add3390 POOL1 0101 3338 MR + +Output is similar to: + + gpok3: Adding disk 0101 to LNX3... Done + +2. To add a network adapter to a virtual server's directory entry: + + chvm gpok3 --addnic 0600 QDIO 3 + +Output is similar to: + + gpok3: Adding NIC 0900 to LNX3... Done + +3. To connects a given network adapter to a GuestLAN: + + chvm gpok3 --connectnic2guestlan 0600 GLAN1 LN1OWNR + +Output is similar to: + + gpok3: Connecting NIC 0600 to GuestLan GLAN1 on LN1OWNR... Done + +4. To connects a given network adapter to a VSwitch: + + chvm gpok3 --connectnic2vswitch 0600 VSW1 + +Output is similar to: + + gpok3: Connecting NIC 0600 to VSwitch VSW1 on LNX3... Done + +5. To removes a minidisk from a virtual server's directory entry: + + chvm gpok3 --removedisk 0101 + +Output is similar to: + + gpok3: Removing disk 0101 on LNX3... Done + +6. To Removes a network adapter from a virtual server's directory entry: + + chvm gpok3 --removenic 0700 + +Output is similar to: + + gpok3: Removing NIC 0700 on LNX3... Done + +7. To replaces a virtual server's directory entry: + + chvm gpok3 --replacevs /tmp/dirEntry.txt + +Output is similar to: + + gpok3: Replacing user entry of LNX3... Done + =head1 FILES