Setup

Run vagrant up to stand up a local development environment then follow the instructions below.

Configure nginx server

$ sudo rm /etc/nginx/sites-enabled/default
$ sudo cp ./etc/nginx/iiif_proxy.conf /etc/nginx/sites-enabled/iiif_proxy
$ sudo service nginx start

Note: be sure to configure SSL for nginx after the basic setup is done. For local testing, you can configure a self-signed certificate like this:

$ sudo mkdir /etc/nginx/ssl
$ sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/nginx/ssl/nginx.key -out /etc/nginx/ssl/nginx.crt

For production, consider using a free service such as Let's Encrypt. Instructions are available on the nginx website.

Configure wsgi app server

Upstart is the init system for ubuntu-like systems.

$ sudo cp ./etc/init/iiif_proxy.conf /etc/init/iiif_proxy.conf
$ sudo service iiif_proxy start

See the configuration for the uwsgi application server in app/config.ini. To manually start the application server, just run cd app && sudo uwsgi config.ini.

Monitor log files

$ sudo tail -f /var/log/nginx/error.log
$ sudo tail -f /var/log/upstart/iiif_proxy.log 

Run Unit Tests

$ nosetests app/tests

URL Scheme

IIIF Manifests

Pattern	Organization	URL
/meta/lib/<identifier>	Harvard Library	http://iiif.lib.harvard.edu/<identifier>
/meta/huam/<identifier>	Harvard Art Museums	http://iiif.harvardartmuseums.org/<identifier>

IIIF Images

Pattern	URL
/images/<identifier>	http://ids.lib.harvard.edu/<identifier>

Images for the library and museum are served from the same repository.

Examples

IIIF Image URL

• Example #1

  • Image URL: http://ids.lib.harvard.edu/ids/iiif/15372852/full/400,/0/native
  • Proxy URL: https://www.iiif-proxy.net/images/ids/iiif/15372852/full/400,/0/native

• Example #2

  • Image URL: http://ids.lib.harvard.edu/ids/iiif/47174896/full/256,/0/native.jpg
  • Proxy URL: https://www.iiif-proxy.net/images/ids/iiif/47174896/full/256,/0/native.jpg

#####Library Manifest

• Manifest URL: http://iiif.lib.harvard.edu/manifests/drs:15372472
• Proxy URL: https://www.iiif-proxy.net/meta/lib/manifests/drs:15372472

#####Harvard Art Museum Manifest

• Manifest URL: http://iiif.harvardartmuseums.org/manifests/object/299843
• Proxy URL: https://www.iiif-proxy.net/meta/huam/manifests/object/299843