SPACEflight/Mastering Guide
From SPACE Wiki
Back to SPACEflight
How to create a fresh SPACEflight
Building a custom SPACEflight demonstrator at any time avoids waiting for the next official version and allows for easy customisation. Through heavy automation of the build process, it is relatively straight-forward to remaster a SPACEflight image.
- Setup an operating system to build the system on. This is usually a standard Debian/Ubuntu machine. Building is recommended on Debian squeeze and Ubuntu lucid.
- Check out the Code Repository to get the source code of SPACE components with packaging metadata and build scripts.
- Run media/devsetup.sh to set up your environment with all the nifty build tools which exist to optimise the media creation process.
- Decide whether to build upon the stable (or just outdated) prepackaged platform services or to build them from scratch. The latter choice gives you the most recent software but takes significantly longer. You can skip the following sub-bullets if you don't need this.
- Follow the instructions from the end of devsetup.sh to check out the SPACE code from its Git repostitory and to create a pbuilder environment. Decide for a Debian or Ubuntu base.
- Run the packaging/autobuilder.sh script. Optionally, pass exclude-foreign.pkgs as argument starting from the second run to speed up the build.
- Create the live distribution directory (in a chroot) by running media/bootstrap.sh. Before, check its settings to match your Debian/Ubuntu choice and some other options.
- Create an image for USB sticks or for DVDs by running media/createimg.sh or media/createiso.sh.
- For writing to media or testing in virtual machines: Follow the instructions in media/production.txt.
- Image post-processing: For the IoS desktop integration, have a look at packaging/scripts/iosdesktop.
Build process
The software is being compiled (if necessary) and put into packages with description and dependency metadata. Packages can be installed on any system or be further processed into a live medium.
