Installation of labfolder¶

+

Labfolder is easy to install. Follow the instructions given in the labfolder Installation Manual. The broad steps are: install MySQL, docker and labolder; configure labfolder via the server.cnf file. This labfolder config file could look like this:

+

# Network settings
+DEFAULT_HTTP_PROTOCOL=https://
+DEFAULT_DOMAIN=labfolder.rz-berlin.mpg.de
+
+# JDBC Properties
+JDBC_SERVER_TIMEZONE=Europe/Berlin
+JDBC_DATABASE_URL=jdbc:mysql://localhost:3306/labfolder?useUnicode=true&characterEncoding=UTF-8
+JDBC_USERNAME=labfolder
+JDBC_PASSWORD=fhilab
+JDBC_SCHEMA_NAME=labfolder
+#REMOVE_ABANDONED_TIMEOUT=60
+
+# Mail client properties
+MAIL_STARTTLS=false
+MAIL_AUTHENTICATION_ENABLE=false
+MAIL_HOST=mail.fhi-berlin.mpg.de
+MAIL_PORT=25
+#MAIL_USERNAME=
+#MAIL_PASSWORD=
+MAIL_EMAIL=ppb@fhi-berlin.mpg.de
+
+# Server Event logging
+LOG_TO_FILE=true
+
+#Maximum upload file size
+FILEUPLOAD_MAXUPLOADSIZE=25000000
+
+# User and group control
+DEFAULT_GROUP_SIZE=50
+DEFAULT_GROUP_TYPE_MAXI=true
+DEFAULT_USER_STORAGE=3221225472
+FEATURE_GLOBAL_PREVENT_DELETE_CONTENT=false
+
+# Terms and Privacy links
+TERMS_OF_USE_LINK=https://www.labfolder.com/terms-external-servers/
+PRIVACY_LINK=https://www.labfolder.com/privacy-external-servers/
+
+# LDAP Authentication
+FEATURE_LDAP_AUTHENTICATION=true
+LDAP_URL=ldap://ldap.rz-berlin.mpg.de:389
+LDAP_BASE=ou=people,dc=ppb,dc=rz-berlin,dc=mpg,dc=de
+#LDAP_SERVER_TYPE=
+LDAP_USER_DN=cn=pwCheck,dc=rz-berlin,dc=mpg,dc=de
+LDAP_PASSWORD=ProstetnikVogonJeltz
+#LDAP_ANONYMOUS_READ_ONLY=
+LDAP_USER_DN_PATTERNS=uid={0}
+#LDAP_IS_TLS_ENABLED=
+#LDAP_IS_ATTRIBUTE_SEARCH_ENABLED=
+#LDAP_ATTRIBUTE_SEARCH_NAME=
+
+# Usage monitoring
+ACTIVE_USER_REPORT_USE_DEFAULT_MAIL_CLIENT=true
+CUSTOMER_IDENTIFIER='Fritz-Haber-Institut'
+
+# Mendeley
+FEATURE_MENDELEY=false
+#MENDELEY_CLIENT_ID=
+#MENDELEY_CLIENT_SECRET=
+#MENDELEY_CLIENT_CALLBACKURL=http://localhost:9091/eln/mendeley/oauthCallback
+
+# Dropbox
+FEATURE_DROPBOX=false
+#DROPBOX_CONSUMER_KEY=
+#DROPBOX_CONSUMER_SECRET=
+
+# Figshare
+FEATURE_FIGSHARE=false
+
+# XHTML Export
+FEATURE_XHTML_EXPORT=true
+EXPORT_DOCUMENT_REPOSITORY_TYPE=fileSystem
+

+

+

The configuration is explained in detail in the installation manual. Now, create the labfolder database and run labfolder (see the manual for details). Additionally, you could install Apache and set it up as a reverse proxy in order to make labfolder only available through https. The exact steps are:

+

labfolder@lf:~$ sudo apt-get install build-essential
+labfolder@lf:~$ sudo apt install apache2
+labfolder@lf:~$ sudo a2enmod proxy proxy_ajp proxy_http rewrite deflate headers proxy_balancer proxy_connect proxy_html xml2enc
+labfolder@lf:~$ sudo a2enmod ssl
+
+### Use certificates from e.g. let's encrypt. Please see below for more information.
+
+### create /etc/apache2/sites-available/labfolder.conf with virtual hosts for http and https:
+labfolder@lf:~$ sudo a2ensite labfolder.conf
+labfolder@lf:~$ sudo a2dissite 000-default.conf
+labfolder@lf:~$ sudo service apache2 restart
+

+

+

To get SSL certificates from letsencrypt is quite straight forward. For example this guide shows how to set up SSL certificates:

+

https://www.digitalocean.com/community/tutorials/how-to-secure-apache-with-let-s-encrypt-on-ubuntu-16-04

+

The Apache labfolder config file could look like this:

+

<VirtualHost *:80>
+    ErrorLog /var/log/apache2/error.log
+    LogLevel warn
+
+    ServerName labfolder.rz-berlin.mpg.de
+    Redirect / https://labfolder.rz-berlin.mpg.de/
+</VirtualHost>
+
+<VirtualHost *:443>
+    ErrorLog /var/log/apache2/error.log
+    LogLevel warn
+
+    ServerName labfolder.rz-berlin.mpg.de
+
+    SSLEngine On
+    SSLCertificateFile /etc/letsencrypt/live/labfolder.rz-berlin.mpg.de/fullchain.pem
+    SSLCertificateKeyFile /etc/letsencrypt/live/labfolder.rz-berlin.mpg.de/privkey.pem
+
+    ProxyPass / http://141.14.138.230:9091/
+    ProxyPassReverse / http://141.14.138.230:9091/
+</VirtualHost>
+

+

+

+ + +