Raphael Digital Documentation Setup

The software referred to here was produced as a prototype digital documentation system within the Mellon funded Raphael Research project. The software was built to test various ideas related to the storage, dissemination and description of museum/gallery related information.

The instruction listed here describe the steps required to set up an empty copy of the system for personal use. As stated the software is classed as prototype or beta software and further develop work would be recommended prior to making use of it for anything more than testing and development purposes.

If you are setting up a remote machine then all web address references to http://localhost will have to be replaced with the actual name or ip address of your server.

This page is part of the Linux Setup discussion.

--Jpadfield 13:00, 23 November 2010 (UTC)

Initial set-up of your Linux machine

Follow the instructions and install the software indicated in the following to sections:

• General Linux
• Linux Apache MySQL and PhP

Vips/Nip software

Add the following lines to end of your .bashrc file

export VIPSHOME=/usr/local/vips
export MANPATH=$MANPATH:$VIPSHOME/man
export PATH=$VIPSHOME/bin:"${PATH}"
export LD_LIBRARY_PATH=/usr/local/lib:$VIPSHOME/lib
export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/lib32/pkgconfig:/usr/share/pkgconfig:$VIPSHOME/lib/pkgconfig

Open up a new xterm window and run the following commands

sudo mkdir /usr/local/vips-7.22
sudo ln -s /usr/local/vips-7.22 /usr/local/vips

Prepare to download the source code

mkdir software
mkdir software/vips
cd  software/vips

Download and unpack the current version of vips and nip2, for example:

wget  http://www.vips.ecs.soton.ac.uk/supported/7.22/vips-7.22.5.tar.gz
wget  http://www.vips.ecs.soton.ac.uk/supported/7.22/nip2-7.22.4.tar.gz
tar xzvf vips-7.22.5.tar.gz
tar xzvf nip2-7.22.4.tar.gz

Move into the vips folder and build the software as indicated:

cd vips-7.22.5
configure --prefix=/usr/local/vips-7.22
make
sudo make install

Move into the nip2 folder and build the software as indicated:

cd ../nip2-7.22.4
configure --prefix=/usr/local/vips-7.22
make
sudo make install

If the software builds without any problems the nip2 software can be run with the command:

nip2

IIPImage system

Open a new xterm or move to your home folder

mkdir software/iipimage
sudo mkdir /var/www/fcgi-bin

Edit your fastcgi.conf:

sudo gedit /etc/apache2/mods-available/fastcgi.conf

To read:

<IfModule mod_fastcgi.c>
 AddHandler fastcgi-script .fcgi
 #FastCgiWrapper /usr/lib/apache2/suexec2
 FastCgiIpcDir /var/lib/apache2/fastcgi 
 ScriptAlias /fcgi-bin/ /var/www/fcgi-bin/

 <Directory "/var/www/fcgi-bin">
  AllowOverride None
  Options +ExecCGI -Includes
  SetHandler fastcgi-script
  Order allow,deny
  Allow from all
 </Directory>

 # Initialise some variables for the FCGI server
 FastCgiServer /var/www/fcgi-bin/iipsrv.fcgi \
 -initial-env MAX_IMAGE_CACHE_SIZE=10 \
 -initial-env LOGFILE=/var/log/iipimage/iipsrv.log \
 -initial-env VERBOSITY=1 \
 -initial-env MAX_CVT=1024 \
 -initial-env JPEG_QUALITY=75 \
 -processes 10
</IfModule>

Download the latest server from IIPImage webpage and save it in your new folder software/iipimage

cd software/iipimage
tar xvjf iipsrv-0.9.8.tar.bz2
cd iipsrv-0.9.8
./configure
make
sudo mv src/iipsrv.fcgi /var/www/fcgi-bin/.

Restart apache2:

sudo /etc/init.d/apache2 restart

Test the iip server has been built correctly by visiting the following web page:

http://localhost/fcgi-bin/iipsrv.fcgi

MySQL database

Set-up a new database user and an empty database using phpmyadmin:

• Goto http://localhost/phpmyadmin
• Click on the Privileges tab and then select the Add a new user option
• Enter an appropriate user name and password, check the Create database with same name ... option and then click Go
• For this example the user/database name ngdd_db has been used.
• Click on the Privileges tab and then click the reload the privileges in the note near the bottom of the page.