Kako instalirati XWiki 9.11.x na Ubuntu 16.04 LTS

XWiki je popularna wiki platforma otvorenog koda na razini poduzeća napisana na Javi. Uz proširivost i jednostavnost korištenja, XWiki se primjenjuje u raznim tvrtkama kao spremište znanja, javni portal i još mnogo toga.

U ovom članku vodit ću vas kroz proces instaliranja XWiki 9.11.2 na instancu poslužitelja Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 i MySQL 5.7 automatski će se instalirati kao ovisnosti tijekom procesa instalacije.

Preduvjeti

• Svježa instanca poslužitelja Vultr Ubuntu 16.04 LTS x64 s najmanje 2 GB memorije, preporuča se 4 GB ili više. Recimo da je njegova IP adresa 203.0.113.1.
• Korisnik sudoa .
• Instanca poslužitelja ažurirana je na najnoviji stabilni status pomoću apt.

Postavite XWiki LTS APT repo

Prijavite se kao sudo korisnik, a zatim preuzmite i postavite XWiki LTS (Long Term Support) APT repo na instancu poslužitelja:

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

Napomena: Ako želite isprobati najnovije stabilno izdanje XWikija (ali NE LTS), umjesto toga možete preuzeti donji 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

Instalirajte sve u jednom XWiki paketu (uključujući XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 i više.)

Kada se implementira u produkciji, XWiki mora raditi s Java Servlet spremnikom i softverom baze podataka. Kao fleksibilna wiki platforma, XWiki službeno nudi različite mogućnosti integracije. Možete koristiti sljedeću naredbu za prikaz svih dostupnih opcija u XWiki LTS APT repo:

apt search xwiki

Rezultat pretraživanja će izgledati sljedeće:

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

Ako želite koristiti XWiki s najčešćim ovisnostima, možete instalirati sve potrebne komponente u jednoj naredbi na sljedeći način:

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

Tijekom procesa instalacije od vas će se tražiti da postavite novu lozinku za MySQL root korisnika nekoliko puta. Samo ostavite polje za zaporku prazno i ​​pritisnite Enterda za sada preskočite ovaj korak. Kasnije ćemo se pozabaviti ovim problemom dok osiguravamo instalaciju MySQL-a.

Kada vas pita da li želite Configure database for xwiki with dbconfig-common?, odaberite <Yes>i zatim pritisnite ENTER.

Kada se od vas zatraži da unesete MySQL application password for xwiki, možete unijeti određenu lozinku za MySQL aplikaciju ili ostaviti polje lozinke prazno. Potonji će reći XWikiju da koristi slučajnu lozinku MySQL aplikacije.

Nakon što je instaliran XWiki i sve potrebne ovisnosti, osigurajte instalaciju MySQL-a:

sudo /usr/bin/mysql_secure_installation

Tijekom procesa, program će vam postaviti nekoliko pitanja. Odgovorite im na sljedeći način:

• Želite li postaviti dodatak VALIDATE PASSWORD? Y
• Unesite 0 = NISKO, 1 = SREDNJE i 2 = SNAŽNO: 2
• Nova lozinka: a-strong-MySQL-root-password
• Ponovno unesite novu lozinku: a-strong-MySQL-root-password
• Želite li nastaviti s priloženom zaporkom? Y
• Ukloniti anonimne korisnike? Y
• Zabraniti root prijavu na daljinu? Y
• Ukloniti testnu bazu podataka i pristupiti njoj? Y
• Ponovno učitati tablice privilegija sada? Y

Povećajte sigurnost XWikija modificiranjem XWiki konfiguracijske datoteke.

Koristite uređivač vi za otvaranje XWiki konfiguracijske datoteke:

sudo vi /etc/xwiki/xwiki.cfg

Pronađite dva reda prikazana u nastavku:

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

Zamijenite vrijednosti oba parametra s dva različita nasumična niza i samo provjerite je li duljina svakog niza jednaka duljini drugog, na primjer:

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

Spremi i zatvori:

:wq!

Zadana kvota memorije je preniska za pokretanje Tomcat 8 i XWiki unutar. Morate povećati zadanu kvotu memorije kako slijedi kako biste mogli ispravno pokrenuti XWiki instancu u Tomcatu 8.

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

Pronađite liniju:

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

Izmijenite liniju kao što je prikazano u nastavku:

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

Napomena: 1024M memorije samo je minimalna kvota za pokretanje male ili srednje XWiki stranice. Možda ćete morati prilagoditi ovu liniju u skladu sa svojim specifičnim zahtjevima.

Spremi i zatvori:

:wq!

