next up previous contents
Next: update-node Up: Utility Programs Previous: Utility Programs   Contents


mk-sysimage

 Usage: mk-sysimage [OPTION]... $<$basedir$>$  

This program prepares a pre-installed linux distribution to be used as a master image for oneSIS cluster nodes.

basedir should be the root of the client's linux image.

Options:
-d, -dryrun Preview changes
-r, -revert Revert all files and services back to normal
-c, -config=FILE Specify alternate configuration file
-p, -patchfile=FILE Specify alternate distribution patch
-sp, -skippatch Skip distribution patch
-q, -quiet Suppress output

The mk-sysimage script reads the oneSIS configuration file, /etc/sysimage.conf, and alters components of the filesystem for oneSIS to operate correctly. It creates some directories, applies the patch file for the specific distribution (see section 4.6), and performs other helpful tasks.

Several directives in /etc/sysimage.conf require altering a file in the image to point to its corresponding location in /ram. mk-sysimage creates any new symbolic links to /ram and the corresponding `.default' files or directories.

mk-sysimage automatically restores files in the master image to their original state when they are removed from the configuration. It can also revert the entire filesystem back to its original state with the -revert option.

To ensure that configuration changes are reflected in the system image, it is recommended that the mk-sysimage script be run after changing any LINK* directives in the configuration.

For an image located in /var/lib/oneSIS/image, mk-sysimage would be run with:

Directives can be safely added or removed from the sysimage.conf file in any order.

Note: mk-sysimage will attempt to patch the target distribution every time it is run. A warning will be displayed unless a patch exists for the distribution or the -skippatch option is supplied. This is meant to encourage anyone hacking the rc scripts of a new distribution to develop a patch for it and feed that back to the oneSIS community.

Warning: If you manually alter your distribution's rc scripts, mk-sysimage will fail to apply the distribution patch and display long error messages. If you plan to do this, you can run mk-sysimage with the -skippatch option so it doesn't try re-patch the distribution.


next up previous contents
Next: update-node Up: Utility Programs Previous: Utility Programs   Contents
root 2017-02-23