Skip to content

Latest commit

 

History

History
115 lines (79 loc) · 3.73 KB

dependencies.md

File metadata and controls

115 lines (79 loc) · 3.73 KB
Raw

Installing Dependencies

These instructions are known to work with Ubuntu 12.04.3. If you have further information, please provide it!

Loris (PIL or Pillow, actually, with the exception of Kakadu) depends on several external libraries that can't be installed with pip, so there are few steps that must be carefully followed to get going. Installing the dependencies manually is a good idea anyway because you'll be able to run the tests.

In order from least to most tedious:

  1. Install Werkzeug (>=0.8.3)
$ sudo pip install Werkzeug
  1. Kakadu. A from Version 1.2.2 on, a copies of Kakadu for 64-bit Linux and OS X are included with Loris. These copies may be used, provided you comply with the terms outlined by NewSouth Innovations. Please see their website or LICENSE-Kakadu.txt for details.

If you are deploying on a different system or architecture, you can Download the appropriate version of Kakadu for your system, if it is available, or else contact Kakadu for a license. You need at least version 7.0 for all features to work properly.

The binaries and shared object file are stored in the source code at loris/(bin|lib)/$system/$machine where $system/$machine is the response from the following command:

$ python -c "import platform as p; print '%s/%s' % (p.system(),p.machine())"

Meaning that if you would like (or need) to supply your own version you may do so before deployment by putting kdu_expand and libkdu_* in their appropriate directories.

After deployment the files are /usr/local/(bin|lib).

  1. Install Pillow (recommended) or PIL

PIL or Pillow have to be built/installed after Little CMS, so first remove all instances of PIL or Pillow, including, but not limited to, the python-imaging package:

sudo pip uninstall PIL
sudo pip uninstall Pillow
sudo apt-get purge python-imaging

Then, get install all of the dependencies (same for PIL or Pillow):

sudo apt-get install libjpeg-turbo8 libjpeg-turbo8-dev libfreetype6 \
libfreetype6-dev zlib1g-dev liblcms2-2 liblcms2-dev liblcms-utils libtiff5-dev

Link them the dirs where PIL or Pillow will find them (this is unfortunate):

sudo ln -s /usr/lib/`uname -i`-linux-gnu/libfreetype.so /usr/lib/
sudo ln -s /usr/lib/`uname -i`-linux-gnu/libjpeg.so /usr/lib/
sudo ln -s /usr/lib/`uname -i`-linux-gnu/libz.so /usr/lib/
sudo ln -s /usr/lib/`uname -i`-linux-gnu/liblcms.so /usr/lib/
sudo ln -s /usr/lib/`uname -i`-linux-gnu/libtiff.so /usr/lib/

Now do A (Pillow) or B (PIL):

A. Pillow (recommended)

pip install Pillow

The output MUST include these lines:

[...]
--- ZLIB (PNG/ZIP) support available
--- TIFF G3/G4 (experimental) support available
--- FREETYPE2 support available
--- LITTLECMS support available
[...]

B. PIL

Download the PIL source:

cd /tmp
wget http://effbot.org/downloads/Imaging-1.1.7.tar.gz
cd Imaging-1.1.7

Do a test build:

python setup.py build_ext -i
python selftest.py

The output MUST include these lines:

--- PIL CORE support ok
--- JPEG support ok
--- ZLIB (PNG/ZIP) support ok
--- FREETYPE2 support ok
--- LITTLECMS support ok

See the README for what to do if there's trouble, otherwise, do:

sudo python setup.py install

And you should be all set.

Once you done all of this, go ahead and run the tests. From the loris directory (not loris/loris) run ./test.py

Proceed to set Configuration Options or go Back to README