https://github.com/roblib/crayfits

Symfony 4 Microservice to retrieve FITS data and persist it as a Drupal media node
https://github.com/roblib/crayfits

islandora8 rdm-085 symfony

Last synced: about 1 month ago
JSON representation

Symfony 4 Microservice to retrieve FITS data and persist it as a Drupal media node

• Host: GitHub
• URL: https://github.com/roblib/crayfits
• Owner: roblib
• License: gpl-2.0
• Created: 2019-04-15T17:02:50.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-09-25T17:54:09.000Z (over 1 year ago)
• Last Synced: 2024-11-05T11:10:33.615Z (3 months ago)
• Topics: islandora8, rdm-085, symfony
• Language: PHP
• Size: 10.5 MB
• Stars: 0
• Watchers: 8
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CrayFits

## Introduction

[FITS][1] as a microservice.

## Requirements

* Tomcat

* [Composer][2]

## Installation

### Install FITS webservice

* Download the latest `fits.zip` and `fits.war` from

[https://projects.iq.harvard.edu/fits/downloads](https://projects.iq.harvard.edu/fits/downloads).

You may need to install a zip library to unzip the file.

* Copy the `.war` file to your Tomcat webapps directory and test.

* Edit the Tomcat `conf/catalina.properties` file by adding the

following two lines to the bottom of the file:

```properties

fits.home=/\/fits

shared.loader=/\/fits/lib/*.jar

```

* Restart Tomcat.

* Test the webservice with:

```bash

curl -k -F datafile="@/path/to/myfile.jpg" http://[tomcat_domain]:[tomcat_port]/fits/examine

```

(note: the ‘@’ is required.)

### Install CrayFITS microservice

* Clone this repository somewhere in your web root.

* `$ cd /path/to/CrayFits` and run `$ composer install`

* For production, configure your web server appropriately (e.g. add a VirtualHost for CrayFits in Apache)

To run the microservice on the Symfony Console, enter:

```bash

php bin/console server:start *:8050

```

in the microservice 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`

#### Optional: Configure Alpaca to accept derivative requests from Islandora.

To use Alpaca as an interface to this microservice, configure

an [`islandora-connector-derivative`](https://github.com/Islandora/Alpaca#islandora-connector-derivative)

appropriate to your installation of CrayFits.

[1]: https://projects.iq.harvard.edu/fits

[2]: https://getcomposer.org/download/