Kā instalēt XWiki 9.11.x operētājsistēmā Ubuntu 16.04 LTS

XWiki ir populāra, uzņēmuma līmeņa atvērtā pirmkoda wiki platforma, kas rakstīta Java valodā. Pateicoties paplašināmībai un lietošanas vienkāršībai, XWiki tiek izvietots dažādos uzņēmumos kā zināšanu krātuve, publisks portāls un daudz kas cits.

Šajā rakstā es jums pastāstīšu par XWiki 9.11.2 instalēšanas procesu Ubuntu 16.04 LTS servera instancē. OpenJDK 8, Tomcat 8 un MySQL 5.7 instalēšanas procesa laikā tiks automātiski instalētas kā atkarības.

Priekšnoteikumi

• Jauns Vultr Ubuntu 16.04 LTS x64 servera gadījums ar vismaz 2 GB atmiņu, ieteicams 4 GB vai vairāk. Pieņemsim, ka tā IP adrese ir 203.0.113.1.
• Sudo lietotāju .
• Servera gadījums ir atjaunināts uz jaunāko stabilo statusu, izmantojot apt.

Iestatiet XWiki LTS APT repo

Piesakieties kā sudo lietotājs un pēc tam lejupielādējiet un iestatiet XWiki LTS (ilgtermiņa atbalsta) APT repo savā servera instancē:

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

Piezīme. Ja vēlaties izmēģināt jaunāko stabilo XWiki versiju (bet NE LTS), tā vietā varat lejupielādēt tālāk norādīto 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

Instalējiet visu vienā XWiki komplektā (tostarp XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 un citas).

Izvietojot ražošanā, XWiki ir jādarbojas ar Java Servlet konteineru un datu bāzes programmatūru. Kā elastīga wiki platforma XWiki oficiāli nodrošina dažādas integrācijas iespējas. Varat izmantot šo komandu, lai parādītu visas pieejamās opcijas XWiki LTS APT repo:

apt search xwiki

Meklēšanas rezultāts būs līdzīgs šim:

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

Ja vēlaties izmantot XWiki ar visizplatītākajām atkarībām, varat instalēt visus nepieciešamos komponentus vienā komandā šādi:

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

Instalēšanas procesa laikā jums vairākas reizes tiks lūgts iestatīt jaunu paroli MySQL root lietotājam. Vienkārši atstājiet paroles lauku tukšu un nospiediet, Enterlai pagaidām izlaistu šo darbību. Mēs šo problēmu risināsim vēlāk, vienlaikus nodrošinot MySQL instalēšanu.

Kad tiek jautāts, vai vēlaties Configure database for xwiki with dbconfig-common?, izvēlieties <Yes>un pēc tam nospiediet ENTER.

Kad tiek prasīts norādīt MySQL application password for xwiki, varat ievadīt konkrētu MySQL lietojumprogrammas paroli vai atstāt paroles lauku tukšu. Pēdējais liks XWiki izmantot nejaušu MySQL lietojumprogrammas paroli.

Kad XWiki un visas nepieciešamās atkarības ir instalētas, nodrošiniet MySQL instalēšanu:

sudo /usr/bin/mysql_secure_installation

Procesa laikā programma jums uzdos dažus jautājumus. Atbildiet uz viņiem, kā norādīts tālāk:

• Vai vēlaties iestatīt spraudni VALIDATE PASSWORD? Y
• Lūdzu, ievadiet 0 = LOW, 1 = VIDĒJS un 2 = STIPRI: 2
• Jauna parole: a-strong-MySQL-root-password
• Atkārtoti ievadiet jauno paroli: a-strong-MySQL-root-password
• Vai vēlaties turpināt izmantot norādīto paroli? Y
• Vai noņemt anonīmos lietotājus? Y
• Vai aizliegt root pieteikšanos attālināti? Y
• Vai noņemt testa datu bāzi un piekļūt tai? Y
• Vai tagad atkārtoti ielādēt privilēģiju tabulas? Y

Uzlabojiet XWiki drošību, modificējot XWiki konfigurācijas failu.

Izmantojiet vi redaktoru, lai atvērtu XWiki konfigurācijas failu:

sudo vi /etc/xwiki/xwiki.cfg

Atrodiet divas zemāk redzamās rindas:

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

Aizstājiet abu parametru vērtības ar divām dažādām nejaušām virknēm un tikai pārliecinieties, vai katras virknes garums ir tāds pats kā otras, piemēram:

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

Saglabāt un iziet:

:wq!

Noklusējuma atmiņas kvota ir pārāk maza, lai tajās palaistu Tomcat 8 un XWiki. Lai varētu pareizi startēt XWiki gadījumu programmā Tomcat 8, jums ir jāpalielina noklusējuma atmiņas kvota, kā norādīts tālāk.

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

Atrodiet līniju:

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

Mainiet rindu, kā parādīts zemāk:

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

Piezīme: 1024 M atmiņas ir tikai minimālā kvota nelielas vai vidējas XWiki vietnes darbināšanai. Jums var būt nepieciešams pielāgot šo līniju atbilstoši jūsu īpašajām prasībām.

