added some more notes
[Evergreen.git] / Open-ILS / admin / ils_admin / README
1 1. Set up the database params in settings.py
2 2. Comment out the following item in the INSTALLED_APPS variable in settings.py (around line 80):  'ils_admin.setup',
3         * If this is not commented out, Django will attempt to create tables for the ILS models, which
4         could cause the creation of duplicate tables with slightly different names/layouts *
5 3. Run "python manage.py syncdb".  This will install the necessary Django tables in the database
6 4. Uncomment the line commented out in #2.
7
8         To test the base Django app installation, you can run "python manage.py shell" to access the models directly.
9         Also, see http://www.djangoproject.com/documentation/tutorial1/
10
11 5. Add an Apache config similar to the one below (requires mod_python):
12
13 <Location /ils_setup/>
14         # Protect this sensitive sight
15         Order deny,allow
16         Deny from all
17         Allow from 10.0.0.0/8
18         SetHandler mod_python
19
20         # set up the python/django handlers
21         PythonHandler django.core.handlers.modpython
22         SetEnv DJANGO_SETTINGS_MODULE ils_admin.settings
23         PythonPath "['/openils/var/admin/', '/usr/lib/python2.4/site-packages/'] +sys.path"
24
25         # set up some good development settings
26         PythonAutoReload On 
27         PythonDebug On
28 </Location>
29
30 6. Add a symlink to "media" in your document root (e.g /openils/var/web) to the admin media dir:
31 e.g. /usr/lib/python2.4/site-packages/django/contrib/admin/media/
32 This can also be accomplished with an Alias directive in Apache config
33
34 7. Start apache
35
36
37
38