imgcapture - Captures an image from a Linux diskful node and create a diskless image on the management node.
imgcapture node [-p|--profile profile] [-o|--osimage osimage] [-i nodebootif] [-n nodenetdrivers] [-V|--verbose] imgcapture [-h | --help] | [-v | --version]
The imgcapture command will capture an image from one running diskful Linux node, prepares the rootimg directory, kernel and initial rmadisks for the liteimg/packimage command to generate the statelite/stateless rootimg.
The node should be one diskful Linux node, managed by the xCAT MN, and the remote shell between MN and the node should have been configured. AIX is not supported.
The osver, arch and profile attributes for the stateless/statelite image to be created are duplicated from the node's attribute. If the -p|--profile profile option is specified, the image will be created under ``/<installroot>/netboot/<osver>/<arch>/<profile>/rootimg''.
The default files/directories excluded in the image are specified by /opt/xcat/share/xcat/netboot/<os>/<profile>.<osver>.<arch>.imgcapture.exlist; also, you can put your customized file (<profile>.<osver>.<arch>.imgcapture.exlist) to /install/custom/netboot/<osplatform>. The directories in the default .imgcapture.exlist file are necessary to capture image from the diskful Linux node managed by xCAT, please don't remove it.
The image captured will be extracted into the /<installroot>/netboot/<osver>/<arch>/<profile>/rootimg directory.
After the imgcapture command returns without any errors, you can customize the rootimg and run the liteimg/packimage command with the options you want.
Assign profile as the profile of the image to be created.
Assign the pre-defined osimage object. The attributes of osimage will be used to capture and prepare the root image.
The network interface the diskless node will boot over (e.g. eth0), which is used by the genimage command to generate initial ramdisks.
This is optional.
The driver modules needed for the network interface, which is used by the genimage command to generate initial ramdisks.
This is optional. By default, the genimage command can provide drivers for the following network interfaces:
For x86 or x86_64 platform:
tg3 bnx2 bnx2x e1000 e1000e igb m1x_en
For ppc64 platform:
e1000 e1000e igb ibmveth ehea
For S390x:
qdio ccwgroup
If the network interface is not in the above list, you'd better specify the driver modules with this option.
Display the usage message.
Display the version.
Verbose output.
0 The command completed sucessfully.
1 An error has occurred.
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:
imgcapture node1
2. In order to capture and prepare the root image with hpc as profile, run the command:
imgcapture node1 -p hpc
3. In order to capture and prepare the root image: its profile is hpc, and the network interface the diskless node will boot over is eth0, the driver modules for this network interface is e1000e.
imgcapture node1 -p hpc -i eth0 -n e1000e
4. There's one pre-defined osimage. In order to capture and prepare the root image for osimage, run the command: imgcapture node1 -o osimage
=head1 FILES
/opt/xcat/bin/imgcapture
genimage(1), imgimport(1), imgexport(1), packimage(1), liteimg(1)