Mercurial > hg > savane-forge

annotate INSTALL @ 282:78c89f6ed764

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update French translation
author Sylvain Beucler <beuc@beuc.net>
date Sat, 14 Aug 2010 09:24:03 +0200
parents c56fa3cf1b29
children c087b8f3a3fb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
154
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
1 * Define your settings.py:
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
2
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
3 - Base it on 'settings_default.py':
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
4 (already done if you're downloading an official release)
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
5
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
6 echo 'from settings_default import *' > settings.py
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
7
181
cbee3f7ef687 INSTALL doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 170
diff changeset
8 - Modify if necessary, e.g.: DATABASES = {...}
154
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
9
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
10
239
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
11 * Dependencies
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
12
193
5249cadd91f4 Update installation instructions
Sylvain Beucler <beuc@beuc.net>
parents: 181
diff changeset
13 - Django >= 1.2 (+ YAML support)
239
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
14 - Django annoying (programming helpers)
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
15 - Django registration (users can create an account)
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
16 - MySQLdb (python-mysql)
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
17 - MySQL (database server)
197
6c2426e44082 Project GPG keyring (computed on the fly)
Sylvain Beucler <beuc@beuc.net>
parents: 193
diff changeset
18 - PyME (GPG Made Easy for Python)
239
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
19 - ssh-keygen (optional, to check submitted SSH public keys)
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
20 - gpg (compute group keyrings)
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
21 - gettext (compile translations)
239
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
22
0abdaf455751 Precise dependencies
Sylvain Beucler <beuc@beuc.net>
parents: 201
diff changeset
23 As Debian packages:
102
eb952fbc0d01 Leverage on new Django 1.1 to implement efficient license->groups query
Sylvain Beucler <beuc@beuc.net>
parents: 96
diff changeset
24
260
c56fa3cf1b29 Added mercurial to the list of debian dependency
Jonathan Gonzalez V <zeus@gnu.org>
parents: 259
diff changeset
25 apt-get install python-django python-mysqldb python-yaml mysql-server python-pyme mercurial
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
26 apt-get install openssh-client gnupg gettext
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
27
169
15d698645728 Trim design to show current progress + code clean-ups
Sylvain Beucler <beuc@beuc.net>
parents: 165
diff changeset
28 hg clone http://bitbucket.org/offline/django-annoying/
170
3ddd86437b55 Integrate django-registration in the project (TODO: auto-create an ExtendedUser)
Sylvain Beucler <beuc@beuc.net>
parents: 169
diff changeset
29 hg clone http://bitbucket.org/ubernostrum/django-registration/
169
15d698645728 Trim design to show current progress + code clean-ups
Sylvain Beucler <beuc@beuc.net>
parents: 165
diff changeset
30
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
31
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
32 * Install process
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
33
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
34 You will need to create the mysql user:
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
35
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
36 mysql -e "CREATE DATABASE savane DEFAULT CHARACTER SET utf8;"
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
37 mysql -e "GRANT ALL PRIVILEGES ON savane.* TO 'savane' IDENTIFIED BY 'yourpass';"
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
38
181
cbee3f7ef687 INSTALL doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 170
diff changeset
39 Edit the the file savane/settings.py and edit the DATABASES block with
cbee3f7ef687 INSTALL doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 170
diff changeset
40 the proper credentials for your MySQL database.
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
41
165
82e2c77565bb Doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 154
diff changeset
42 Initialize the database::
82e2c77565bb Doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 154
diff changeset
43
82e2c77565bb Doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 154
diff changeset
44 ./manage.py syncdb
254
05d27bf8ca84 Base structure for the 'Jobs'/'People' app
Sylvain Beucler <beuc@beuc.net>
parents: 239
diff changeset
45 ./manage.py loaddata savane/*/fixtures/*.yaml
165
82e2c77565bb Doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 154
diff changeset
46
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
47 Compile the translations::
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
48
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
49 ./manage.py compilemessages
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
50
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
51
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
52 * Run for testing:
13
533dccc57aeb Initial import with the django framework
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents:
diff changeset
53
17
bb2b96a64265 Added a few lines to show how to test the install
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents: 13
diff changeset
54 You can test your install using:
181
cbee3f7ef687 INSTALL doc fixes
Sylvain Beucler <beuc@beuc.net>
parents: 170
diff changeset
55 $ ./manage.py loaddata savane/svmain/fixtures/demo/*.yaml
154
20584264d28c Reorganise directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 147
diff changeset
56 $ ./manage.py runserver
17
bb2b96a64265 Added a few lines to show how to test the install
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents: 13
diff changeset
57
bb2b96a64265 Added a few lines to show how to test the install
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents: 13
diff changeset
58
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
59 * Run with Apache:
17
bb2b96a64265 Added a few lines to show how to test the install
Jonathan Gonzalez V <zeus@lunareja.(none)>
parents: 13
diff changeset
60
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
61 ** Dedicated server:
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
62
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
63 apt-get install libapache2-mod-python
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
64
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
65 <Location "/">
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
66 SetHandler python-program
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
67 PythonHandler django.core.handlers.modpython
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
68 SetEnv DJANGO_SETTINGS_MODULE settings
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
69 #PythonOption django.root /savane
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
70 PythonDebug On
85
2fbfe0cfbd88 Update documentation wrt directory layout
Sylvain Beucler <beuc@beuc.net>
parents: 83
diff changeset
71 PythonPath "['/var/www/framework/src'] + sys.path"
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
72 </Location>
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
73 <Location "/media">
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
74 SetHandler None
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
75 </Location>
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
76 <Location "/static-media">
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
77 SetHandler None
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
78 </Location>
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
79 Alias /media /usr/share/python-support/python-django/django/contrib/admin/media
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
80 #Alias /media /usr/share/pyshared/django/contrib/admin/media
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
81 Alias /static-media /var/www/framework/static-media
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
82
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
83 ** FCGI + suExec (shared hosting):
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
84 http://docs.djangoproject.com/en/dev/howto/deployment/fastcgi/
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
85
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
86 apt-get install libapache2-mod-fcgid # _not_ mod-fastcgi which is non-free
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
87 apt-get install python-flup
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
88 a2enmod rewrite
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
89
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
90 httpd.conf:
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
91
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
92 DocumentRoot /var/www/framework/public
33
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
93 SuexecUserGroup myuser mygroup
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
94
189c9bd937ac Complete setup instructions and add Apache draft
Sylvain Beucler <beuc@beuc.net>
parents: 17
diff changeset
95 Alias /media /usr/share/python-support/python-django/django/contrib/admin/media
83
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
96 #Alias /media /usr/share/pyshared/django/contrib/admin/media
45933e4a5aec - Clean-up in the login code to reuse Django 'auth' app; if I removed
Sylvain Beucler <beuc@beuc.net>
parents: 33
diff changeset
97
259
02f8038a2f3c Improve install process
Sylvain Beucler <beuc@beuc.net>
parents: 254
diff changeset
98 # Cf. public/.htaccess for the rest of the configuration