Prior to installing WIRM, you must have each of the the following software packages installed and tested:
For our apache server symlinks are enabled by setting the option, FollowSymLinks for the document root directory, the cgi-bin directory, and the user cgi-bin and public_html directories.
If you want to install wirm in a personal user directory you need to enable both the public_html mechanism, and the use of personal cgi-bin directories. Consult your apache manual for instructions on how to do this.
If you haven't already done so, get the latest release of the WIRM library and CGI scripts from the WIRM Download Page . There you will be given instructions on downloading the tarfile wirm-xxx.tar, where xxx is the version. If you are using the local CVS system, just do, from the directory where you want to install wirm:
cvs checkout -d wirm src/wirm
% tar -xvf wirm-xxx.tarThis will create a directory tree rooted at wirm. Go into the wirm directory. You should see the following:
README repos wrm
wrm contains the generic toolkit used by all repositories, repos contains the individual repositories found on this server. Initially repos contains demo_repo, the lending library that is the subject of the tutorial. If checking out from CVS, repos will contain all repositories checked into CVS, but you need only worry about the ones you are interested in.Within wirm/wrm you should see:
ChangeLog README cgi htdocs libcgi has cgi scripts that will be called from a web server cgi-bin directory, htdocs has icons, docs and other html pages that will be served from the web servers documents directory, lib has scripts that are called by the cgi-bin scripts, as well as additional subdirectories containing backup, installation and miscelaneous scripts. The installation script will link to the cgi and htdocs directories from within the web server's cgi-bin and htdocs directories.
Each repository is a subdirectory of wirm/repos, where the subdirectory name is the name of the repository, and is also the name of the msql database. Within each repository the subdirectories are organized similarly to the wrm toolkit, as cgi, lib and htdocs.
cd wirm/wrm/libCopy the file conf.pl.sample to conf.pl.
Invoke your text editor on conf.pl. You will note at least two configuration templates that assign initial values to the hash %WRM_CONF. The first is for installation in an individual user's public_html and cgi-bin directories. The second is for installation in shared space. Keep only the template relevant to your installation, and delete the others (there should be only one assignment to %WRM_CONF in conf.pl.
Edit the values for the following variables:
Important: you must have write access to the var, doc_root and cgi_path directories, as described above:
cd wirm/wrm/lib/confMake sure that install.pl is executable, then
Execute the script install.pl.
http://yourserver/cgi-bin/wrm/console.pl(or whatever the appropriate cgi-bin directory as specified in conf.pl). A page should appear with the repository banner, saying that you must first set the repository, which can't be done until a repository is created or installed.
For further help installing WIRM, please email firstname.lastname@example.org.
Copyright (C) 2000, WIRM.org.