Chapter 1. Installation

The stasher and LIBCXX development toolkits must be installed before building distreboot. On Fedora, executing rpmbuild -ta stasher-distreboot-version.tar.bz2 produces an RPM package. Execute systemctl enable stasher-distreboot.service and systemctl start stasher-distreboot.service. If the server has more than one object repository node directory (and multiple instances of the stasher server), distreboot needs to know which one to use. Edit stasher-distreboot.service, or install an override in /etc/systemd, and add the --node directory parameter after --start.

distreboot gets installed on all nodes in a stasher cluster. Install the RPM package on every node in the stasher cluster. On other Linux distributions, use the following instructions as a guide to preparing a similar installable package.

  1. Unpack the tarball, run the configure script, that takes the usual autoconf options, followed by make or gmake.

    Note

    The same configure options, specifically the installation directories, that were used to build stasher are required. Otherwise distreboot will not get installed properly.

  2. Execute make install DESTDIR=/tmp/instimage. This creates an installation image in /tmp/instimage (or some other directory of your choosing). Use this installation image to create an installable package for your platform.

  3. distreboot's application properties must be configured by the installation script. The default configuration installs distreboot in /usr/local/sbin, and the property file in /usr/local/etc. The installation script should then execute the following, as part of distreboot package instllation:

    properties --set /usr/local/etc/distreboot.properties /usr/local/sbin/distreboot

    Adjust the directories according to any non-default options to the configure script. Alternatively, if your platform's installable package format preserves extended file attributes, this can be executed as part of the package build script, and have include the distreboot binary, with the extended attribute that points to the property file, in the installable package. See properties(1) for more information.