Az XWiki 9.11.x telepítése Ubuntu 16.04 LTS rendszeren

Az XWiki egy népszerű, nagyvállalati szintű nyílt forráskódú, Java nyelven írt wikiplatform. A bővíthetőségnek és az egyszerű használatnak köszönhetően az XWikit különféle vállalatok használják tudástárként, nyilvános portálként stb.

Ebben a cikkben végigvezetem az XWiki 9.11.2 Ubuntu 16.04 LTS kiszolgálópéldányra történő telepítésének folyamatán. Az OpenJDK 8, a Tomcat 8 és a MySQL 5.7 függőségekként automatikusan telepítésre kerül a telepítési folyamat során.

Előfeltételek

• Friss Vultr Ubuntu 16.04 LTS x64 szerverpéldány legalább 2 GB memóriával, 4 GB vagy több ajánlott. Tegyük fel, hogy az IP-címe 203.0.113.1.
• Egy sudo felhasználó .
• A kiszolgálópéldány frissítve lett a legújabb stabil állapotra a használatával apt.

Állítsa be az XWiki LTS APT repót

Jelentkezzen be sudo felhasználóként, majd töltse le és állítsa be az XWiki LTS (Long Term Support) APT repót a kiszolgálópéldányán:

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

Megjegyzés: Ha ki szeretné próbálni a legújabb stabil XWiki kiadást (de NEM az LTS-t), ehelyett letöltheti az alábbi XWiki APT repót:

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

Telepítse az összeset egy XWiki-csomagban (beleértve az XWiki LTS 9.11.2-t, a Tomcat 8-at, a MySQL 5.7-et és egyebeket).

Éles környezetben történő telepítéskor az XWikinek Java Servlet tárolóval és adatbázisszoftverrel kell működnie. Rugalmas wikiplatformként az XWiki hivatalosan is különféle integrációs lehetőségeket kínál. A következő paranccsal megjelenítheti az XWiki LTS APT repo összes elérhető opcióját:

apt search xwiki

A keresés eredménye a következőhöz fog hasonlítani:

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

Ha az XWikit a leggyakoribb függőségekkel szeretné használni, az összes szükséges összetevőt egyetlen paranccsal telepítheti az alábbiak szerint:

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

A telepítési folyamat során a rendszer többször felkéri, hogy állítson be új jelszót a MySQL root felhasználó számára. Csak hagyja üresen a jelszó mezőt, és nyomja meg Entera gombot a lépés kihagyásához. Ezt a problémát később kezeljük, miközben biztosítjuk a MySQL telepítését.

Amikor a rendszer megkérdezi, hogy szeretné-e Configure database for xwiki with dbconfig-common?, válassza ki <Yes>, majd nyomja meg a gombot ENTER.

Amikor a rendszer arra kéri, hogy adjon meg egy MySQL application password for xwiki, megadhat egy adott MySQL-alkalmazásjelszót, vagy üresen hagyhatja a jelszómezőt. Ez utóbbi azt fogja mondani, hogy az XWiki véletlenszerű MySQL-alkalmazásjelszót használjon.

Az XWiki és az összes szükséges függőség telepítése után biztosítsa a MySQL telepítését:

sudo /usr/bin/mysql_secure_installation

A folyamat során a program feltesz néhány kérdést. Válaszoljon nekik az alábbiak szerint:

• Szeretné beállítani a JELSZÓ VALÓSÍTÁSA beépülő modult? Y
• Kérjük, írja be a következőt: 0 = ALACSONY, 1 = KÖZEPES és 2 = ERŐS: 2
• Új jelszó: a-strong-MySQL-root-password
• Adja meg újra az új jelszót: a-strong-MySQL-root-password
• Folytatja a megadott jelszóval? Y
• Eltávolítja a névtelen felhasználókat? Y
• Letiltja a root bejelentkezést távolról? Y
• Eltávolítja a tesztadatbázist, és hozzáférhet hozzá? Y
• Újratölti a jogosultságtáblázatokat most? Y

Növelje az XWiki biztonságát az XWiki konfigurációs fájl módosításával.

Használja a vi szerkesztőt egy XWiki konfigurációs fájl megnyitásához:

sudo vi /etc/xwiki/xwiki.cfg

Keresse meg az alábbi két sort:

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

Cserélje le mindkét paraméter értékét két különböző véletlenszerű karakterláncra, és csak győződjön meg arról, hogy mindegyik karakterlánc hossza megegyezik a másikéval, például:

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

Mentés és kilépés:

:wq!

Az alapértelmezett memóriakvóta túl alacsony a Tomcat 8 és az XWiki futtatásához. Az alábbiak szerint növelnie kell az alapértelmezett memóriakvótát, mielőtt megfelelően elindíthat egy XWiki-példányt a Tomcat 8-ban.

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

Keresse meg a sort:

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

Módosítsa a sort az alábbiak szerint:

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

