liteimg - Modify statelite image by creating a series of links.
liteimg [-h| --help]
liteimg [-v| --version]
liteimg imagename
This command modifies the statelite image by creating a series of links. It creates 2 levels of indirection so that files can be modified while in their image state as well as during runtime. For example, a file like <$imgroot>/etc/ntp.conf will have the following operations done to it:
mkdir -p $imgroot/.default/etc
mkdir -p $imgroot/.statelite/tmpfs/etc
mv $imgroot/etc/ntp.conf $imgroot/.default/etc
cd $imgroot/.statelite/tmpfs/etc
ln -sf ../../../.default/etc/ntp.conf .
cd $imgroot/etc
ln -sf ../.statelite/tmpfs/etc/ntp.conf .
When finished, the original file will reside in $imgroot/.default/etc/ntp.conf. $imgroot/etc/ntp.conf will link to $imgroot/.statelite/tmpfs/etc/ntp.conf which will in turn link to $imgroot/.default/etc/ntp.conf
Note: If you make any changes to your litefile table after running liteimg then you will need to rerun liteimg again.
For an image with rootfstype set to ramdisk, liteimg also packs the image into rootimg-statelite.gz. It writes the new file and its SHA-256 checksum, rootimg-statelite.gz.sha256, next to the existing files. It replaces them only when the new file is complete. Compute nodes check the file as described in packimage(1), and the rootimgchecksum attribute turns the check off in the same way.
imagename specifies the name of a os image definition to be used. The specification for the image is stored in the osimage table and linuximage table.
-h|--help Display usage message.
-v|--version Command Version.
0 The command completed successfully.
1 An error has occurred.
1. To lite a RHEL 6.6 statelite image for a compute node architecture x86_64 enter:
liteimg rhels6.6-x86_64-statelite-compute/opt/xcat/bin/liteimg
This command is part of the xCAT software product.