So installieren Sie XWiki 9.11.x unter Ubuntu 16.04 LTS

• Voraussetzungen
• Richten Sie das XWiki LTS APT-Repo ein
• Installieren Sie das All-in-One-XWiki-Bundle (einschließlich XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 und mehr).
• Initialisieren Sie XWiki über die Weboberfläche des "Verteilungsassistenten"
• (Optional) Kürzen Sie die URL der XWiki-Site
• (Optional) Richten Sie einen Nginx-Reverse-Proxy ein

XWiki ist eine beliebte Open-Source-Wiki-Plattform auf Unternehmensebene, die in Java geschrieben wurde. Aufgrund seiner Erweiterbarkeit und Benutzerfreundlichkeit wird XWiki in verschiedenen Unternehmen als Wissensrepository, öffentliches Portal und mehr bereitgestellt.

In diesem Artikel werde ich Sie durch den Prozess der Installation von XWiki 9.11.2 auf einer Ubuntu 16.04 LTS-Serverinstanz führen. OpenJDK 8, Tomcat 8 und MySQL 5.7 werden während des Installationsvorgangs automatisch als Abhängigkeiten installiert.

Voraussetzungen

• Eine neue Vultr Ubuntu 16.04 LTS x64-Serverinstanz mit mindestens 2 GB Speicher, 4 GB oder mehr wird empfohlen. Angenommen, die IP-Adresse lautet 203.0.113.1.
• Ein Sudo-Benutzer .
• Die Serverinstanz wurde mit auf den neuesten stabilen Status aktualisiert apt.

Richten Sie das XWiki LTS APT-Repo ein

Melden Sie sich als Sudo-Benutzer an und laden Sie das XWiki LTS-APT-Repo (Long Term Support) auf Ihre Serverinstanz herunter und richten Sie es ein:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/lts/xwiki-lts.list" -P /etc/apt/sources.list.d/
sudo apt update

Hinweis: Wenn Sie die neueste stabile XWiki-Version (aber NICHT LTS) ausprobieren möchten , können Sie stattdessen das folgende XWiki APT-Repo herunterladen:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo apt update

Installieren Sie das All-in-One-XWiki-Bundle (einschließlich XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 und mehr).

Bei der Bereitstellung in der Produktion muss XWiki mit einem Java-Servlet-Container und einer Datenbanksoftware arbeiten. Als flexible Wiki-Plattform bietet XWiki offiziell verschiedene Integrationsoptionen. Mit dem folgenden Befehl können Sie alle verfügbaren Optionen im XWiki LTS APT-Repo anzeigen:

apt search xwiki

Das Suchergebnis sieht folgendermaßen aus:

xwiki-common/lts 9.11.2 all
xwiki-mysql-common/lts 9.11.2 all
xwiki-pgsql-common/lts 9.11.2 all
xwiki-solr-data/lts 9.11.2 all
xwiki-tomcat7-common/lts 9.11.2 all
xwiki-tomcat7-mysql/lts 9.11.2 all
xwiki-tomcat7-pgsql/lts 9.11.2 all
xwiki-tomcat8-common/lts 9.11.2 all
xwiki-tomcat8-mysql/lts 9.11.2 all
xwiki-tomcat8-pgsql/lts 9.11.2 all

Wenn Sie XWiki mit den häufigsten Abhängigkeiten verwenden möchten, können Sie alle erforderlichen Komponenten wie folgt in einem Befehl installieren:

sudo apt install xwiki-tomcat8-mysql/lts -y

Während des Installationsvorgangs werden Sie mehrmals aufgefordert, ein neues Kennwort für den MySQL-Root-Benutzer einzurichten. Lassen Sie einfach das Passwortfeld leer und drücken Sie Enter, um diesen Schritt vorerst zu überspringen. Wir werden dieses Problem später angehen, während wir die Installation von MySQL sicherstellen.

Wenn Sie gefragt werden, ob Sie möchten Configure database for xwiki with dbconfig-common?, wählen Sie <Yes>und drücken Sie dann ENTER.

