Getting the ChRIS Store to work on Fedora

These instructions have been tested on Fedora 31, and should also work on Fedora 32.

Step 1:

Get a functional Docker environment on your system

Docker doesn't support SELinux OOTB, and there are also changes in how Fedora 32 works with respect to CGroups and a change to NFTables for the firewall. So before you complete the setup instructions for the ChRIS store, you'll want to complete the steps outlined in this Fedora magazine article:

HOWTO: Docker and Fedora 32

Step 2:

Modify the dev docker-compose yml to be SELinux-compatible

The docker-compose_dev.yml file in the ChRIS_store repo needs to be modified to be SELinux compatible so it can run on Fedora:

https://github.com/FNNDSC/ChRIS_store/blob/master/docker-compose_dev.yml

You must change the following 3 lines by appending a ":z" to their end:

• Line 17: - ./store_backend:/home/localuser/store_backend:z
• Line 30: - chris_store_dev_db_data:/var/lib/mysql:z
• Line 44: - swift_storage_dev:/srv:z

Step 3:

Begin following the simplified setup instructions to set up the backend

The simplified setup instructions for getting the ChRIS store to run on your system are in the README file of the ChRIS UI repo:

https://github.com/FNNDSC/ChRIS_store_ui

You will follow these with some modifications. Complete the steps for getting the backend up and running and stop before the instructions on setting up the UI.

Step 3:

Set up the UI

Follow these alternative instructions to get the UI running on Fedora:

Build the UI

docker build -t local/chris_store_ui .

Run the UI

docker run --name chris_store_ui -p 3000:3000 -d local/chris_store_ui

View the UI in a local browser

The UI will be available at http://localhost:3000. The login credentials are as follows:

• Login: cubeadmin
• Password: cubeadmin1234

Tear down the UI container

docker stop chris_store_ui

docker rm chris_store_ui

(If needed) Tear down the ChRIS Store backend

$ cd ChRIS_store

$ ./make.sh down