Kaip įdiegti XWiki 9.11.x Ubuntu 16.04 LTS

XWiki yra populiari įmonės lygio atvirojo kodo wiki platforma, parašyta Java kalba. Dėl išplečiamumo ir naudojimo paprastumo XWiki įvairiose įmonėse diegiamas kaip žinių saugykla, viešasis portalas ir kt.

Šiame straipsnyje paaiškinsiu, kaip įdiegti XWiki 9.11.2 Ubuntu 16.04 LTS serverio egzemplioriuje. „OpenJDK 8“, „Tomcat 8“ ir „MySQL 5.7“ bus automatiškai įdiegtos kaip priklausomybės diegimo proceso metu.

Būtinos sąlygos

• Naujas Vultr Ubuntu 16.04 LTS x64 serverio egzempliorius su mažiausiai 2 GB atminties, rekomenduojama 4 GB ar daugiau. Pasakykite, kad jo IP adresas yra 203.0.113.1.
• Sudo vartotojas .
• Serverio egzempliorius buvo atnaujintas į naujausią stabilią būseną naudojant apt.

Nustatykite XWiki LTS APT repo

Prisijunkite kaip sudo vartotojas, tada atsisiųskite ir nustatykite XWiki LTS (ilgalaikio palaikymo) APT repo savo serverio egzemplioriuje:

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

Pastaba: jei norite išbandyti naujausią stabilų XWiki leidimą (bet NE LTS), galite atsisiųsti toliau pateiktą XWiki APT repo:

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

Įdiekite viską viename XWiki pakete (įskaitant XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 ir kt.)

Diegiant gamyboje, XWiki turi dirbti su Java Servlet konteineriu ir duomenų bazės programine įranga. Kaip lanksti wiki platforma, XWiki oficialiai siūlo įvairias integravimo parinktis. Galite naudoti šią komandą, kad parodytumėte visas galimas parinktis XWiki LTS APT repo:

apt search xwiki

Paieškos rezultatas bus panašus į šiuos:

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

Jei norite naudoti XWiki su dažniausiai pasitaikančiomis priklausomybėmis, galite įdiegti visus reikalingus komponentus vienoje komandoje taip:

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

Diegimo proceso metu jūsų bus paprašyta kelis kartus nustatyti naują MySQL root vartotojo slaptažodį. Tiesiog palikite slaptažodžio lauką tuščią ir paspauskite, Enterkad kol kas praleistumėte šį veiksmą. Šią problemą išspręsime vėliau, užtikrindami MySQL diegimą.

Kai jūsų paklaus, ar norite Configure database for xwiki with dbconfig-common?, pasirinkite <Yes>ir paspauskite ENTER.

Kai būsite paprašyti pateikti MySQL application password for xwiki, galite įvesti konkretų MySQL programos slaptažodį arba palikti slaptažodžio lauką tuščią. Pastarasis lieps XWiki naudoti atsitiktinį MySQL programos slaptažodį.

Įdiegę XWiki ir visas reikalingas priklausomybes, užsitikrinkite MySQL diegimą:

sudo /usr/bin/mysql_secure_installation

Proceso metu programa užduos jums keletą klausimų. Atsakykite jiems taip:

• Ar norite nustatyti įskiepį PALIDATE PASSWORD? Y
• Įveskite 0 = LOW, 1 = VIDUTINIS ir 2 = STIPRUS: 2
• Naujas Slaptažodis: a-strong-MySQL-root-password
• Iš naujo įveskite naują slaptažodį: a-strong-MySQL-root-password
• Ar norite tęsti naudodami pateiktą slaptažodį? Y
• Pašalinti anoniminius naudotojus? Y
• Neleisti root prisijungimo nuotoliniu būdu? Y
• Pašalinti bandymų duomenų bazę ir prieigą prie jos? Y
• Dabar iš naujo įkelti privilegijų lenteles? Y

Padidinkite XWiki saugumą pakeisdami XWiki konfigūracijos failą.

Norėdami atidaryti XWiki konfigūracijos failą, naudokite vi redaktorių:

sudo vi /etc/xwiki/xwiki.cfg

Raskite dvi toliau pateiktas eilutes:

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

Pakeiskite abiejų parametrų reikšmes dviem skirtingomis atsitiktinėmis eilutėmis ir tiesiog įsitikinkite, kad kiekvienos eilutės ilgis yra toks pat kaip kitos, pavyzdžiui:

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

Išsaugoti ir išeiti:

:wq!

Numatytoji atminties kvota per maža, kad būtų galima paleisti Tomcat 8 ir XWiki. Kad galėtumėte tinkamai paleisti XWiki egzempliorių Tomcat 8, turite padidinti numatytąją atminties kvotą, kaip nurodyta toliau.

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

Raskite eilutę:

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

Pakeiskite eilutę, kaip parodyta toliau:

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

Pastaba: 1024M atminties yra tik minimali kvota, skirta mažai ar vidutinei XWiki svetainei paleisti. Jums gali tekti pakoreguoti šią eilutę pagal konkrečius poreikius.

Išsaugoti ir išeiti:

:wq!

Iš naujo paleiskite Tomcat 8, kad įsigaliotų visi pakeitimai:

