Jak nainstalovat XWiki 9.11.x na Ubuntu 16.04 LTS

XWiki je populární open source wiki platforma na podnikové úrovni napsaná v Javě. Díky rozšiřitelnosti a snadnému použití je XWiki nasazována v různých společnostech jako úložiště znalostí, veřejný portál a další.

V tomto článku vás provedu procesem instalace XWiki 9.11.2 na instanci serveru Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 a MySQL 5.7 budou automaticky nainstalovány jako závislosti během procesu instalace.

Předpoklady

• Čerstvá instance serveru Vultr Ubuntu 16.04 LTS x64 s alespoň 2 GB paměti, doporučeno 4 GB nebo více. Řekněme, že jeho IP adresa je 203.0.113.1.
• Uživatel sudo .
• Instance serveru byla aktualizována na nejnovější stabilní stav pomocí apt.

Nastavte XWiki LTS APT repo

Přihlaste se jako uživatel sudo a poté si stáhněte a nastavte repo APT XWiki LTS (Long Term Support) na instanci vašeho serveru:

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: Pokud chcete vyzkoušet nejnovější stabilní verzi XWiki (ale NE LTS), můžete si místo toho stáhnout níže 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

Nainstalujte vše v jednom balíčku XWiki (včetně XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 a dalších.)

Při nasazení v produkci musí XWiki pracovat s kontejnerem Java Servlet a databázovým softwarem. Jako flexibilní wiki platforma XWiki oficiálně poskytuje různé možnosti integrace. Následující příkaz můžete použít k zobrazení všech dostupných možností v XWiki LTS APT repo:

apt search xwiki

Výsledek hledání bude vypadat následovně:

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

Pokud chcete používat XWiki s nejběžnějšími závislostmi, můžete nainstalovat všechny požadované komponenty v jednom příkazu následovně:

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

Během procesu instalace budete několikrát požádáni o nastavení nového hesla pro uživatele root MySQL. Ponechte pole pro heslo prázdné a stisknutím tlačítka Entertento krok prozatím přeskočte. Tento problém budeme řešit pozd��ji při zabezpečení instalace MySQL.

Až budete dotázáni, zda chcete Configure database for xwiki with dbconfig-common?, vyberte <Yes>a stiskněte ENTER.

Když budete požádáni o zadání MySQL application password for xwiki, můžete buď zadat konkrétní heslo aplikace MySQL, nebo ponechat pole pro heslo prázdné. Ten řekne XWiki, aby použila náhodné heslo aplikace MySQL.

Po instalaci XWiki a všech požadovaných závislostí zajistěte instalaci MySQL:

sudo /usr/bin/mysql_secure_installation

Během procesu vám program položí několik otázek. Odpovězte jim níže:

• Chcete nastavit plugin VALIDATE PASSWORD? Y
• Zadejte prosím 0 = NÍZKÁ, 1 = STŘEDNÍ a 2 = SILNÁ: 2
• Nové heslo: a-strong-MySQL-root-password
• Znovu zadejte nové heslo: a-strong-MySQL-root-password
• Přejete si pokračovat se zadaným heslem? Y
• Odebrat anonymní uživatele? Y
• Zakázat vzdálené přihlášení root? Y
• Odebrat testovací databázi a přístup k ní? Y
• Znovu načíst tabulky oprávnění? Y

Vylepšete zabezpečení XWiki úpravou konfiguračního souboru XWiki.

Pomocí editoru vi otevřete konfigurační soubor XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Najděte dva řádky zobrazené níže:

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

Nahraďte hodnoty obou parametrů dvěma různými náhodnými řetězci a ujistěte se, že délka každého řetězce je stejná jako délka druhého, například:

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

Uložit a ukončit:

:wq!

Výchozí kvóta paměti je příliš nízká pro spuštění Tomcat 8 a XWiki v rámci. Než budete moci správně spustit instanci XWiki v Tomcat 8, musíte zvýšit výchozí kvótu paměti následovně.

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

Najděte řádek:

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

Upravte řádek, jak je znázorněno níže:

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

Poznámka: 1024M paměti je pouze minimální kvóta pro provozování malého nebo středního webu XWiki. Možná budete muset provést úpravy této řady v souladu s vašimi konkrétními požadavky.

Uložit a ukončit:

:wq!

Restartujte Tomcat 8, aby se všechny vaše úpravy projevily:

