ARCHIVED

This project is no longer maintained and will not receive any further updates. If you plan to continue using it, please be aware that future security issues will not be addressed.

DaKaMon

Introduction

DaKaMon is a system for storing hydrological measurements in a structured database and was developed within the "Monitoringprogramm für prioritäre Stoffe zur Ableitung deutschlandweiter differenzierter Emissionsfaktoren zur Bilanzierung der Stoffeinträge aus kommunalen Kläranlagen".

License

• GPLv2 (see LICENSE.md)
• see NOTICE.md for used libraries

Steps for Developers

1. Clone this repository:

   git clone https://github.com/52north/dakamon.git
   

2. Clone dakamon-r-tools repository and create docker image for shiny-server. If you are using Windows you have to check the docker/shiny-server.sh file for line-endings because it should be LF and not CRLF. With CRLF the shiny server does not start! Please replace USER with your username and YYYY-MM with the current values in the following commands:

   git clone https://github.com/52north/dakamon-r-tools.git
   cd dakamon-r-tools
   docker build -f docker/Dockerfile -t shiny-server:dakamon-$(date +%Y-%m) .
   

3. Update the according docker-compose.yml (dev/production) to use the correct shiny-server image:

       [...]
       shiny:
         image: shiny-server:dakamon-YYYY-MM
       [...]
   

4. Switch back to this repository.
5. Build SOS image (adjust path to Dockerfile and tagname!):

       docker build -f sos/Dockerfile -t sos:dakamon-$(date +%Y-%m) .
   

6. Update the according docker-compose.yml (dev/production) to use the correct sos image:

       [...]
       sos:
         build: .
         image: sos:dakamon-YYYY-MM
       [...]
   

7. Launch according docker-compose.yml for testing the set-up:

      user@host:~$ docker-compose --file (dev|production)/docker-compose.yml up --force-recreate --remove-orphans
   

Steps for Users

1. Clone this repository:

   user@host:~/$ git clone https://github.com/52north/dakamon.git
   

2. Make the scripts executable:

   user@host:~/$ cd dakamon
   user@host:~/dakamon$ chmod +x init-vm.sh init-db.sh update-apps.sh
   

3. Run start installation script and follow the instructions on the screen:

   user@host:~/dakamon$ sudo ./init-vm.sh
   

4. Run database initialization script and follow the instructions on the screen

   user@host:~/dakamon$ sudo su postgres
   postgres@host:/home/user/dakamon$ ./init-db.sh
   

5. Run apps install and update script:

   user@host:~/dakamon$ sudo ./update-apps.sh
   

Contact

• Gräler, Benedikt

Developer

• Bredel, Henning
• Hollmann, Carsten
• Jürrens, Eike Hinderk