sudo systemctl restart tomcat8.service

Pakeiskite UFW ugniasienės taisykles, kad galėtumėte pasiekti žiniatinklio prievadą 8080:

sudo ufw allow 8080
sudo ufw enable

Inicijuoti XWiki Distribution Wizardžiniatinklio sąsajoje

Šiuo metu jūs sukūrėte funkcionalią, bet tuščią XWiki svetainę. Norėdami užpildyti turinį, pradinėje XWiki žiniatinklio sąsajoje, pavadintoje " Distribution Wizard" , turite atlikti keletą tolesnių užduočių, įskaitant administratoriaus naudotojo sukūrimą ir šio wiki papildinio bei reikalingų plėtinių įdiegimą .

Nukreipkite savo mėgstamą žiniatinklio naršyklę į " " http://203.0.113.1:8080/xwikiir būsite automatiškai nukreipti į " Distribution Wizard" žiniatinklio sąsają. Norėdami Continuepradėti vedlį, spustelėkite mygtuką " ".

Puslapyje „ Step 1 - Admin user“ turite įvesti administratoriaus vartotojo kredencialus, pavyzdžiui:

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

Užpildę visus privalomus laukus, spustelėkite Register and loginmygtuką " ", kad galėtumėte tęsti.

Kitame puslapyje, kuriame rodoma " You are connected with user John Doe.", spustelėkite Continuemygtuką " ", kad sukurtumėte administratoriaus naudotoją, John Doekurio vartotojo vardas yra, johndoeir pereikite toliau.

Puslapyje " Step 2 - Flavor" spustelėkite " XWiki Standard Flavor 9.11.2" sritį, kad paryškintumėte šį skonį, tada spustelėkite Install this flavormygtuką " ", kad pereitumėte toliau.

Kitame puslapyje, kuriame išsamiai aprašyta " XWiki Standard Flavor 9.11.2", spustelėkite Installmygtuką " ", kad atliktumėte diegimą.

Įdiegę skonį, visi reikalingi plėtiniai bus pateikti puslapyje, spustelėkite Continuemygtuką " ", kad įdiegtumėte juos visus.

Įdiegę skonį ir visus reikiamus plėtinius, spustelėkite Continuemygtuką " " apatiniame dešiniajame kampe, kad galėtumėte tęsti.

Puslapyje „ Step 4 - Report“ galite peržiūrėti visus sukurtus puslapius.

Jei reikia, galite ištrinti visus nepopuliarius puslapius spustelėdami atitinkamą raudoną Xmygtuką.

Galiausiai spustelėkite Continuemygtuką " ", kad užbaigtumėte " Distribution Wizard". Jūs būsite nukreiptas į XWiki prietaisų skydelį kaip administratorius, kurį nustatėte anksčiau.

(Pasirenkama) Sutrumpinkite XWiki svetainės URL

Pagal numatytuosius nustatymus, kadangi Tomcat gali aptarnauti daugiau nei vieną programą vienu metu, turite pasiekti savo XWiki svetainę adresu URL http://203.0.113.1:8080/xwiki. Tačiau jei XWiki yra vienintelė programa, veikianti Tomcat ir norite sutrumpinti XWiki svetainės URL, pašalindami /xwikigalūnę, turėtumėte modifikuoti tris XWiki konfigūracijos failus, kaip nurodyta toliau.

1 failo modifikacija:

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

2 failo modifikacija:

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

Raskite eilutę:

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

Pakeiskite kelio parametro reikšmę:

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

Išsaugoti ir išeiti:

:wq!

3 failo modifikacija:

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

Raskite eilutę:

# xwiki.webapppath=

Atšaukti komentarą:

xwiki.webapppath=

Išsaugoti ir išeiti:

:wq!

Galiausiai iš naujo paleiskite Tomcat 8, kad pritaikytumėte visus pakeitimus:

sudo systemctl restart tomcat8.service

Nuo šiol savo XWiki svetainėje apsilankysite http://203.0.113.1:8080/tiesiogiai iš .

(Pasirenkama) Nustatykite „Nginx“ atvirkštinį tarpinį serverį

Pagal numatytuosius nustatymus „Tomcat 8“ veikia prievade 8080ir galite apsilankyti savo „XWiki“ svetainėje tik iš to paties prievado. Jei norite palengvinti lankytojų prieigą pašalindami prievado numerio dalį, galite įdiegti „Nginx“ kaip atvirkštinį tarpinį serverį tarp „XWiki“ ir lankytojų.

Pirmiausia įdiekite „Nginx“ naudodami apt:

sudo apt install nginx -y

Tada nustatykite „Nginx“ kaip atvirkštinį tarpinį serverį, pakeisdami numatytąsias svetainės konfigūracijas:

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

Užpildykite failą taip:

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

Išsaugoti ir išeiti:

:wq!

Paleiskite „Nginx“ paslaugą ir nustatykite, kad ji automatiškai paleistų paleidžiant sistemą:

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

Galiausiai atitinkamai pakeiskite UFW ugniasienės taisykles:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Nuo šiol jūsų XWiki svetainės lankytojams nebereikia nurodyti prievado numerio. Jie turėtų apsilankyti tiesiogiai http://203.0.113.1/.