==== Installation von OpenProject auf GAIA in Bonn ====

FIXME

Installation instruction with docker: 
[[https://docs.openproject.org/installation-and-operations/installation/docker/#_ga=2.221799888.95447116.1593584930-33507941.1590480381|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.

<code bash >

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

</code>

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.)

=== docker container neu aufsetzen ===

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.)



<code bash>
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  

</code>

  * 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


=== Apache2 anpassen ===

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

<code bash >
     # 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>                                                                                                                            
</code>


check if everything is setup correctly and restart the apache2 server

<code bash >
sudo apache2ctl configtest
sudo service apache2 restart 

</code>

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

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

User: admin
PW: <decrypt>U2FsdGVkX1+2y5SS3I3JH2Y4zia9ZMU9Is2BEqErReM=</decrypt>


use following commands to start or stop container
<code bash>
sudo docker start openproject
sudo docker stop openproject
</code>
=== TODO ===

  * 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)