Root-fs-installer

DOCUMENT NOT FINISHED YET!

Using it
Instead of the manual procedure, you can use the root-fs-installer script to automatically install and set up a completely working root_fs. The script can be used with both the source (.tar.gz) or APT VNUML installations, although the last one is recommended.

In order to use the root-fs-installer script:


 * Download it


 * Invoke it, using the desired root_fs release as single argument. For example, if you want to get the 0.5.0 release.

perl root-fs-installer 0.5.0

That's all!

Features
The script will deal with the downloading of the .bz2 file (looking for a working mirror), unzipping, checking of MD5SUMs, installing in the proper place (either /usr/share/vnuml/filesystems/ or /usr/local/share/filesystems/, depending of your installation; if both directories exits, the former takes preference over the later) and updating the root_fs_tutorial symlink (to point to the greater root_fs version, maybe the one donwloaded.

Moreover, if you have installed the linux-um package ('apt-get linux-um'), the script looks for the modules in /usr/share/linux-um and automatically install them in the just downloaded root_fs.

Of course, the script can not do miracles and some circumstances make it to fail (e.g., no one mirror can be found because your Internet connection is broken). In that case, it report the user what the cause of the problem was, aiming it to execute it again when the error condition has been solved.

The script is designed to be polite, so it does not remove any conflicting file (typically, a root_fs_tutorial with the same name in /usr/share/vnuml/filesystem). In that case, the existing file is rename, suffixing it with the token 'old' plus a random string.