Skip to content
Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
613 lines (419 sloc) 21.3 KB

Sommaire

INSTALLATION LINSHARE

1. Installation minimale de Linshare

INSTALLATION LINSHARE

Note:
Ce guide d'installation est pour les versions 2.x LinShare sur Debian 8 Jessie (Les autres distributions de Debian ne sont pas supportées). L'installation des versions précédentes de LinShare est disponible dans les branches github par exemple: LinShare 1.12.x

Installation minimale de LinShare

Téléchargement de LinShare

LinShare est en libre téléchargement à l’adresse suivante:

Note:
Vous trouverez toutes les versions de LinShare à l'adresse [suivante] (http://download.linshare.org/versions/). Choisissez la version de LinShare en accord avec votre guide d'installation. Chaque version de LinShare contient tous les composants nécessaires liés à une version spécifique de LinShare. N'installez pas et n'utilisez pas un composant dont la version est différente de celles que vous trouverez dans le même dossier. Sinon, vous risquez de rencontrer des problèmes de dépendances et LinShare peut ne pas fonctionner correctement.

Pour cette installation, téléchargez les fichiers suivants :

  • linshare-core-{VERSION}.war

  • linshare-ui-admin-{VERSION}.tar.bz2

  • linshare-ui-user-{VERSION}.tar.bz2

Déploiement de l'archive et des fichiers de configurations

Afin de manipuler les archives, il est nécessaire d’utiliser les outils Unzip et Bzip :

[root@localhost ~]$ aptitude install unzip bzip2 vim

Créez le répertoire de configuration de LinShare et copiez les fichiers de configuration :

[root@localhost ~]$ mv linshare-core-{VERSION}.war linshare.war
[root@localhost ~]$ mkdir -p /etc/linshare
[root@localhost ~]$ unzip -j -d /etc/linshare/ linshare.war WEB-INF/classes/{linshare,log4j}.*

Environnement d’exécution Java (JVM)

LinShare fonctionne avec OpenJDK et Sun/Oracle Java version 8. Ce guide porte sur OpenJDK Java 8.

Installation de OpenJDK Java JRE

Installez Java Runtime Environment (JRE) de OpenJDK depuis les dépôts :

Note:

  • Si vous êtes sur Debian jessie, vous devez ajoutez les bakcports pour pouvoir installer JAVA 8. Pour ce faire vous devez ajouter cette ligne : deb http://ftp.debian.org/debian jessie-backports mai au fichier /etc/apt/sources.list. Puis vous pouvez installer le package désiré comme suit : aptitude update; aptitude -t jessie-backports install votre_package.
[root@localhost ~]$ aptitude install openjdk-8-jre
[root@localhost ~]$ update-alternatives --config java

Remarque:
* les éventuelles erreurs relatives au plugin Java peuvent être ignorées.

Base de données

LinShare requière l’utilisation d’une base de données (PostgreSQL) pour ses fichiers et sa configuration. Ce guide présente une installation avec PostgreSQL.

Installation de PostgreSQL depuis les dépôts :

[root@localhost ~]$ aptitude install postgresql

Démarrez le service PostgreSQL :

[root@localhost ~]$ service postgresql start

Création des accès sécurisés

Adaptez le fichier de gestion des accès de PostgreSQL :

[root@localhost ~]$ vim /etc/postgresql/<VERSION>/main/pg_hba.conf
 # TYPE  DATABASE                  USER          CIDR-ADDRESS         METHOD
 local   linshare                  linshare                           md5
 host    linshare                  linshare      127.0.0.1/32         md5
 host    linshare                  linshare      ::1/128              md5

Note:

  • Ces lignes se trouvent généralement à la fin du fichier de configuration.
  • Pour des raisons de sécurité, le service PostgreSQL n’écoute qu’en local.
  • Pensez à redémarrer/recharger le serveur PostgreSQL après vos modifications pour qu'elles soient prises en compte:
    [root@localhost ~]$ service postgresql restart/reload

Il convient également d'ajouter ces règles dans les premières. En effet, PostgreSQL utilise la premère règle valide qui correspond à la demande d'authentification.

Créez l’utilisateur « linshare » (mot de passe {PASSWORD}) :

[root@localhost ~]$ su - postgres
[postgres@localhost ~]$ psql

CREATE ROLE linshare
  ENCRYPTED PASSWORD '{PASSWORD}'
  NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;