Saglabāt un iziet:

:wq!

Restartējiet Tomcat 8, lai stātos spēkā visas izmaiņas:

sudo systemctl restart tomcat8.service

Mainiet UFW ugunsmūra noteikumus, lai atļautu piekļuvi tīmeklim portā 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializējiet XWiki Distribution Wizardtīmekļa saskarnē

Šajā brīdī esat iestatījis funkcionālu, bet tukšu XWiki vietni. Lai aizpildītu saturu, sākotnējā XWiki tīmekļa saskarnē ar nosaukumu " Distribution Wizard" ir jāpabeidz vairāki papildu uzdevumi, tostarp jāizveido administrators un jāinstalē šī wiki versija un nepieciešamie paplašinājumi .

Norādiet savu iecienītāko tīmekļa pārlūkprogrammu uz http://203.0.113.1:8080/xwiki, un jūs automātiski tiksit novirzīts uz Distribution Wizardtīmekļa saskarni. Noklikšķiniet uz Continuepogas " ", lai sāktu vedni.

Lapā " Step 1 - Admin user" ir jāievada administratora lietotāja akreditācijas dati, piemēram:

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

Kad esat aizpildījis visus nepieciešamos laukus, noklikšķiniet uz Register and loginpogas " ", lai turpinātu.

Nākamajā lapā, kurā tiek rādīts " You are connected with user John Doe.", noklikšķiniet uz Continuepogas " ", lai izveidotu administratora lietotāju, John Doekura lietotājvārds ir, johndoeun turpinātu darbu.

Lapā " Step 2 - Flavor" noklikšķiniet uz XWiki Standard Flavor 9.11.2apgabala " ", lai izceltu šo garšu, un pēc tam noklikšķiniet uz Install this flavorpogas " ", lai turpinātu.

Nākamajā lapā, kurā ir norādīts " XWiki Standard Flavor 9.11.2", noklikšķiniet uz Installpogas " ", lai veiktu instalēšanu.

Pēc garšas instalēšanas lapā tiks parādīti visi nepieciešamie paplašinājumi. Noklikšķiniet uz Continuepogas " ", lai tos visus instalētu.

Kad garša un visi nepieciešamie paplašinājumi ir instalēti, noklikšķiniet uz Continuepogas " " apakšējā labajā stūrī, lai turpinātu.

Lapā " Step 4 - Report" varat pārskatīt visas izveidotās lapas.

Ja nepieciešams, varat izdzēst visas nepopulārās lapas, noklikšķinot uz atbilstošās sarkanās Xpogas.

Visbeidzot, noklikšķiniet uz Continuepogas " ", lai pabeigtu " Distribution Wizard". Jūs tiksit novirzīts uz XWiki informācijas paneli kā iepriekš iestatītais administrators.

(Neobligāti) Saīsiniet XWiki vietnes URL

Pēc noklusējuma, tā kā Tomcat vienlaikus var apkalpot vairākas lietojumprogrammas, jums ir jāpiekļūst savai XWiki vietnei, izmantojot URL http://203.0.113.1:8080/xwiki. Tomēr, ja XWiki ir vienīgā lietojumprogramma, kas darbojas programmā Tomcat, un vēlaties saīsināt XWiki vietnes URL, noņemot /xwikisufiksu, jums ir jāmaina trīs XWiki konfigurācijas faili, kā norādīts tālāk.

1. faila modifikācija:

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

2. faila modifikācija:

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

Atrodiet līniju:

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

Mainiet ceļa parametra vērtību:

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

Saglabāt un iziet:

:wq!

3. faila modifikācija:

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

Atrodiet līniju:

# xwiki.webapppath=

Atceliet komentāru:

xwiki.webapppath=

Saglabāt un iziet:

:wq!

Visbeidzot, restartējiet Tomcat 8, lai lietotu visas izmaiņas:

sudo systemctl restart tomcat8.service

No šī brīža jūs apmeklēsit savu XWiki vietni http://203.0.113.1:8080/tieši no .

(Neobligāti) Iestatiet Nginx reverso starpniekserveri

Pēc noklusējuma Tomcat 8 darbojas portā 8080, un jūs varat apmeklēt savu XWiki vietni tikai no tā paša porta. Ja vēlaties atvieglot apmeklētāju piekļuvi, noņemot porta numura daļu, varat instalēt Nginx kā apgriezto starpniekserveri starp XWiki un apmeklētājiem.

Vispirms instalējiet Nginx, izmantojot apt:

sudo apt install nginx -y

Pēc tam iestatiet Nginx kā apgriezto starpniekserveri, mainot tā noklusējuma vietņu konfigurācijas:

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

Aizpildiet failu ar sekojošo:

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

Saglabāt un iziet:

:wq!

Sāciet pakalpojumu Nginx un iestatiet to automātiski startēt sistēmas startēšanas laikā:

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

Visbeidzot, attiecīgi modificējiet UFW ugunsmūra noteikumus:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

No šī brīža jūsu XWiki vietnes apmeklētājiem vairs nav jānorāda porta numurs. Viņiem vajadzētu tieši apmeklēt http://203.0.113.1/.