]> git.sesse.net Git - itkacl/blob - itkacl-web-1.0/README
Release a new version of the Apache module, with the context support.
[itkacl] / itkacl-web-1.0 / README
1 How to set up the web admin interface:
2
3 1. Install required Perl modules, e.g. on Debian/Ubuntu:
4
5       aptitude install libdbi-perl libapache-session-perl libdbd-pg-perl
6
7 2. Create the Postgres ITKACL database, using itkacl.sql from the
8    core distribution:
9
10      createdb itkacl
11      psql itkacl < itkacl.sql
12
13 3. Roots must be added manually, e.g.:
14
15      echo "INSERT INTO objects (name, description) VALUES ('web', 'WWW-based systems');" | psql itkacl
16
17 4. Create a separate database for holding the sessions
18    (see perldoc Apache::Session::Store::Postgres):
19
20      createdb itkacl-sessions
21      echo 'CREATE TABLE sessions ( id char(32) not null primary key, a_session text )' | psql itkacl-sessions
22
23 5. Create a user for itkacl-web and give it full access:
24
25      createuser --pwprompt itkacl-web
26      echo 'GRANT SELECT, INSERT, UPDATE, DELETE ON objects TO "itkacl-web";' | psql itkacl
27      echo 'GRANT SELECT, UPDATE ON objects_id_seq TO "itkacl-web";' | psql itkacl
28      echo 'GRANT SELECT, INSERT, UPDATE, DELETE ON aclentries TO "itkacl-web";' | psql itkacl
29      echo 'GRANT SELECT, INSERT, UPDATE, DELETE ON sessions TO "itkacl-web";' | psql itkacl-sessions
30
31    You could use a separate session username if you wish, although there's
32    probably not point.
33
34 6. Set up an include/config.local.pm file. It will probably look very much like
35    include/config.pm, except without the eval part, and with your own values
36    for password etc. filled in. Remember to chmod so that it is only readable
37    by the web server.
38
39 7. Make a vhost in Apache (or any other web server supporting CGI), with the web/
40    directory as the DocumentRoot, index.pl as the DocumentIndex, and .pl enabled
41    as CGI scripts.
42
43 8. Go to your vhost, and administer to your heart's content.