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>