April 2017 Archives

Installing DigiPal in AWS

There is some documentation on spinning up Digipal in a server, versus the Docker distribution, on their Github, but I found that information incomplete. Here is what I had to do to configure a running instance in AWS, running on AWS's linux AMI, which is mostly like Fedora. Note that I do not have Nginx running, so there's still some port weirdness. This is part 1 of 2, we'll just install and build everything. Part 2 will have configuring lighttpd to serve the images and postgresql account stuff

Pre-reqs

What to install

The following packages all to be installed with yum. There's a single-line at the bottom if you want to just do it

• git - git (duh)
• Postgres - postgresql93 postgresql93-server postgresql93-devel
• ImageMagick - (note that we only need the CLI tools, not the devel libs) ImageMagick
• libmysqlclient-devel - (stated in the reqs, no idea why) mysql56-devel
• lighttpd - (needed for iip fastcgi) lighttpd lighttpd-fastcgi
• Pre-reqs to build IIP - gcc, gcc-g++ libxml2-devel libxml2-python27 libxslt-devel automake autoconf libtool libjpeg-devel libtiff-devel
• Lessc - (used by Digipal in the CLI, runs in Node.js. Note that this is not part of the AWS repos, so you have to pull from epel) nodejs npm python-lesscpy

Big omnibus commands, need to be run as root or via sudo

yum install git postgresql93 postgresql93-server postgresql93-devel ImageMagick 
mysql56-devel gcc, gcc-g++ libxml2-devel libxml2-python27 libxslt-devel automake 
autoconf libtool libjpeg-devel libtiff-devel lighttpd lighttpd-fastcgi

yum install nodejs npm python-lesscpy --enablerepo=epel

What to build

• lesscp - needs to be built by npm, -g makes it global - npm install -g less

IIP

• Get the code from git - git clone https://github.com/ruven/iipsrv.git
• Build it:

cd iipserv
./autogen.sh
./configure
make
make check
sudo cp src/iipsrv.fcgi /etc/lighttpd/

DigiPal

Now time to install digipal itself

• get the code from Git

git clone https://github.com/kcl-ddh/digipal
cd digipal
git checkout 1.2.1a

• Now follow their instructions to get dependencies and install
  pip install -r requirements.txt

NB 1.2.1a is the current version in git. If you want to look at the versions, go to the GitHub page and click the "branches" dropdown. Replace 1.2.1a with any of those values verbatum