XWiki 9.11.x:n asentaminen Ubuntu 16.04 LTS:ään

XWiki on suosittu, yritystason avoimen lähdekoodin wikialusta, joka on kirjoitettu Java-kielellä. Laajennettavuuden ja helppokäyttöisyyden ansiosta XWiki on otettu käyttöön useissa yrityksissä tietovarastona, julkisena portaalina ja paljon muuta.

Tässä artikkelissa opastan sinua XWiki 9.11.2:n asentamisessa Ubuntu 16.04 LTS -palvelinesiintymään. OpenJDK 8, Tomcat 8 ja MySQL 5.7 asennetaan automaattisesti riippuvuuksina asennuksen aikana.

Edellytykset

• Tuore Vultr Ubuntu 16.04 LTS x64 -palvelinesiintymä, jossa on vähintään 2 Gt muistia, 4 Gt tai enemmän suositellaan. Sano, että sen IP-osoite on 203.0.113.1.
• Sudo käyttäjä .
• Palvelimen ilmentymä on päivitetty uusimpaan vakaaseen tilaan käyttämällä apt.

Asenna XWiki LTS APT -repo

Kirjaudu sisään sudo-käyttäjänä ja lataa ja asenna sitten XWiki LTS (Long Term Support) APT -repo palvelinesiintymässäsi:

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

Huomautus: Jos haluat kokeilla uusinta vakaata XWiki-julkaisua (mutta EI LTS:ää), voit ladata sen sijaan alla olevan XWiki APT -repon:

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

Asenna kaikki yhdessä XWiki-paketissa (mukaan lukien XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 ja paljon muuta.)

Kun XWiki otetaan käyttöön tuotannossa, sen on toimittava Java Servlet -säilön ja tietokantaohjelmiston kanssa. Joustavana wiki-alustana XWiki tarjoaa virallisesti erilaisia ​​integraatiovaihtoehtoja. Voit käyttää seuraavaa komentoa näyttääksesi kaikki käytettävissä olevat vaihtoehdot XWiki LTS APT -varastossa:

apt search xwiki

Hakutulos muistuttaa seuraavaa:

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

Jos haluat käyttää XWikia yleisimpien riippuvuuksien kanssa, voit asentaa kaikki tarvittavat komponentit yhdellä komennolla seuraavasti:

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

Asennuksen aikana sinua pyydetään määrittämään uusi salasana MySQL-pääkäyttäjälle useita kertoja. Jätä salasanakenttä tyhjäksi ja paina Enterohittaaksesi tämän vaiheen toistaiseksi. Käsittelemme tätä ongelmaa myöhemmin samalla kun varmistamme MySQL:n asennuksen.

Kun sinulta kysytään, haluatko Configure database for xwiki with dbconfig-common?, valitse <Yes>ja paina sitten ENTER.

Kun MySQL application password for xwikisinua pyydetään antamaan , voit joko syöttää tietyn MySQL-sovelluksen salasanan tai jättää salasanakentän tyhjäksi. Jälkimmäinen käskee XWikiä käyttämään satunnaista MySQL-sovelluksen salasanaa.

Kun XWiki ja kaikki tarvittavat riippuvuudet on asennettu, varmista MySQL:n asennus:

sudo /usr/bin/mysql_secure_installation

Prosessin aikana ohjelma kysyy sinulta muutaman kysymyksen. Vastaa heille seuraavasti:

• Haluatko määrittää VALIDATE PASSWORD -laajennuksen? Y
• Kirjoita 0 = MATALA, 1 = KESKIPÄÄINEN ja 2 = VAHVA: 2
• Uusi salasana: a-strong-MySQL-root-password
• Kirjoita uusi salasana uudelleen: a-strong-MySQL-root-password
• Haluatko jatkaa antamalla salasanalla? Y
• Poistetaanko nimettömät käyttäjät? Y
• Estä root-kirjautuminen etänä? Y
• Poistetaanko testitietokanta ja pääsy siihen? Y
• Ladataanko etuoikeustaulukot uudelleen nyt? Y

Paranna XWikin turvallisuutta muokkaamalla XWikin konfigurointitiedostoa.

Avaa XWiki-asetustiedosto vi-editorilla:

sudo vi /etc/xwiki/xwiki.cfg

Etsi alla näkyvät kaksi riviä:

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

Korvaa molempien parametrien arvot kahdella eri satunnaisella merkkijonolla ja varmista vain, että kunkin merkkijonon pituus on sama kuin toisen, esimerkiksi:

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

Tallenna ja lopeta:

:wq!

Oletusmuistikiintiö on liian pieni Tomcat 8:n ja XWikin käyttämiseen. Sinun on lisättävä oletusmuistikiintiötä seuraavasti, ennen kuin voit käynnistää XWiki-esiintymän oikein Tomcat 8:ssa.

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

Etsi rivi:

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

Muokkaa riviä alla olevan kuvan mukaisesti:

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

Huomautus: 1024 Mt muistia on vain vähimmäiskiintiö pienen tai keskikokoisen XWiki-sivuston käyttämiselle. Saatat joutua tekemään muutoksia tähän riviin erityisvaatimustesi mukaisesti.

