X-Git-Url: https://git.ozlabs.org/?a=blobdiff_plain;f=docs%2FINSTALL;h=05fea7c13983f0273616336d634a9bd4a584f88b;hb=4a039197705f92ee1c362401a7f7bb834ecc9079;hp=0d5cc3e78553510a10658ea1a060e139edb85e5b;hpb=941db44d31f4736bab7c60c4995de16961944745;p=patchwork diff --git a/docs/INSTALL b/docs/INSTALL index 0d5cc3e..05fea7c 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -29,16 +29,21 @@ in brackets): user that your mail server runs as). On Ubuntu these are www-data and nobody, respectively. - PostgreSQL: - createdb patchwork - createuser www-data - createuser nobody + For PostgreSQL - MySQL: + $ createdb patchwork + $ createuser www-data + $ createuser nobody + + - postgres uses the standard UNIX authentication, so these users + will only be accessible for processes running as the same username. + This means that no passwords need to be set. + + For MySQL: $ mysql > CREATE DATABASE 'patchwork'; - > INSERT INTO user (Host, User) VALUES ('localhost', 'www-data'); - > INSERT INTO user (Host, User) VALUES ('localhost', 'nobody'); + > CREATE USER 'www-data'@'localhost' IDENTIFIED BY ''; + > CREATE USER 'nobody'@'localhost' IDENTIFIED BY ''; 2. Django setup @@ -62,15 +67,17 @@ in brackets): cd ../../apps ln -s ../lib/packages/django-registration ./registration - You'll need to customise apps/settings.py to suit your database, and - change the SECRET_KEY variable too. While you're there, change the - following to suit your installation: + The settings.py file contains default settings for patchwork, you'll + need to configure settings for your own setup. + + Rather than edit settings.py, create a file 'local_settings.py', and + override or add settings as necessary. You'll need to define the + following: - SECRET_KEY + SECRET_KEY ADMINS TIME_ZONE LANGUAGE_CODE - MEDIA_ROOT You can generate the SECRET_KEY with the following python code: @@ -78,16 +85,29 @@ in brackets): chars = string.letters + string.digits + string.punctuation print repr("".join([random.choice(chars) for i in range(0,50)])) + If you have patchwork installed in somewhere other than /srv/patchwork, + you'll also need to define: + + MEDIA_ROOT + TEMPLATE_DIRS + + If you wish to enable the XML-RPC interface, add the following to + your local_settings.py file: + + ENABLE_XMLRPC = True + Then, get patchwork to create its tables in your configured database: cd apps/ - ./manage.py syncdb + PYTHONPATH=../lib/python ./manage.py syncdb And add privileges for your mail and web users: Postgresql: - psql -f lib/sql/grant-all.sql patchwork + psql -f lib/sql/grant-all.postgres.sql patchwork + MySQL: + mysql patchwork < lib/sql/grant-all.mysql.sql 3. Apache setup