h1. LibreOfficeOnline

h2. Objectifs

Si Etherpad et Ethercalc peuvent suffire à des besoins ponctuels, ils se montrent parfois insuffisant pour des groupes un groupe de travail plus important et manquent de fonctionnalités.
important. Les services de Google (Drive, ...) sont souvent utilisé à leur place, dans ce cas, mais si l'on veux s'en défaire, la solution de LibreOffice Online est une alternative commence à devenir viable.

Ce document explique comment installer sur une VM une instance de NextCloud et LibreOffice Online à destination d'un petit groupe. groupe de travail.

h2. Principe

Ce projet https://github.com/smehrbrodt/nextcloud-libreoffice-online a servi de modèle.

Les choix sont les suivants:

* VM sous Debian 9. 1.5Go de RAM, 8Go de disque minimum
* Instance nexcloud pour servir de cadre
* Base de donnée sqlite
* Dans un 1er temps pas de HTTPS *(à revoir)*
* IPv6 activé
* Utilisation de docker & de docker-compose

h2. Étapes préparatoires

Les étapes suivantes se feront en tant que root:

* Après avoir créé la VM, mettre à jour: jour celle-ci

<pre>
# apt-get update; apt-get dist-upgrade
</pre>

* Installer docker-ce et docker-compose: docker-compose

<pre>
# apt-get install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
# curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
# add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
# apt-get update
# apt-get install docker-ce docker-ce-cli containerd.io docker-compose
</pre>

* Configurer docker pour activer l'IPv6

Dans @/etc/docker/daemon.json@ : (bien sur remplacer les xxxx par votre préfixe IPv6)

<pre><code class="json">
{
"ipv6": true,
"fixed-cidr-v6": "2a03:xxxx:xxxx:xxxx::1/64"
}
</code></pre>

Puis relancer le service docker :

<pre>
# systemctl reload docker
</pre>

* Ajouter l'utilisateur par défaut "debian" dans le groupe docker :

<pre>
# adduser debian docker
</pre>

h2. Instanciation des docks dockers

Les étapes suivantes se feront en tant qu'utilisateur , ici @debian@. Il faut que cet utilisateur appartienne au groupe @docker@.

* Créer le ficher @.env@ suivant dans @/home/debian@ :

<pre>
NEXTCLOUD_DOMAIN=<fqdn du domaine de la VM>
LO_ONLINE_USERNAME=admin
LO_ONLINE_PASSWORD=<mot de passe admin>
LO_ONLINE_EXTRA_PARAMS=--o:ssl.enable=false
</pre>

* Créer le ficher @docker-compose.yml@ suivant dans @/home/debian@ :

<pre><code class="yaml">
version: '2'

services:
app:
image: nextcloud
ports:
- 80:80
volumes:
- nextcloud:/var/www/html
restart:
always
online:
image: libreoffice/online:master
environment:
domain: ${NEXTCLOUD_DOMAIN}
username: ${LO_ONLINE_USERNAME}
password: ${LO_ONLINE_PASSWORD}
extra_params: ${LO_ONLINE_EXTRA_PARAMS}
DONT_GEN_SSL_CERT: 1
volumes:
- config-volume:/etc/loolwsd
cap_add:
- MKNOD
ports:
- "9980:9980"
restart:
unless-stopped
volumes:
config-volume:
nextcloud:
</code></pre>

* Lancer l'assemblage:

<pre>
~$ docker-compose up -b
</pre>

Le lancement initial est assez long. Il est possible de vérifier le déroulement des opérations avec @docker-compose logs@ .



Si tout se passe bien, l'instance nextcloud est disponible sur http://<fqdn> .
Le 1er login requiert le choix du compte administrateur et de la base de donnée (ici sqlite).

* Une fois loggué en administrateur (et près une phase d'administration basique : passage en Français, ...) , il faut installer le connecteur collabora et les Group group Folders :

<pre>
Menu de droite -> Applications -> Bureautique et Texte -> Collabora Online .
Menu de droite -> Applications -> Fichers -> Group Folders .
</pre>

* Toujours en tant qu'administrateur, il faut associer le connecteur collabora avec l'instance LibreOfficeOnline :

<pre>
Menu de droite -> Paramètres -> Collabora en Ligne
</pre>

Puis dans le champ @URL (et port) su serveur Collabora Online@ , inscrire @http://<fqdn>:9980 , et appliquer.

Désormais il est possible de créer (ou importer) dans Nextcloud un fichier .odt, et l'ouvrir en ligne.

L'URL http://<fqdn>:9980/loleaflet/dist/admin/admin.html permet d'obtenir quelques statistiques sur l'instance LibreOfficeOnline.

Néanmoins il est souhaitable de bloquer l'accès à ce port depuis internet à l'aide d'une règle de firewall.