profiles/hostmaster/INSTALL.txt

-*-rst-*-

This document is formatted using the ReST syntax.

Aegir 0.2 installation instructions
===================================

This document describes briefly how to install a multi-platform,
single-server Aegir Drupal provisionning system. Those instructions
limit themselves to getting you into the Aegir wizard, which will then
give you further configuration instructions.

This document assumes the Aegir home is in /var/aegir, adapt as desired,
but make sure that the user you create (as suggested in the install
wizard) has this directory configured as its home directory.

Checking out the code
---------------------

This assumes you have installed CVS and have access to the /var
directory. This may require running those steps as root.

Shell commands::
 cd /var
 cvs -z6 -d:pserver:anonymous:anonymous@cvs.drupal.org:/cvs/drupal co -d aegir/drupal-5.x -r DRUPAL-5-12 drupal
 cd aegir/drupal-5.x/
 cvs co -d profiles/hostmaster contributions/profiles/hostmaster
 cvs co -d sites/default/modules/hosting contributions/modules/hosting
 cd /var/aegir
 cvs co -d drush  contributions/modules/drush
 mkdir .drush
 cvs co -d .drush/provision  contributions/modules/provision

Apache configuration
--------------------

Those instructions assume you are running Debian specific and
installing aegir in http://aegir.example.com. If you are running
another system you basically need to:

 1. create a directory for Aegir configs
 2. activate the mod_rewrite engine
 3. include the Aegir apache configurations in Apache
 4. create a base configuration file for Aegir in /var/aegir/config/vhost.d/aegir.example.com
 5. restart apache

So this needs to be ran as root too.

Shell commands::
 cd /var/aegir
 mkdir -p config/vhost.d/
 a2enmod rewrite
 echo "Include /var/aegir/config/vhost.d/" > /etc/apache2/conf.d/aegir
 cp drupal-5.x/profiles/hostmaster/apache2.conf.txt config/vhost.d/aegir.example.com
 /etc/init.d/apache2 restart

Database configuration
----------------------

Here you want to make a basic database configuration for the Drupal
you are going to install. You want to run those commands using your
database 'root' user.

SQL commands::
 CREATE DATABASE aegir;
 GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, \
  CREATE TEMPORARY TABLES, LOCK TABLES ON aegir.* TO \
  'aegir'@'localhost' IDENTIFIED BY 'XXXXXXXX';

Install the Drupal
------------------

Now you are ready to install the first Drupal using this installation
profile. Point your browser to http://aegir.example.com/ , assuming
DNS is properly configured to point to your webserver, otherwise you
may want to try http://localhost/ .

The installer is going to complain about the permissions of
settings.php, just fix the permissions:

Shell commands::
 chmod a+w /var/aegir/drupal-5.x/sites/default/settings.php

Select the hostmaster install profile, enter the database credentials
you setup above and then the installer will prompt you to secure the
permissions on the settings.php file again:

Shell commands::
 chmod a-w /var/aegir/drupal-5.x/sites/default/settings.php

Follow the wizard
-----------------

You should now be in the installation wizard. The wizard is usually
self-documenting so you should just be able to follow the instructions
in the wizard to configure Aegir to properly use the webserver and
database server.

Installing new platforms
------------------------

To deploy new platforms to provisions site to, you simply need to
download the platform source code (which can be done with drush) and
then, on the hostmaster site, create a new Platform node which points
to where the source was downloaded.

Shell commands::
 cd /var/aegir
 ./drush/drush.php dl drupal

Use "drush dl drupal-5.x" to get the latest release of the 5.x branch.
1	--rst--
2
3	This document is formatted using the ReST syntax.
4
5	Aegir 0.2 installation instructions
6	===================================
7
8	This document describes briefly how to install a multi-platform,
9	single-server Aegir Drupal provisionning system. Those instructions
10	limit themselves to getting you into the Aegir wizard, which will then
11	give you further configuration instructions.
12
13	This document assumes the Aegir home is in /var/aegir, adapt as desired,
14	but make sure that the user you create (as suggested in the install
15	wizard) has this directory configured as its home directory.
16
17	Checking out the code
18	---------------------
19
20	This assumes you have installed CVS and have access to the /var
21	directory. This may require running those steps as root.
22
23	Shell commands::
24	cd /var
25	cvs -z6 -d:pserver:anonymous:anonymous@cvs.drupal.org:/cvs/drupal co -d aegir/drupal-5.x -r DRUPAL-5-12 drupal
26	cd aegir/drupal-5.x/
27	cvs co -d profiles/hostmaster contributions/profiles/hostmaster
28	cvs co -d sites/default/modules/hosting contributions/modules/hosting
29	cd /var/aegir
30	cvs co -d drush contributions/modules/drush
31	mkdir .drush
32	cvs co -d .drush/provision contributions/modules/provision
33
34	Apache configuration
35	--------------------
36
37	Those instructions assume you are running Debian specific and
38	installing aegir in http://aegir.example.com. If you are running
39	another system you basically need to:
40
41	1. create a directory for Aegir configs
42	2. activate the mod_rewrite engine
43	3. include the Aegir apache configurations in Apache
44	4. create a base configuration file for Aegir in /var/aegir/config/vhost.d/aegir.example.com
45	5. restart apache
46
47	So this needs to be ran as root too.
48
49	Shell commands::
50	cd /var/aegir
51	mkdir -p config/vhost.d/
52	a2enmod rewrite
53	echo "Include /var/aegir/config/vhost.d/" > /etc/apache2/conf.d/aegir
54	cp drupal-5.x/profiles/hostmaster/apache2.conf.txt config/vhost.d/aegir.example.com
55	/etc/init.d/apache2 restart
56
57	Database configuration
58	----------------------
59
60	Here you want to make a basic database configuration for the Drupal
61	you are going to install. You want to run those commands using your
62	database 'root' user.
63
64	SQL commands::
65	CREATE DATABASE aegir;
66	GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, \
67	CREATE TEMPORARY TABLES, LOCK TABLES ON aegir.* TO \
68	'aegir'@'localhost' IDENTIFIED BY 'XXXXXXXX';
69
70	Install the Drupal
71	------------------
72
73	Now you are ready to install the first Drupal using this installation
74	profile. Point your browser to http://aegir.example.com/ , assuming
75	DNS is properly configured to point to your webserver, otherwise you
76	may want to try http://localhost/ .
77
78	The installer is going to complain about the permissions of
79	settings.php, just fix the permissions:
80
81	Shell commands::
82	chmod a+w /var/aegir/drupal-5.x/sites/default/settings.php
83
84	Select the hostmaster install profile, enter the database credentials
85	you setup above and then the installer will prompt you to secure the
86	permissions on the settings.php file again:
87
88	Shell commands::
89	chmod a-w /var/aegir/drupal-5.x/sites/default/settings.php
90
91	Follow the wizard
92	-----------------
93
94	You should now be in the installation wizard. The wizard is usually
95	self-documenting so you should just be able to follow the instructions
96	in the wizard to configure Aegir to properly use the webserver and
97	database server.
98
99	Installing new platforms
100	------------------------
101
102	To deploy new platforms to provisions site to, you simply need to
103	download the platform source code (which can be done with drush) and
104	then, on the hostmaster site, create a new Platform node which points
105	to where the source was downloaded.
106
107	Shell commands::
108	cd /var/aegir
109	./drush/drush.php dl drupal
110
111	Use "drush dl drupal-5.x" to get the latest release of the 5.x branch.