This site is a static archive of the Aegir community site. Documentation has moved to http://docs.aegirproject.org. Other community resources can be found on the Contacting the community page.
Skip navigation

Revision of How about moving install documentation back here? from Mon, 02/28/2011 - 19:56

Help

How about moving install documentation back here?

Referenced Page: 
Installation Guide

It seems that people want the install documentation here. I take for example this page that details a (non-official!) install script for Ubuntu, while the INSTALL.txt is almost an install script in itself for Debian derivatives.

It seems to me that people are not reading the stuff in the docs/ directory out there. Even worse, we have installation instructions stuck in the issue queue since forever for Gentoo and FreeBSD...

I therefore propose that we move all the documentation from the git repository into the Handbook, now that we have one that stands. (One of the reasons why we had docs in git was that the wiki on groups.drupal.org was utterly chaotic and scary.) I am not sure yet, but I think we can merge (gasp!) the HINTS files into the INSTALL.txt to provide a one-size-fits-all handbook that covers all supported platforms. The examples can be separated by platform in each page

I propose the following structure, with each item here being a page in the handbook.

You will understand from there that I would gladly ditch the current install.sh (my long-lasting phantasm) in favor of Debian packages or scripts (like barracuda or this Ubuntu one ) that actually run as root and do everything up to hostmaster-install. Now, I don't like the idea of giving people stuff to run as root, but since others seem to be doing it and posting it in our wiki, might as well cut our losses, commit that script to provision, and maintain it. If people don't want to run stuff as root, then they follow the manual install process, which covers all cases anyways.

How does this sound? Who wants to do that magic?

Need help?

The revisions let you track differences between multiple versions of a post.

Discussion

The discussion area lets your team communicate by posting updates and discussing issues. It is a great place for sharing progress, discussing challenges, and exploring ideas.