Commit d4e1697b authored by Adrian Rossouw's avatar Adrian Rossouw

Updated install and upgrade docs.

parent f7fde0bf
......@@ -208,22 +208,22 @@ Apache configuration as above, with the same user name and directory paths. SSH
public/private keys should be set up so hostmaster's Aegir user can access
remote web Aegir users with no passwords.
They will also need a login shell, which can be modified using the `chsh` command.
Shell command as root::
chsh -s /sbin/sh aegir
Database configuration
----------------------
If you are only running a single server instance of Aegir, the default mysql
configuration will be sufficient for your needs, and you won't need to modify
your configuration file.
If you are going to be managing multiple servers, you will need to adjust your
mysql configuration file to modify the ``bind-address`` setting and change
it to correctly represent your public ip address.
To make sure that the Aegir backend, and all the possible web servers can
reach your database server, you need to configure mysql to listen on all
the public IP addresses available to it.
/etc/mysql/my.conf configuration line to change::
/etc/mysql/my.conf configuration line to comment out::
bind-address = 127.0.0.1
Wether you are running multiple servers or not, you should take this opportunity
to restart mysql, to clear any caches.
Now you need to restart mysql, to clear any caches.
Shell command as root::
/etc/init.d/mysql restart
......@@ -232,6 +232,13 @@ The installer will prompt you for your MySQL root user password. It will
not store this information, but instead use it to generate a new super
user account for the aegir system.
Even though MySQL is now listening on all IP's, it will not allow invalid users
to connect to the databases, without the correct user accounts configured.
If you are concerned about MySQL being accessible in this way, you can also
configure your firewall to only allow incoming connections from certain addresses.
This is outside the scope of this document however.
3. Run the install script
=========================
......@@ -251,7 +258,6 @@ the official release.). You can modify which version to install by editing the
AEGIR_VERSION variable in the script.
Shell commands::
su -s /bin/sh aegir -c "sh install.sh.txt aegir.example.com"
Note you must run this as root or prefix with sudo.
......
......@@ -150,7 +150,67 @@ simply be run again when a new security release of Drupal is made available.
Version-specific upgrade notes
==============================
0.4 - multi server support
0.4 - DNS Configuration
-----------------------
Aegir requires that the hostname returned by the `hostname` and `uname -n`
shell commands, resolves to the IP address for this server.
Shell commands as root::
AEGIR_HOST=`uname -n`
resolveip $AEGIR_HOST
If the command returns your IP address, you are all set. If it returns
an error you will need to edit your ``/etc/hosts`` file.
First line of this file looks like:
``127.0.0.1 localhost``
Simply add all domains you want to this line. e.g:
``127.0.0.1 localhost $AEGIR_HOST $AEGIR_DOMAIN other1 other2``
If you only intend to use Aegir on a single server, it is acceptable for
the resolved IP address to be the '127.0.0.1' loopback address.
If you intend to manage multiple servers using Aegir, you will need to
make sure that the IP address is the public IP of this server.
0.4 - Database configuration
----------------------------
To make sure that the Aegir backend, and all the possible web servers can
reach your database server, you need to configure mysql to listen on all
the public IP addresses available to it.
/etc/mysql/my.conf configuration line to comment out::
bind-address = 127.0.0.1
Now you need to restart mysql, to clear any caches.
Shell command as root::
/etc/init.d/mysql restart
Because you have already installed Aegir when it was using the generic grants,
you will need to create new grants using the public IP address and hostname
of this server.
Shell command ::
mysql -uroot -p mysql
You need to generate the following grants using the hostname returned by the
`uname -n` command, and the IP address that the `resolveip` command returns
for that hostname.
You need to re-use the pasword you had for the account before.
Mysql grants ::
GRANT ALL ON *.* to 'aegir_root'@$AEGIR_HOST IDENTIFIED BY 'xxxx' WITH GRANT OPTION;
GRANT ALL ON *.* to 'aegir_root'@$AEGIR_IP IDENTIFIED BY 'xxxx' WITH GRANT OPTION;
0.4 - Apache configuration
--------------------------
This release introduces multi-server support and required reorganizing
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment