IIPImage can be installed on Linux, Mac or Windows. The provided binary package is for Linux only. To install and use the provided package for IIPImage you will need a Linux server installed with the latest stable version of Debian GNU/Linux or any other Debian-based distributions such as Ubuntu Linux.
Note: This step by step guide is installing Lighttpd webserver. To use the IIPImage software with another webserver like Apache please follow the original Server Documentation.
Fast step by step installation for Ubuntu:
Here are the commands with comments to install IIPImage from the terminal.
1. Install prerequisites
2. Download and install the package with IIPImage and JPEG2000 support
The `iipsrv.fcgi` Fast CGI binary is installed into `/usr/lib/cgi-bin`.
3. Install and configure the Lighttpd webserver
A prepared Lighttpd configuration file is packaged with IIPImage.
First link it into the Lighttpd configuration directory and then enable it:
You can edit the *bin-environment* field in this file to configure IIPImage. Check the manual page of IIPImage for details about the Environment variables.
4. Link the default IIPMooViewer into the webserver root directory:
5. Test if IIPImage is running correctly and view the sample .jp2 image
Open a web browser like Firefox and point it to the server web address, by the default image with the IIPMooViewer is now available at the /iip/ url of the server.
To test the availability of the image server you can always try: http://localhost/cgi-bin/iipsrv.fcgi
The web viewers are internally always calling the iipsrv.fcgi script, where part of the request is always the path to the .jp2 or .tif files.
So you can point the viewers to your own files.
List of the alternative pan&zoom viewers - feel free to copy&paste the code or customize it for your need.