Index: INSTALL.txt
===================================================================
RCS file: /cvs/drupal/contributions/profiles/hostmaster/INSTALL.txt,v
retrieving revision 1.30
diff -u -p -r1.30 INSTALL.txt
--- INSTALL.txt	19 Aug 2009 02:40:51 -0000	1.30
+++ INSTALL.txt	19 Aug 2009 06:29:16 -0000
@@ -47,6 +47,10 @@ You will require a MySQL server, obvious
 dedicated server since Aegir will create MySQL users, since it will
 require a "root" MySQL user.
 
+One can install MySQL as a server on Debian-based distributions as follows:
+Shell commands::
+ sudo apt-get install mysql-server
+
 Mail transfer agent
 -------------------
 
@@ -84,13 +88,25 @@ wizard) has this directory configured as
 Checking out the code
 ---------------------
 
-This assumes you have installed CVS. Those commands should be ran as the
-aegir user and assume it can write to /var/aegir.
+This assumes you have installed CVS. CVS can be installed on Debian-based
+systems with the following command:
+
+Shell commands::
+ sudo apt-get install cvs
+
+The following commands also assume that you have created the 'aegir' user 
+with a home directory of '/var/aegir'.
+
+On Debian-based systems this can be achieved with:
+
+Shell commands::
+ adduser --home /var/aegir aegir 
 
+These commands should be ran as the aegir user and assume it can write to /var/aegir.
 
 Shell commands::
  export CVSROOT=:pserver:anonymous:anonymous@cvs.drupal.org:/cvs/drupal
- mkdir /var/aegir
+ mkdir -p /var/aegir
  cd /var/aegir
  cvs co -d drush -rDRUPAL-6--2-0 contributions/modules/drush
  mkdir .drush
@@ -100,14 +116,15 @@ Shell commands::
  cd drupal-6.*
  cvs co -d profiles/hostmaster -rDRUPAL-6--0-3 contributions/profiles/hostmaster
  cd profiles/hostmaster
- /var/aegir/drush/drush.php dl hosting install_profile_api 
+ mkdir modules
+ /var/aegir/drush/drush.php dl --destination=/var/aegir/drupal-6.*/profiles/hostmaster/modules hosting install_profile_api
 
 We still use CVS to checkout the hostmaster profile because drush has
 problems downloading profiles: http://drupal.org/node/500324
 
 The above should install version 2.1 of install_profile_api and the
 proper versions (0.3) of the hosting, hostmaster and provision
-projets. Make sure the versions reported by drush in the output seem
+projects. Make sure the versions reported by drush in the output seem
 right.
 
 Checking out the optional components
@@ -124,7 +141,8 @@ document.
 
 Shell commands::
  cd drupal-6.*/profiles/hostmaster
- /var/aegir/drush/drush.php dl eldir admin_menu
+ /var/aegir/drush/drush.php dl --destination=/var/aegir/drupal-6.*/profiles/hostmaster/modules admin_menu
+ /var/aegir/drush/drush.php dl --destination=/var/aegir/drupal-6.*/profiles/hostmaster/themes eldir
 
 Apache configuration
 --------------------
@@ -139,16 +157,21 @@ another system you basically need to:
  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.
+So this needs to be run as root too.
 
 Shell commands::
  cd /var/aegir
  mkdir -p config/vhost.d/
+ chown -R aegir:aegir config
+ chmod 0700 /var/aegir/config
  a2enmod rewrite
  echo "Include /var/aegir/config/vhost.d/" > /etc/apache2/conf.d/aegir
  echo "NameVirtualHost *:80" >> /etc/apache2/conf.d/aegir
  cp drupal-6.*/profiles/hostmaster/apache2.conf.txt config/vhost.d/aegir.example.com
  /etc/init.d/apache2 restart
+ mkdir /var/aegir/backups
+ chown aegir:aegir /var/aegir/backups
+ chmod 0700 /var/aegir/backups
 
 You MUST modify the config/vhost.d/aegir.example.com to suit your
 needs (particularly the path leading to the Drupal core
@@ -194,17 +217,26 @@ SQL commands::
 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/ .
+We are almost ready to install the first Drupal using this installation
+profile. The installer is going to complain about the missing settings.php.
+
+It is recommended that you create the aegir site as a real site in the sites/
+directory. The following commands will create this site directory and create
+the settings.php and files directory with the appropriate permissions to
+proceed through the installer.
 
-The installer is going to complain about the missing settings.php. It
-is recommended that you create the aegir site as a real site.
+Run these commands as the aegir user.
 
 Shell commands::
  mkdir drupal-6.*/sites/aegir.example.com
+ cp drupal-6.*/sites/default/default.settings.php drupal-6.*/sites/aegir.example.com/settings.php
  chmod a+w drupal-6.*/sites/aegir.example.com/settings.php
+ mkdir drupal-6.*/sites/aegir.example.com/files
+ chmod 2770 drupal-6.*/sites/aegir.example.com/files
+
+Now 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/ .
 
 Select the hostmaster install profile, enter the database credentials
 you setup above and then the installer will prompt you to secure the