Wenn Sie aufgefordert werden, ein MySQL application password for xwikiKennwort anzugeben, können Sie entweder ein bestimmtes MySQL-Anwendungskennwort eingeben oder das Kennwortfeld leer lassen. Letzteres weist XWiki an, ein zufälliges MySQL-Anwendungskennwort zu verwenden.

Wenn XWiki und alle erforderlichen Abhängigkeiten installiert sind, sichern Sie die Installation von MySQL:

sudo /usr/bin/mysql_secure_installation

Während des Vorgangs stellt Ihnen das Programm einige Fragen. Antworte ihnen wie folgt:

• Möchten Sie das VALIDATE PASSWORD Plugin einrichten? Y
• Bitte geben Sie 0 = NIEDRIG, 1 = MITTEL und 2 = STARK ein: 2
• Neues Kennwort: a-strong-MySQL-root-password
• Neues Passwort erneut eingeben: a-strong-MySQL-root-password
• Möchten Sie mit dem angegebenen Passwort fortfahren? Y
• Anonyme Benutzer entfernen? Y
• Remote-Login aus der Ferne nicht zulassen? Y
• Testdatenbank entfernen und darauf zugreifen? Y
• Berechtigungstabellen jetzt neu laden? Y

Erhöhen Sie die Sicherheit von XWiki, indem Sie die XWiki-Konfigurationsdatei ändern.

Verwenden Sie den vi-Editor, um eine XWiki-Konfigurationsdatei zu öffnen:

sudo vi /etc/xwiki/xwiki.cfg

Suchen Sie die beiden folgenden Zeilen:

xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

Ersetzen Sie die Werte beider Parameter durch zwei verschiedene zufällige Zeichenfolgen und stellen Sie sicher, dass die Länge jeder Zeichenfolge mit der der anderen übereinstimmt. Beispiel:

xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4

Speichern und Beenden:

:wq!

Das Standardspeicherkontingent ist zu niedrig, um Tomcat 8 und XWiki darin auszuführen. Sie müssen das Standardspeicherkontingent wie folgt erhöhen, bevor Sie eine XWiki-Instanz in Tomcat 8 ordnungsgemäß starten können.

sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8

Finden Sie die Linie:

JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"

Ändern Sie die Zeile wie unten gezeigt:

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"

Hinweis: 1024 MB Speicher sind nur das Mindestkontingent für die Ausführung einer kleinen oder mittleren XWiki-Site. Möglicherweise müssen Sie diese Linie entsprechend Ihren spezifischen Anforderungen anpassen.

Speichern und Beenden:

:wq!

Starten Sie Tomcat 8 neu, um alle Änderungen zu übernehmen:

sudo systemctl restart tomcat8.service

Ändern Sie die UFW-Firewall-Regeln, um den Webzugriff auf den Port zu ermöglichen 8080:

sudo ufw allow 8080
sudo ufw enable

Initialisieren Sie XWiki auf der Distribution WizardWeboberfläche

Zu diesem Zeitpunkt haben Sie eine funktionierende, aber leere XWiki-Site eingerichtet. Um Inhalte auszufüllen, müssen Sie mehrere Folgeaufgaben ausführen, einschließlich des Erstellens eines Administratorbenutzers und der Installation einer Version und der erforderlichen Erweiterungen für dieses Wiki auf der anfänglichen XWiki-Weboberfläche mit dem Namen " Distribution Wizard".

Zeigen Sie mit Ihrem bevorzugten Webbrowser auf http://203.0.113.1:8080/xwiki, und Sie werden automatisch auf die " Distribution Wizard" Weboberfläche weitergeleitet. Klicken Sie auf die ContinueSchaltfläche " ", um den Assistenten zu starten.

Auf der Step 1 - Admin userSeite " " müssen Sie die Anmeldeinformationen des Administrators eingeben, zum Beispiel:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `[email protected]`

Nachdem Sie alle erforderlichen Felder ausgefüllt haben, klicken Sie auf die Register and loginSchaltfläche " ", um fortzufahren.

