add and improve zone manpages

xCAT-client/pods/man1/mkzone.1.pod

@@ -13,8 +13,8 @@ B<mkzone> [B<-h> | B<-v>]
 
 The B<mkzone> command is designed to divide the xCAT cluster into multiple zones. The nodes in each zone will share common root ssh keys. This allows the nodes in a zone to be able to as root ssh to each other without password, but cannot do the same to any node in another zone. All zones share a common xCAT Management Node and database including the site table, which defines the attributes of the entire cluster.
 The mkzone command is only supported on Linux ( No AIX support).
-The nodes are not updated with the new root ssh keys by mkzone.  You must run updatenode -k  or xdsh -K to the nodes to update the root ssh keys to the new generated zone keys.    
-
+The nodes are not updated with the new root ssh keys by mkzone.  You must run updatenode -k  or xdsh -K to the nodes to update the root ssh keys to the new generated zone keys. This will also sync any service nodes with the zone keys, if you have a hierarchical cluster.   
+Note: if any zones in the zone table, there must be one and only one defaultzone. Otherwise, errors will occur.
 
 =head1 B<OPTIONS>
 
@@ -39,6 +39,7 @@ if --defaultzone is input, then it will set the zone defaultzone attribute to ye
 if --defaultzone is input and another zone is currently the default,
 then the -f flag must be used to force a change to the new defaultzone.
 If -f flag is not use an error will be returned and no change made. 
+Note: if any zones in the zone table, there must be one and only one defaultzone. Otherwise, errors will occur.
 
 =item B<-a | --addnoderange> I<noderange>
 

xCAT-client/pods/man1/rmzone.1.pod

@@ -0,0 +1,84 @@
+=head1 B<NAME>
+
+B<rmzone> - Removes a zone from the cluster. 
+
+=head1 B<SYNOPSIS>
+
+B<rmzone> <zonename>  [B<-g>] [B<-f>] 
+
+B<rmzone> [B<-h> | B<-v>]
+
+
+=head1 B<DESCRIPTION>
+
+The B<rmzone> command is designed to remove a previously defined zone from the cluster.
+It will remove the zone entry in the zone table.  It will remove the zone from the zonename attributes on the nodes that were assigned to the zone. Optionally, it will remove the zonename group from the nodes that were assigned to the zone. 
+It will also remove the root ssh keys that were created for that zone on the Management Node. 
+The rmzone command is only supported on Linux ( No AIX support).
+The nodes are not automatically updated with new root ssh keys by rmzone.  You must run updatenode -k  or xdsh -K to the nodes to update the root ssh keys. The nodes new ssh key will be assigned from the defaultzone in the zone table, or if  no entries in the zone table,  the keys will come from /root/.ssh.   
+Note: if any zones in the zone table, there must be one and only one defaultzone. Otherwise, errors will occur.  
+
+
+=head1 B<OPTIONS>
+
+=over 5
+
+=item B<-h>|B<--help> 
+
+Displays usage information. 
+
+=item B<-v>|B<--version> 
+
+Displays command version and build date. 
+
+=item B<-f | --force> 
+
+Used to remove a zone that is defined as current default zone.  This should only be done if you are removing all zones, or you will
+adding a new zone or changing an existing zone to be the default zone. 
+
+=item B<-g | --assigngroup> 
+
+Remove the assigned group named B<zonename> from all nodes assigned to the zone being removed. 
+
+=item B<-V>|B<--Verbose>
+
+Verbose mode.
+
+
+=back
+
+
+=head1 B<Examples>
+
+=over 3
+
+=item *
+
+To remove zone1 from the zone table and the zonename attribute on all it's assigned nodes , enter:
+
+B<rmzone> I<zone1>
+
+
+=item *
+
+To remove zone2 from the zone table, the zone2 zonename attribute, and the zone2 group assigned to all nodes that were in zone2, enter:
+
+B<rmzone> I<zone2> -g 
+
+=item *
+
+To remove zone3 from the zone table, all the node zone attributes and  override the fact it is the defaultzone,  enter:
+
+B<rmzone> I<zone3> -g -f
+
+=back
+
+B<Files>
+
+B</opt/xcat/bin/rmzone/>
+
+Location of the rmzone command.
+
+=head1 B<SEE ALSO>
+
+L <xdsh(1)|xdsh.1>, L<updatenode(1)|updatenode.1>