Kuidas installida XWiki 9.11.x Ubuntu 16.04 LTS-i

XWiki on populaarne, ettevõtte tasemel avatud lähtekoodiga vikiplatvorm, mis on kirjutatud Java keeles. Laiendatavuse ja kasutuslihtsusega XWiki on erinevates ettevõtetes kasutusele võetud teadmiste hoidla, avaliku portaalina ja muuna.

Selles artiklis juhendan teid XWiki 9.11.2 installimise protsessi Ubuntu 16.04 LTS-i serveri eksemplari. OpenJDK 8, Tomcat 8 ja MySQL 5.7 installitakse installiprotsessi käigus automaatselt sõltuvustena.

Eeltingimused

• Värske Vultr Ubuntu 16.04 LTS x64 serveri eksemplar, millel on vähemalt 2 GB mälu, soovitatav on 4 GB või rohkem. Ütle, et selle IP-aadress on 203.0.113.1.
• Sudo kasutaja .
• Serveri eksemplar on värskendatud uusimale stabiilsele olekule, kasutades apt.

Seadistage XWiki LTS APT repo

Logige sisse sudo kasutajana ning seejärel laadige alla ja seadistage oma serveri eksemplaris XWiki LTS (pikaajaline tugi) APT repo:

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

Märkus. Kui soovite proovida uusimat stabiilset XWiki versiooni (kuid MITTE LTS-i), saate selle asemel alla laadida alloleva 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

Installige kõik ühes XWiki komplektis (sh XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 ja palju muud.)

Tootmises juurutamisel peab XWiki töötama Java Servleti konteineri ja andmebaasitarkvaraga. Paindliku vikiplatvormina pakub XWiki ametlikult erinevaid integreerimisvõimalusi. Kõigi XWiki LTS APT repos saadaolevate valikute kuvamiseks saate kasutada järgmist käsku:

apt search xwiki

Otsingu tulemus sarnaneb järgmisega:

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

Kui soovite kasutada XWiki kõige levinumate sõltuvustega, saate installida kõik vajalikud komponendid ühe käsuga järgmiselt:

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

Installiprotsessi ajal palutakse teil mitu korda seadistada MySQL-i juurkasutaja jaoks uus parool. Jätke lihtsalt parooliväli tühjaks ja vajutage Enterselle sammu praeguseks vahelejätmiseks. Selle probleemiga tegeleme hiljem, tagades MySQL-i installimise.

Kui teilt küsitakse, kas soovite Configure database for xwiki with dbconfig-common?, valige <Yes>ja seejärel vajutage ENTER.

Kui MySQL application password for xwikiteil palutakse sisestada , võite sisestada konkreetse MySQL-i rakenduse parooli või jätta parooliväli tühjaks. Viimane käsib XWikil kasutada juhuslikku MySQL-i rakenduse parooli.

Kui XWiki ja kõik vajalikud sõltuvused on installitud, kindlustage MySQL-i installimine:

sudo /usr/bin/mysql_secure_installation

Protsessi käigus esitab programm teile mõned küsimused. Vastake neile järgmiselt:

• Kas soovite seadistada plugina VALIDISTA PAROOLI? Y
• Sisestage 0 = MADAL, 1 = KESKMINE ja 2 = TUGEV: 2
• Uus salasõna: a-strong-MySQL-root-password
• Sisestage uus parool uuesti: a-strong-MySQL-root-password
• Kas soovite jätkata antud parooliga? Y
• Kas eemaldada anonüümsed kasutajad? Y
• Kas keelata juurjuurde sisselogimine eemalt? Y
• Kas eemaldada testandmebaas ja sellele juurdepääs? Y
• Kas laadida privileegitabelid kohe uuesti? Y

Suurendage XWiki turvalisust, muutes XWiki konfiguratsioonifaili.

Kasutage XWiki konfiguratsioonifaili avamiseks vi-redaktorit:

sudo vi /etc/xwiki/xwiki.cfg

Otsige üles kaks allpool näidatud rida:

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

Asendage mõlema parameetri väärtused kahe erineva juhusliku stringiga ja lihtsalt veenduge, et iga stringi pikkus oleks sama, mis teisel, näiteks:

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

Salvestage ja lõpetage:

:wq!

Vaikimisi mälukvoot on Tomcat 8 ja XWiki käitamiseks liiga väike. Enne XWiki eksemplari õiget käivitamist Tomcat 8-s peate suurendama vaikemälu kvooti järgmiselt.

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

Leidke rida:

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

Muutke rida, nagu allpool näidatud:

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

Märkus. 1024M mälu on vaid minimaalne kvoot väikese või keskmise XWiki saidi käitamiseks. Võimalik, et peate seda rida vastavalt oma konkreetsetele nõudmistele kohandama.