\q

Commandes : pour quitter, tapez « \q » ; pour obtenir de l’aide sous PSQL, tapez « ? ».

Créez et importez les schémas de base de données :

[root@localhost ~]$ su - postgres
[postgres@localhost ~]$ psql

CREATE DATABASE linshare
  WITH OWNER = linshare
       ENCODING = 'UTF8'
       TABLESPACE = pg_default
       LC_COLLATE = 'en_US.UTF-8'
       LC_CTYPE = 'en_US.UTF-8'
       CONNECTION LIMIT = -1;


GRANT ALL ON DATABASE linshare TO linshare;

\q

Important : si votre base de données est installée en langue française, remplacez toutes les occurrences de chaîne « en_US » par « fr_FR ».

Note:
* Si besoin, vous disposez d'un script nommé createDatabase.sh sous /WEB-INF/classes/sql/postgresql/ qui vous fournit les commandes pour créer vos bases de données.

Importez les fichiers SQL « createSchema.sql » et « import-postgresql.sql » :

[root@localhost ~]$ tar xjvf linshare-core-*-sql.tar.bz2
[root@localhost ~]$ psql -U linshare -W -d linshare linshare-core-sql/postgresql/createSchema.sql
Password for user linshare: {PASSWORD}
[root@localhost ~]$ psql -U linshare -W -d linshare linshare-core-sql/postgresql/import-postgresql.sql
Password for user linshare: {PASSWORD}

Éditez le fichier de configuration de LinShare :

[root@localhost ~]$ vim /etc/linshare/linshare.properties
#******************** DATABASE
### PostgreSQL
linshare.db.username=linshare
linshare.db.password={PASSWORD}
linshare.db.driver.class=org.postgresql.Driver
linshare.db.url=jdbc:postgresql://localhost:5432/linshare
linshare.db.dialect=org.hibernate.dialect.PostgreSQLDialect

Pour l'installation de LinShare, vous aurez aussi besoin d'installer une base de données mongoDB spécifique (version 3.2), vous pouvez le faire en suivant les commandes suivantes :

Importez d'abord la clé publique utilisée par le système de gestion des paquets:

[root@localhost ~]$ apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927

Vous devez créer un fichier de liste:

[root@localhost ~]$ echo "deb http://repo.mongodb.org/apt/debian jessie/mongodb-org/3.2 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list

Après cela, vous devez recharger les paquets locaux de la base de données:

[root@localhost ~]$ apt-get update

Installez la dernière version stable de MongoDB:

[root@localhost ~]$ apt-get install -y mongodb-org

Avant de lancer MongoDB, assurez-vous que le fichier /etc/mongod.conf a l'adresse IP de bind: 127.0.0.1

Pour finir, lancez la commande suivante pour démarrer mongod.

[root@localhost ~]$ service mongod start

Activation du moteur d'aperçu (Optionnel)

LinShare dispose d'un moteur de génération d'aperçu pour plusieurs types de fichiers :
  • Formats OpenDocument (ODT, ODP, ODS, ODG)
  • Formats de documents Microsoft (DOCX, DOC, PPTX, PPT, XLSX, XLS)
  • PDF documents
  • Fichiers images (PNG, JPEG, JPG, GIF)
  • Fichiers text (TXT, XML, LOG, HTML, ...)

Note:
* Avant d'activer le module vous devez avoir installé LibreOffice ou OpenOffice, la version minimale requise pour LibreOffice est : 4.2.8.

Pour installer LibreOffice, exécutez la commande suivante dans votre terminal :

 aptitude update
 aptitude install libreoffice

Par défault le moteur de génération de thumbnail est mis à FALSE. Pour l'activer vous devez modifier le fichier de configuration de LinShare comme ceci :

#******** LinThumbnail configuration
# key to enable or disable thumbnail generation
linshare.documents.thumbnail.enable=true
# key to enable remote thumbnail generation
linshare.linthumbnail.remote.mode=false
linshare.linthumbnail.dropwizard.server=http://0.0.0.0:8090/linthumbnail?mimeType=%1$s
linshare.documents.thumbnail.pdf.enable=true

Cela va permettre de générer des aperçus après chaque dépôt de fichiers.

Vous avez également la possibilité d'utiliser le moteur de thumbnail à distance. Pour cela il faut d'abord activer le remote.mode :

