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:
||to show you where you are (Print Working Directory)|
For this you will need:
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
- Download the
sas.zipfile from the latest SimpleAnnotationServer release:
- Extract the zip file into a
- 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
- In your terminal window
cdinto 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
- Run the SimpleAnnotationStore:
java -jar dependency/jetty-runner.jar --port 8888 simpleAnnotationStore.war
- Navigate to http://localhost:8888/index.html
- And you should see Mirador
- Navigate to an item and make an annotation. Does it save? If not ask for help
- 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://127.0.0.1:5500/manifest.json into the addNewObject text field and click
- You should now see:
- 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.