XWiki 9.11.x installeren op Ubuntu 16.04 LTS

• Vereisten
• Stel de XWiki LTS APT-repo in
• Installeer de alles-in-één XWiki-bundel (inclusief XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 en meer.)
• Initialiseer XWiki op de "Distribution Wizard" webinterface
• (Optioneel) Kort de URL van de XWiki-site in
• (Optioneel) Stel een Nginx reverse proxy in

XWiki is een populair open source wiki-platform op ondernemingsniveau, geschreven in Java. Met uitbreidbaarheid en gebruiksgemak wordt XWiki in verschillende bedrijven ingezet als kennisopslagplaats, openbaar portaal en meer.

In dit artikel zal ik je begeleiden bij het installeren van XWiki 9.11.2 op een Ubuntu 16.04 LTS-serverinstantie. OpenJDK 8, Tomcat 8 en MySQL 5.7 worden automatisch geïnstalleerd als afhankelijkheden tijdens het installatieproces.

Vereisten

• Een nieuwe Vultr Ubuntu 16.04 LTS x64-serverinstantie met minimaal 2 GB geheugen, 4 GB of meer aanbevolen. Stel dat het IP-adres is 203.0.113.1.
• Een sudo-gebruiker .
• De serverinstantie is bijgewerkt naar de laatste stabiele status met apt.

Stel de XWiki LTS APT-repo in

Meld u aan als sudo-gebruiker en download en installeer de XWiki LTS (Long Term Support) APT-repo op uw serverinstantie:

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

Opmerking: als je de nieuwste stabiele XWiki-release (maar NIET LTS) wilt uitproberen , kun je in plaats daarvan de onderstaande XWiki APT-repo downloaden:

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

Installeer de alles-in-één XWiki-bundel (inclusief XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 en meer.)

Wanneer het in productie wordt genomen, moet XWiki werken met een Java Servlet-container en databasesoftware. Als flexibel wiki-platform biedt XWiki officieel verschillende integratie-opties. U kunt de volgende opdracht gebruiken om alle beschikbare opties in de XWiki LTS APT-repo weer te geven:

apt search xwiki

Het zoekresultaat ziet er als volgt uit:

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

Als je XWiki met de meest voorkomende afhankelijkheden wilt gebruiken, kun je als volgt alle vereiste componenten in één commando installeren:

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

Tijdens het installatieproces wordt u meerdere keren gevraagd om een ​​nieuw wachtwoord in te stellen voor de MySQL-rootgebruiker. Laat het wachtwoordveld leeg en druk Enterop om deze stap voorlopig over te slaan. We zullen dit probleem later aanpakken terwijl we de installatie van MySQL beveiligen.

Als u wordt gevraagd of u dat wilt Configure database for xwiki with dbconfig-common?, kiest u <Yes>en drukt u vervolgens op ENTER.

Wanneer u wordt gevraagd om een ​​op te geven MySQL application password for xwiki, kunt u een specifiek MySQL-toepassingswachtwoord invoeren of het wachtwoordveld leeg laten. De laatste zal XWiki vertellen om een ​​willekeurig MySQL-toepassingswachtwoord te gebruiken.

Zorg dat XWiki en alle vereiste afhankelijkheden zijn geïnstalleerd en beveilig de installatie van MySQL:

sudo /usr/bin/mysql_secure_installation

Tijdens het proces stelt het programma u een paar vragen. Beantwoord ze zoals hieronder:

• Wilt u de VALIDATE PASSWORD-plug-in instellen? Y
• Voer 0 = LAAG, 1 = MIDDEL en 2 = STERK in: 2
• Nieuw paswoord: a-strong-MySQL-root-password
• Voer nieuw wachtwoord opnieuw in: a-strong-MySQL-root-password
• Wilt u doorgaan met het opgegeven wachtwoord? Y
• Anonieme gebruikers verwijderen? Y
• Root-login op afstand niet toestaan? Y
• Testdatabase verwijderen en er toegang toe hebben? Y
• Privilettabellen nu opnieuw laden? Y

Verbeter de beveiliging van XWiki door het XWiki-configuratiebestand te wijzigen.

Gebruik de vi-editor om een ​​XWiki-configuratiebestand te openen:

sudo vi /etc/xwiki/xwiki.cfg

Zoek de twee onderstaande lijnen:

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

Vervang de waarden van beide parameters door twee verschillende willekeurige tekenreeksen en zorg ervoor dat de lengte van elke tekenreeks hetzelfde is als de andere, bijvoorbeeld:

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

Opslaan en afsluiten:

:wq!

Het standaard geheugenquotum is te laag om Tomcat 8 en XWiki binnen uit te voeren. Je moet het standaard geheugenquotum als volgt verhogen voordat je een XWiki-instantie in Tomcat 8 goed kunt starten.

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

Zoek de regel:

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

