tmfev/gpas repository overview

⁠Note - Obsolete Release

This software product has no longer been maintained in the TMF Docker Hub since 2020. The latest versions in the form of docker-compose are continuously made available at ths-greifswald.de⁠.

For questions and suggestions, please contact us⁠.

⁠About

The gPAS⁠ (generic Pseudonym Administration Service) generates and administers appropriate pseudonyms using non-deterministic pseudonyms for arbitrary alphanumeric sequences. Additionally it allows defining domain-specific alphabets and generator algorithms as required and offers functions for de-pseudonymisation and anonymisation.

⁠Available Images

tmfev/gpas:1.9.1

tmfev/gpas:latest

⁠Image Structure

The gPAS Docker image bases on the mosaicgreifswald/wildfly image (latest), which was extended with a mysql database and the necessary deployments for gPAS. After successful start of the container, the database is prepared and initialised. Afterwards the wildfly starts and publishes the EAR- and WAR-files.

For more flexibility and ease of use, it is possible to access the MySQL Database, to mount a folder of the host-system as database volume

⁠Installation

docker run -p 8080:8080 tmfev/gpas:latest

⁠Using the Web-Interface

• after the container successfully started, open your web-brower and visit http://your-ip:8080/gpas-web

⁠Accessing the gPAS MySQL Database

• In order to access the database the port 3306 has to be published.

• Change the run command to docker run -p 8080:8080 -p 3306:3306 tmfev/gpas:latest

• Database credentials: user=gpas_user, password=gpas_password

⁠Custom database initialisation

• Use a volume to initialise your gpas database with demo data or domain configurations. Simply put your sql-files into a separate folder within your host-system and provide the respective volume as follows

docker run -p 8080:8080 -v /your/path/to/sqls:/entrypoint-mysql-initfiles tmfev/gpas:latest

⁠Docker-External data storage

• Use a volume to store the database contents outside of docker and within your host file system

docker run -p 8080:8080 -v /your/absolute/path:/entrypoint-mysql-data tmfev/gpas:latest

⁠More Information

Concept and implementation:

• Lars Geidel
• Arne Blumentritt

Please cite our publications:

• MOSAIC--A Modular Approach to Data Management in Epidemiological Studies. (http://dx.doi.org/10.3414/ME14-01-0133⁠)
• A workflow-driven approach to integrate generic software modules in a Trusted Third Party. (http://dx.doi.org/10.1186/s12967-015-0545-6⁠)
• http://dx.doi.org/10.3205/17gmds146⁠

For more info

• Visit https://ths-greifswald.de/gpas⁠
• Check out our live demo from https://ths-greifswald.de/gpas/demo⁠

⁠License

This Software was developed by the University Medicine Greifswald. It it licensed under AGPLv3 and initially provided by the DFG-funded MOSAIC-Project (grant number HO 1937/2-1).