Ako nainštalovať XWiki 9.11.x na Ubuntu 16.04 LTS

XWiki je populárna open source wiki platforma na podnikovej úrovni napísaná v jazyku Java. Vďaka rozšíriteľnosti a jednoduchosti používania sa XWiki nasadzuje v rôznych spoločnostiach ako úložisko znalostí, verejný portál a ďalšie.

V tomto článku vás prevediem procesom inštalácie XWiki 9.11.2 na inštanciu servera Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 a MySQL 5.7 sa automaticky nainštalujú ako závislosti počas procesu inštalácie.

Predpoklady

• Čerstvá inštancia servera Vultr Ubuntu 16.04 LTS x64 s najmenej 2 GB pamäte, odporúča sa 4 GB alebo viac. Povedzme, že jeho IP adresa je 203.0.113.1.
• Sudo používateľ .
• Inštancia servera bola aktualizovaná na najnovší stabilný stav pomocou apt.

Nastavte XWiki LTS APT repo

Prihláste sa ako používateľ sudo a potom si stiahnite a nastavte repo APT XWiki LTS (Long Term Support) na inštancii vášho servera:

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

Poznámka: Ak chcete vyskúšať najnovšiu stabilnú verziu XWiki (ale NIE LTS), môžete si namiesto toho stiahnuť nižšie uvedené repo 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

Nainštalujte všetko v jednom balíku XWiki (vrátane XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 a ďalších.)

Pri nasadení do produkcie musí XWiki pracovať s kontajnerom Java Servlet a databázovým softvérom. Ako flexibilná wiki platforma XWiki oficiálne poskytuje rôzne možnosti integrácie. Na zobrazenie všetkých dostupných možností v XWiki LTS APT repo môžete použiť nasledujúci príkaz:

apt search xwiki

Výsledok vyhľadávania bude vyzerať takto:

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

Ak chcete používať XWiki s najbežnejšími závislosťami, môžete nainštalovať všetky požadované komponenty v jednom príkaze takto:

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

Počas procesu inštalácie budete niekoľkokrát požiadaní o nastavenie nového hesla pre používateľa root MySQL. Ak Enterchcete tento krok nateraz preskočiť, ponechajte pole pre heslo prázdne a stlačte tlačidlo . Tento problém budeme riešiť neskôr pri zabezpečení inštalácie MySQL.

Keď sa zobrazí otázka, či chcete Configure database for xwiki with dbconfig-common?, vyberte <Yes>a potom stlačte ENTER.

Keď sa zobrazí výzva na zadanie MySQL application password for xwiki, môžete zadať konkrétne heslo aplikácie MySQL alebo ponechať pole hesla prázdne. Ten povie XWiki, aby použila náhodné heslo aplikácie MySQL.

Po nainštalovaní XWiki a všetkých požadovaných závislostí zabezpečte inštaláciu MySQL:

sudo /usr/bin/mysql_secure_installation

Počas procesu vám program položí niekoľko otázok. Odpovedzte im takto:

• Chcete nastaviť doplnok VALIDATE PASSWORD? Y
• Zadajte 0 = NÍZKE, 1 = STREDNÉ a 2 = SILNÉ: 2
• Nové heslo: a-strong-MySQL-root-password
• Znova zadajte nové heslo: a-strong-MySQL-root-password
• Chcete pokračovať so zadaným heslom? Y
• Chcete odstrániť anonymných používateľov? Y
• Zakázať prihlásenie root na diaľku? Y
• Odstrániť testovaciu databázu a získať k nej prístup? Y
• Chcete teraz znova načítať tabuľky práv? Y

Zvýšte bezpečnosť XWiki úpravou konfiguračného súboru XWiki.

Na otvorenie konfiguračného súboru XWiki použite editor vi:

sudo vi /etc/xwiki/xwiki.cfg

Nájdite dva riadky zobrazené nižšie:

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

Nahraďte hodnoty oboch parametrov dvoma rôznymi náhodnými reťazcami a uistite sa, že dĺžka každého reťazca je rovnaká ako dĺžka druhého reťazca, napríklad:

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

Uložiť a ukončiť:

:wq!

Predvolená kvóta pamäte je príliš nízka na spustenie Tomcat 8 a XWiki v rámci. Pred správnym spustením inštancie XWiki v Tomcat 8 musíte zvýšiť predvolenú kvótu pamäte nasledovne.

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

Nájdite riadok:

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

Upravte riadok, ako je znázornené nižšie:

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