Tallenna ja lopeta:

:wq!

Käynnistä Tomcat 8 uudelleen, jotta kaikki muutokset tulevat voimaan:

sudo systemctl restart tomcat8.service

Muokkaa UFW-palomuurisääntöjä salliaksesi verkkokäytön portissa 8080:

sudo ufw allow 8080
sudo ufw enable

Alusta XWiki Distribution Wizardverkkokäyttöliittymässä

Tässä vaiheessa olet asettanut toimivan mutta tyhjän XWiki-sivuston. Sisällön täyttämiseksi sinun on suoritettava useita jatkotehtäviä, mukaan lukien järjestelmänvalvojan luominen ja tämän wikin lisäyksen ja vaadittujen laajennusten asentaminen alkuperäiseen XWiki-verkkoliittymään nimeltä " Distribution Wizard".

Osoita suosikkiselaimesi kohtaan http://203.0.113.1:8080/xwiki, niin sinut tuodaan automaattisesti " Distribution Wizard" verkkokäyttöliittymään. Napsauta " Continue" -painiketta aloittaaksesi ohjatun toiminnon.

" Step 1 - Admin user" -sivulla sinun on syötettävä järjestelmänvalvojan käyttäjän tunnistetiedot, esimerkiksi:

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

Kun olet täyttänyt kaikki vaaditut kentät, napsauta " Register and login" -painiketta jatkaaksesi.

You are connected with user John Doe.Napsauta seuraavalla sivulla, jossa näkyy " ", Continueluodaksesi järjestelmänvalvojan käyttäjän, John Doejonka käyttäjätunnus on, johndoeja siirry eteenpäin.

Step 2 - FlavorNapsauta " " -sivulla " XWiki Standard Flavor 9.11.2" -aluetta korostaaksesi tätä makua ja napsauta sitten " Install this flavor" -painiketta jatkaaksesi.

Suorita asennus XWiki Standard Flavor 9.11.2napsauttamalla seuraavalla sivulla " " olevaa " Install" -painiketta.

Kun maku on asennettu, kaikki tarvittavat laajennukset näkyvät sivulla. Napsauta " Continue" -painiketta asentaaksesi ne kaikki.

Kun maku ja kaikki tarvittavat laajennukset on asennettu, napsauta " Continue" -painiketta oikeassa alakulmassa jatkaaksesi.

" Step 4 - Report" -sivulla voit tarkastella kaikkia luotuja sivuja.

Tarvittaessa voit poistaa epäsuositut sivut napsauttamalla vastaavaa punaista Xpainiketta.

Napsauta lopuksi " Continue" -painiketta päättääksesi " Distribution Wizard". Sinut tuodaan XWikin kojelautaan järjestelmänvalvojana, jonka olet määrittänyt aiemmin.

(Valinnainen) Lyhennä XWiki-sivuston URL-osoite

Oletusarvoisesti, koska Tomcat voi palvella useampaa kuin yhtä sovellusta samanaikaisesti, sinun on käytettävä XWiki-sivustoasi osoitteessa URL http://203.0.113.1:8080/xwiki. Jos XWiki on kuitenkin ainoa Tomcatissa käynnissä oleva sovellus ja haluat lyhentää XWiki-sivuston URL-osoitetta poistamalla /xwikipääte, sinun tulee muokata kolmea XWiki-asetustiedostoa seuraavasti.

Tiedoston muutos 1:

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

Tiedoston muutos 2:

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

Etsi rivi:

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

Muokkaa polkuparametrin arvoa:

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

Tallenna ja lopeta:

:wq!

Tiedoston muutos 3:

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

Etsi rivi:

# xwiki.webapppath=

Poista kommentti:

xwiki.webapppath=

Tallenna ja lopeta:

:wq!

Lopuksi käynnistä Tomcat 8 uudelleen ottaaksesi kaikki muutokset käyttöön:

sudo systemctl restart tomcat8.service

Tästä lähtien vierailet XWiki-sivustollasi http://203.0.113.1:8080/suoraan.

(Valinnainen) Asenna Nginx-käänteinen välityspalvelin

Oletusarvoisesti Tomcat 8 toimii portissa 8080, ja voit vierailla XWiki-sivustollasi vain samasta portista. Jos haluat helpottaa vierailijoiden käyttöä poistamalla portin numeron osan, voit asentaa Nginxin käänteisenä välityspalvelimena XWikin ja vierailijoiden välillä.

Asenna ensin Nginx apt:lla:

sudo apt install nginx -y

Määritä seuraavaksi Nginx käänteiseksi välityspalvelimeksi muokkaamalla sen oletussivuston asetuksia:

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

Täytä tiedosto seuraavasti:

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

Tallenna ja lopeta:

:wq!

Käynnistä Nginx-palvelu ja aseta se käynnistymään automaattisesti järjestelmän käynnistyksen yhteydessä:

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

Muokkaa lopuksi UFW-palomuurisääntöjä vastaavasti:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Tästä eteenpäin XWiki-sivustosi vierailijoiden ei enää tarvitse määrittää portin numeroa. Heidän pitäisi käydä suoraan http://203.0.113.1/.