Installation instruction with docker: Externer Link

Zu beginn wird eine Ordner struktur auf Gaia geschaffen, in denen die generierten Dateien abgelegt werden können. Dadurch wird sichergestellt, dass Inhalte noch vorhanden sind , wenn der docker container neu gestartet wird. Diese Dateien müssten in Zukunft gesichert werden und in die Backup-Routine aufgenommen werden. Dies ist für die Zeit der Testphase nicht vorgesehen, wodurch keine wichtigen Informationen gespeichert werden sollten.

sudo mkdir -p /var/lib/openproject/{pgdata,static}

Der erste Anlauf die einzelnen services in eigene container zu stecken hat nicht funktioniert, da die docker-compose version zu alt ist. Daher wird für die Testphase die all-in-1 Lösung verwendet.

daher wird der docker container all-in-one gestartet

(Github wurde heruntergeladen. Wird aber vermutlich nur für die geteilte Lösung benötigt.)

The following command will produce our container: (the first two docker container commands were run previously. These are not the final ones. BUT: somehow they set environmental variables, which are important for a propper setup. If we leave the first two out and only start with the third one, some small icons are missing.)

sudo docker ps #to check which container are running
 
#sudo docker run -it -p 6580:80 -e SECRET_KEY_BASE=hm013joe40 openproject/community:10
#sudo docker run -d -p 6580:80 -e SECRET_KEY_BASE=hm013joe40 openproject/community:10
 
#set environmental variables 
#not shure if all are needed...
BASH_REMATCH=()
COMP_WORDBREAKS='
"'\''><=;|&(:'
arg=op
 
#now start the docker container
sudo docker run -d -p 6580:80 -e OPENPROJECT_RAILS__RELATIVE__URL__ROOT=/op -e OPENPROJECT_RAILS__FORCE__SSL=true -e SECRET_KEY_BASE=hm013joe40 --name openproject -v /var/lib/openproject/pgdata:/var/openproject/pgdata -v /var/lib/openproject/static:/var/openproject/assets openproject/community:10

• port on localhost 6580 : connected to port on container 80
• we send the output to the relative URL /op
• we enforce SSL
• our secret key
• name of our container is openproject (this makes start/stop easier)
• folder on local system /var/lib/openproject/pgdata is connected to the folder within the container /var/openproject/pgdata
• folder on local system /var/lib/openproject/static is connected to the folder within the container /var/openproject/assets
• the docker image is pulled from the dockerhub openproject/community:10

Wir müssen nun einen bestehenden Webserver (Apache2) so configurieren, dass die information die auf localhost:6580 von dem container ankommt über ein Unterverzeichnis auf https://gaia.zfmk.de/ erreichbar ist.

Dafür wird folgende Datei angepasst und die nachfolgenden Zeilen ergänzt.

/etc/apache2/sites-available/gaia_zfmk_de.conf

     # openproject test                                                                                                                                         
    RewriteEngine on                                                                                                                                           
    RewriteRule "^/op$" "/op/" [R,L]                                                                                                                           
 
    ProxyRequests off                                                                                                                                          
 
    <Location "/op/">                                                                                                                                          
          RequestHeader set X-Forwarded-Proto 'https'                                                                                                          
 
          ProxyPreserveHost On                                                                                                                                 
          ProxyPass http://127.0.0.1:6580/op/                                                                                                                  
          ProxyPassReverse http://127.0.0.1:6580/op/                                                                                                           
    </Location>                                                                                                                            

check if everything is setup correctly and restart the apache2 server

sudo apache2ctl configtest
sudo service apache2 restart

We should now be able to find our OpenProject page here:

https://gaia.zfmk.de/op/

User: admin PW: ••••••••••

use following commands to start or stop container

sudo docker start openproject
sudo docker stop openproject

• Email SMTP server ( for user notifications )
• Backup of Folders
• LDAP ( for the next phase if more users should be included. Sync with zfmk usernames and passwords. Should be done by the IT )
• Try to connect calender with outlook or other calender (for Verwaltung and those windows users)