Poznámka: 1024M pamäte je len minimálna kvóta pre spustenie malej alebo strednej stránky XWiki. Možno budete musieť vykonať úpravy tohto riadku v súlade s vašimi špecifickými požiadavkami.

Uložiť a ukončiť:

:wq!

Reštartujte Tomcat 8, aby sa všetky vaše úpravy prejavili:

sudo systemctl restart tomcat8.service

Upravte pravidlá brány firewall UFW, aby ste umožnili webový prístup na porte 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializujte XWiki na Distribution Wizardwebovom rozhraní

V tomto bode ste nastavili funkčnú, ale prázdnu stránku XWiki. Aby ste mohli vyplniť obsah, musíte dokončiť niekoľko nadväzujúcich úloh, vrátane vytvorenia administrátora a inštalácie príchute a požadovaných rozšírení pre túto wiki na úvodnom webovom rozhraní XWiki s názvom „ Distribution Wizard“.

Ukážte svoj obľúbený webový prehliadač na http://203.0.113.1:8080/xwikia budete automaticky presmerovaní na Distribution Wizardwebové rozhranie. Kliknutím na tlačidlo " Continue" spustíte sprievodcu.

Na stránke „ Step 1 - Admin user“ musíte zadať poverenia správcu správcu, napríklad:

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

Po vyplnení všetkých povinných polí kliknite na tlačidlo " Register and login" a pokračujte ďalej.

Na ďalšej stránke, ktorá zobrazuje „ You are connected with user John Doe.“, kliknite na tlačidlo „ Continue“, čím vytvoríte administrátora, John Doektorého používateľské meno je, johndoea pokračujte ďalej.

Na stránke „ Step 2 - Flavor“ kliknite na oblasť „ XWiki Standard Flavor 9.11.2“, aby ste zvýraznili túto príchuť, a potom kliknite na tlačidlo „ Install this flavor“, aby ste pokračovali.

On the next page which details the "XWiki Standard Flavor 9.11.2", click the "Install" button to perform the installation.

Having the flavor installed, all of the required extensions will be listed on the page, click the "Continue" button to install them all.

Having the flavor and all of the required extensions installed, click the "Continue" button at the bottom right corner to move on.

On the "Step 4 - Report" page, you can review all of the pages created.

If necessary, you can delete any unpopular pages by clicking the corresponding red X button.

Finally, click the "Continue" button to finish the "Distribution Wizard". You will be brought into the XWiki dashboard as the admin user you had setup earlier.

(Voliteľné) Skráťte adresu URL lokality XWiki

V predvolenom nastavení, keďže Tomcat môže slúžiť viac ako jednej aplikácii súčasne, musíte na svoju stránku XWiki pristupovať na adrese URL http://203.0.113.1:8080/xwiki. Ak je však XWiki jedinou aplikáciou spustenou v Tomcat a chcete skrátiť adresu URL stránky XWiki odstránením /xwikiprípony, mali by ste upraviť tri konfiguračné súbory XWiki nasledovne.

Úprava súboru 1:

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

Úprava súboru 2:

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

Nájdite riadok:

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

Upravte hodnotu parametra cesty:

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

Uložiť a ukončiť:

:wq!

Úprava súboru 3:

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

Nájdite riadok:

# xwiki.webapppath=

Odkomentujte to:

xwiki.webapppath=

Uložiť a ukončiť:

:wq!

Nakoniec reštartujte Tomcat 8, aby ste mohli použiť všetky svoje úpravy:

sudo systemctl restart tomcat8.service

Odteraz budete svoju stránku XWiki navštevovať priamo z http://203.0.113.1:8080/.

(Voliteľné) Nastavte reverzný proxy server Nginx

V predvolenom nastavení Tomcat 8 funguje na porte 8080a svoju stránku XWiki môžete navštíviť iba z rovnakého portu. Ak chcete uľahčiť prístup návštevníkov odstránením časti čísla portu, môžete nainštalovať Nginx ako reverzný proxy medzi XWiki a návštevníkmi.

Najprv nainštalujte Nginx pomocou apt:

sudo apt install nginx -y

Ďalej nastavte Nginx ako reverzný proxy úpravou jeho predvolených konfigurácií stránok:

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

Do súboru vyplňte nasledovné:

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

Uložiť a ukončiť:

:wq!

Spustite službu Nginx a nastavte jej automatické spustenie pri štarte systému:

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

Nakoniec podľa toho upravte pravidlá brány firewall UFW:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Odteraz už návštevníci vašej stránky XWiki nemusia zadávať číslo portu. Mali by priamo navštíviť http://203.0.113.1/.