From ee383000edfe11166a7912fc463f32213d1253e5 Mon Sep 17 00:00:00 2001 From: mxi1 Date: Sat, 25 Sep 2010 07:13:37 +0000 Subject: [PATCH] for defect 3074153, the manpage for genimage and geninitrd are updated. git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@7633 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man1/genimage.1.pod | 16 ++++++++++------ xCAT-client/pods/man1/geninitrd.1.pod | 10 +++++++--- 2 files changed, 17 insertions(+), 9 deletions(-) diff --git a/xCAT-client/pods/man1/genimage.1.pod b/xCAT-client/pods/man1/genimage.1.pod index 1103f6a57..bc343d32e 100644 --- a/xCAT-client/pods/man1/genimage.1.pod +++ b/xCAT-client/pods/man1/genimage.1.pod @@ -4,9 +4,9 @@ B - Generates a stateless image to be used for a diskless install. =head1 SYNOPSIS -B B<-i> I B<-n> I B<-o> I B<-p> I [B<-l> I] [B<-r> I] [B<-k> I] [B<-m> I] +B [B<-i> I] [B<-n> I] B<-o> I B<-p> I [B<-l> I] [B<-r> I] [B<-k> I] [B<--permission> I] -B B<-i> I B<-n> I [B<-o> I] [B<-l> I] [B<-r> I] [B<-k> I] imagename +B [B<-i> I] [B<-n> I] [B<-o> I] [B<-l> I] [B<-r> I] [B<-k> I] imagename B [B<-h> | B<--help> | B<-v> | B<--version>] @@ -15,11 +15,13 @@ B [B<-h> | B<--help> | B<-v> | B<--version>] Generates a stateless image that can be used to boot xCAT nodes in a diskless mode. If I is not specified, the default packages included -(and excluded) in the image are specified by /opt/xcat/share/xcat/netboot//.pkglist and +(and excluded) in the image are specified by /opt/xcat/share/xcat/netboot//...pkglist and /opt/xcat/share/xcat/netboot//.exlist. -Additional packages that are not from the os distro can be specified in a .otherpkgs.pkglist file. +Additional packages that are not from the os distro can be specified in a ..otherpkgs.pkglist file. Customized package list files can be specified under /install/custom/netboot/ directory. The generated image will be put in /install/netboot///. + If I is specified, the package list files are specified in the I table and I table. +If B runs on the Management node, both the I table and I table will be updated following the B options. And, if there is no I called --netboot- or --statelite-, the B command will create them into I and I tables. The B command must be run on a system that is the same architecture as the nodes it will be used on. If the management node is not the same architecture, copy the contents of @@ -31,6 +33,8 @@ you want to rebuild the initrd.) After your image is created, you can chroot to image, install any additional software you would like, or make modifications to files, and then run B to prepare the image for deployment. +The B and B commands will generate two initial ramdisks for B and B, one is B, the other one is B. + =head1 Parameters I specifies the name of a os image definition to be used. The specification for the image is storted in the I table and I table. @@ -55,9 +59,9 @@ the nodes' nodetype.profile attribute must be set to this same value. The network interface the diskless node will boot over (e.g. eth0). -=item B<-m> I +=item B<--permission> I -The mode of diskless image, the valid value is statelite. Statelite provides an efficient and flexible diskless solution because most of the OS image is NFS mounted read-only, but a configurable list of directories and files can be read-write. The read-write files can either be persistent across reboots, or volatile (restoring to pristine state after reboot). The configuration can be done through B, B and B tables. If this option is not specified, regular non-statelite diskless image will be generated. +The mount permission of B directory for B mode, which is only used for B mode, and the default permission is 755. =item B<-n> I diff --git a/xCAT-client/pods/man1/geninitrd.1.pod b/xCAT-client/pods/man1/geninitrd.1.pod index ffa150a7b..0527fe33a 100644 --- a/xCAT-client/pods/man1/geninitrd.1.pod +++ b/xCAT-client/pods/man1/geninitrd.1.pod @@ -4,14 +4,16 @@ B - Regenerates the initrd for a stateless image to be used for a dis =head1 SYNOPSIS -B B<-i> I B<-n> I B<-o> I B<-p> I [B<-l> I] [B<-k> I] +B [B<-i> I] [B<-n> I] [B<-o> I] [B<-p>] [I] [B<-l> I] [B<-k> I] [B<--permission> I] + +B [B<-i> I] [B<-n> I] [B<-o> I] [B<-p>] [I] [B<-l> I] [B<-k> I] [B<--permission> I] imagename B [B<-h> | B<--help> | B<-v> | B<--version>] =head1 DESCRIPTION -Regenerates the initrd that is part of a stateless image that is used to boot xCAT nodes in a diskless mode. +Regenerates the initrd that is part of a stateless/statelite image that is used to boot xCAT nodes in a stateless/statelite mode. The generated initrd will be put in /install/netboot///. The B command must be run on a system that is the same architecture as the nodes it will be @@ -19,6 +21,8 @@ used on. If the management node is not the same architecture, copy the contents /opt/xcat/share/xcat/netboot/ to a system that is the proper architecture, and mount /install from the management node to that system. +The B command will generate two initial ramdisks, one is B for B mode, the other one is B for B mode. + =head1 OPTIONS @@ -93,4 +97,4 @@ To regenerate the initrd for a fedora8 image for a compute node architecture x86 =head1 SEE ALSO -L, L \ No newline at end of file +L, L