Kako namestiti XWiki 9.11.x na Ubuntu 16.04 LTS

XWiki je priljubljena odprtokodna wiki platforma na ravni podjetja, napisana v Javi. Zaradi razširljivosti in enostavnosti uporabe se XWiki uvaja v različna podjetja kot skladišče znanja, javni portal in še več.

V tem članku vas bom vodil skozi postopek namestitve XWiki 9.11.2 na primerek strežnika Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 in MySQL 5.7 bodo med postopkom namestitve samodejno nameščeni kot odvisnosti.

Predpogoji

• Nov primerek strežnika Vultr Ubuntu 16.04 LTS x64 z vsaj 2 GB pomnilnika, priporočeno 4 GB ali več. Recimo, da je njegov naslov IP 203.0.113.1.
• Uporabnik sudo .
• Primerek strežnika je bil posodobljen na najnovejše stabilno stanje z uporabo apt.

Nastavite repo XWiki LTS APT

Prijavite se kot uporabnik sudo, nato pa prenesite in nastavite repo APT XWiki LTS (dolgoročna podpora) na svojem primerku strežnika:

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

Opomba: Če želite preizkusiti najnovejšo stabilno izdajo XWiki (vendar NE LTS), lahko namesto tega prenesete spodnji 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

Namestite vse v enem svežnju XWiki (vključno z XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 in več.)

Ko je nameščen v produkciji, mora XWiki delati z vsebnikom Java Servlet in programsko opremo baze podatkov. Kot prilagodljiva wiki platforma XWiki uradno ponuja različne možnosti integracije. Za prikaz vseh razpoložljivih možnosti v repo XWiki LTS APT lahko uporabite naslednji ukaz:

apt search xwiki

Rezultat iskanja bo podoben naslednjemu:

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

Če želite uporabljati XWiki z najpogostejšimi odvisnostmi, lahko vse potrebne komponente namestite v enem ukazu, kot sledi:

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

Med postopkom namestitve boste večkrat pozvani, da nastavite novo geslo za korenskega uporabnika MySQL. Pustite polje za geslo prazno in pritisnite, Enterda ta korak za zdaj preskočite. To težavo se bomo lotili pozneje, medtem ko bomo varovali namestitev MySQL.

Ko vas vpraša, ali želite Configure database for xwiki with dbconfig-common?, izberite <Yes>in pritisnite ENTER.

Ko vas prosimo, da vnesete MySQL application password for xwiki, lahko vnesete določeno geslo aplikacije MySQL ali pustite polje za geslo prazno. Slednji bo XWikiju povedal, naj uporabi naključno geslo aplikacije MySQL.

Ko imate nameščen XWiki in vse potrebne odvisnosti, zavarujte namestitev MySQL:

sudo /usr/bin/mysql_secure_installation

Med postopkom vam bo program postavil nekaj vprašanj. Odgovorite jim, kot sledi:

• Ali želite nastaviti vtičnik VALIDATE PASSWORD? Y
• Vnesite 0 = NIZKO, 1 = SREDNJE in 2 = MOČNO: 2
• Novo geslo: a-strong-MySQL-root-password
• Ponovno vnesite novo geslo: a-strong-MySQL-root-password
• Ali želite nadaljevati s posredovanim geslom? Y
• Želite odstraniti anonimne uporabnike? Y
• Ali želite na daljavo onemogočiti root prijavo? Y
• Odstraniti testno bazo podatkov in dostop do nje? Y
• Ponovno naložite tabele privilegijev zdaj? Y

Izboljšajte varnost XWikija s spreminjanjem konfiguracijske datoteke XWiki.

Uporabite urejevalnik vi, da odprete konfiguracijsko datoteko XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Poiščite dve vrstici, prikazani spodaj:

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

Zamenjajte vrednosti obeh parametrov z dvema različnima naključnima nizoma in se prepričajte, da je dolžina vsakega niza enaka dolžini drugega, na primer:

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

Shrani in zapusti:

:wq!

Privzeta pomnilniška kvota je prenizka za izvajanje Tomcat 8 in XWiki znotraj. Preden lahko pravilno zaženete primerek XWiki v Tomcatu 8, morate povečati privzeto pomnilniško kvoto, kot sledi.

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

Poiščite vrstico:

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

Spremenite vrstico, kot je prikazano spodaj:

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

Opomba: 1024M pomnilnika je le minimalna kvota za zagon majhnega ali srednjega mesta XWiki. Morda boste morali to vrstico prilagoditi glede na vaše posebne zahteve.

Shrani in zapusti:

