This document provides instructions for setting up the Aegir hosting platform on a Linux server. It discusses what Aegir is, its history and requirements. It then provides step-by-step instructions for installing Aegir, which includes setting up the server with LAMP stack, creating an Aegir user, configuring Apache virtual hosts, installing Aegir from Git, configuring the database, and completing the Aegir installation wizard. Finally, it discusses creating a super administrator for Aegir and the file structure once Aegir is installed.

1. S
Aegir 0.4 Alpha 5
Use Aegir to generate Multiple Drupal websites
Drupal Camp – Toronto
October 2010
@mindtrades , Email: Vin@mindtrades.com

2. What is Aegir
S Aegir is a set of Drupal modules that helps you
maintain your Drupal sites.
S Provides you with a simple Drupal based hosting front
end for your entire network of sites
S It deployes the new site as a new node. So to create a
site you need to create a new site node.

3. History of Aegir
S Aegir was Developed initially by rain city studios and now
the development is headed by development seed. It is
head by Adrian Rossouw
S Adrian is a senior developer at Development Seed. He is
the father of Aegir, a set of contributed modules useful for
hosting and managing huge numbers of Drupal sites.A
Great Contribution to the Community.

4. Requirement for Aegir
S The instructions are mentioned on install.txt file ,we would go into details of
Architecture
S Your Own Linux server or a VPS ( 512 RAM min) as configuration requires you
to have root permissions.
S System requirement is same as to use Drupal as it is based completely on
Drupal.
S Vps Running Apache.We would work here with Apache 2, But the Script is
compatible with apache 1.x too.It also works well with Nginx
S Php 5.2- As Aegir would use drush, we would require php 5.2 and above
S Mysql would be the database server
S Would require MTA(mail Transfer agent) like Sendmail,postfix. This is required
to send emails when you add new sites.
S Other Utilities like : sudo,git and unzip is required because your script would
get installed directly from git. As a jquery library is used Unzip is essential to
extract

5. Step-1
S Set up wild card dns for your domain , Enter a new A
Record  eg * A 173.xxx.xxx.xxx
S apt-get install apache2 php5 php5-cli php5-mysql mysql-
server postfix
S apt-get install sudo git-core unzip( to install aegir from
git) Install all the packages Required: The Lamp stack

6. Step-2- Aegir User
S The provision framework would require script to be run as
non-root user for security and would have all file
permissions to be safe, so we need a non root user here
S adduser --system --group --home /var/aegir aegir
S adduser aegir www-data
This ensures that the file permissions on the hosted sites are always safe

7. Step-3 Apache Config
S The Rewrite module should be enabled and apache must
be configured to include aegir vhost path to read
configurations
S a2enmod rewrite
S echo "Include /var/aegir/config/vhost.d/" >
/etc/apache2/conf.d/aegir

8. Step 4-Database Configuration
S Login to mysql -p
S CREATE DATABASE aegir;
S GRANT SELECT, INSERT, UPDATE, DELETE, CREATE,
DROP, INDEX, ALTER,
S CREATE TEMPORARY TABLES, LOCK TABLES ON
aegir.* TO
S 'aegir'@'localhost' IDENTIFIED BY ’testing';

9. Step 5-Install Script
S http://git.aegirproject.org/?p=hostmaster.git;a=blob_plain;f=install.
sh.txt;hb=hostmaster-0.4-alpha5 ( Change the URL for your
domain name )
S su -s /bin/sh aegir –c "sh /var/tmp/install.sh.txt"
S apt-get install php-pear ( Drush broken error)
S pear install Console_Table
S cp /usr/share/php/Console/Table.php
/var/aegir/drush/includes/table.inc
S /etc/init.d/apache2 restart
Download from pear is broken; Critical bug has been submitted, Immediate fix
Is
To install pear console table and copy it into your standard install

10. Towards Aegir
S Now point your browser to
http://aegir.mindtrades.ca/install.php and proceed

11. Select Install Profile

12. DataBase Configuration

13. Site Configuration

14. Aegir Configuration

15. Web Server Settings
aegir ALL=NOPASSWD:
/usr/sbin/apache2ctl
Apache should be restarted every time
a new site is created

16. Creating Super Admin
S Log in to your mysql server as root, and type in the
following command: mysql -uroot -pXXXXXXXXX
mysql mysql> GRANT ALL PRIVILEGES ON *.* TO
'aegir_root'@'localhost' IDENTIFIED BY
'mypassword' WITH GRANT OPTION;
To create a super admin provide in order to create new databases

17. Super Admin

18. Final Steps
S f you are not logged in as aegir user, log in with
command : su -s /bin/sh aegirNow
S execute the following commands :
S cd /var/aegir/hostmaster-0.4-alpha5
S php /var/aegir/drush/drush.php --
uri=http://platform.mindtrades.ca hosting-setup

19. Final Steps

20. Success!

21. Import Site

22. Installed

23. Aegir Dashboard

24. Create Site

25. Site Creation

26. Host Master Profile

27. The File Structure

28. Easy Install Script: Barracuda(
By omega8 )
Installing Barracuda (main system and core Aegir instance)
S $ cd; wget http://github.com/omega8cc/nginx-for-
drupal/raw/master/BARRACUDA.sh.txt
S $ cd; nano BARRACUDA.sh.txt (edit your e-mail address)
S $ cd; bash BARRACUDA.sh.txt

29. Thanks
S Questions
S Email : vin@mindtrades.com
S Twitter: @mindtrades