Instructions for Installing "Extractor Info Fetcher" Service in BD-Clowder-Dev and BD-Clowder

This document is currently under development. 

This document details the instructions for installing the Brown Dog auxiliary service Extractor Info Fetcher in BD-Clowder-dev (dev) and BD-Clowder (prod) machines. 

1. SSH into to bd-clowder.ncsa.illinois.edu or bd-clowder-dev.ncsa.illinois.edu. Rest of the instructions are identical for both these machines unless specified otherwise.
2. Clone extractor-info-service code repository into /home/browndog

   1. git clone opensource.ncsa.illinois.edu/bitbucket/scm/bd/bd-aux-services.git

3. Install extractor-info-service

   1. cd /home/browndog/bd-aux-services/extractor-info-fetcher

   2. sudo pyvenv prototype-endpoint-env

   3. source ./prototype-endpoint-env/bin/activate

   4. sudo pip install -r requirements.txt

   5. Update config.py so that the variables, especially rabbitmq_vhost, clowder_url, clowder_key store details about development instances or production instances based on the machine (i.e. dev or prod) in which the service is being installed.

4. Convert source code from Python2.7 to Python3 compatible by running (or something similar):

   1. sudo 2to3-3.5 -w extractor-info-fetcher.py

5. Update file permissions:
   

   1. sudo chown -R browndog /home/browndog/bd-aux-services/

   2. sudo chgrp -R users /home/browndog/bd-aux-services/

6. Make sure that the flask app can be run locally:

   1. sh ./run-scrip.sh

   2. If everything looks fine, kill the Flask app by pressing Ctrl + C.

7. Setup the Flask app as a systemd service

   1. sudo cp extractor-info-fetcher.service /lib/systemd/system

   2. sudo systemctl daemon-reload

   3. sudo systemctl start extractor-info-fetcher.service

8. Check the systemd service and make sure it is running:

   1. sudo systemctl status extractor-info-fetcher.service

9. Update iptables to allow traffic to port 5000 on this machine from within NCSA network

   1.