S

Aegir 0.4 Alpha 5Use Aegir to generate Multiple Drupal websites

Drupal Camp – Toronto

October 2010

@mindtrades , Email: Vin@mindtrades.com

What is Aegir

Aegir is a set of Drupal modules that helps you maintain your Drupal sites.

Provides you with a simple Drupal based hosting front end for your entire network of sites

It deployes the new site as a new node. So to create a site you need to create a new site node.

History of Aegir

Aegir was Developed initially by rain city studios and now the development is headed by development seed. It is head by Adrian Rossouw

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.

Requirement for Aegir

The instructions are mentioned on install.txt file ,we would go into details of Architecture

Your Own Linux server or a VPS ( 512 RAM min) as configuration requires you to have root permissions.

System requirement is same as to use Drupal as it is based completely on Drupal.

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

Php 5.2- As Aegir would use drush, we would require php 5.2 and above

Mysql would be the database server Would require MTA(mail Transfer agent) like Sendmail,postfix. This is

required to send emails when you add new sites. 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

Step-1

Set up wild card dns for your domain , Enter a new A Record eg * A 173.xxx.xxx.xxx

apt-get install apache2 php5 php5-cli php5-mysql mysql-server postfix

apt-get install sudo git-core unzip( to install aegir from git)Install all the packages Required: The Lamp stack

Step-2- Aegir User

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

adduser --system --group --home /var/aegir aegir

adduser aegir www-data

This ensures that the file permissions on the hosted sites are always safe

Step-3 Apache Config

The Rewrite module should be enabled and apache must be configured to include aegir vhost path to read configurations

a2enmod rewrite

echo "Include /var/aegir/config/vhost.d/" > /etc/apache2/conf.d/aegir

Step 4-Database Configuration

Login to mysql -p

CREATE DATABASE aegir;

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, \

CREATE TEMPORARY TABLES, LOCK TABLES ON aegir.* TO \

'aegir'@'localhost' IDENTIFIED BY ’testing';

Step 5-Install Script

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 )

su -s /bin/sh aegir –c "sh /var/tmp/install.sh.txt" apt-get install php-pear ( Drush broken error) pear install Console_Table cp /usr/share/php/Console/Table.php

/var/aegir/drush/includes/table.inc /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

Towards Aegir

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

Select Install Profile

DataBase Configuration

Site Configuration

Aegir Configuration

Web Server Settings

aegir ALL=NOPASSWD: /usr/sbin/apache2ctl

Apache should be restarted every time a new site is created

Creating Super Admin

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

Super Admin

Final Steps

f you are not logged in as aegir user, log in with command : su -s /bin/sh aegirNow

execute the following commands :

cd /var/aegir/hostmaster-0.4-alpha5

php /var/aegir/drush/drush.php --uri=http://platform.mindtrades.ca hosting-setup

Final Steps

Success!

Import Site

Installed

Aegir Dashboard

Create Site

Site Creation

Host Master Profile

The File Structure

Easy Install Script: Barracuda( By omega8 )

Installing Barracuda (main system and core Aegir instance)

$ cd; wget http://github.com/omega8cc/nginx-for-drupal/raw/master/BARRACUDA.sh.txt

$ cd; nano BARRACUDA.sh.txt (edit your e-mail address)

$ cd; bash BARRACUDA.sh.txt

Thanks

Questions

Email : vin@mindtrades.com

Twitter: @mindtrades