So installierst du XWiki unter Ubuntu 22.04

XWiki ist eine freie und quelloffene Wikisoftware, die in Java geschrieben wurde und auf Tomcat läuft. Sie hilft den Nutzern, effizienter zusammenzuarbeiten. Sie bietet viele nützliche Funktionen wie WYSIWYG-Bearbeitung, OpenOffice-basierten Dokumentenimport/-export, semantische Annotationen und Tagging sowie eine erweiterte Rechteverwaltung. Es nutzt eine Datenbank wie MySQL oder PostgreSQL, um seine Informationen zu speichern.

Diese Anleitung zeigt dir, wie du XWiki auf einem Ubuntu 22.04 Server installierst.

Voraussetzungen

  • Ein Server, auf dem Ubuntu 22.04 läuft.
  • Ein gültiger Domainname ist auf die IP deines Servers verweist.
  • Ein Root-Passwort ist auf dem Server eingerichtet.

Erste Schritte

Bevor du beginnst, aktualisiere alle Systempakete mit dem folgenden Befehl auf die neueste Version:

apt update -y
apt upgrade -y

Sobald alle Pakete aktualisiert sind, kannst du mit dem folgenden Befehl weitere erforderliche Abhängigkeiten installieren:

apt-get install wget curl unzip git name gnupg2 -y

Sobald du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

Java JDK installieren

XWiki ist eine Java-basierte Anwendung, daher musst du Java auf deinem Server installieren. Du kannst es mit dem folgenden Befehl installieren:

apt-get install default-jdk -y

Sobald Java installiert ist, kannst du die Java-Version mit dem folgenden Befehl überprüfen:

java --version

Du erhältst die folgende Ausgabe:

openjdk 11.0.17 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

XWiki-Repository hinzufügen

Standardmäßig ist das XWiki-Paket nicht im Standard-Repository von Ubuntu enthalten. Daher musst du das offizielle XWiki-Repository zu deinem Server hinzufügen.

Lade zunächst den GPG-Schlüssel herunter und füge ihn mit dem folgenden Befehl hinzu:

wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg

Als nächstes fügst du das XWiki-Repository mit dem folgenden Befehl zu APT hinzu:

wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list

Sobald das Repository zur APT hinzugefügt wurde, kannst du den Repository-Cache mit dem folgenden Befehl aktualisieren:

apt-get update -y

Als Nächstes suchst du mit folgendem Befehl nach dem XWiki-Paket:

apt-cache search xwiki

Du solltest alle XWiki-Pakete in der folgenden Ausgabe sehen:

xwiki-solr-all - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-core - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-data - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-events - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-extension_index - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-like - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-ratings - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis

XWiki auf Ubuntu 22.04 installieren

Wähle nun die neueste Version von XWiki und installiere sie mit dem folgenden Befehl:

apt-get install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y

Während der Installation wirst du aufgefordert, die Datenbank wie unten gezeigt zu konfigurieren:

Wähle Ja und drücke die Eingabetaste. Du wirst aufgefordert, ein MySQL-Passwort für XWiki festzulegen:

Lege dein Passwort fest und klicke auf OK, um die Installation abzuschließen.

Sobald das XWiki installiert ist, kannst du den Tomcat-Dienst mit dem folgenden Befehl überprüfen:

systemctl status tomcat9.service

Du erhältst die folgende Ausgabe:

? tomcat9.service - Apache Tomcat 9 Web Application Server
     Loaded: loaded (/lib/systemd/system/tomcat9.service; enabled; vendor preset: enabled)
    Drop-In: /etc/systemd/system/tomcat9.service.d
             ??xwiki-tomcat9-systemd.conf
     Active: active (running) since Mon 2022-11-28 16:49:48 UTC; 6s ago
       Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html
    Process: 27582 ExecStartPre=/usr/libexec/tomcat9/tomcat-update-policy.sh (code=exited, status=0/SUCCESS)
   Main PID: 27586 (java)
      Tasks: 20 (limit: 464122)
     Memory: 272.6M
     CGroup: /system.slice/tomcat9.service
             ??27586 /usr/lib/jvm/default-java/bin/java -Djava.util.logging.config.file=/var/lib/tomcat9/conf/logging.properties -Djava.util.>

Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: Loaded Apache Tomcat Native library [1.2.31] using APR version [1.7.0].
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR capabilities: IPv6 [true], sendfile [true], accept filters [false], random [true], UDS [true].
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR/OpenSSL configuration: useAprConnector [false], useOpenSSL [true]
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: OpenSSL successfully initialized [OpenSSL 3.0.2 15 Mar 2022]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Initializing ProtocolHandler ["http-nio-8080"]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Server initialization in [1204] milliseconds
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting service [Catalina]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting Servlet engine: [Apache Tomcat/9.0.58 (Ubuntu)]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Deploying deployment descriptor [/etc/tomcat9/Catalina/localhost/xwiki.xml]

