Dorsal 0.7.2

The Dorsal project offers a set of simple scripts to help build the components of the FEniCS project (along with their dependencies) for various platforms.<br /><br />The following environments are currently supported by Dorsal:<br /><br />* Debian GNU/Linux 4.0, 5.0, unstable<br />* Fedora 10, 11<br />* Mac OS X 10.4, 10.5, 10.6 (with Fink, MacPorts)<br />* openSUSE 11.1<br />* Red Hat Enterprise Linux 4, 5<br />* Ubuntu 8.04 LTS, 8.10, 9.04, 9.10<br /><br />Fetch a copy of the script and start playing today!<br /><br />Usage:<br /><br />Basic scenario<br /><br />The simplest scenario is setting up everything for the first time on a supported platform. In order to do this, you:<br /><br /> 1. First tweak dorsal.cfg to your liking. This file is used, for instance, to define where you'd like to install the FEniCS projects once they are built.<br /> 2. Invoke the build script by running:<br /><br />./dorsal.sh<br /><br />If all goes according to plan, you should see a lot of compilation-related text scroll past your screen and eventually end up with a complete, up-to-date installation of various FEniCS projects and their corresponding dependencies.<br /><br />Don't forget to follow any post-build instructions before rushing off to try the demos!<br /><br />Repeated builds<br /><br />After initial setup, we find it tedious to build all projects from scratch every time we want to update to recent versions of FEniCS projects. In order to just build the few fast-changing projects you want on subsequent builds, you:<br /><br /> 1. Create a new platform file, say mymachine.platform, in the platforms folder. This file contains only a list of projects you want to repeatedly build, as well as environment variables pointing to already built projects, say PETSc, you're not keen on building again and again. See fenics.platform for an example of what I use on my machine.<br /> 2. Invoke the build script by running:<br /><br />./dorsal.sh platforms/mymachine.platform<br /><br />This will build only the projects you explicitly ask for, saving you a lot of time.<br /><br />Parallel stable and development builds<br /><br />A final advanced use of Dorsal is to maintain parallel stable and development builds of the FEniCS projects. In order to achieve this, you:<br /><br /> 1. Modify the variables dorsal.cfg to put stable builds in one location.<br /> 2. Run dorsal.sh<br /> 3. Modify the variables dorsal.cfg to put unstable builds in another location.<br /> 4. Run dorsal.sh again

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Build,  Builds,  Built,  Dorsal,  Dorsalcfg,  Dorsalsh,  Fenics,  Invoke,  Location,  Modify,  Order,  Project,  Projects,  Script,  Stable,  Unstable,  Variables
Users rating:	0/10