Megjegyzés: 1024 millió memória csak a minimális kvóta egy kis vagy közepes XWiki webhely futtatásához. Előfordulhat, hogy saját igényeinek megfelelően módosítania kell ezt a sort.

Mentés és kilépés:

:wq!

Indítsa újra a Tomcat 8-at az összes módosítás érvénybe léptetéséhez:

sudo systemctl restart tomcat8.service

Módosítsa az UFW tűzfal szabályait, hogy engedélyezze a webes hozzáférést a következő porton 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializálja az XWikit a Distribution Wizardwebes felületen

Ezen a ponton beállított egy működőképes, de üres XWiki webhelyet. A tartalom kitöltéséhez el kell végeznie számos további feladatot, beleértve az adminisztrátori felhasználó létrehozását, valamint a wiki verziójának és a szükséges bővítmények telepítését az XWiki kezdeti webes felületén, a " Distribution Wizard" néven.

Mutasson kedvenc webböngészőjére a címre http://203.0.113.1:8080/xwiki, és automatikusan a Distribution Wizardwebes felületre kerül. Kattintson a " Continue" gombra a varázsló elindításához.

A " Step 1 - Admin user" oldalon meg kell adnia az adminisztrátor felhasználó hitelesítő adatait, például:

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

Az összes kötelező mező kitöltése után kattintson a " Register and login" gombra a továbblépéshez.

A következő oldalon, amelyen a " You are connected with user John Doe." látható, kattintson a " Continue" gombra az adminisztrátori felhasználó létrehozásához, John Doeakinek a felhasználóneve, johndoeés lépjen tovább.

A " Step 2 - Flavor" oldalon kattintson a " XWiki Standard Flavor 9.11.2" területre az íz kiemeléséhez, majd kattintson a " Install this flavor" gombra a továbblépéshez.

A következő oldalon, amely részletezi a " XWiki Standard Flavor 9.11.2" elemet, kattintson a " Install" gombra a telepítés végrehajtásához.

Miután telepítette az ízt, az összes szükséges bővítmény megjelenik az oldalon, kattintson a " Continue" gombra az összes telepítéséhez.

Miután telepítette az ízt és az összes szükséges bővítményt, kattintson a Continuejobb alsó sarokban található " " gombra a továbblépéshez.

A " Step 4 - Report" oldalon megtekintheti az összes létrehozott oldalt.

Ha szükséges, törölheti a nem népszerű oldalakat a megfelelő piros Xgombra kattintva.

Végül kattintson a " Continue" gombra a " Distribution Wizard" befejezéséhez . A korábban beállított adminisztrátorként megjelenik az XWiki irányítópultján.

(Opcionális) Rövidítse le az XWiki webhely URL-jét

Alapértelmezés szerint, mivel a Tomcat egynél több alkalmazást is tud egyszerre kiszolgálni, XWiki webhelyét a következő címen kell elérnie: http://203.0.113.1:8080/xwiki. Ha azonban az XWiki az egyetlen alkalmazás, amely a Tomcatban fut, és le szeretné rövidíteni az XWiki webhely URL-címét az /xwikiutótag eltávolításával , akkor módosítania kell három XWiki konfigurációs fájlt az alábbiak szerint.

1. fájlmódosítás:

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

2. fájlmódosítás:

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

Keresse meg a sort:

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

Módosítsa az elérési út paraméter értékét:

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

Mentés és kilépés:

:wq!

3. fájlmódosítás:

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

Keresse meg a sort:

# xwiki.webapppath=

Törölje a megjegyzést:

xwiki.webapppath=

Mentés és kilépés:

:wq!

Végül indítsa újra a Tomcat 8-at az összes módosítás alkalmazásához:

sudo systemctl restart tomcat8.service

Mostantól http://203.0.113.1:8080/közvetlenül az XWiki webhelyére látogat .

(Opcionális) Állítson be egy Nginx fordított proxyt

Alapértelmezés szerint a Tomcat 8 a porton működik 8080, és csak ugyanarról a portról látogathatja meg XWiki webhelyét. Ha szeretné megkönnyíteni a látogatók hozzáférését a portszám rész eltávolításával, telepítheti az Nginx-et fordított proxyként az XWiki és a látogatók között.

Először telepítse az Nginx-et az apt segítségével:

sudo apt install nginx -y

Ezután állítsa be az Nginx-et fordított proxyként az alapértelmezett webhelykonfigurációk módosításával:

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

Töltse ki a fájlt a következőkkel:

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

Mentés és kilépés:

:wq!

Indítsa el az Nginx szolgáltatást, és állítsa be, hogy automatikusan elinduljon a rendszer indításakor:

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

Végül ennek megfelelően módosítsa az UFW tűzfalszabályait:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Mostantól az XWiki webhely látogatóinak nem kell megadniuk a portszámot. Közvetlenül meg kell látogatniuk http://203.0.113.1/.