Access
Access is a Maven project consisting of six modules,
- access-core: basic framework of access, including batch derivative generated based on Spring Batch, messaging based on Spring Integration
- access-static: helper classes for Apache static URLs and Djatoka URLs
- access-bookreader: generates thumbnails and bookreader.json from BookReader (based on IA BookReader)
- access-download: generates full package of PDF, JPEG and OCR, also provides offline download
- access-oai: OAI-PMH provider based on Proai
- access-web: integrates all modules and provides RESTfull entries for each serivce
common tasks
- maven install/package: (is not recommended to manually test/package/install this project because it contains a list of properties, please refer to Jenkins job for ingest)
- deploy:
- bhladmin@bhl-int1: sudo ln -s {access_web_project}/dist/access-web.xxx.war /var/lib/tomcat6/webapp/access.war
- bhladmin@bhl-int1: sudo ln -s {access_oai_project}/dist/access-web.xxx.war /var/lib/tomcat6/webapp/access-oai.war
- undeploy: bhladmin@bhl-int1: cd {ingest_web_project} ; mvn tomcat:undeploy -Dpath=access
location
- Github: https://github.com/bhle/bhle/tree/master/access
- web-application: /var/lib/tomcat6/webapp/access.war, /var/lib/tomcat6/webapp/access-oai.war
- log: /var/log/ingest/access.log, /var/log/ingest/access-oai.log, /var/log/tomcat6/catalina.out
dependencies
- Fedora Repository
- Djatoka
- ImageMagick
modifying config files
- Each module holds a property file.
- access-core: access.properties, logback.xml
- access-download: access-download.properties
- access-oai: proai.properties, log4j.properties
- access-static: access-static.properties
- access-web: batch-default.properties
- {access_classpath}: environment-test/prod.properties
- Platform-specific configuration files. These files contains the same list of parameters in Jenkins.
- Triggered by: mvn clean package -DskipTests -Denvironment=test (or -Denvironment=prod)
how to test if it's working
- Every build by Jenkins ensures passing all test cases.
- BookReader: access/stream/a000test
- Download: Full package generation of PDF, JPEG and OCR; Offline download in BookReader
- Batch derivative generation: access/batch-admin/jobs/generateDerivatives, fill job parameters with:
- PID=(choose a PID of a 'book' object)
proxy information