Auf der nächsten Seite , die zeigt , „ You are connected with user John Doe.“, klicken Sie auf „ Continue“ , um den Admin - Benutzer zu erstellen , John Doedessen Benutzername ist johndoeund weitermachen.

Auf dem „ Step 2 - Flavor“ -Seite, klicken Sie auf „ XWiki Standard Flavor 9.11.2“ Bereich Geschmack zu markieren, und dann auf den „ Install this flavor“ -Taste auf bewegen.

XWiki Standard Flavor 9.11.2Klicken Sie auf der nächsten Seite mit den Details zu " " auf die InstallSchaltfläche " ", um die Installation durchzuführen.

Nachdem Sie die Version installiert haben, werden alle erforderlichen Erweiterungen auf der Seite aufgelistet. Klicken Sie auf die ContinueSchaltfläche " ", um alle zu installieren.

Wenn Sie den Geschmack und alle erforderlichen Erweiterungen installiert haben, klicken Sie auf die ContinueSchaltfläche " " in der unteren rechten Ecke, um fortzufahren.

Auf der Step 4 - ReportSeite " " können Sie alle erstellten Seiten überprüfen.

Bei Bedarf können Sie unbeliebte Seiten löschen, indem Sie auf die entsprechende rote XSchaltfläche klicken .

Klicken Sie abschließend auf die ContinueSchaltfläche " ", um das " Distribution Wizard" zu beenden . Sie werden als der zuvor eingerichtete Administrator in das XWiki-Dashboard aufgenommen.

(Optional) Kürzen Sie die URL der XWiki-Site

Da Tomcat mehr als eine Anwendung gleichzeitig bereitstellen kann, müssen Sie standardmäßig unter der URL auf Ihre XWiki-Site zugreifen http://203.0.113.1:8080/xwiki. Wenn XWiki jedoch die einzige in Tomcat ausgeführte Anwendung ist und Sie die URL der XWiki-Site durch Entfernen des /xwikiSuffixes verkürzen möchten , sollten Sie drei XWiki-Konfigurationsdateien wie folgt ändern.

Dateimodifikation 1:

cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak

Dateimodifikation 2:

cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml

Finden Sie die Linie:

<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Ändern Sie den Wert des Pfadparameters:

<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

Speichern und Beenden:

:wq!

Dateimodifikation 3:

cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg

Finden Sie die Linie:

# xwiki.webapppath=

Kommentieren Sie es aus:

xwiki.webapppath=

Speichern und Beenden:

:wq!

Starten Sie schließlich Tomcat 8 neu, um alle Ihre Änderungen zu übernehmen:

sudo systemctl restart tomcat8.service

Von nun an besuchen Sie Ihre XWiki-Site http://203.0.113.1:8080/direkt von.

(Optional) Richten Sie einen Nginx-Reverse-Proxy ein

Standardmäßig funktioniert Tomcat 8 am Port 8080, und Sie können Ihre XWiki-Site nur über denselben Port besuchen. Wenn Sie den Besuchern den Zugriff erleichtern möchten, indem Sie den Portnummer-Teil entfernen, können Sie Nginx als Reverse-Proxy zwischen XWiki und Besuchern installieren.

Installieren Sie zuerst Nginx mit apt:

sudo apt install nginx -y

Richten Sie Nginx als Reverse-Proxy ein, indem Sie die Standard-Site-Konfigurationen ändern:

cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default

Füllen Sie die Datei wie folgt aus:

server {
listen 0.0.0.0:80;

proxy_request_buffering off;
proxy_buffering off;

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_redirect     off;
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Host $server_name;
}
}

Speichern und Beenden:

:wq!

Starten Sie den Nginx-Dienst und stellen Sie ihn so ein, dass er beim Systemstart automatisch gestartet wird:

sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

Ändern Sie abschließend die UFW-Firewall-Regeln entsprechend:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Von nun an müssen Besucher Ihrer XWiki-Site die Portnummer nicht mehr angeben. Sie sollten direkt besuchen http://203.0.113.1/.