Simultaneous editing of pages by multiple users requires some server preparation. For this, MongoDB and the CollabPadsBackendService must be installed.
Install MongoDB
Please install MongoDB according to the documentation your Linux distribution. It can then be started and configured for auto-start like this:
sudo systemctl start mongod sudo systemctl enable mongod
Install php-mongodb extension
The CollabPadsBackend service required a special PHP extension in order to be able to communicate with the MongoDB server. This extension is available through PECL. If you don't have PECL installed already, you can do this for example using:
sudo apt install php-devel sudo pecl install mongodb
Check the path of your PHP version to find the proper INI file. The extension can then be enabled e.g. via:
echo "extension=mongodb.so" >> /etc/php/8.2/cli/php.ini
Install CollabPadsBackendService
The CollabPadsBackendService is a pre-built PHP application that can be downloaded from buildservice.bluespice.com. You can download it like this:
cd /opt wget https://buildservice.bluespice.com/webservices/4.5.x/CollabPadsBackend.tar.gz tar xzf CollabPadsBackend.tar.gz
To configure the service one must first create a config.php file. An example file is included:
cd CollabPadsBackend cp config.example.php config.php vim config.php
Modify config.php to match your environment. Example:
<?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' => [] ];
Next you should create a proper servicedescriptor for running the application:
sudo vim /etc/systemd/system/collabpad.service
Example of 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
Start and configure the service for auto start like this:
sudo systemctl enable collabpad.service sudo systemctl start collabpad.service
Configure Apache
The new service must be reachable by the client. By default the wiki application will try to connect to it using the WebSocket protocol on the /_collabpads subpath relative to the wiki application base URL ($wgServer ).
In order to achieve this, you must add a proper URL rewrite rule. For the Apache Webserver it looks like this:
RewriteCond %{REQUEST_URI} ^/_collabpads [NC]
RewriteCond %{QUERY_STRING} transport=websocket [NC]
RewriteRule /(.*) ws://127.0.0.1:8099/$1 [P,L]
The webserver needs to be restarted to load the changes:
systemctl restart apache2
You should now be able to use the editing mode Edit together.
