Configuring Linshare¶

Properties files¶

Linshare configuration is based on java properties files.
All available options can be found in linshare-default.properties.
This file is located on src/main/resources of source folder or in WEB-INF/classes directory of linshare.war.
This file shouldn't be change directly.

To configure any of linshare properties you should override default config by using a custom linShare.properties file.

Do as following:

Create a linShare.properties (or use one of samples files found in src/main/resources folder)
Copy properties that you need to override from linshare-default.properties.
Change to desirated values
Set the java option -Dlinshare.config.path to point to the directory containing the linShare.properties file

Optionally for developers you can add a linShare.properties file in src/main/resources that will be pick up at launch.

If you have used the installer or the release bundle you can directly configure linShare by editing $INSTALL_FOLDER/jetty/resources/linShare.properties

What should I configure¶

Linshare to work use three main components:

a database to stock informations
an Ldap directory
A JCR repository to stock document contents

These three components need to be parametrized. You also need to configure an SMTP server to allow linShare to send emails.

Database configuration¶

#******************** DATABASE
### PostgreSQL
linshare.db.username=linshare
linshare.db.password=linshare
linshare.db.driver.class=org.postgresql.Driver
linshare.db.url=jdbc:postgresql://localhost:5432/linshare
linshare.db.dialect=org.hibernate.dialect.PostgreSQLDialect
linshare.db.persistence_manager=org.apache.jackrabbit.core.persistence.bundle.PostgreSQLPersistenceManager

#show sql command in console (true in debug mode)
linshare.db.show_sql=false
#format sql command in console (true in debug mode)
linshare.db.format_sql=false
#generate statistics with hibernate
linshare.db.gen_stats=false
# can be create, create-drop, update, validate, choose validate for production
linshare.db.hbm2ddl.auto=validate

LDAP configuration¶

#******************** LDAP FOR AUTHENTICATION
#if you use ssl with ldap put ldaps in url
ldap.auth.url=ldap://localhost:389
ldap.auth.base=dc=linagora,dc=com
ldap.auth.baseDN=ou=test,o=linShare
ldap.auth.attribute=mail
ldap.auth.key=${ldap.auth.attribute}={0}
ldap.hash.algo=SHA
# Strategy is SIMPLE, DEFAULT_TLS, or EXTERNAL_TLS for SASL connection. TLS is not supported at this time by linShare
ldap.auth.strategy=SIMPLE
#Leave ldap ssl configuration empty if not used. Give path to a java trustore.
ldap.auth.ssl.trustore.file=
ldap.auth.ssl.trustore.password=

#Leave userDN and password empty for anonymous connection to LDAP
ldap.auth.userDN=cn=nss,dc=linagora,dc=com
ldap.auth.password=nss

#paging ldap search: pageSize < sizelimit of the ldap
# Use only with compatible directories, 0 instead
#ldap.pageSize=400
ldap.pageSize=0

Smtp configuration¶

#******************** MAIL CONFIGURATION TO SEND MAIL INFORMATION TO USER

mail.smtp.host=smtp.linagora.com
mail.smtp.sender=linShare@linagora.com
mail.smtp.user=user
mail.smtp.password=password
mail.smtp.auth.needed=false
mail.smtp.charset=UTF-8

General properties¶

#******************** GENERAL PROPERTIES

#max input type file slots in upload form
linshare.default.maxUpload=10
#Maximum size (in bytes) of a single upload request Defaults to -1 (no limit).
linshare.default.maxUploadSize=-1
#linshare url which is used in mail templates. give a different internal url if internal
# user connect with a different url (e.g. CAS url)
linshare.info.url.base=http://localhost:8080/linshare/
linshare.info.url.internal=http://localhost:8080/linshare/
#directory of the jws application to decrypt document (jwsDecrypt.jar)
javawebstart.decrypt.url.suffixcodebase=applet
#set to true in tapestry production environnement
linshare.productionMode=false
#local work directory to encrypt/decrypt data
linshare.encipherment.tmp.dir=${LINSHARE_HOME}/var/lib/linshare/tmp
#local work directory to sign data
linshare.signature.tmp.dir=${LINSHARE_HOME}/var/lib/linshare/tmp/linSignDocuments
#directory used to store shared files
linshare.files.directory=${LINSHARE_HOME}/var/lib/linshare/repository

SSO Configuration¶

#******************** SSO 
sso.button.hide=true
# extra config for CAS sso (disable springContext-security and use configuration springContext-securityCAS.xml)
sso.cas.url=http://localhost:8081/cas-server-webapp-3.3.5
sso.cas.url.login=http://localhost:8081/cas-server-webapp-3.3.5/login
sso.cas.url.serviceId=http://localhost:8080/linshare/j_spring_cas_security_check
# LemonLDAP::NG / SiteMinder HTTP request authenticator
sso.header.user=Auth-User

Virus scanner Configuration¶

#******************** VIRUS SCANNER
#uncomment those properties if you want to enable clamav virus scanner feature
#virusscanner.clamav.host=localhost
#virusscanner.clamav.port=3310

Document Timestamping¶

just set URL of your central TSA service.

you can install openTSA (http://www.opentsa.org/)
OR signserver (http://signserver.org/installationguide.html) with the Timestamp demo

#******** TSA Authority (optional)
tsa.url=http://localhost:8080/signserver/tsa?signerId=1

Managing Linshare¶

You can use admin account to manage LinShare (see administration)

Also available in: HTML TXT

LinShare

Wiki