diff options
Diffstat (limited to 'ucgi/INSTALL')
-rw-r--r-- | ucgi/INSTALL | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/ucgi/INSTALL b/ucgi/INSTALL new file mode 100644 index 0000000..33a2231 --- /dev/null +++ b/ucgi/INSTALL @@ -0,0 +1,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/. |