Cantaloupe

Nous allons supposer que Omeka S est servi par Apache sur un système Debian.

Installer Cantaloupe

Commencez par installer Java:

apt-get install openjdk-11-jre-headless

Puis installez Cantaloupe en utilisant le fichier ZIP de la dernière version:

wget https://github.com/cantaloupe-project/cantaloupe/releases/download/v5.0.5/cantaloupe-5.0.5.zip
unzip cantaloupe-5.0.5.zip
mv cantaloupe-5.0.5 /opt/cantaloupe

Configurer Cantaloupe

Copiez le fichier de configuration d’exemple:

cp /opt/cantaloupe/cantaloupe.properties.sample /opt/cantaloupe/cantaloupe.properties

Puis modifiez la copie. Vous aurez besoin de définir le chemin vers vos images pyramide:

FilesystemSource.BasicLookupStrategy.path_prefix = <path_to_pyramid_images>/

Vous pouvez utiliser PyramidImageBuilder pour créer ces images pyramide. Si c’est ce que vous utilisez, les images pyramide seront dans <OMEKA_PATH>/files/pyramid/.

Note

La barre oblique de fin dans path_prefix est importante!

Démarrer Cantaloupe

Le moyen le plus simple de démarrer Cantaloupe est de lancer les commandes suivantes:

cd /opt/cantaloupe
java -Dcantaloupe.config=cantaloupe.properties -Xmx2g -jar cantaloupe-5.0.5.jar

Configurer Apache pour transmettre les requêtes à Cantaloupe

Activez les modules Apache proxy et proxy_http:

a2enmod proxy proxy_http

Dans le <VirtualHost> Apache pour Omeka S (probablement situé dans /etc/apache2/sites-enabled/), ajoutez les lignes suivantes:

ProxyPass "/iiif" "http://localhost:8182/iiif"
ProxyPassReverse "/iiif" "http://localhost:8182/iiif"

Puis redémarrez Apache:

systemctl restart apache2.service

Configurer OctopusViewer

Dans la configuration du module, modifiez le modèle d’URI IIIF Image:

https://<yourhost>/iiif/3/{storage_id}/info.json

Ça suppose que les fichiers d’image pyramide portent le même nom que le storage ID du média Omeka S, ce que fait PyramidImageBuilder. Si vos images sont nommées différemment, modifiez le modèle d’URI en conséquence.