From 399e1ad5045c1e4a84eb1db581f3a1a07c4226fd Mon Sep 17 00:00:00 2001 From: phamt Date: Mon, 26 Nov 2012 17:09:40 +0000 Subject: [PATCH] Added zVM specific options to chhypervisor man page. git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@14429 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man1/chhypervisor.1.pod | 180 ++++++++++++++++++++++- 1 file changed, 178 insertions(+), 2 deletions(-) diff --git a/xCAT-client/pods/man1/chhypervisor.1.pod b/xCAT-client/pods/man1/chhypervisor.1.pod index e982b9bfe..a7ce49332 100644 --- a/xCAT-client/pods/man1/chhypervisor.1.pod +++ b/xCAT-client/pods/man1/chhypervisor.1.pod @@ -20,6 +20,36 @@ B I [B<-d>] =back +B + +=over 2 + +B I [B<--adddisk2pool> I I I I] + +B I [B<--addzfcp2pool> I I I I I I] + +B I [B<--diskpoolnames>] + +B I [B<--fcpchannels> I] + +B I [B<--getnetworknames>] + +B I [B<--getnetwork> I] + +B I [B<--removediskfrompool> I I I] + +B I [B<--removezfcpfrompool> I I] + +B I [B<--resetsmapi>] + +B I [B<--smapi> I I] + +B I [B<--zfcppoolnames>] + +B I [B<--zfcppool> I I] + +=back + =head1 DESCRIPTION The B command can be used to configure the RHEV-h host. @@ -31,15 +61,17 @@ After registering, the network interfaces of host need to be added to the 'netwo RHEV. And the power management for the host should be configured so that rhev-m could make proper decision when certain host encountered error. +The B command can also be used to configure the zVM host. + For each host, an entry should be added to the hypervisor table: The columns of hypervisor table: =over 2 -B - rhev-h host name. +B - rhev-h host name or zVM host name. -B - Must be set to 'rhevh'. +B - Must be set to 'rhevh' or 'zvm'. B - The rhev manager (The FQDN of rhev-m server) for the host. @@ -52,6 +84,8 @@ default is 'Default' cluster if not specified. =head1 OPTIONS +=head2 RHEV specific : + =over 2 =item B<-a> @@ -113,6 +147,75 @@ Display usage message. =back +=head2 zVM specific : + +=over 2 + +=item B I [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. If the volume already exists in the EXTENT CONTROL, use +function 5. If the volume does not exist in the EXTENT CONTROL, but is attached +to SYSTEM, use function 4. + +=item B I [B<--addzfcp2pool> I I I I I I] + +Add a zFCP device to a device pool defined in xCAT. The device must have been +carved up in the storage controller and configured with a WWPN/LUN before it +can be added to the xCAT storage pool. z/VM does not have the ability to +communicate directly with the storage controller to carve up disks dynamically. + +=item B I [B<--diskpoolnames>] + +List the disk pool names available. + +=item B I [B<--fcpchannels> I] + +List the state of real FCP adapter devices. + +=item B I [B<--getnetworknames>] + +List the defined network names available for a given host. + +=item B I [B<--getnetwork> I] + +List the configuration for a given network. + +=item B I [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 I [B<--removezfcpfrompool> I I] + +Remove a zFCP device from a device pool defined in xCAT. + +=item B I [B<--resetsmapi>] + +Reset z/VM SMAPI, assuming the SMAPI worker machines to reset are: VSMWORK1, +VSMWORK2, VSMWORK3, VSMREQIN, and VSMREQIU. + +=item B I [B<--smcli> I I] + +Execute a SMAPI function. A list of APIs supported can be found by using the +help flag, e.g. chhypervisor pokdev61 --smcli -h. Specific arguments associated +with a SMAPI function can be found by using the help flag for the function, +e.g. chhypervisor pokdev61 --smcli Image_Query_DM -h. Only z/VM 5.4 SMAPI +functions are supported at this time. Additional SMAPI functions will be added +in subsequent zHCP versions. + +=item B I [B<--zfcppoolnames>] + +List the zFCP device pool names available. + +=item B I [B<--zfcppool> I I] + +List the devices in a given zFCP device pool. Space can be either: free or used. + +=back + =head1 RETURN VALUE 0 The command completed successfully. @@ -121,6 +224,8 @@ Display usage message. =head1 EXAMPLES +=head2 RHEV specific : + =over 2 =item 1. @@ -150,6 +255,77 @@ To deactivate the host 'host1', enter: =back +=head2 zVM specific : + +=over 2 + +=item 1. +To add a disk to a disk pool defined in the EXTENT CONTROL, enter: + + chhypervisor pokdev61 --adddisk2pool 4 DM1234 DM1234 POOL1 + +=item 2. +To add a zFCP device to a device pool defined in xCAT, enter: + + chhypervisor pokdev61 --addzfcp2pool zfcp1 free 500501234567C890 4012345600000000 8G + +=item 3. +To remove a region from a group in the EXTENT CONTROL, enter: + + chhypervisor pokdev61 --removediskfrompool 2 DM1234 POOL1 + +=item 4. +To remove a zFCP device from a device pool defined in xCAT, enter: + + chhypervisor pokdev61 --removezfcpfrompool zfcp1 4012345600000000 + +=item 5. +To reset z/VM SMAPI, enter: + + chhypervisor pokdev61 --resetsmapi + +=item 6. +To list the disk pool names available, enter: + + chhypervisor pokdev61 --diskpoolnames + +=item 7. +To list the configuration for a given disk pool, enter: + + chhypervisor pokdev61 --diskpool POOL1 free + +=item 8. +To list the zFCP device pool names available, enter: + + chhypervisor pokdev61 --zfcppoolnames + +=item 9. +To list the devices in a given zFCP device pool, enter: + + chhypervisor pokdev61 --zfcppool zfcp1 + +=item 10. +To list the state of real FCP adapter devices, enter: + + chhypervisor pokdev61 --fcpchannels free + +=item 11. +To list the defined network names available for a given node, enter: + + chhypervisor pokdev61 --getnetworknames + +=item 12. +To list the configuration for a given network, enter: + + chhypervisor pokdev61 --getnetwork GLAN1 + +=item 13. +To execute a SMAPI function (Image_Query_DM), enter: + + chhypervisor pokdev61 --smcli Image_Query_DM -T LNX3 + +=back + =head1 FILES /opt/xcat/bin/chhypervisor