ORCID-Hub 3.0.1.dev757

# NZ-ORCID-Hub [](https://travis-ci.org/Royal-Society-of-New-Zealand/NZ-ORCID-Hub)[](https://coveralls.io/github/Royal-Society-of-New-Zealand/NZ-ORCID-Hub)[](http://docs.orcidhub.org.nz/)
The home of development for the New Zealand ORCID Hub.

- [Application Docker Image](#application-docker-image)
* [Usage](#usage)
* [Environment Variables](#environment-variables)
- [Steps to execute this application](#steps-to-execute-this-application)
- [Development Environment](#development-environment)


## Application Docker Image

Application Docker Image ([orcidhub/app](https://hub.docker.com/r/orcidhub/app/)) is packaged with:
- CentOS 7
- Apache 2.4
- Python 3.6
- mod_wsgi (Pythgon/WSGI Apache module)
- psycopg2 (native PostgreSQL Python DB-API 2.0 driver)
- PyPI packages necessary for the application

### Environment Variables

The application image uses several environment variables which are easy to miss. These ariable should be set up for the specific runtime environment.

| Variable | Example | Description |
|-----------------------------|-----------------------|------------------------|
|ENV |test | The runtime environment name |
|SHIB_SP_DOMAINNAME |${ENV}.<container domainname> | Your **Service Provider** domain name |
|SHIB_IDP_DOMAINNAME |http://directory.tuakiri.ac.nz | Your **Idendtity Provider** domain name |
|SHIB_SSO_DS_URL |https://${SHIB_IDP_DOMAINNAME}/ds/DS | SSO discovery service URL |
|SHIB_METADATA_PROVIDER_URI |https://engine.surfconext.nl/authentication/idp/metadata| **Shibboleth** SAML 2.0 meta data provider URI [NativeSPMetadataProvider](https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPMetadataProvider) |
|SHIB_METADATA_CERT_FILE |conf/tuakiri-test-metadata-cert.pem | Meta data signig certificate |
|ORCID_CLIENT_ID |0000-1234-2922-7589 |Orcid API client ID and secret |
|ORCID_CLIENT_SECRET |b2aab710-89a1-49e8-65e4-8df4f038dce9 |Orcid API client ID and secret |

### Usage

1 - run application containers:

docker-compose up -d

2 - find container IP address:

docker inspect --format '{{.NetworkSettings.IPAddress}}' app

3 - verify it's running:

http $(docker inspect --format '{{.NetworkSettings.IPAddress}}' app)

## Steps to execute this application

If you are running this application for the first time then follow steps a to d:

a. From the project directory run

pip3 install -r requirement.txt

b. to install postgress and required libraries do

sh ./install_package.sh

c. Create database and user in postgres

CREATE USER orcidhub WITH PASSWORD '*****';
CREATE DATABASE orcidhub;
GRANT ALL PRIVILEGES ON DATABASE orcidhub to orcidhub;

d. Run initializedb.py to create table in postgres

python application.py

Open link https://test.orcidhub.org.nz/index

## Development Environment

It is possible to run the application as stand-alone Python Flask application using another remote application instance for Tuakiri user authentication. For example, if the remote
(another application instance) url is https://dev.orcidhub.org.nz, all you need is to set up environment varliable `export EXTERNAL_SP=https://dev.orcidhub.org.nz/Tuakiri/SP`.

In order to siplify the development environment you can use Sqlite3 DB for the backend.

To set up the database use environment variable DATABASE_URL, e.g. `export DATABASE_URL=sqlite:///data.db` and run application either directly invoking it with `python application.py` or using Flask CLI (http://flask.pocoo.org/docs/0.12/cli/):

export EXTERNAL_SP=https://dev.orcidhub.org.nz/Tuakiri/SP
export DATABASE_URL=sqlite:///data.db
export FLASK_APP=/path/to/main.py
export PYTHONPATH=$(dirname $FLASK_APP) ## flask run has problems with setting up search paths
export FLASK_DEBUG=1
flask run

You can add these setting to you virtual environment activation script, e.g. (assuming it's located in the root directory):

export FLASK_APP=$(dirname $VIRTUAL_ENV)/main.py
export PYTHONPATH=$(dirname $FLASK_APP)
export EXTERNAL_SP=https://dev.orcidhub.org.nz/Tuakiri/SP
export DATABASE_URL=sqlite:///data.db
export FLASK_DEBUG=1

To connect to the PostgreSQL node:

export PGHOST=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $(docker-compose ps -q db))
export DATABASE_URL=postgresql://orcidhub:p455w0rd@${PGHOST}:5432/orcidhub