Cum se instalează XWiki 9.11.x pe Ubuntu 16.04 LTS

• Cerințe preliminare
• Configurați repetarea APT XWiki LTS
• Instalați totul într-un pachet XWiki (inclusiv XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 și altele).
• Inițializați XWiki pe interfața web „Expertul de distribuție”
• (Opțional) Scurtați adresa URL a site-ului XWiki
• (Opțional) Configurați un proxy invers Nginx

XWiki este o populară platformă wiki open source la nivel de întreprindere, scrisă în Java. Cu extensibilitate și ușurință de utilizare, XWiki este implementat în diverse companii ca depozit de cunoștințe, portal public și multe altele.

În acest articol, vă voi ghida în procesul de instalare a XWiki 9.11.2 pe o instanță a serverului Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 și MySQL 5.7 vor fi instalate automat ca dependențe în timpul procesului de instalare.

Cerințe preliminare

• O nouă instanță a serverului Vultr Ubuntu 16.04 LTS x64 cu cel puțin 2 GB memorie, 4 GB sau mai mult recomandate. Spuneți că adresa IP este 203.0.113.1.
• Un utilizator sudo .
• Instanța serverului a fost actualizată la cea mai recentă stare stabilă folosind apt.

Configurați repetarea APT XWiki LTS

Conectați-vă ca utilizator sudo, apoi descărcați și configurați repoțiția APT XWiki LTS (Asistență pe termen lung) pe instanța serverului:

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

Notă: Dacă doriți să încercați cea mai recentă versiune stabilă XWiki (dar NU LTS), puteți descărca repoțiția de mai jos a XWiki APT:

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

Instalați totul într-un pachet XWiki (inclusiv XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 și altele).

Când este implementat în producție, XWiki trebuie să lucreze cu un container Servlet Java și un software de bază de date. Ca platformă wiki flexibilă, XWiki oferă în mod oficial diverse opțiuni de integrare. Puteți utiliza următoarea comandă pentru a afișa toate opțiunile disponibile în repoziția APT XWiki LTS:

apt search xwiki

Rezultatul căutării va semăna cu următoarele:

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

Dacă doriți să utilizați XWiki cu cele mai comune dependențe, puteți instala toate componentele necesare într-o singură comandă, după cum urmează:

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

În timpul procesului de instalare, vi se va cere să configurați o nouă parolă pentru utilizatorul root MySQL de mai multe ori. Lasă câmpul de parolă necompletat și apasă Enterpentru a sări acest pas deocamdată. Vom rezolva această problemă mai târziu, în timp ce vom asigura instalarea MySQL.

Când vi se cere dacă doriți Configure database for xwiki with dbconfig-common?, alegeți <Yes>și apoi apăsați ENTER.

Când MySQL application password for xwikivi se cere să furnizați o , puteți introduce o parolă specifică pentru aplicația MySQL sau lăsa câmpul de parolă necompletat. Acesta din urmă va spune XWiki să folosească o parolă aleatorie pentru aplicația MySQL.

După instalarea XWiki și a tuturor dependențelor necesare, asigurați-vă instalarea MySQL:

sudo /usr/bin/mysql_secure_installation

În timpul procesului, programul vă va pune câteva întrebări. Răspundeți-le ca mai jos:

• Doriți să configurați pluginul VALIDATE PASSWORD? Y
• Vă rugăm să introduceți 0 = LOW, 1 = MEDIUM și 2 = STRONG: 2
• Parolă Nouă: a-strong-MySQL-root-password
• Reintroduceți parola nouă: a-strong-MySQL-root-password
• Doriți să continuați cu parola furnizată? Y
• Ștergeți utilizatorii anonimi? Y
• Înlăturați conectarea root la distanță? Y
• Ștergeți baza de date de testare și accesați-o? Y
• Reîncărcați tabelele de privilegii acum? Y

Îmbunătățiți securitatea XWiki modificând fișierul de configurare XWiki.

Utilizați editorul vi pentru a deschide un fișier de configurare XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Găsiți cele două rânduri prezentate mai jos:

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

Înlocuiți valorile ambilor parametri cu două șiruri aleatorii diferite și asigurați-vă că lungimea fiecărui șir este aceeași ca a celuilalt, de exemplu:

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

Salvează și închide:

:wq!

Cota de memorie implicită este prea mică pentru a rula Tomcat 8 și XWiki în interior. Trebuie să creșteți cota de memorie implicită, după cum urmează, înainte de a putea porni corect o instanță XWiki în Tomcat 8.

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

Găsiți linia:

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

Modificați linia așa cum se arată mai jos:

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