#******** LinThumbnail configuration
# key to enable or disable thumbnail generation
linshare.documents.thumbnail.enable=true
# key to enable remote thumbnail generation
linshare.linthumbnail.remote.mode=true
linshare.linthumbnail.dropwizard.server=http://0.0.0.0:8090/linthumbnail?mimeType=%1$s
linshare.documents.thumbnail.pdf.enable=true

Vous pouvez maintenant, allez à cette adresse http://download.linshare.org/versions/ et téléchargez les fichiers suivants :

  • linshare-thumbnail-server-{VERSION}.jar
  • linshare-thumbnail-server-{VERSION}.yml

Note
Par défaut, le serveur est configuré pour écouter sur le port 80, vous pouvez le changer, si nécessaire.

Copiez le fichier linshare-thumbnail-server-{VERSION}.yml dans /etc/linshare/linshare-thumbnail-server.yml et copiez aussi l'archive java linshare-thumbnail-server-{VERSION}.jar dans le répertoire /usr/local/sbin/linshare-thumbnail-server.jar, vous pouvez utilisez les commandes suivantes pour ça :

cp linshare-thumbnail-server-*.yml /etc/linshare/linshare-thumbnail-server.yml
cp linshare-thumbnail-server-*.jar /usr/local/sbin/linshare-thumbnail-server.jar
  • Vous pouvez automatiser le lancement du serveur thumbnail, en créant un service systemd sur le répertoire /etc/systemd/system, nommez-le comme suit linshare-thumbnail-server.service.

Éditez le fichier linshare-thumbnail-server.service et copiez le code ci-dessous :

[Unit]
Description=LinShare thumbnail server
After=network.target

[Service]
Type=idle
KillMode=process
ExecStart=/usr/bin/java -jar /usr/local/sbin/linshare-thumbnail-server.jar server /etc/linshare/linshare-thumbnail-server.yml

[Install]
WantedBy=multi-user.target
Alias=linshare-thumbnail-server.service

Vous pouvez maintenant activer le service, il sera lancé automatiquement après un redémarrage:

systemctl enable linshare-thumbnail-server.service

Exécutez la commande suivante pour démarrer le service :

systemctl start linshare-thumbnail-server.service

Conteneur de servlets

LinShare étant une application Java compilée et empaquetée au format WAR ( Web Application aRchive), il lui faut donc un conteneur de servlets Java (Tomcat ou Jetty) pour fonctionner.

Ce paragraphe présente l’installation et la configuration du serveur Tomcat.

Installation de Tomcat 8

Installez Tomcat depuis les dépôts :

[root@localhost ~]$ aptitude install tomcat8

Paramètres supplémentaires

Dans le fichier /var/lib/tomcat8/conf/catalina.properties de votre tomcat, vous avez une clé de configuration nommée tomcat.util.scan.StandardJarScanFilter.jarsToSkip, vous devez ajouter la ligne du milieu ci-dessous :

jetty-*.jar,oro-*.jar,servlet-api-*.jar,tagsoup-*.jar,xmlParserAPIs-*.jar,\
jclouds-bouncycastle-1.9.2.jar,bcprov-*.jar,\
xom-*.jar

Configuration de Tomcat 8

Pour spécifier l’emplacement de la configuration de LinShare (fichier linshare.properties) ainsi que les options de démarrage par défaut nécessaire, récupérer les lignes commentées dans l'en-tête dans le fichier linshare.properties et copier-coller les dans le fichier tomcat ( /etc/default/tomcat8 ).

L’ensemble des options de démarrage par défaut nécessaires à LinShare sont indiquées dans les en-têtes des fichiers de configuration suivants :

  • /etc/linshare/linshare.properties
  • /etc/linshare/log4j.properties

Déploiement de l'archive

Déployez l’archive de l’application LinShare dans le serveur Tomcat :

[root@localhost ~]$ cp linshare.war /var/lib/tomcat8/webapps/
[root@localhost ~]$ mkdir -p /var/lib/linshare
[root@localhost ~]$ chown -R tomcat8:tomcat8 /var/lib/linshare

Serveur web

L’interface d’administration de LinShare est une application s’appuyant sur les langages web HTML/CSS et JavaScript. Elle nécessite un simple serveur web de type Apache ou nginx.

Ce guide présente l’installation de Apache HTTP Server.