:wq!

Znova zaženite Tomcat 8, da uveljavite vse svoje spremembe:

sudo systemctl restart tomcat8.service

Spremenite pravila požarnega zidu UFW, da omogočite spletni dostop na vratih 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializirajte XWiki na Distribution Wizardspletnem vmesniku " "

Na tej točki ste nastavili funkcionalno, a prazno mesto XWiki. Če želite izpolniti vsebino, morate dokončati več nadaljnjih opravil, vključno z ustvarjanjem skrbniškega uporabnika ter namestitvijo okusa in potrebnih razširitev za ta wiki, na začetnem spletnem vmesniku XWiki z imenom " Distribution Wizard".

Usmerite svoj najljubši spletni brskalnik na http://203.0.113.1:8080/xwiki, in samodejno boste preusmerjeni na Distribution Wizardspletni vmesnik. Kliknite Continuegumb " ", da zaženete čarovnika.

Na strani " Step 1 - Admin user" morate vnesti poverilnice skrbniškega uporabnika, na primer:

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

Ko izpolnite vsa zahtevana polja, kliknite Register and logingumb " " za nadaljevanje.

Na naslednji strani, ki prikazuje " You are connected with user John Doe.", kliknite gumb " Continue", da ustvarite skrbniškega uporabnika, John Doekaterega uporabniško ime je, johndoein nadaljujte.

Na strani " Step 2 - Flavor" kliknite območje " XWiki Standard Flavor 9.11.2", da označite ta okus, in nato kliknite gumb " Install this flavor" za nadaljevanje.

Na naslednji strani s podrobnostmi o " XWiki Standard Flavor 9.11.2" kliknite gumb " Install" za izvedbo namestitve.

Ko je okus nameščen, bodo na strani navedene vse zahtevane razširitve, kliknite gumb " Continue", da jih namestite vse.

Ko imate nameščen okus in vse zahtevane razširitve, kliknite gumb " Continue" v spodnjem desnem kotu, da nadaljujete.

Na strani » Step 4 - Report« si lahko ogledate vse ustvarjene strani.

Če je potrebno, lahko izbrišete vse nepriljubljene strani s klikom na ustrezen rdeči Xgumb.

Na koncu kliknite gumb " Continue", da dokončate " Distribution Wizard". Na nadzorno ploščo XWiki boste pripeljani kot skrbniški uporabnik, ki ste ga nastavili prej.

(Izbirno) Skrajšajte URL spletnega mesta XWiki

Ker lahko Tomcat hkrati služi več kot eno aplikacijo, morate privzeto dostopati do svojega mesta XWiki na naslovu URL http://203.0.113.1:8080/xwiki. Če pa je XWiki edina aplikacija, ki se izvaja v Tomcatu in želite skrajšati URL spletnega mesta XWiki z odstranitvijo /xwikipripone, morate tri konfiguracijske datoteke XWiki spremeniti na naslednji način.

Sprememba datoteke 1:

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

Sprememba datoteke 2:

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

Poiščite vrstico:

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

Spremenite vrednost parametra poti:

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

Shrani in zapusti:

:wq!

Sprememba datoteke 3:

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

Poiščite vrstico:

# xwiki.webapppath=

Odkomentiraj:

xwiki.webapppath=

Shrani in zapusti:

:wq!

Končno znova zaženite Tomcat 8, da uveljavite vse svoje spremembe:

sudo systemctl restart tomcat8.service

Od zdaj naprej boste svoje spletno mesto XWiki obiskali http://203.0.113.1:8080/neposredno.

(Izbirno) Nastavite povratni proxy Nginx

Tomcat 8 privzeto deluje na vratih 8080in svoje spletno mesto XWiki lahko obiščete samo iz istega pristanišča. Če želite obiskovalcem olajšati dostop tako, da odstranite del številke vrat, lahko namestite Nginx kot povratni proxy med XWikijem in obiskovalci.

Najprej namestite Nginx z uporabo apt:

sudo apt install nginx -y

Nato nastavite Nginx kot povratni proxy tako, da spremenite njegove privzete konfiguracije spletnega mesta:

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

Izpolnite datoteko z naslednjim:

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

Shrani in zapusti:

:wq!

Zaženite storitev Nginx in jo nastavite, da se samodejno zažene ob zagonu sistema:

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

Na koncu ustrezno spremenite pravila požarnega zidu UFW:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Od zdaj naprej obiskovalcem vašega spletnega mesta XWiki ni več treba navajati številke vrat. Obiskati bi jih morali neposredno http://203.0.113.1/.