Salvestage ja lõpetage:

:wq!

Taaskäivitage Tomcat 8, et kõik oma muudatused jõustuksid:

sudo systemctl restart tomcat8.service

Muutke UFW tulemüüri reegleid, et võimaldada veebile juurdepääsu pordile 8080:

sudo ufw allow 8080
sudo ufw enable

Käivitage XWiki Distribution Wizardveebiliideses " "

Siinkohal olete seadistanud toimiva, kuid tühja XWiki saidi. Sisu täitmiseks peate XWiki algses veebiliideses nimega " Distribution Wizard" lõpetama mitmed järeltoimingud, sealhulgas looma administraatori kasutaja ning installima selle wiki jaoks maitse ja nõutavad laiendused .

Suunake oma lemmikveebibrauser aadressile http://203.0.113.1:8080/xwikija teid suunatakse automaatselt " Distribution Wizard" veebiliidesesse. ContinueNõustaja käivitamiseks klõpsake nuppu " ".

Lehel " Step 1 - Admin user" peate sisestama administraatori kasutaja mandaadid, näiteks:

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

Pärast kõigi nõutavate väljade täitmist klõpsake Register and loginedasiliikumiseks nuppu " ".

Järgmisel lehel, kus kuvatakse " You are connected with user John Doe.", klõpsake Continuenuppu " ", et luua administraatori kasutaja, John Doekelle kasutajanimi on, johndoeja liikuda edasi.

Lehel " Step 2 - Flavor" klõpsake XWiki Standard Flavor 9.11.2selle maitse esiletõstmiseks alal " " ja seejärel klõpsake Install this flavoredasi liikumiseks nuppu " ".

Järgmisel lehel, kus on üksikasjalikult kirjeldatud " XWiki Standard Flavor 9.11.2", klõpsake Installinstallimiseks nuppu " ".

Kui maitse on installitud, kuvatakse lehel kõik vajalikud laiendused Continue. Nende kõigi installimiseks klõpsake nuppu " ".

Kui maitse ja kõik vajalikud laiendused on installitud, klõpsake Continueedasi liikumiseks all paremas nurgas nuppu " ".

Lehel " Step 4 - Report" saate üle vaadata kõik loodud lehed.

Vajadusel saate kustutada ebapopulaarsed lehed, klõpsates vastavat punast Xnuppu.

Lõpuks klõpsake " Continue" lõpetamiseks nuppu " Distribution Wizard". Teid tuuakse XWiki armatuurlauale administraatorina, kelle olete varem seadistanud.

(Valikuline) Lühendage XWiki saidi URL-i

Kuna Tomcat saab korraga teenindada mitut rakendust, peate vaikimisi avama oma XWiki saidi aadressil URL http://203.0.113.1:8080/xwiki. Kui aga XWiki on ainus Tomcatis töötav rakendus ja soovite lühendada XWiki saidi URL-i, eemaldades /xwikijärelliide, peaksite kolme XWiki konfiguratsioonifaili muutma järgmiselt.

Faili muudatus 1:

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

Faili muudatus 2:

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

Leidke rida:

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

Muutke tee parameetri väärtust:

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

Salvestage ja lõpetage:

:wq!

Faili muudatus 3:

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

Leidke rida:

# xwiki.webapppath=

Tühista see kommentaar:

xwiki.webapppath=

Salvestage ja lõpetage:

:wq!

Lõpuks taaskäivitage Tomcat 8, et rakendada kõik oma muudatused:

sudo systemctl restart tomcat8.service

Nüüdsest külastate oma XWiki saiti http://203.0.113.1:8080/otse.

(Valikuline) Seadistage Nginxi pöördpuhverserver

Vaikimisi töötab Tomcat 8 pordis 8080ja saate oma XWiki saiti külastada ainult samast pordist. Kui soovite hõlbustada külastajate juurdepääsu, eemaldades pordi numbri osa, saate installida Nginxi pöördpuhverserverina XWiki ja külastajate vahel.

Esmalt installige Nginx, kasutades apt:

sudo apt install nginx -y

Järgmisena seadistage Nginx pöördpuhverserverina, muutes selle saidi vaikekonfiguratsioone:

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

Täitke fail järgmisega:

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

Salvestage ja lõpetage:

:wq!

Käivitage Nginxi teenus ja määrake see süsteemi käivitamisel automaatselt käivituma:

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

Lõpuks muutke UFW tulemüüri reegleid vastavalt.

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Nüüdsest ei pea teie XWiki saidi külastajad enam pordi numbrit määrama. Nad peaksid otse külastama http://203.0.113.1/.