Installation

Note: this page is a bit outdated. Probably it will be rewritten soon.

Requirements

UNIX/Linux/MacOS (source package)

If installing from source packages, these are the requirements:

  • python interpreter (v2.5 or later) and python development libraries
  • python twisted matrix libs 8.x or later
  • python SOAPpy package 0.12
  • C/C++ compilers
  • libmagick
  • libmagick++
  • SWIG

Debian, Ubuntu or -like

On a Debian-based Linux system, these requirements can be installed by running this command:

sudo apt-get install build-essential swig python-twisted-web libmagick++-dev python-dev

That’s it, now skip to the next section “Building and installing from source”

RedHat, CentOS, Amazon Linux

On an RPM or Yum -based Linux system (RedHat, CentOS, Amazon Linux), these requirements can be installed by running this command:

sudo yum install ImageMagick-c++-devel swig gcc-c++ python-setuptools python-devel python-twisted-web

That’s it, now skip to the next section “Building and installing from source”

On Mac OS X:

  1. Go to http://brew.sh and install Homebrew
  2. Install swig: brew install swig
  3. Install ImageMagick: brew install ImageMagick
  4. Install pkg-config: brew install pkg-config

Alternatively, you can try it with macports.

That’s it, now skip to the next section “Building and installing from source”

Windows

All requirements are included on the installer, just run it and then skip to section “Configuring the server”.

Building and installing from source

If you have setuptools available on your system, you can install isk-daemon by running:

sudo easy_install isk-daemon

If your don’t have or don’t want to use setuptools, download the multi-platform source package for isk-daemon, extract/decompress it and run from the top level directory:

python setup.py build

This should build the optimized C++ image processing library and install it on your system. If successful, the last lines should look like:

running build_scripts

creating build/scripts-2.7

copying and adjusting isk-daemon.py -> build/scripts-2.7

changing mode of build/scripts-2.7/isk-daemon.py from 644 to 755

In case of errors, make sure all requirements were installed and check the FAQ.

Finally install it on system folders by running:

python setup.py install

Configuring the server

All configuration defaults should be enough to start using isk-daemon but if necessary many options can be changed (requires restarting the server) by editing the config file isk-daemon.conf (sample file) with a text editor. This file can be located on the same directory as the iskdaemon.py (or .exe) script, on the current user home directory or at /etc/iskdaemon.

Running the server

If you installed from source, just run:

iskdaemon.py

The Windows installer runs the server automatically if a choice is made to run it as a service. If not, locate iskdaemon.exe on the Program Files directory and run it.

On Linux systems, if you want to have isk-daemon run automatically on boot, add this to the /etc/rc.local file:

iskdaemon.py&

The log file isk-daemon.log is created on the current directory (or on c:\windows\syswow64 for WIndows 2008 servers). It contains detailed logs that could be useful for diagnosing problems.