Installation de Apache 2

Installez Apache 2 depuis les dépôts :

`[root@localhost ~]$ aptitude install apache2

Configuration du vhost

ui-user

Deployer l'archive de LinShare application UI User dans le repertoire approprié d'Appache 2 :

[root@localhost ~]$ cd /var/www/
[root@localhost ~]$ tar xjf /tmp/linshare_data/linshare-ui-user-<VERSION>.tar.bz2
[root@localhost ~]$ mv linshare-ui-user-<VERSION> /var/www/linshare-ui-user

Pour déployer l’application LinShare, il est nécessaire d’activer le module mod_proxy sur Apache 2. De plus, il faut ajouter la configuration ci-après au fichier fourni par défaut par Debian :

[root@localhost ~]$ cd /etc/apache2/sites-available
[root@localhost ~]$ cp default linshare-user.conf
[root@localhost ~]$ a2dissite default
[root@localhost ~]$ a2enmod ssl
[root@localhost ~]$ a2enmod headers
[root@localhost ~]$ a2ensite linshare-user.conf
[root@localhost ~]$ a2enmod proxy proxy_http
[root@localhost ~]$ vim linshare-user.conf

<VirtualHost *:80>
...
ServerName linshare-user.local
DocumentRoot /var/www/linshare-ui-user
<Location /linshare>
    ProxyPass http://127.0.0.1:8080/linshare
    ProxyPassReverse http://127.0.0.1:8080/linshare
    ProxyPassReverseCookiePath /linshare /

    # Workaround to remove httpOnly flag (could also be done with tomcat)
    Header edit Set-Cookie "(JSESSIONID=.*); Path.*" "$1; Path=/"
    # For https, you should add Secure flag.
    # Header edit Set-Cookie "(JSESSIONID=.*); Path.*" "$1; Path=/; Secure"

    #This header is added to avoid the  JSON cache issue on IE.
    Header set Cache-Control "max-age=0,no-cache,no-store"
</Location>

ErrorLog /var/log/apache2/linshare-user-error.log
CustomLog /var/log/apache2/linshare-user-access.log combined
...
</Virtualhost>

Note:

  • Après toute modification d'un vhost, il faut recharger le server Apache 2 :
    [root@localhost ~]$ service apache2 reload
  • Dans les versions récentes de Apache, le fichier default peut se nommer default.conf.
  • Dans le cas où créez un document root, vous pourrez y créer un sous repertoire custom,
    dans lequel vous pourrez déployer votre logo :
    [root@localhost ~]$ mkdir -p linshare/custom

ui-admin

Déployez l’archive de l’application LinShare UI Admin dans le répertoire du serveur Apache 2 :

[root@localhost ~]$ cd /var/www/
[root@localhost ~]$ tar xjf linshare-ui-admin-{VERSION}.tar.bz2
[root@localhost ~]$ mv linshare-ui-admin-{VERSION} /var/www/linshare-ui-admin

Pour déployer l’interface d’administration de LinShare, il est nécessaire d’activer le module mod_proxy sur Apache2. De plus, il faut ajouter la configuration ci-après au fichier fourni par défaut par Debian :

[root@localhost ~]$ cd /etc/apache2/sites-available
[root@localhost ~]$ cp default linshare-admin.conf
[root@localhost ~]$ a2dissite default
[root@localhost ~]$ a2enmod ssl
[root@localhost ~]$ a2enmod headers
[root@localhost ~]$ a2ensite linshare-admin.conf
[root@localhost ~]$ a2enmod proxy proxy_http headers
[root@localhost ~]$ vim linshare-admin.conf
<VirtualHost *:80>
...
ServerName linshare-admin.local
DocumentRoot /var/www/linshare-ui-admin
<Location /linshare>
    ProxyPass http://127.0.0.1:8080/linshare
    ProxyPassReverse http://127.0.0.1:8080/linshare
    ProxyPassReverseCookiePath /linshare /

    # Workaround to remove httpOnly flag (could also be done with tomcat)
    Header edit Set-Cookie "(JSESSIONID=.*); Path.*" "$1; Path=/"
    # For https, you should add Secure flag.
    # Header edit Set-Cookie "(JSESSIONID=.*); Path.*" "$1; Path=/; Secure"

    #Cette entête est rajoutée pour éviter à IE de faire du cache sur le JSON
    Header set Cache-Control "max-age=0,no-cache,no-store"
</Location>

ErrorLog /var/log/apache2/linshare-admin-error.log
CustomLog /var/log/apache2/linshare-admin-access.log combined
...
</Virtualhost>

Note:

  • Après toute modification d'un vhost. il faut recharger le server Apache 2 :
    [root@localhost ~]$ service apache2 reload
  • Dans les version récentes de Apache, le fichier default peut se nommer default.conf.

Configuration & Lancement de LinShare

Configurez l’emplacement de stockage des fichiers :

[root@localhost ~]$ vim /etc/linshare/linshare.properties
linshare.encipherment.tmp.dir=/var/lib/linshare/tmp
linshare.signature.tmp.dir=/var/lib/linshare/tmp/linSignDocuments
linshare.files.directory=/var/lib/linshare/repository

Configurez l’accès à un service SMTP, pour l’envoi des messages de notification :

mail.smtp.host=<smtp.yourdomain.com>
mail.smtp.port=25
mail.smtp.user=linshare
mail.smtp.password=<SMTP-PASSWORD>
mail.smtp.auth.needed=false
mail.smtp.charset=UTF-8

Sur LinShare, vous avez deux modes d'authentification possibles, le permier est celui par défaut et le second est une authification par sso. Pour démarrer LinShare vous devez au moins activer l'un des modes suivants :

  • default : processus d'authentification par défaut.
  • sso : permet l'injection d'entête pour le SSO. Ce profil inclue les ... du profil par défaut.

Le profil par défaut est jcloud pour le filesystem pour les tests.

Vous pouvez surcharger ces paramètres en utilisant -Dspring.profiles.active=xxx Ou vous pouvez utiliser une variable d'environnement : SPRING_PROFILES_ACTIVE

Vous devez aussi activer au moins un des profiles de système de sockage de fichiers en dessous :

Available file data store profiles :

  • jcloud : Utilisant jcloud comme système de stockage de fichier : Amazon S3, Swift, Ceph, filesystem (que pour les tests).

  • gridfs : Using gridfs (mongodb) comme système de stockage de fichier.

  • jackrabbit2 : Using jackrabbit comme système de stockage de fichier.

  • jackrabbit-to-jcloud : Utilisant Jcloud comme nouveau système de stockage de fichier, jackrabbit comme fallback file data store.

  • jackrabbit-to-gridfs : Utilisant GridFS comme nouveau système de stockage de fichier, jackrabbit comme fallback file data store.

Le profil recommandé est jcloud avec swift.

Note:
- Nous utilisons uniquement JackRabbit pour la transition, car il est obsolète.

Pour démarrer LinShare, démarrez le service Tomcat :

[root@localhost ~]$ service tomcat8 restart

Afin de vérifier le fonctionnement de LinShare, consultez les fichiers des journaux (logs) :

[root@localhost ~]$ tail -f /var/log/tomcat8/catalina.out

En fin d’un démarrage correct du service, vous devriez avoir les messages suivants :

org.apache.coyote.http11.Http11Protocol start
INFO: Démarrage de Coyote HTTP/1.1 sur http-8080
org.apache.catalina.startup.Catalina start
INFO: Server startup in 23151 ms

Puis redémarrez le service Apache 2 :

[root@localhost ~]$ service apache2 restart

Note:
Vous disposez d'exemples de vhosts dans le repertoire : utils/apache2/vhosts-sample/ Vous disposez d'exemples de configuration suplémentaire dans le repertoire (En anglais uniquement): configuration

Premier accès

Le service LinShare est désormais accessible aux adresses suivantes.

Pour l’interface utilisateur :

Note:
Vous devez renseignez cette url dans les paramètres de votre domaine.
Pour ce faire, choisissez la fonctionalité Domaine dans la liste de vos fonctionalités
et renseignez la champs Url de base pour les notifications dans la sous fonctionalité URL de base pour les notifications par courriel.

Pour l’interface d’administration :

Paramétrage de LinShare

Connectez vous à LinShare en tant qu’administrateur système de LinShare :

Ensuite, afin d’interconnecter LinShare avec votre référentiel utilisateurs de type LDAP, créez un nouveau domaine depuis la rubrique « DOMAINES ». Pour plus d’informations, veuillez vous référer au Guide de configuration et d’administration de LinShare [LINSHARE:CONF].

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.