Penlist

You can find the web-service factsheet at the following address: http://toolxite.net/penlist/ws/factsheet.html

You need to run a web-server supporting CGI scripts, to this day the software has only be tested on apache (http://httpd.apache.org/).

Furthermore, the CGI bin directory for the web server must be one of the following:

• /usr/lib/cgi-bin
• /var/www/cgi-bin
• /usr/local/apache/cgi-bin
• /usr/local/apache/share/cgi-bin
• /usr/local/etc/httpd/cgi-bin
• /usr/local/www/cgi-bin
• /usr/local/www/apache/cgi-bin
• /home/httpd/cgi-bin

If you CGI directory is not one of these, the simplest solution is to create a symbolic link from one of these to the real directory before installing the pensum application:

e.g.
cd /usr/lib
ln -s /var/share/cgibin cgi-bin

The cataloguing solftware is compose of a Pensum application and the Metatoo core system. Both packages must be downloaded and installed using the following instructions:

1 - download the latest metatoo core package

http://www.toolxite.dk/metatoo/download/

2 - download the latest pensum application package

http://www.toolxite.dk/penlist/download/

3 - unpack both packages in the same directory

mkdir /usr/local/pensum
cd /usr/local/pensum
tar xzf pensum.1.0.tar.gz
tar xzf fit.1.5.5.tar.gz

4 - run setup script as root, or using the sude command

Running the setup script will create a symbolic link (fit) in the parent directory and will install a number of file in your CGI bin directory. All files copied to the CGI bin directory will have a prefix corresponding to the Service name you choose during setup, pensum by default.

It is recommended that whenever a default value is offered, in square brackets
e.g. Service name [pensum]
you accept it by just pressing return.

cd pensum.1.0
./setup
Application root: /usr/local/pensum/pensum.1.0
Metatoo core: /usr/local/pensum/fit.1.5.5
Service name [pensum]
Database name [pensum]
MySQL user name [] pensum
MySQL password [] password
Admin email []
metatoo user 'admin' password [] password-for-admin
metatoo user 'root' password [] password-for-root
database=pensum
Database pensum does not exist, do you want to create it [Y/n]
Creating database: pensum
Creating database tables
Loading XML definitions
info: new record: 234, updates: 0
info: new record: 0, updates: 234
Running make
make[1]: Entering directory `/usr/local/pensum/fit'
Installing web files
--------------------
cp pscr.pm /usr/lib/cgi-bin/pensum_pscr.pm
cp fit /usr/lib/cgi-bin/pensum
cp fit_img /usr/lib/cgi-bin/pensum_img
cp fit_doc /usr/lib/cgi-bin/pensum_doc
cp fit_export /usr/lib/cgi-bin/pensum_export
cp fit_ext /usr/lib/cgi-bin/pensum_ext
cp fit_js /usr/lib/cgi-bin/pensum_js
cp fit_file /usr/lib/cgi-bin/pensum_file
cp fit_cas /usr/lib/cgi-bin/pensum_cas
cp fit_das /usr/lib/cgi-bin/pensum_das
cp fit_style /usr/lib/cgi-bin/pensum_style
cp fit_auth /usr/lib/cgi-bin/pensum_auth
cp /home/franck/projects/pensum/fit_search /usr/lib/cgi-bin/pensum_search
cp /home/franck/projects/pensum/fit_pdf /usr/lib/cgi-bin/pensum_pdf
cp config.tab /usr/lib/cgi-bin/pensum.tab
warn: cannot find mod_perl
make[1]: Leaving directory `/home/franck/projects/fit'

4 - test installation

You can then test the installation at:

http://your-server.example.com/cgi-bin/pensum