Setup:Installationsanleitung/Kompendium/Servereinrichtung für CollabPads

CollabPads ist ab BlueSpice 4.5 enthalten.

Die gleichzeitige Bearbeitung von Seiten durch mehrere Benutzer erfordert einige Servervorbereitungen. Hierfür ist es nötig, MongoDB zu installieren.

MongoDB installieren

Installieren Sie MongoDB gemäß der Anleitung für Ihre Linux-Distribution.

sudo systemctl start mongod
sudo systemctl enable mongod

php-mongodb installieren

Prüfen Sie den Pfad Ihrer PHP Version, bevor Sie folgende Check the path of your PHP version before you run:

sudo apt install php-devel
sudo pecl install mongodb

echo "extension=mongodb.so" >> /etc/php/8.2/cli/php.ini

CollabPadsBackendService installieren

cd /opt
wget https://buildservice.bluespice.com/webservices/4.5.x/CollabPadsBackend.tar.gz
tar xzf CollabPadsBackend.tar.gz
cd CollabPadsBackend
cp config.example.php config.php
vim config.php

Passen Sie die config.php an:

<?php

return [
	'server-id' => 'mediawiki-collabpads-backend',
	'ping-interval' => 25000,
	'ping-timeout' => 5000,
	'port' => 8099,                //The port you wish to use
	'request-ip' => '127.0.0.1',  //The ip you want to open your service  
	'baseurl' => 'https://yourwikiurl.com', 
	'db-type' => 'mongo',
	'db-host' => '127.0.0.1',   // your MongoDB-Host
	'db-port' => 27017,         // your MongoDB-Port
	'db-name' => 'collabpads',  // your MongoDB-DB-Name
	'db-user' => '',           // MongoDB-Username 
	'db-password' => '',       // MongoDB-Password
	'log-level' => 'INFO',
	'http-client-options' => []
];

sudo vim /etc/systemd/system/collabpad.service

collabpad.service:

[Unit]
Description = BlueSpice-CollabpadsBackend
[Service]
Type = simple
User = www-data
ExecStart =/usr/bin/php /opt/CollabpadsBackend/bin/server.php
StandardOutput = file:/var/log/apache2/collabpad.log
[Install]
WantedBy = default.target

sudo systemctl enable collabpad.service
sudo systemctl start collabpad.service

Apache konfigurieren

Fügen Sie folgende Zeilen zu Ihren rewrite Regeln hinzu:

RewriteCond %{REQUEST_URI}  ^/_collabpads          [NC]
RewriteCond %{QUERY_STRING} transport=websocket    [NC]
RewriteRule /(.*)           ws://127.0.0.1:8099/$1 [P,L]

Starten Sie apache2 neu:

systemctl restart apache2

Sie sollten nun den Bearbeitungsmodus Gemeinsam bearbeiten zur Auswahl haben.

Gemeinsam bearbeiten

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.

---

Feedback zur Dokumentation ist im Community-Forum möglich.