Browse Source

(wip) HowtoCollaboraCode

master
Ludovic Poujol 1 year ago
parent
commit
6fe0c65d8b
1 changed files with 151 additions and 0 deletions
  1. +151
    -0
      HowtoCollaboraCode.md

+ 151
- 0
HowtoCollaboraCode.md View File

@@ -0,0 +1,151 @@
---
title: How to Collabora Code
---

Collabora Online Development Edition (CODE) est une suite bureautique utilisable dans son navigateur. Le logiciel est basé sur Libre Office Online (lool)

## Installation

Collabora propose des paquets via leur dépôt pour installer le logiciel :

~~~
# echo 'deb https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian10 ./' >> /etc/apt/sources.list.d/collabora-code.list
# apt-key adv --keyserver http://keyserver.ubuntu.com --recv-keys 0C54D189F4BA284D
# apt update

# apt install loolwsd code-brand collaboraofficebasis6.0-fr collaboraoffice6.0-dict-fr
~~~

Pour les versions de Debian antérieures à Debian 10, tout est expliqué sur [leur site](https://www.collaboraoffice.com/code/linux-packages/)


## Configuration

Fichiers de configuration :

~~~
/etc/loolwsd/
├── loolkitconfig.xcu
└── loolwsd.xml
~~~

Le fichier de configuration principal se trouve être `/etc/loolwsd/loolwsd.xml`. Juste après installation, le service loolwsd.service ne fonctionnera pas, car la configuration du service écoute en HTTPS par défaut, mais aucun certificat n'est présent.

Il est plus simple d'utiliser un serveur web comme [Nginx](HowtoNginx) en reverse proxy en amont pour faire la terminaison SSL avant de transférer le trafic à collabora-code localement, sans HTTPS.

Pour cela, il faut passer changer les paramètres suivants de la section `<ssl>` :

* `<enable>` : de *true* à **false**
* `<termination>` de *false* à **true**


~~~.xml

(...)
<ssl desc="SSL settings">
<enable type="bool" desc="Controls whether SSL encryption is enable (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">false</enable>
<termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">true</termination>

(...)
~~~



Côté Nginx, on utilisera le vhost proposé par les [développeurs de collabora code](https://www.collaboraoffice.com/code/nginx-reverse-proxy/) :

~~~
server {
listen 443 ssl;
server_name collabora.example.org;

ssl_certificate /etc/letsencrypt/live/collabora00.evolix.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/collabora00.evolix.org/privkey.pem;

root /var/www/collabora00.evolix.org;

access_log /var/log/nginx/access.collabora00.evolix.org.log;
error_log /var/log/nginx/error.collabora00.evolix.org.log;


# static files
location ^~ /loleaflet {
proxy_pass http://localhost:9980;
proxy_set_header Host $http_host;
}

# WOPI discovery URL
location ^~ /hosting/discovery {
proxy_pass http://localhost:9980;
proxy_set_header Host $http_host;
}

# Capabilities
location ^~ /hosting/capabilities {
proxy_pass http://localhost:9980;
proxy_set_header Host $http_host;
}

# main websocket
location ~ ^/lool/(.*)/ws$ {
proxy_pass http://localhost:9980;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $http_host;
proxy_read_timeout 36000s;
}

# download, presentation and image upload
location ~ ^/lool {
proxy_pass http://localhost:9980;
proxy_set_header Host $http_host;
}

# Admin Console websocket
location ^~ /lool/adminws {
proxy_pass http://localhost:9980;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $http_host;
proxy_read_timeout 36000s;
}
}
~~~


## Utilisation

#### Avec Nextcloud et le connecteur Collabora

Dans Nextcloud, il y a une application nommée ["Collabora Online"](https://apps.nextcloud.com/apps/richdocuments) permet de faire connecteur entre l'installation Nextcloud et le service Collabora Code fraîchement installé. Cela permettra de consulter et modifier des fichiers directement depuis l'interface de Nextcloud.

##### Configuration dans Nextcloud

##### Configuration dans Collabora Code

Dans le fichier de configuration `/etc/loolwsd/loolwsd.xml`, il faut autoriser l'adresse de l'instance Nextcloud à travailler avec Collabora.

Dans la sous-section `<wopi>` de la section `<storage>`, il faut rajouter un élément `<host></host>` qui contient une regex d'hôtes à autoriser

~~~.xml

(...)

<storage desc="Backend storage">
<wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true">
<host desc="Regex pattern of hostname to allow or deny." allow="true">nextcloud.example.net</host>
<host desc="Regex pattern of hostname to allow or deny." allow="true">sharedcloud[0-9]{4}.example.org</host>

(...)
~~~

## Monitoring

### Nagios

### Munin

## Plomberie

## FAQ



Loading…
Cancel
Save