Tomcat wird nicht ausgeführt und lauscht auf Port 8080. Du kannst ihn mit dem folgenden Befehl überprüfen:

ss -antpl | grep 8080

Du solltest die folgende Ausgabe sehen:

LISTEN 1      100                *:8080            *:*    users:(("java",pid=27586,fd=39)) 

Nginx als Reverse Proxy konfigurieren

Als Nächstes musst du Nginx als Reverse Proxy konfigurieren, damit du über Port 80 auf das XWiki zugreifen kannst. Installiere zunächst das Nginx-Paket mit dem folgenden Befehl:

apt-get install nginx -y

Nachdem du Nginx installiert hast, erstelle eine Nginx-Konfigurationsdatei:

nano /etc/nginx/conf.d/xwiki.conf

Füge die folgende Konfiguration hinzu:

server {
listen 80;

server_name xwiki.example.com;

access_log /var/log/nginx/xwiki-access.log;
error_log /var/log/nginx/xwiki-error.log;

location / {
proxy_set_header   X-Real-IP $remote_addr;
proxy_set_header   Host      $host;
proxy_http_version 1.1;
proxy_set_header   Upgrade $http_upgrade;
proxy_set_header   Connection 'upgrade';
proxy_cache_bypass $http_upgrade;
proxy_pass         http://127.0.0.1:8080;
}

}

Speichere und schließe die Datei und starte den Nginx-Dienst neu, um die Änderungen zu übernehmen:

systemctl restart nginx

Du kannst den Nginx-Status auch mit folgendem Befehl überprüfen:

systemctl status nginx

Du erhältst die folgende Ausgabe:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-11-28 16:51:25 UTC; 5s ago
       Docs: man:nginx(8)
    Process: 27892 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 27894 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 27895 (nginx)
      Tasks: 3 (limit: 464122)
     Memory: 3.4M
     CGroup: /system.slice/nginx.service
             ??27895 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"
             ??27896 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
             ??27897 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

Nov 28 16:51:25 ubuntu22041 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 28 16:51:25 ubuntu22041 systemd[1]: Started A high performance web server and a reverse proxy server.

An diesem Punkt ist XWiki mit Nginx als Reverse Proxy installiert. Du kannst nun mit dem nächsten Schritt fortfahren.

XWiki Web-Installation durchführen

Öffne nun deinen Webbrowser und rufe den XWiki-Webinstallationsassistenten über die URL http://xwiki.example.com/xwiki/bin/view/Main/ auf . Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche Weiter. Du solltest den Registrierungsbildschirm sehen:

Gib deinen Namen, deinen Admin-Benutzernamen, dein Passwort und deine E-Mail-Adresse ein und klicke auf die Schaltfläche Registrieren und anmelden. Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche “ Weiter“. Du solltest den Bildschirm zur Auswahl des Flavors sehen:

Wähle dein XWiki-Flavor aus und klicke auf die Schaltfläche Dieses Flavor installieren. Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche Installieren. Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche Weiter. Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche Fortfahren. Auf dem folgenden Bildschirm solltest du das XWiki-Dashboard sehen:

Fazit

Glückwunsch! Du hast XWiki mit Nginx erfolgreich auf dem Ubuntu 22.04 Server installiert. Du kannst jetzt deine eigene Wiki-Anwendung mit XWiki einrichten. Wenn du noch Fragen hast, kannst du dich gerne an mich wenden.

Das könnte dich auch interessieren …