sudo systemctl restart tomcat8.service

Upravte pravidla brány firewall UFW, abyste povolili webový přístup na portu 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializujte XWiki na Distribution Wizardwebovém rozhraní

V tomto okamžiku jste nastavili funkční, ale prázdný web XWiki. Abyste mohli vyplnit obsah, musíte dokončit několik navazujících úkolů, včetně vytvoření administrátora a instalace příchutí a požadovaných rozšíření pro tuto wiki na úvodním webovém rozhraní XWiki s názvem „ Distribution Wizard“.

Nasměrujte svůj oblíbený webový prohlížeč na http://203.0.113.1:8080/xwikia budete automaticky přesměrováni na Distribution Wizardwebové rozhraní. Klepnutím na tlačítko " Continue" spustíte průvodce.

Na stránce „ Step 1 - Admin user“ musíte zadat přihlašovací údaje administrátora, například:

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

Po vyplnění všech povinných polí Register and loginpokračujte kliknutím na tlačítko " ".

Na další stránce, která zobrazuje „ You are connected with user John Doe.“, klikněte na tlačítko „ Continue“ pro vytvoření administrátora, John Doejehož uživatelské jméno je, johndoea pokračujte.

Na stránce „ Step 2 - Flavor“ klikněte na oblast „ XWiki Standard Flavor 9.11.2“ pro zvýraznění této příchutě a poté klikněte na tlačítko „ Install this flavor“ pro pokračování.

Na další stránce s podrobnostmi o „ XWiki Standard Flavor 9.11.2“ klikněte na tlačítko „ Install“ pro provedení instalace.

Po nainstalované verzi budou všechna požadovaná rozšíření uvedena na stránce, kliknutím na tlačítko " Continue" je nainstalujete všechna.

Po instalaci příchuti a všech požadovaných rozšíření klikněte na tlačítko " Continue" v pravém dolním rohu a pokračujte.

Na stránce „ Step 4 - Report“ si můžete prohlédnout všechny vytvořené stránky.

V případě potřeby můžete jakékoli neoblíbené stránky smazat kliknutím na odpovídající červené Xtlačítko.

Nakonec kliknutím na tlačítko „ Continue“ dokončete „ Distribution Wizard“. Budete uvedeni do řídicího panelu XWiki jako uživatel správce, kterého jste dříve nastavili.

(Volitelné) Zkraťte adresu URL webu XWiki

Ve výchozím nastavení, protože Tomcat může obsluhovat více než jednu aplikaci současně, musíte ke svému webu XWiki přistupovat na adrese URL http://203.0.113.1:8080/xwiki. Pokud je však XWiki jedinou aplikací spuštěnou v Tomcatu a chcete zkrátit adresu URL webu XWiki odstraněním /xwikipřípony, měli byste upravit tři konfigurační soubory XWiki následovně.

Úprava souboru 1:

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

Úprava souboru 2:

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

Najděte řádek:

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

Upravte hodnotu parametru cesta:

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

Uložit a ukončit:

:wq!

Úprava souboru 3:

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

Najděte řádek:

# xwiki.webapppath=

Odkomentujte to:

xwiki.webapppath=

Uložit a ukončit:

:wq!

Nakonec restartujte Tomcat 8, abyste mohli použít všechny své úpravy:

sudo systemctl restart tomcat8.service

Od nynějška budete své stránky XWiki navštěvovat http://203.0.113.1:8080/přímo.

(Volitelné) Nastavte reverzní proxy Nginx

Ve výchozím nastavení Tomcat 8 funguje na portu 8080a web XWiki můžete navštívit pouze ze stejného portu. Pokud chcete usnadnit přístup návštěvníků odstraněním části čísla portu, můžete nainstalovat Nginx jako reverzní proxy mezi XWiki a návštěvníky.

Nejprve nainstalujte Nginx pomocí apt:

sudo apt install nginx -y

Dále nastavte Nginx jako reverzní proxy úpravou jeho výchozí konfigurace webu:

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

Do souboru vyplňte následující:

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žit a ukončit:

:wq!

Spusťte službu Nginx a nastavte ji tak, aby se automaticky spouštěla ​​při startu systému:

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

Nakonec odpovídajícím způsobem upravte pravidla brány firewall UFW:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Od této chvíle již návštěvníci vašeho webu XWiki nemusí uvádět číslo portu. Měli by přímo navštívit http://203.0.113.1/.