Notă: 1024M de memorie este doar cota minimă pentru rularea unui site XWiki mic sau mediu. Este posibil să fie necesar să ajustați această linie în conformitate cu cerințele dvs. specifice.

Salvează și închide:

:wq!

Reporniți Tomcat 8 pentru a aduce toate modificările în vigoare:

sudo systemctl restart tomcat8.service

Modificați regulile de firewall UFW pentru a permite accesul web pe port 8080:

sudo ufw allow 8080
sudo ufw enable

Inițializați XWiki pe Distribution Wizardinterfața web

În acest moment, ați configurat un site XWiki funcțional, dar gol. Pentru a completa conținutul, trebuie să finalizați mai multe sarcini de urmărire, inclusiv crearea unui utilizator de administrare și instalarea unei arome și a extensiilor necesare pentru acest wiki, pe interfața web XWiki inițială denumită " Distribution Wizard".

Indicați-vă browser-ul web preferat http://203.0.113.1:8080/xwikiși veți fi adus automat pe Distribution Wizardinterfața web. Faceți clic pe Continuebutonul " " pentru a începe expertul.

În pagina " Step 1 - Admin user", trebuie să introduceți datele de autentificare ale utilizatorului admin, de exemplu:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `johndoe@example.com`

După completarea tuturor câmpurilor necesare, faceți clic pe Register and loginbutonul " " pentru a continua.

În următoarea pagină care apare " You are connected with user John Doe.", faceți clic pe Continuebutonul " " pentru a crea utilizatorul de administrator John Doeal cărui nume de utilizator este johndoeși continuați.

În pagina " Step 2 - Flavor", faceți clic pe zona " XWiki Standard Flavor 9.11.2" pentru a evidenția această aromă, apoi faceți clic pe Install this flavorbutonul " " pentru a continua.

În pagina următoare care descrie detaliile " XWiki Standard Flavor 9.11.2", faceți clic pe Installbutonul " " pentru a efectua instalarea.

După instalarea aromei, toate extensiile necesare vor fi listate pe pagină, faceți clic pe Continuebutonul " " pentru a le instala pe toate.

Având aroma și toate extensiile necesare instalate, faceți clic pe Continuebutonul " " din colțul din dreapta jos pentru a continua.

Pe pagina " Step 4 - Report", puteți examina toate paginile create.

Dacă este necesar, puteți șterge orice pagină nepopulară făcând clic pe Xbutonul roșu corespunzător .

În cele din urmă, faceți clic pe Continuebutonul " " pentru a termina " Distribution Wizard". Veți fi introdus în tabloul de bord XWiki ca utilizator de administrator pe care l-ați configurat mai devreme.

(Opțional) Scurtați adresa URL a site-ului XWiki

În mod implicit, deoarece Tomcat poate servi mai multe aplicații în același timp, trebuie să accesați site-ul XWiki la adresa URL http://203.0.113.1:8080/xwiki. Cu toate acestea, dacă XWiki este singura aplicație care rulează în Tomcat și doriți să scurtați adresa URL a site-ului XWiki prin eliminarea /xwikisufixului, ar trebui să modificați trei fișiere de configurare XWiki după cum urmează.

Modificarea fișierului 1:

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

Modificarea fișierului 2:

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

Găsiți linia:

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

Modificați valoarea parametrului de cale:

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

Salvează și închide:

:wq!

Modificarea fișierului 3:

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

Găsiți linia:

# xwiki.webapppath=

Deconsider-o:

xwiki.webapppath=

Salvează și închide:

:wq!

În cele din urmă, reporniți Tomcat 8 pentru a aplica toate modificările:

sudo systemctl restart tomcat8.service

De acum înainte, veți vizita http://203.0.113.1:8080/direct site-ul dvs. XWiki .

(Opțional) Configurați un proxy invers Nginx

În mod implicit, Tomcat 8 funcționează în port 8080și puteți vizita site-ul dvs. XWiki din același port. Dacă doriți să facilitați accesul vizitatorilor prin eliminarea părții cu numărul portului, puteți instala Nginx ca proxy invers între XWiki și vizitatori.

În primul rând, instalați Nginx folosind apt:

sudo apt install nginx -y

Apoi, configurați Nginx ca proxy invers prin modificarea configurațiilor sale implicite ale site-ului:

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

Completați fișierul cu următoarele:

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

Salvează și închide:

:wq!

Porniți serviciul Nginx și setați-l să pornească automat la pornirea sistemului:

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

În cele din urmă, modificați regulile firewall-ului UFW în consecință:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

De acum, vizitatorii site-ului dvs. XWiki nu mai trebuie să specifice numărul portului. Ar trebui să viziteze direct http://203.0.113.1/.