ucgi/INSTALL

   1 To install the www-cgi service:
   2
   3 1. Run make to build ucgi and ucgitarget.
   4
   5 2. Create the directory /usr/local/lib/user-cgi/cgi
   6
   7 3. Install the programs:
   8 (a) ucgitarget as /usr/local/lib/user-cgi/target
   9 (b) ucgi as /usr/local/lib/user-cgi/ucgi
  10 (c) a symlink /usr/local/lib/user-cgi/ucgi-debug -> ucgi
  11 (d) the script `check' as /usr/local/lib/user-cgi/check
  12
  13 4. Put the extra ScriptAlias directives in srm.conf.fragment in the
  14 appropriate part of your webserver configuration.
  15
  16 5. Install the userv service:
  17 (a) Put the file www-cgi in /etc/userv/services.d (you may need to
  18     adjust it for your local configuration)
  19 (b) If you don't already have it, add this line to /etc/userv/system.default:
  20     include-lookup service /etc/userv/services.d
  21
  22 6. As a test user, create a `public-cgi' directory, and a symlink in
  23 it called `check' which points to /usr/local/lib/user-cgi/check.
  24
  25 7. Test that all is working by visiting
  26   http://www.example.com/ucgi-debug/~fred/check
  27   http://www.example.com/ucgi/~fred/check
  28
  29
  30 Copyright 1996-2013 Ian Jackson <ijackson@chiark.greenend.org.uk>
  31 Copyright 1998 David Damerell <damerell@chiark.greenend.org.uk>
  32 Copyright 1999,2003
  33    Chancellor Masters and Scholars of the University of Cambridge
  34 Copyright 2010 Tony Finch <fanf@dotat.at>
  35 Copyright 2013,2016 Mark Wooding <mdw@distorted.org.uk>
  36
  37 All the utilities here are free software; you can redistribute it and/or
  38 modify it under the terms of the GNU General Public License as published by
  39 the Free Software Foundation; either version 3 of the License, or (at your
  40 option) any later version.
  41
  42 This program is distributed in the hope that it will be useful, but
  43 WITHOUT ANY WARRANTY; without even the implied warranty of
  44 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  45 General Public License for more details.
  46
  47 You should have received a copy of the GNU General Public License
  48 along with userv-utils; if not, see http://www.gnu.org/licenses/.