Ponovno pokrenite Tomcat 8 kako bi sve vaše izmjene bile na snazi:

sudo systemctl restart tomcat8.service

Izmijenite pravila UFW vatrozida kako biste omogućili pristup webu na portu 8080:

sudo ufw allow 8080
sudo ufw enable

Inicijalizirajte XWiki na Distribution Wizardweb sučelju " "

U ovom trenutku, postavili ste funkcionalnu, ali praznu XWiki stranicu. Da biste ispunili sadržaj, morate dovršiti nekoliko naknadnih zadataka, uključujući stvaranje administratorskog korisnika i instaliranje okusa i potrebnih proširenja za ovaj wiki, na početnom XWiki web sučelju pod nazivom " Distribution Wizard".

Usmjerite svoj omiljeni web preglednik na http://203.0.113.1:8080/xwiki, i automatski ćete biti dovedeni na " Distribution Wizard" web sučelje. Kliknite Continuegumb " " za pokretanje čarobnjaka.

Na stranici " Step 1 - Admin user" morate unijeti vjerodajnice administratorskog korisnika, na primjer:

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

Nakon što ste ispunili sva potrebna polja, kliknite Register and logingumb " " za nastavak.

Na sljedećoj stranici koja prikazuje " You are connected with user John Doe.", kliknite Continuegumb " " za stvaranje administratorskog korisnika John Doečije je korisničko ime johndoei nastavite dalje.

Na stranici " Step 2 - Flavor" kliknite na područje " XWiki Standard Flavor 9.11.2" da biste istaknuli ovaj okus, a zatim kliknite Install this flavorgumb " " za nastavak.

Na sljedećoj stranici s detaljima o " XWiki Standard Flavor 9.11.2", kliknite Installgumb " " za izvođenje instalacije.

Nakon instaliranja okusa, sva potrebna proširenja bit će navedena na stranici, kliknite Continuegumb " " da biste ih sve instalirali.

Nakon što su instalirani okus i sva potrebna proširenja, kliknite Continuegumb " " u donjem desnom kutu za nastavak.

Na stranici " Step 4 - Report" možete pregledati sve izrađene stranice.

Ako je potrebno, možete izbrisati sve nepopularne stranice klikom na odgovarajući crveni Xgumb.

Na kraju, kliknite Continuegumb " " da biste dovršili " Distribution Wizard". Bit ćete dovedeni na XWiki nadzornu ploču kao administratorski korisnik kojeg ste prethodno postavili.

(Neobavezno) Skratite URL web-mjesta XWiki

Prema zadanim postavkama, budući da Tomcat može poslužiti više od jedne aplikacije u isto vrijeme, morate pristupiti svojoj XWiki web stranici na URL-u http://203.0.113.1:8080/xwiki. Međutim, ako je XWiki jedina aplikacija koja radi u Tomcatu i želite skratiti URL XWiki stranice uklanjanjem /xwikisufiksa, trebali biste izmijeniti tri XWiki konfiguracijske datoteke kako slijedi.

Izmjena datoteke 1:

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

Izmjena datoteke 2:

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

Pronađite liniju:

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

Promijenite vrijednost parametra puta:

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

Spremi i zatvori:

:wq!

Izmjena datoteke 3:

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

Pronađite liniju:

# xwiki.webapppath=

Dekomentiraj:

xwiki.webapppath=

Spremi i zatvori:

:wq!

Konačno, ponovno pokrenite Tomcat 8 kako biste primijenili sve svoje izmjene:

sudo systemctl restart tomcat8.service

Od sada ćete http://203.0.113.1:8080/izravno posjećivati ​​svoju XWiki stranicu .

(Izborno) Postavite Nginx obrnuti proxy

Prema zadanim postavkama, Tomcat 8 radi na portu 8080, a svoju XWiki stranicu možete posjetiti samo s istog porta. Ako posjetiteljima želite olakšati pristup uklanjanjem dijela broja porta, možete instalirati Nginx kao obrnuti proxy između XWikija i posjetitelja.

Prvo instalirajte Nginx koristeći apt:

sudo apt install nginx -y

Zatim postavite Nginx kao obrnuti proxy mijenjajući njegove zadane konfiguracije web-mjesta:

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

Ispunite datoteku sljedećim:

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

Spremi i zatvori:

:wq!

Pokrenite uslugu Nginx i postavite je da se automatski pokreće pri pokretanju sustava:

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

Konačno, u skladu s tim izmijenite pravila UFW vatrozida:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Od sada posjetitelji vaše XWiki stranice više ne moraju navesti broj porta. Trebali bi izravno posjetiti http://203.0.113.1/.