Installing an Annotation Server (Advanced)

We are now going to attempt to install an Annotation Server locally. This is useful if you want to try out your own annotations and keep them private. This exercise will need you to run some command line commands.

A summary of the commands we will be using are:

Command Description
cd Change directory
ls list directory
pwd to show you where you are (Print Working Directory)

For this you will need:

Prerequisites

Java

If you followed the Cantaloupe or Static Images exercise as part of the Image API session you may already have this. If not you will need Java 11 installed.

To verify you have the correct package installed, you can run the following command from a terminal or command prompt:

$ java -version
# java version "1.11.0_102"

You should see version 1.11.x.

Step 1:

  • Download the sas.zip file from the latest SimpleAnnotationServer release:

https://github.com/glenrobson/SimpleAnnotationServer/releases

image

Step 2:

  • Extract the zip file into a iiif-workshop directory.
  • On windows make sure it is extracted by right click on the file and uncompressing.
  • Note: this doesn't need to be in your Chrome Web server directory

Step 3:

  • In your terminal window cd into the sas directory which should have been created in the last step.
MacBook-Pro:tmp gmr$ cd sas
MacBook-Pro:sas gmr$ ls
dependency            simpleAnnotationStore.war

Step 4:

  • Run the SimpleAnnotationStore:

java -jar dependency/jetty-runner.jar --port 8888 simpleAnnotationStore.war

Step 5:

Step 6:

  • Now add your manifest
    • Go to http://localhost:8888/index.html
    • Go to the list of manifests (click the big plus sign or if you are viewing a manifest click the four boxes at the top left and select 'newObject').
    • In the list of manifests paste the link to your manifest http://localhost:8887/manifest2.json into the addNewObject text field and click load.
    • You should now see:

image

Step 7:

  • Click on your manifest in the list
  • Add some annotations to this manifest. Do they save?
  • You should now be able to use the SimpleAnnotationServer to save and search annotations.

Extras:

Last modified by Glen Robson 2020-11-26 11:36:05
Created by Glen Robson 2020-11-26 11:36:05

results matching ""

    No results matching ""