https://github.com/roblib/islandora_fits
Config module to make Islandora aware of FITS microservice
https://github.com/roblib/islandora_fits
islandora8 rdm-085
Last synced: about 1 month ago
JSON representation
Config module to make Islandora aware of FITS microservice
- Host: GitHub
- URL: https://github.com/roblib/islandora_fits
- Owner: roblib
- License: gpl-2.0
- Created: 2019-04-15T17:26:32.000Z (about 6 years ago)
- Default Branch: 8.x-1.x
- Last Pushed: 2024-04-29T00:56:53.000Z (about 1 year ago)
- Last Synced: 2025-03-25T18:54:03.155Z (about 2 months ago)
- Topics: islandora8, rdm-085
- Language: PHP
- Size: 94.7 KB
- Stars: 0
- Watchers: 6
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Islandora FITS
Config module to make Islandora aware of FITS microservice
## Installation
#### Install this module
Install and enable this module in the usual way. On installation the module will
add a context causing the creation of A FITS media when an Original File media is ingested; however, this process is
predicated on the existence of an `islandora_media_use` term with an external URI of `https://projects.iq.harvard.
edu/fits`--the `islandora_fits_tags` migration might be executed to create such a term.
#### Install FITS Webservice
FITS XMLs are generated from an easily installed web service.
Get the latest fits.zip and fits.war from https://projects.iq.harvard.edu/fits/downloads
(on my box I had to install a missing zip library with
‘sudo apt-get install php7.1-zip’)
Install following their instructions.
Copy the `.war` file to your webapps directory and test.
Edit the `catalina.properties` file on the Drupal server by adding the
following two lines to the bottom of the file:
```properties
fits.home=/\/fits
shared.loader=/\/fits/lib/*.jar
```
Restart Tomcat and test with:
```bash
curl -k -F datafile="@/path/to/myfile.jpg" http://example.com:8080/fits/examine
```
(note: the ‘@’ is required.)
#### Installing Microservice
Get code from https://github.com/roblib/CrayFits and install. This code can live anywhere, including an external server,
but most installations will have it at `/var/www/html`.
The App runs by entering:
```bash
php bin/console server:start *:8050
```
in the App root folder.
The server is stopped with:
```bash
php bin/console server:stop
```
On a production machine you'd probably want to configure an additional
port in Apache.
Note: The location of the FITS webserver is stored in the `.env` file in the
root dir of the Symfony app. This will have to be reconfigured if the FITS
server is anywhere other than `localhost:8080/fits`
#### Adding FITs requests to the queue
Copy the file `assets/ca.islandora.alpaca.connector.ocr.blueprint.xml`
to `/opt/karak/deploy` on your server. There is no need to restart.
#### Adding Checksum to Display
A pseudo field with the computed checksum can be added to Repository Item
display. Navigate to `admin/structure/types/manage/islandora_object/display`
to enable or disable display of `File Checksum`.