diff --git a/xCAT-client/pods/man1/imgexport.1.pod b/xCAT-client/pods/man1/imgexport.1.pod index 7ba54f11e..a7ef501b2 100644 --- a/xCAT-client/pods/man1/imgexport.1.pod +++ b/xCAT-client/pods/man1/imgexport.1.pod @@ -6,28 +6,57 @@ B - Exports an xCAT image. B -B -B I +B =head1 DESCRIPTION -The imgexport command will export an image that is being used by xCAT. To export images, you must have the images defined in the osimage table. -The following columns must be filled out for an image to be exported: -osimage.imagename -osimage.profile -osimage.provmethod -osimage.osvers -osimage.osarch +The imgexport command will export an image that is being used by xCAT. To export images, you must have the images defined in the I table. All the columns in the I and I tables will be exported. In addition, the following files will also be exported. + +For statefull: + x.pkglist + x.otherpkgs.pkglist + x.tmpl + x.synclist + +For stateless: + kernel + intied.gz + rootimg.gz + x.pkglist + x.otherpkgs.pkglist + x.synclist + x.postinstall + x.exlist + + +For statelite: + intied.gz + x.pkglist + x.synclist + x.otherpkgs.pkglist + x.postinstall + x.exlist + +where x is the name of the profile. + +Any files specified by the -e flag will also be exported. If -p flag is specified, the postscripts and the postbootscripts for the given node will be exported. =head1 OPTIONS -B<-h> Display usage message. +B<-e|--extra> I Pack up extra files. If I is omitted, the destination directory will be the same as the source directory. -B<-v> Verbose output. +B<-h|--help> Display usage message. + +B<-p|--postscripts> I Get the postscripts for the given node and pack it into the image. + +B<-v|--verbose> Verbose output. + +I The name of the image. Use I osimage to find out all the image names. + +I The output bundle file name. -B<-extra srcfile:destdir> Pack up extra files =head1 RETURN VALUE @@ -41,17 +70,19 @@ B<-extra srcfile:destdir> Pack up extra files B -foo.tgz will be built in the current working directory. Make sure that you have enough space in the directory -that you are in to run imgexport if you have a big image to tar up. +foo.tgz will be built in the current working directory. Make sure that you have enough space in the directory that you are in to run imgexport if you have a big image to tar up. 2. To include extra files with your image: -B +B -This will export the image Default_stateless_1265981465 into a file called foo.tgz. In addition, it will package up extra files as well: - compute.centos5.4.pkglist - compute.exlist -It will also place the contents of the file in the manifest.xml file that is part of the bundle. +In addition to all the default files, this will export I and the whole directory I into the file called foo.tgz. And when imgimport is called I will be copied into the same directory and I will be copied to I. + +3. To include postscripts with your image: + +B + +The I and the I specified in the I table for node1 will be exported into the image. =head1 FILES diff --git a/xCAT-client/pods/man1/imgimport.1.pod b/xCAT-client/pods/man1/imgimport.1.pod index a24e4ee4b..f1f696409 100644 --- a/xCAT-client/pods/man1/imgimport.1.pod +++ b/xCAT-client/pods/man1/imgimport.1.pod @@ -1,25 +1,75 @@ =head1 NAME -B - Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin -deploying with it.. +B - Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin deploying with it. =head1 SYNOPSIS -B +B -B I [-v] +B bundle_file_name [-p|--postscripts nodelist] [-f|--profile new_profile] [-v|--verbose]> =head1 DESCRIPTION -The imgimport command will import an image that has been exported by imgexport from xCAT. This is the easiest way -to transfer/backup/ or share images created by xCAT whether they be stateless or stateful. +The imgimport command will import an image that has been exported by I from xCAT. This is the easiest way to transfer/backup/, change or share images created by xCAT whether they be stateless or stateful. The bundle file will be unpacked in the current working directory. The xCAT configuration such as I and I tables will then be updated. + +For statefull, the following files will be copied to the appropriate directories. + x.pkglist + x.otherpkgs.pkglist + x.tmpl + x.synclist + +For stateless, the following files will be copied to the appropriate directories. + kernel + intied.gz + rootimg.gz + x.pkglist + x.otherpkgs.pkglist + x.synclist + x.postinstall + x.exlist + +For statelite, the following files will be copied to the appropriate directories. + intied.gz + x.pkglist + x.synclist + x.otherpkgs.pkglist + x.postinstall + x.exlist + +where x is the profile name. + +Any extra files, included by --extra flag in the imgexport command, will also be copied to the appropriate directories. + +If -p flag is specified, the I table will be updated with the postscripts and the postbootscripts from the image for the nodes given by this flag. + +If -f flag is not specified, all the files will be copied to the same directories as the source. If it is specified, the old profile name x will be changed to the new and the files will be copied to the appropriate directores for the new profiles. For example, I will be copied to I and I will be copied to I. This flag is commonly used when you want to copy the image on the same xCAT mn so you can make modification on the new one. + +After this command, you can run the I command and then start deploying the nodes. You can also choose to modify the files and run the following commands before the node depolyment. + +For statefull: + nodeset + +For stateless: + genimage + packimage + nodeset + +For statelite + genimage + liteimg + nodeset + =head1 OPTIONS -B<-h> Display usage message. +B<-f|--profile> I Import the image with a new profile name. -B<-v> Verbose output. +B<-h|--help> Display usage message. + +B<-p|--postscripts> I Import the postscripts. The postscripts contained in the image will be set in the postscripts table for I. + +B<-v|--verbose> Verbose output. =head1 RETURN VALUE @@ -34,8 +84,16 @@ B<-v> Verbose output. I -foo.tgz will be unpacked in the current working directory. The xCAT configuration will then be updated and the -files will be copied to the appropriate directories. + +2. Import the image with postscripts + +I + + +3. Import the image with a new profile name + +I + =head1 FILES