summaryrefslogtreecommitdiff
path: root/ucgi/INSTALL
blob: 33a2231e5ecf9c5fdb75574e2ea828a275018fef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
To install the www-cgi service:

1. Run make to build ucgi and ucgitarget.

2. Create the directory /usr/local/lib/user-cgi/cgi

3. Install the programs:
(a) ucgitarget as /usr/local/lib/user-cgi/target
(b) ucgi as /usr/local/lib/user-cgi/ucgi
(c) a symlink /usr/local/lib/user-cgi/ucgi-debug -> ucgi
(d) the script `check' as /usr/local/lib/user-cgi/check

4. Put the extra ScriptAlias directives in srm.conf.fragment in the
appropriate part of your webserver configuration.

5. Install the userv service:
(a) Put the file www-cgi in /etc/userv/services.d (you may need to
    adjust it for your local configuration)
(b) If you don't already have it, add this line to /etc/userv/system.default:
    include-lookup service /etc/userv/services.d

6. As a test user, create a `public-cgi' directory, and a symlink in
it called `check' which points to /usr/local/lib/user-cgi/check.

7. Test that all is working by visiting
  http://www.example.com/ucgi-debug/~fred/check
  http://www.example.com/ucgi/~fred/check


Copyright 1996-2013 Ian Jackson <ijackson@chiark.greenend.org.uk>
Copyright 1998 David Damerell <damerell@chiark.greenend.org.uk>
Copyright 1999,2003
   Chancellor Masters and Scholars of the University of Cambridge
Copyright 2010 Tony Finch <fanf@dotat.at>
Copyright 2013,2016 Mark Wooding <mdw@distorted.org.uk>

All the utilities here are free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with userv-utils; if not, see http://www.gnu.org/licenses/.