Additional Resources - inab/openVRE GitHub Wiki

Additional Resources

This section provides helpful references, troubleshooting tips, and legal information for using and citing the platform.

4.1 FAQ

Frequently Asked Questions (FAQ) about using the system, common issues, and their solutions.

4.2 Troubleshooting

Guidance for diagnosing and resolving common problems.

  1. Frontend is not being build because of a Mongo dependency
    • When building front_end container: MongoDB occasionally moves or updates their GPG key. You can to replace the original RUN line in frontend/Dockerfile by an equivalent line using another URL instead:
RUN curl -fsSL https://pgp.mongodb.com/server-4.2.asc | apt-key add -
  1. Authentication failes because token expiration
    • When connecting to an external Keycloak service, make sure that both systems have the right date and time.
#Updating timezone
sudo timedatectl set-timezone Europe/Madrid

  1. Error response from daemon: path /home/jmfernandez/TEMP/openVRE-core-dev/volumes/shared_data is mounted on / but it is not a shared mount

    • You can solve this problem running this command:
    sudo mount --make-shared /
    • Another solution you can use (can change based on the operating system), is commenting or deleting the line :rshared in the docker-compose.yml sgecore Volumes section.

  2. Data is not accessible

    • After setting up the docker-compose up command, and trying to connect to the front_end via web, the error Data is not accessible comes out. In your system, you will have to change permissions of the openVRE-core-dev /volumes/ dir permission:
    chmod 777 volumes/shared/data

  3. $FQDN_HOST port 272017 already in use

    • After setting up the docker-compose up command, from the front_end container errors (coming from running docker logs front_end) and this is the error appearing, it would be needed to change the value for port configuration for $MONGO_PORT in the .env file, as well as in openVRE-core-dev /front_end/openVRE/config/mongo.conf corresponding port value.

4.3 Citation and Acknowledgements

Information on how to cite the platform, and acknowledgement of contributors or funding sources.

4.4 License

Details on the licensing of the platform, data, and software components.