XWiki installieren
Allgemein
XWiki ist eine Wiki Anwendung mit vielen Plugins, die sich als Alternative zu Confluence und MediaWiki sieht. Man kann damit sogar einen Blog mit Kommentaren einrichten.
Siehe auch die Demo auf https://playground.xwiki.org/xwiki
XWiki ist in Java geschrieben, und kann mit Apache Tomcat bei Hostsharing betrieben werden.
Installation mit Ansible Skript
Die gesamte Installation kann mit Hilfe eines Ansible Skriptes durchgeführt werden, siehe https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/xwiki Dort ist auch eine README Datei, die die Benutzung von Ansible erklärt.
Im folgenden werden die Schritte erklärt, die das Ansible Skript durchführt.
Vorbereitungen für Installation
Benutzer und Postgresql Datenbank einrichten
In HSAdmin müssen folgende Dinge eingerichtet werden:
- der Benutzer xyz00-xwiki
- der PostgreSQL Benutzer xyz00_xwiki
- die PostgreSQL Datenbank xyz00_xwiki
Tomcat installieren
Dazu gibt es eine eigene Anleitung, siehe Tomcat Installieren.
Bitte auch den Hinweis beachten, dass dazu ein eigener Serverdienst laufen muss, der im Shared Hosting eine kostenpflichtige Option ist.
Installation von XWiki
Man kann verschiedene Versionen von XWiki wählen: LTS oder Stable, siehe https://www.xwiki.org/xwiki/bin/view/Download/
Wenn man z.B. LTS wählt, kommt man momentan auf https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=14.10.12
Dort sollte unter "Production Installation" das "WAR Package for Servlet Container" heruntergeladen werden.
Es muss ein Verzeichnis webapps/xwiki im Benutzer xyz00-xwiki angelegt werden, und dort muss die heruntergeladene .war Datei extrahiert werden, mit unzip:
xwiki_lts_version=14.10.12
wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/${xwiki_lts_version}/xwiki-platform-distribution-war-${xwiki_lts_version}.war
mkdir -p ~/webapps/xwiki
cd ~/webapps/xwiki
unzip ~/xwiki-platform-distribution-war-$xwiki_lts_version.war
Es muss ein Datenverzeichnis angelegt werden, dass ausserhalb des app Verzeichnisses liegt:
mkdir ~/data
Dieses Verzeichnis muss in die Datei ~/webapps/xwiki/WEB-INF/xwiki.properties eingetragen werden:
environment.permanentDirectory = /home/pacs/xyz00/users/xwiki/data
Ausserdem muss noch der JDBC Treiber für PostgreSQL von https://jdbc.postgresql.org/download.html an die richtige Stelle heruntergeladen werden:
postgresql_jdbc_version=42.6.0
wget -O ~/xwiki/WEB-INF/lib/postgresql-${postgresql_jdbc_version}.jar https://jdbc.postgresql.org/download/postgresql-${postgresql_jdbc_version}.jar
In der Datei ~/webapps/xwiki/WEB-INF/hibernate.cfg.xml muss der Block für die Default Datenbank hsqldb auskommentiert werden, und der Block für PostgreSQL aktiviert werden.
Ausserdem müssen die entsprechenden Zeilen angepasst werden:
<property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/xyz00_xwiki</property>
<property name="hibernate.connection.username">xyz00_xwiki</property>
<property name="hibernate.connection.password">MeinDBPasswortTopSecret</property>
Wenn dann noch Monit etc eingerichtet ist, wie auf Tomcat Installieren beschrieben, dann sollte der XWiki unter der URL https://xwiki.example.org/xwiki erreichbar sein.
Es gibt dann zum Anfang einen Assistenten, mit dem man den Administratorzugang einrichtet.