From 7d2ad45443bd15a61752ba4d4e8ea5a109bce2ee Mon Sep 17 00:00:00 2001 From: sjing Date: Mon, 4 Mar 2013 07:38:50 +0000 Subject: [PATCH] support imaged provisioning. git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@15368 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man1/imgcapture.1.pod | 52 ++++++++++++++++++-------- 1 file changed, 37 insertions(+), 15 deletions(-) diff --git a/xCAT-client/pods/man1/imgcapture.1.pod b/xCAT-client/pods/man1/imgcapture.1.pod index fbcbeccd8..e8c7f5e91 100644 --- a/xCAT-client/pods/man1/imgcapture.1.pod +++ b/xCAT-client/pods/man1/imgcapture.1.pod @@ -1,19 +1,26 @@ =head1 NAME -B - Captures an image from a Linux diskful node and create a diskless image on the management node. +B - Captures an image from a Linux diskful node and create a diskless or diskful image on the management node. =head1 SYNOPSIS -B node [B<-p>|B<--profile> I] [B<-o>|B<--osimage> I] [B<-i> I] [B<-n> I] [B<-V>|B<--verbose>] +B node B<-t>|B<--type> diskless [B<-p>|B<--profile> I] [B<-o>|B<--osimage> I] [B<-i> I] [B<-n> I] [B<-V>|B<--verbose>] + +B node B<-t>|B<--type> sysclone B<-o>|B<--osimage> I [B<-V>|B<--verbose>] + B [B<-h> | B<--help>] | [B<-v> | B<--version>] =head1 DESCRIPTION -The B command will capture an image from one running diskful Linux node, prepares the rootimg directory, kernel and initial rmadisks for the B/B command to generate the statelite/stateless rootimg. +The B command will capture an image from one running diskful Linux node and create a diskless or diskful image for later use. The B should be one diskful Linux node, managed by the xCAT MN, and the remote shell between MN and the B should have been configured. AIX is not supported. -The B, B and B attributes for the stateless/statelite image to be created are duplicated from the B's attribute. If the B<-p|--profile> I option is specified, the image will be created under "/>/netboot///>/rootimg". +The B command supports two image types: B and B. For the B type, it will capture an image from one running diskful Linux node, prepares the rootimg directory, kernel and initial rmadisks for the B/B command to generate the statelite/stateless rootimg. For the B 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 type: + +The I is pre-defined, the attributes of osimage will be used to capture and prepare the root image. The B, B and B attributes for the stateless/statelite image to be created are duplicated from the B's attribute. If the B<-p|--profile> I option is specified, the image will be created under "/>/netboot///>/rootimg". The default files/directories excluded in the image are specified by /opt/xcat/share/xcat/netboot//>...imgcapture.exlist; also, you can put your customized file (>...imgcapture.exlist) to /install/custom/netboot/. 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 />/netboot/ command returns without any errors, you can customize the rootimg and run the B/B command with the options you want. +The B type: + +xCAT leverages the Open Source Tool - Systemimager to capture the osimage from the B, and put it into />/B/B directory. + +The B command will create the I definition after the image is captured successfully, you can use this osimage and B 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 Assign I as the profile of the image to be created. =item B<-o|--osimage> I -Assign the pre-defined I object. The attributes of I will be used to capture and prepare the root image. +The osimage name. =item B<-i> I @@ -83,25 +100,30 @@ Verbose output. B 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 as profile, run the command: +2. In order to capture and prepare the diskless root image with B 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, and the network interface the diskless node will boot over is B, the driver modules for this network interface is B. +3. In order to capture and prepare the diskless root image: its profile is B, and the network interface the diskless node will boot over is B, the driver modules for this network interface is B. -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. In order to capture and prepare the diskless root image for I, run the command: + +imgcapture node1 -t diskless -o osimage + +5. In order to capture the diskful image from B and create the I B, run the command: + +imgcapture node1 -t sysclone -o img1 -4. There's one pre-defined I. In order to capture and prepare the root image for I, run the command: -imgcapture node1 -o osimage - =head1 FILES /opt/xcat/bin/imgcapture =head1 SEE ALSO -L, L, L, L, L +L, L, L, L, L, L