arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

support imaged provisioning.

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@15368 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
sjing 2013-03-04 07:38:50 +00:00
parent 1c2f665993
commit 7d2ad45443
1 changed files with 37 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
xCAT-client/pods/man1/imgcapture.1.pod
View File

@ -1,19 +1,26 @@
=head1 NAME
B<imgcapture> - Captures an image from a Linux diskful node and create a diskless image on the management node.
B<imgcapture> - Captures an image from a Linux diskful node and create a diskless or diskful image on the management node.
=head1 SYNOPSIS
B<imgcapture> node [B<-p>|B<--profile> I<profile>] [B<-o>|B<--osimage> I<osimage>] [B<-i> I<nodebootif>] [B<-n> I<nodenetdrivers>] [B<-V>|B<--verbose>]
B<imgcapture> node B<-t>|B<--type> diskless [B<-p>|B<--profile> I<profile>] [B<-o>|B<--osimage> I<osimage>] [B<-i> I<nodebootif>] [B<-n> I<nodenetdrivers>] [B<-V>|B<--verbose>]
B<imgcapture> node B<-t>|B<--type> sysclone B<-o>|B<--osimage> I<osimage> [B<-V>|B<--verbose>]
B<imgcapture> [B<-h> | B<--help>] | [B<-v> | B<--version>]
=head1 DESCRIPTION
The B<imgcapture> command will capture an image from one running diskful Linux node, prepares the rootimg directory, kernel and initial rmadisks for the B<liteimg>/B<packimage> command to generate the statelite/stateless rootimg.
The B<imgcapture> command will capture an image from one running diskful Linux node and create a diskless or diskful image for later use.
The B<node> should be one diskful Linux node, managed by the xCAT MN, and the remote shell between MN and the B<node> should have been configured. AIX is not supported.
The B<osver>, B<arch> and B<profile> attributes for the stateless/statelite image to be created are duplicated from the B<node>'s attribute. If the B<-p|--profile> I<profile> option is specified, the image will be created under "/<I<installroot>>/netboot/<osver>/<arch>/<I<profile>>/rootimg".
The B<imgcapture> command supports two image types: B<diskless> and B<sysclone>. For the B<diskless> type, it will capture an image from one running diskful Linux node, prepares the rootimg directory, kernel and initial rmadisks for the B<liteimg>/B<packimage> command to generate the statelite/stateless rootimg. For the B<sysclone> type, it will capture an image from one running diskful Linux node, create an osimage which can be used to clone other diskful Linux nodes.
The B<diskless> type:
The I<osimage> is pre-defined, the attributes of osimage will be used to capture and prepare the root image. The B<osver>, B<arch> and B<profile> attributes for the stateless/statelite image to be created are duplicated from the B<node>'s attribute. If the B<-p|--profile> I<profile> option is specified, the image will be created under "/<I<installroot>>/netboot/<osver>/<arch>/<I<profile>>/rootimg".
The default files/directories excluded in the image are specified by /opt/xcat/share/xcat/netboot/<os>/<I<profile>>.<osver>.<arch>.imgcapture.exlist; also, you can put your customized file (<I<profile>>.<osver>.<arch>.imgcapture.exlist) to /install/custom/netboot/<osplatform>. The directories in the default I<.imgcapture.exlist> file are necessary to capture image from the diskful Linux node managed by xCAT, please don't remove it.
@ -21,17 +28,27 @@ The image captured will be extracted into the /<I<installroot>>/netboot/<B<osver
After the B<imgcapture> command returns without any errors, you can customize the rootimg and run the B<liteimg>/B<packimage> command with the options you want.
The B<sysclone> type:
xCAT leverages the Open Source Tool - Systemimager to capture the osimage from the B<node>, and put it into /<I<installroot>>/B<sysclone>/B<images> directory.
The B<imgcapture> command will create the I<osimage> definition after the image is captured successfully, you can use this osimage and B<nodeset> command to clone diskful nodes.
=head1 OPTIONS
=over 4
=item B<-t>|B<--type>
Specify the osimage type you want to capture, two types are supported: diskless and sysclone.
=item B<-p|--profile> I<profile>
Assign I<profile> as the profile of the image to be created.
=item B<-o|--osimage> I<osimage>
Assign the pre-defined I<osimage> object. The attributes of I<osimage> will be used to capture and prepare the root image.
The osimage name.
=item B<-i> I<nodebootif>
@ -83,25 +100,30 @@ Verbose output.
B<node1> is one diskful Linux node, which is managed by xCAT.
1. In order to capture and prepare the root image, run the following command:
1. In order to capture and prepare the diskless root image, run the following command:
imgcapture node1
imgcapture node1 -t diskless
2. In order to capture and prepare the root image with B<hpc> as profile, run the command:
2. In order to capture and prepare the diskless root image with B<hpc> as profile, run the command:
imgcapture node1 -p hpc
imgcapture node1 -t diskless -p hpc
3. In order to capture and prepare the root image: its profile is B<hpc>, and the network interface the diskless node will boot over is B<eth0>, the driver modules for this network interface is B<e1000e>.
3. In order to capture and prepare the diskless root image: its profile is B<hpc>, and the network interface the diskless node will boot over is B<eth0>, the driver modules for this network interface is B<e1000e>.
imgcapture node1 -p hpc -i eth0 -n e1000e
imgcapture node1 -t diskless -p hpc -i eth0 -n e1000e
4. There's one pre-defined I<osimage>. In order to capture and prepare the diskless root image for I<osimage>, run the command:
imgcapture node1 -t diskless -o osimage
5. In order to capture the diskful image from B<node1> and create the I<osimage> B<img1>, run the command:
imgcapture node1 -t sysclone -o img1
4. There's one pre-defined I<osimage>. In order to capture and prepare the root image for I<osimage>, run the command:
imgcapture node1 -o osimage
=head1 FILES
/opt/xcat/bin/imgcapture
=head1 SEE ALSO
L<genimage(1)|genimage.1>, L<imgimport(1)|imgimport.1>, L<imgexport(1)|imgexport.1>, L<packimage(1)|packimage.1>, L<liteimg(1)|liteimg.1>
L<genimage(1)|genimage.1>, L<imgimport(1)|imgimport.1>, L<imgexport(1)|imgexport.1>, L<packimage(1)|packimage.1>, L<liteimg(1)|liteimg.1>, L<nodeset(1)|nodeset.1>