Installation

This document covers deployment of Thumbnailer [1] project.

OS specific

Here are repcipes for specific operating systems. They should help you go fast or automate installation procedure.

Debian

The first lines in the following sh commands define some variables. Adapt them to your needs.

# Define some variables.
thumbnailer_dir=~/thumbnailer  # Installation directory.
thumbnailer_venv_dir=${thumbnailer_dir}  # Virtualenv
upstream_url="git://github.com/Natim/Thumbnailer.git"  # Main repository.
fork_url=${upstream_url}  # Your fork.
system-install() {  # Shortcut for system package installer.
  su -c "aptitude install --without-recommends ${*}";
}

# Install base system dependencies.
system-install git-core python-virtualenv
# Download project.
git clone ${fork_url} ${thumbnailer_dir}
# Create a virtualenv and activate it.
virtualenv ${thumbnailer_dir}
cd ${thumbnailer_dir}
source bin/activate
# Install core.
cd src/thumbnailer.core/
python setup.py develop
cd ${thumbnailer_dir}
# Install images engine.
system-install libjpeg8 libjpeg8-dev libfreetype6 libfreetype6-dev
system-install python-dev
pip install PIL
cd src/thumbnailer.engines.images/
python setup.py develop
cd ${thumbnailer_dir}
# Install documents engine.
system-install rubygems graphicsmagick poppler-utils pdftk ghostscript
su -c "gem install docsplit"
pip install -U pip  # Recent version of pip is required.
pip install git+https://github.com/anderser/pydocsplit@dev#egg=pydocsplit
cd src/thumbnailer.engines.documents/
python setup.py develop
cd ${thumbnailer_dir}

# Done!
# Run the server.
make provider_server

Generic guidelines

System requirements

Base

Provider (server)

Images engine

Documents engine

Get the source

git clone git@github.com:Natim/Thumbnailer.git

Install Python packages

Install thumbnailer.core, thumbnailer.engines.images and thumbnailer.engines.documents in your Python environment.

You can use setup.py files provided at:

  • src/thumbnailer.core/setup.py
  • src/thumbnailer.engines.images/setup.py
  • src/thumbnailer.engines.documents/setup.py

Run

Use the provided Makefile to run the server:

make runserver

By default, Thumbnailer’s serves: