liteimg.1¶

NAME¶

liteimg - Modify statelite image by creating a series of links.

SYNOPSIS¶

liteimg [-h| –help]

liteimg [-v| –version]

liteimg [-o OS] [ -p profile] [-a architecture] [-t rootfstype]

liteimg imagename

DESCRIPTION¶

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.

Parameters¶

imagename specifies the name of a os image definition to be used. The specification for the image is storted in the osimage table and linuximage table.

OPTIONS¶

-h Display usage message.

-v Command Version.

-o Operating system (fedora8, rhel5, sles10,etc)

-p Profile (compute,service)

-a Architecture (ppc64,x86_64,etc)

-t The type of rootfs for the image (nfs, ramdisk). It is optional, nfs is used to be the rootfs type when -t is not specified.

RETURN VALUE¶

0 The command completed successfully.

1 An error has occurred.

EXAMPLES¶

To lite a fedora8 image for a compute node architecture x86_64 enter:

liteimg -o fedora8 -p compute -a x86_64

FILES¶

/opt/xcat/bin/

NOTES¶

This command is part of the xCAT software product.