Manual Installation

Tagged:

Aegir installation seems difficult at first, but once you get around it, it's fairly simple. It's 3 basic steps::

  1. Install the system requirements
  2. Configure system requirements, which include:
  3. Complete the installation by either:
    • running the install script, or
    • installing Drush & Provision manually, then invoking 'hostmaster-install'.

Note that these instructions setup a complete Aegir system. If you want to only setup a new remote web/db server, it should be sufficient to system requirements (step 1), configure them (step 2) and follow the Remote server how-to.

These instructions provide example commands for a Debian-like distribution, but should be fairly easy to adapt to other environments. In fact, this document is meant as a canonical reference that should work on every platform and that can be used for people porting Aegir to new platforms or installing on alien platform for which Aegir is not yet packaged.

Platform-specific cheat sheets are also available for other platforms in HINTS_*.txt files alongside this document. Those files are basically a bullet-point summary of the steps required for the installation. In case of conflict between INSTALL.txt and other documentation, INSTALL.txt should be considered the canonical source of information.

#1

A few points just on installing drush with RedHat 6 that I seem to run in to every time.

When I try to discover the pear channel as aegir user I get could not create lock file: fopen(/usr/share/pear/.lock): failed to open stream: Permission denied

I also get the following after I make the aegir user owner of the .lock file

pear channel-discover pear.drush.org
Discovering channel pear.drush.org over http:// failed with message: channel-add: adding Channel "pear.drush.org" to registry failed
Trying to discover channel pear.drush.org over https:// instead
Discovery of channel "pear.drush.org" failed (channel-add: Cannot open "https://pear.drush.org/channel.xml" (Connection to `pear.drush.org:443' failed: Connection refused))

I can add it with root user but when installing drush I get

pear install drush/drush-5.8.0
Cannot install, php_dir for channel "pear.drush.org" is not writeable by the current user

I always have to install drush as root and then modify ownership/permissions to aegir user. Is the documentation wrong, or am I missing something?

Also, for drush 5 it seems that 'http://download.pear.php.net/package/Console_Table-1.1.3.tgz' is a dependency!