===============================================
Aegir -- Fedora installation instructions hints
This is a helper file to the canonical INSTALL.txt. It is aimed at
helping you install Aegir on CentOS. It simply lists commands that
diverge from the base INSTALL.txt in a concise document that will be
easy to maintain in the long term.
It is recommended that the INSTALL.txt document is consulted before
going ahead with this install.
We reuse the same process describe in that document:
- Install requirements
- Configure system requirements, which include:
- create a Aegir user
- configure Apache, MySQL, DNS, etc
- Install the Aegir files
- Follow the install wizard
1. Install software requirements
My install was using an AMAZON dedicated server, so it was pre-installed with Apache, PHP 5.2, and MYSQL. It didd not have FTP, and still does not, so scp is the way to upload stuff into that environment.
If this is not the case for you, using yum to download apache, php, mysql, and postgres should work.
2. Configure system requirements
Shell commands::
useradd -b /var/aegir aegir
usermod -a aegir apache
chmod -R 755 /var/aegir
# Include the Aegir config
Add to end of /etc/httpd/conf/httpd.conf :
Include /var/aegir/config/vhost.d
service mysqld start
# Optional: set the mysql root password
mysqladmin password $password
mysql -uroot -p
The last two lines can also be (better) accomplished using the
mysql_secure_installation script.
MySQL commands::
# Replace 'aegir_password' with the chosen password for 'aegir' mysql account
CREATE DATABASE aegir;
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, \
CREATE TEMPORARY TABLES, LOCK TABLES ON aegir.* TO \
'aegir'@'localhost' IDENTIFIED BY 'aegir_password';
# Create a mysql super user (with GRANT OPTION)
# Replace 'aegir_root_password' with a new password
GRANT ALL PRIVILEGES ON . TO 'aegir_root'@'localhost' \
IDENTIFIED BY 'aegir_root_password' WITH GRANT OPTION;
You may need to edit your local hosts file to get the aegir domain to work if you have not already added a DNS record for this.
3. Install the Aegir files
Shell commands::
su aegir -c "sh install.sh.txt -w apache"
/etc/init.d/httpd restart
4. Follow the install 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.
5. Common issues
There are various caveats on running Aegir on Fedora.
In my case i had to use /etc/init.d/httpd restart in order to restart apache properly.
You may need to adjust CentOS's firewall settings to allow HTTP
traffic on port 80. If you installed CentOS with a UI, enable
"Firewall settings -- WWW (HTTP)".
Also, in some configurations, it seems necessary to restart crond for
the user crontab changes to take effect (very bizarre). For that, use:
Shell commands::
service crond restart
See http://drupal.org/node/632308 if you have more information about
this issue.
The default sudo configuration in CentOS requires sudo to run in a real
TTY which will make verify and install tasks failed with the message:
"Web server could not be restarted. Changes might not be available
until this has been done"
For sudo to behave properly, you should comment out the following line
in your /etc/sudoers file: