In diesem Tutorial zeigen wir Ihnen, wie Sie XWiki auf Ihrem Ubuntu 20.04-Server installieren. Wir erklären, wofür XWiki steht und die Schritte zur Installation, Konfiguration und anderer zusätzlich erforderlicher Software.
XWiki ist eine in Java geschriebene Open-Source- und kostenlose Wiki-Plattform, mit der Sie Ihr Wiki mit einer sehr einfachen und benutzerfreundlichen Weboberfläche anpassen können. Es läuft auf Tomcat-, Jetty- oder JBoss-Servlet-Containern und verwendet MySQL/MariaDB oder PostgreSQL als Datenbank zum Speichern der Informationen.
In diesem Beitrag verwenden wir Tomcat als Servlet-Container und MariaDB als Datenbank. Die Installation von XWiki auf Ubuntu 20.04 sollte nicht länger als 15 Minuten dauern. Beginnen wir mit der Installation!
Voraussetzungen
- Neuinstallation von Ubuntu 20.04
- Benutzerberechtigungen:Root- oder Nicht-Root-Benutzer mit sudo-Berechtigungen
Schritt 1. Aktualisieren Sie das System
Wir müssen das System auf die neueste Version aktualisieren und sicherstellen, dass die Software auf dem neuesten Stand ist, da wir davon ausgehen, dass Sie eine Neuinstallation von Ubuntu 20.04
habenFühren Sie den folgenden einzeiligen Befehl aus und warten Sie einige Zeit, bis das System die neuesten Software-Updates erhält
sudo apt update -y && sudo apt upgrade -y
Schritt 2. Java installieren
Wir brauchen Java, um auf unserem System installiert zu sein, weil XWiki darin geschrieben ist. Java kann mit dem folgenden Befehl installiert werden:
apt-get install default-jdk gnupg2 -y
Sobald Java installiert ist, können Sie die Version mit dem folgenden Befehl überprüfen:
java --version
Die folgende Ausgabe sollte zurückgegeben werden.
root@vps:~# java --version openjdk 11.0.11 2021-04-20 OpenJDK Runtime Environment (build 11.0.11+9-Ubuntu-0ubuntu2.20.04) OpenJDK 64-Bit Server VM (build 11.0.11+9-Ubuntu-0ubuntu2.20.04, mixed mode, sharing)
Schritt 3. Öffentlicher Schlüssel und Repository von XWiki GPG
Der signierende GPG-Schlüssel kann mit dem folgenden Befehl hinzugefügt werden:
wget https://maven.xwiki.org/xwiki-keyring.gpg -P /usr/share/keyrings/
Ubuntu 20.04 enthält das XWiki-Repo nicht und deshalb ist dieser Schritt wichtig, um es hinzuzufügen.
wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Aktualisieren Sie das Repository mit dem folgenden Befehl:
sudo apt update -y
Schritt 4. Installieren Sie das XWiki zusammen mit Tomcat und MySQL
Vor der Installation von XWiki gibt es eine Option, um die verfügbaren XWiki-Pakete aufzulisten:
apt-cache search xwiki
In diesem Tutorial müssen wir xwiki-tomcat9-common und xwiki-tomcat9-mariadb mit dem folgenden Befehl installieren:
sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y
Während der Installation der erforderlichen Pakete werden Sie aufgefordert, das MySQL-Root-Passwort für Ihre XWiki-Installation einzugeben.
Klicken Sie im ersten Fenster auf Ja.
Geben Sie das MySQL-Root-Passwort ein und klicken Sie auf Ja.
Bestätigen Sie das MySQL-Root-Passwort und klicken Sie auf Ja.
Während der Installation empfiehlt es sich, das MySQL-Root-Passwort für die spätere Konfiguration in Ihren Notizen zu speichern.
Wenn die Pakete jetzt installiert sind, können wir überprüfen, ob die Tomcat- und MariaDB-Dienste aktiv sind.
Führen Sie den folgenden Befehl aus, um zu sehen, ob der Tomcat-Dienst ordnungsgemäß ausgeführt wird:
systemctl status tomcat9
Sie sollten die folgende Ausgabe sehen:
root@vps:/# systemctl status tomcat9
● 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 2021-10-11 23:32:55 UTC; 7min ago
Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html
Main PID: 91633 (java)
Tasks: 67 (limit: 4617)
Memory: 690.8M
CGroup: /system.slice/tomcat9.servic Um zu überprüfen, ob der MariaDB-Dienst aktiv ist, führen Sie den folgenden Befehl aus:
sudo systemctl status mariadb
Sie sollten die folgende Ausgabe sehen:
root@vps:/# sudo systemctl status mariadb
● mariadb.service - MariaDB 10.3.31 database server
Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2021-10-11 23:30:46 UTC; 10min ago
Docs: man:mysqld(8)
https://mariadb.com/kb/en/library/systemd/
Main PID: 90670 (mysqld)
Status: "Taking your SQL requests now..."
Tasks: 30 (limit: 4617)
Memory: 69.9M
CGroup: /system.slice/mariadb.service
└─90670 /usr/sbin/mysqld Schritt 5. Nginx als Webserver installieren
Wir brauchen einen Webserver, damit wir den Reverse-Proxy für den Zugriff auf die XWiki-Installation einrichten können.
Führen Sie den folgenden Befehl aus, um den Nginx-Webserver zu installieren:
sudo apt install nginx -y
Sobald Nginx installiert ist, starten Sie es mit dem folgenden Befehl:
sudo systemctl start nginx
Überprüfen Sie, ob der Dienst ausgeführt wird:
sudo systemctl status nginx
Sie sollten die folgende Ausgabe sehen:
root@vps:/# sudo systemctl status nginx
● 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 2021-10-11 23:44:40 UTC; 5s ago
Docs: man:nginx(8)
Process: 93791 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 93798 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 93799 (nginx)
Tasks: 5 (limit: 4617)
Memory: 5.0M
CGroup: /system.slice/nginx.service
Schritt 6. Erstellen Sie eine neue virtuelle Nginx-Hostdatei
Sobald der Nginx-Webserver installiert ist, erstellen Sie die virtuelle Hostdatei mit dem folgenden Befehl:
sudo nano /etc/nginx/conf.d/xwiki.conf
Fügen Sie die folgenden Zeilen ein:
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;
}
} Speichern und schließen Sie die Konfigurationsdatei.
Der nächste Schritt besteht darin, den hash_bucket-Größenwert in der Datei nginx.conf zu erhöhen:
sudo nano /etc/nginx/nginx.conf
Fügen Sie die folgende Zeile unter dem HTTP-Abschnitt wie gezeigt hinzu oder kommentieren Sie sie aus:
server_names_hash_bucket_size 64;
Speichern Sie die Konfigurationsdatei und starten Sie den Nginx-Dienst neu.
sudo systemctl restart nginx
Schritt 7. Greifen Sie auf die XWiki-Webschnittstelle zu
Öffnen Sie Ihren Browser und greifen Sie über die URL im Reverse-Proxy xwiki.example.com/xwiki auf die XWiki-Oberfläche zu
Klicken Sie auf die Schaltfläche „Weiter“, wo ein weiteres Fenster angezeigt wird, um den Vor- und Nachnamen, den Benutzernamen, das Passwort und die E-Mail-Adresse einzugeben Adresse.
Sobald alles ausgefüllt ist, klicken Sie auf die Schaltfläche „Registrieren und Anmelden“
Wählen Sie im nächsten Fenster ein Flavor Ihrer Wahl aus und installieren Sie es, indem Sie auf die Schaltfläche „Dieses Flavor installieren“ klicken.
Belassen Sie in den nächsten Schritten alles wie es ist und klicken Sie einfach auf die Schaltfläche „Weiter“, bis die Installation abgeschlossen ist.
Nach dem letzten Schritt sehen Sie das Willkommens-Dashboard von XWiki.
Das ist es! Sie haben die XWiki-Plattform erfolgreich auf Ubuntu 20.04 installiert. Natürlich müssen Sie es nicht installieren, wenn es Ihnen schwer fällt. Sie können einfach unsere erfahrenen Linux-VPS-Hosting-Administratoren bitten, XWiki auf Ubuntu 20.04 für Sie zu installieren. Sie sind rund um die Uhr erreichbar und kümmern sich umgehend um Ihr Anliegen.
Wenn Ihnen dieser Beitrag zur Installation von XWiki auf Ubuntu 20.04 gefallen hat, teilen Sie ihn bitte mit Ihren Freunden in den sozialen Netzwerken über die Schaltflächen auf der linken Seite oder hinterlassen Sie einfach unten eine Antwort. Danke.