diff --git a/INSTALL b/INSTALL index 405e4ba28..fb13191a1 100644 --- a/INSTALL +++ b/INSTALL @@ -24,9 +24,8 @@ dovecot. Create a database with the name you specified in settings.py. Make sure your database is using UTF8 as a default charset. If not, you -will surely have problems with MySQL. - -You will probably need to install a python database backend like MySQLdb. +will surely have problems (with MySQL at least). You will probably +need to install a python database backend (like MySQLdb). Initialise the database by running the following command:: @@ -45,19 +44,30 @@ How to upgrade First, decompress the new tarball at the same location than your current installation. Then, check if the new version you're installing -required a migration:: +requires a migration:: 0.7 -> 0.8 : SQL migration needed. -south is needed to handle migrations. You will find instructions on -how to install south here: -http://south.aeracode.org/docs/installation.html. +Before you start migration, make sure you have updated your +INSTALLED_APPS variable and that it contains at least:: + + INSTALLED_APPS = ( + # Django's stuff before + + 'south', + 'mailng', + 'mailng.lib', + 'mailng.admin', + 'mailng.userprefs', + ) + +Starting with 0.8, mailng.main doesn't exist anymore. You need to +remove it from your INSTALLED_APPS. NB: Before doing this migration, I recommend that you make a copy of your existing database. -When this is done, add 'mailng.lib' and 'south' to your -INSTALLED_APPS. Then, run the following commands: +Finally, run the following commands: # python manage.py syncdb # python manage.py convert_to_south @@ -95,17 +105,17 @@ group/user needed because we are in a virtual hosting configuration For example, create a vmail group:: - groupadd vmail + # groupadd vmail Then create a vmail user:: - useradd -g vmail -d /var/vmail -m vmail + # useradd -g vmail -d /var/vmail -m vmail At last, the system user used to run mailng will need permissions to -manipulate directories in vmail's homedir. To do that, edit your /etc/sudoers +manipulate directories in vmail's homedir. To do so, edit your /etc/sudoers file and add the following inside:: - www-data ALL=(vmail) NOPASSWD: ALL + ALL=(vmail) NOPASSWD: ALL Testing installation -------------------- @@ -113,7 +123,7 @@ Testing installation As a typical Django application, MailNG can be tested using a simple web server. Just run this command to start it:: - python manage.py runserver + # python manage.py runserver You will be able to play with MailNG by looking at http://:8000/mailng/admin/.