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.