Installing Jukebox.cgi

Version 0.93

Copyright (c) 1995, David Hillman

This program is 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 2 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 this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

David Hillman, d-hillman@uchicago.edu

1) Get, and unpack ( in a directory accessible to W3 browsers, and from which CGI scripts are allowed ) the jukebox.tar.(gz|z) package.

This will create a subdirectory called 'jukebox', containing four Perl scripts, in addition to a README, a copy of the GNU General Public License and this file, INSTALL.

1. create_base.pl, a one-off utility to prime the simple text-file database
2. jukebox.cgi, the script to be requested by a browser
3. jspin.cgi, the back-end, non-trivial part
4. jconfig.pl, user configurable options

2) Edit the four scripts.

1. Point the initial line of all four scripts to Perl(5) on your system.
2. Edit jconfig.pl to reflect the locations of files and directories
3. Edit the HTML in jconfig.pl to taste.

*** The following subdirectory nonsense is necessary due to a known bug, but I'm trying to get this out to some testers quickly. It is not a feature.
3) Create a subdirectory of 'jukebox' called 'data' and chmod it 777.

$base should live in 'data/', ie, specify $base = "data/filename" in jconfig.pl.

4) Run create_base.pl

prompt% ls -1 > temp
prompt% ./create_base.pl temp

create_base.pl will prompt you for human readable names for each file in succession. If you can think of a better way to prime the database, please suggest.

5) Point your favorite browser at http://machine.domain/path/to/jukebox/jukebox.cgi

Where "machine.domain" is the hostname of the server on which you are installing the package, "path/to/jukebox", is obviously, the web-space path to the files you just installed, "jukebox.cgi" is name of the script ( you can rename it to whatever you like.)