Book Toolbox

• download a whole book in OCR, PDF, jpg format with high/medium/low resolution
• select pages to download in OCR, PDF, jpg format with high/medium/low resolution
• search keywords inside a book
• etc.

common tasks

• start: bhladmin@bhl-test2:/$ sudo etc/init.d/tomcat6 start
• stop: bhladmin@bhl-test2:/$ sudo etc/init.d/tomcat6 stop
• status: bhladmin@bhl-test2:/$ sudo etc/init.d/tomcat6 status

how to test if it's working

• Find a book object and a page object in Fedora (PID of book object: bhle:<GUID>; page object: bhle:<GUID>-<4 digits>)
  • http://bhl-test.nhm.ac.uk/fedora/objects?pid=true&title=true&type=true&terms=*bhle*
• "View the Methods List for this Object"
• Run each method having "Service Definition" bhle-service:* in the list.

location

• Github: https://github.com/bhle/bhle/tree/master/access/booktoolbox
• web-application: /var/lib/tomcat6/webapps/booktoolbox
• application-container:/usr/share/tomcat6/
• config files:
  • ./booktoolbox/src/main/resources/booktoolbox.properties
• logs:
  • tomcat: /var/log/tomcat6/catalina.out
  • fedora: /var/log/fedora/fedora.log

dependencies

• Tomcat (Access)
• aDORe-Djatoka

modifying config files

1. after modifying any config file: restart tomcat

login information if necessary

• NA

proxy information

• booktoolbox is accessed locally, no need to have proxy

Installation

Book Toolbox

• download source from https://github.com/bhle/bhle/tree/master/access/booktoolbox
• and place in /opt/access/booktoolbox/
• cd /opt/access/booktoolbox
• modify properties file
  • ./src/main/resources/booktoolbox.properties
• mvn clean package
• deploy target/booktoolbox.war into /var/lib/tomcat6/webapps
• update/ingest Fedora service and content model objects
  /src/main/resources/*.xml
  check objects in Fedora Admin http://bhl-<environment>.nhm.ac.uk/fedora/admin
  example (islandora:bookCModel):
  • Open Object: islandora:bookCModel
  • if it doesn't exist
  • Ingest Object: islandora_bookCModel.xml