Difference between revisions of "Raphael Digital Documentation Setup"

From National Gallery Research Wiki
Jump to navigation Jump to search
(sudo mkdir)
Line 130: Line 130:
 
* Details of edited files: /project_path/project_edited
 
* Details of edited files: /project_path/project_edited
 
* Deleted files: /project_path/project_trash
 
* Deleted files: /project_path/project_trash
 +
 +
Make main project data folder and then create the other folders within it.  Once they have been created you will also need to make sure than the www-data user can create and edit files within these folders
 +
 +
sudo mkdir -p /data/ngdd
 +
cd /data/ngdd
 +
sudo mkdir project_files project_links project_pyr project_edited project_trash
 +
sudo chown www-data:www-data *
  
 
== Web front end ==
 
== Web front end ==

Revision as of 18:58, 29 November 2010

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:

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.

Download the initial database sql from HERE, then uncompress the file and enter the data to the database with the following commands, replacing the user name and database name as appropriate.

tar xzvf ngdd_blank_1.0.tar.gz
mysql -u ngdd_db -p -D ngdd_db < ngdd_blank_1.0.sql

Check default directories and settings

sudo mkdir /usr/local/ngdd_scripts
sudo chmod o+rw /usr/local/ngdd_scripts

File Folders

Current file folders:

  • Uploaded file store: /project_path/project_files
  • Links to down-loadable files: /project_path/project_links
  • Pyramidal image file folder: /project_path/project_pyr
  • Details of edited files: /project_path/project_edited
  • Deleted files: /project_path/project_trash

Make main project data folder and then create the other folders within it. Once they have been created you will also need to make sure than the www-data user can create and edit files within these folders

sudo mkdir -p /data/ngdd
cd /data/ngdd
sudo mkdir project_files project_links project_pyr project_edited project_trash
sudo chown www-data:www-data *

Web front end