Pas de lijn aan zoals hieronder weergegeven:

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

Opmerking: 1024 M geheugen is slechts het minimumquotum voor het uitvoeren van een kleine of middelgrote XWiki-site. Mogelijk moet u deze lijn aanpassen aan uw specifieke eisen.

Opslaan en afsluiten:

:wq!

Start Tomcat 8 opnieuw om al uw wijzigingen door te voeren:

sudo systemctl restart tomcat8.service

Wijzig de UFW-firewallregels om webtoegang op de poort toe te staan 8080:

sudo ufw allow 8080
sudo ufw enable

Initialiseer XWiki op de " Distribution Wizard" webinterface

Op dit punt heb je een functionele maar lege XWiki-site opgezet. Om inhoud in te vullen, moet je verschillende vervolgtaken voltooien, waaronder het aanmaken van een admin-gebruiker en het installeren van een smaak en vereiste extensies voor deze wiki, op de initiële XWiki-webinterface genaamd " Distribution Wizard".

Wijs uw favoriete webbrowser aan http://203.0.113.1:8080/xwikien u wordt automatisch naar de " Distribution Wizard" webinterface geleid . Klik op de Continueknop " " om de wizard te starten.

Op de " Step 1 - Admin user" pagina moet u de inloggegevens van de admin-gebruiker invoeren, bijvoorbeeld:

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

Nadat je alle verplichte velden hebt ingevuld, klik je op de Register and loginknop ' ' om verder te gaan.

Klik op de volgende pagina met " You are connected with user John Doe." op de Continueknop " " om de admin-gebruiker te maken John Doewiens gebruikersnaam is johndoeen ga verder.

Klik op de " Step 2 - Flavor" pagina op het " XWiki Standard Flavor 9.11.2" gebied om deze smaak te markeren en klik vervolgens op de " Install this flavor" knop om verder te gaan.

Op de volgende pagina met details over de " XWiki Standard Flavor 9.11.2" klikt u op de Installknop " " om de installatie uit te voeren.

Als de smaak is geïnstalleerd, worden alle vereiste extensies op de pagina vermeld, klik op de Continueknop " " om ze allemaal te installeren.

Met de smaak en alle vereiste extensies geïnstalleerd, klik je op de Continueknop " " in de rechterbenedenhoek om verder te gaan.

Op de " Step 4 - Report" pagina kunt u alle gemaakte pagina's bekijken.

Indien nodig kunt u alle impopulaire pagina's verwijderen door op de bijbehorende rode Xknop te klikken.

Klik ten slotte op de Continueknop " " om het " " te voltooien Distribution Wizard. Je wordt naar het XWiki-dashboard gebracht als de admin-gebruiker die je eerder had ingesteld.

(Optioneel) Kort de URL van de XWiki-site in

Omdat Tomcat standaard meer dan één applicatie tegelijk kan bedienen, moet je standaard toegang krijgen tot je XWiki-site via de URL http://203.0.113.1:8080/xwiki. Als XWiki echter de enige applicatie is die in Tomcat draait en je de URL van de XWiki-site wilt verkorten door het /xwikiachtervoegsel te verwijderen , moet je drie XWiki-configuratiebestanden als volgt wijzigen.

Bestandswijziging 1:

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

Bestandswijziging 2:

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

Zoek de regel:

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

Wijzig de waarde van de padparameter:

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

Opslaan en afsluiten:

:wq!

Bestandswijziging 3:

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

Zoek de regel:

# xwiki.webapppath=

Maak een commentaar:

xwiki.webapppath=

Opslaan en afsluiten:

:wq!

Start ten slotte Tomcat 8 opnieuw op om al uw wijzigingen toe te passen:

sudo systemctl restart tomcat8.service

Vanaf nu bezoekt u uw XWiki-site http://203.0.113.1:8080/rechtstreeks.

(Optioneel) Stel een Nginx reverse proxy in

Standaard werkt Tomcat 8 op de poort 8080en je kunt je XWiki-site alleen vanaf dezelfde poort bezoeken. Als je de toegang van bezoekers wilt vergemakkelijken door het poortnummer te verwijderen, kun je Nginx installeren als een reverse proxy tussen XWiki en bezoekers.

Installeer eerst Nginx met apt:

sudo apt install nginx -y

Stel vervolgens Nginx in als een reverse proxy door de standaard siteconfiguraties te wijzigen:

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

Vul het bestand in met het volgende:

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;
}
}

Opslaan en afsluiten:

:wq!

Start de Nginx-service en stel deze in om automatisch te starten bij het opstarten van het systeem:

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

Pas ten slotte de UFW-firewallregels dienovereenkomstig aan:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Vanaf nu hoeven bezoekers van uw XWiki-site niet langer het poortnummer op te geven. Ze moeten rechtstreeks bezoeken http://203.0.113.1/.