Si të instaloni XWiki 9.11.x në Ubuntu 16.04 LTS

XWiki është një platformë wiki popullore, me burim të hapur në nivel ndërmarrje, e shkruar në Java. Me shtrirjen dhe lehtësinë e përdorimit, XWiki po shpërndahet në kompani të ndryshme si një depo njohurish, portal publik dhe më shumë.

Në këtë artikull, unë do t'ju udhëheq përmes procesit të instalimit të XWiki 9.11.2 në një shembull të serverit Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 dhe MySQL 5.7 do të instalohen automatikisht si vartësi gjatë procesit të instalimit.

Parakushtet

• Një shembull i ri i serverit Vultr Ubuntu 16.04 LTS x64 me të paktën 2 GB memorie, rekomandohet 4 GB ose më shumë. Thuaj se adresa e tij IP është 203.0.113.1.
• Një përdorues sudo .
• Shembulli i serverit është përditësuar në statusin më të fundit të qëndrueshëm duke përdorur apt.

Konfiguro depon e XWiki LTS APT

Identifikohu si përdorues sudo dhe më pas shkarkoni dhe konfiguroni repon APT XWiki LTS (Mbështetje afatgjatë) në shembullin e serverit tuaj:

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

Shënim: Nëse dëshironi të provoni versionin më të fundit të qëndrueshëm të XWiki (por JO LTS), në vend të kësaj mund të shkarkoni repon e mëposhtme të 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

Instaloni të gjitha në një paketën XWiki (përfshirë XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 dhe më shumë.)

Kur vendoset në prodhim, XWiki duhet të punojë me një kontejner Java Servlet dhe softuer bazë të dhënash. Si një platformë fleksibël wiki, XWiki ofron zyrtarisht opsione të ndryshme integrimi. Ju mund të përdorni komandën e mëposhtme për të shfaqur të gjitha opsionet e disponueshme në depon e XWiki LTS APT:

apt search xwiki

Rezultati i kërkimit do të jetë si më poshtë:

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

Nëse dëshironi të përdorni XWiki me varësitë më të zakonshme, mund të instaloni të gjithë komponentët e kërkuar në një komandë si më poshtë:

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

Gjatë procesit të instalimit, do t'ju kërkohet të vendosni një fjalëkalim të ri për përdoruesin rrënjësor të MySQL disa herë. Thjesht lini bosh fushën e fjalëkalimit dhe shtypni Enterpër ta kapërcyer këtë hap tani për tani. Ne do ta trajtojmë këtë problem më vonë ndërsa sigurojmë instalimin e MySQL.

Kur pyeteni nëse dëshironi Configure database for xwiki with dbconfig-common?, zgjidhni <Yes>dhe më pas shtypni ENTER.

Kur ju kërkohet të jepni një MySQL application password for xwiki, ju ose mund të futni një fjalëkalim specifik të aplikacionit MySQL ose ta lini bosh fushën e fjalëkalimit. Ky i fundit do t'i thotë XWikit të përdorë një fjalëkalim të rastësishëm të aplikacionit MySQL.

Duke pasur të instaluar XWiki dhe të gjitha varësitë e nevojshme, siguroni instalimin e MySQL:

sudo /usr/bin/mysql_secure_installation

Gjatë procesit, programi do t'ju bëjë disa pyetje. Përgjigjuni atyre si më poshtë:

• Dëshironi të konfiguroni shtesën VALIDATE PASSWORD? Y
• Ju lutemi shkruani 0 = ULËT, 1 = MESIMOR dhe 2 = FORTË: 2
• Fjalëkalim i ri: a-strong-MySQL-root-password
• Rifusni fjalëkalimin e ri: a-strong-MySQL-root-password
• Dëshironi të vazhdoni me fjalëkalimin e dhënë? Y
• Të hiqen përdoruesit anonimë? Y
• Të mos lejohet identifikimi i rrënjës nga distanca? Y
• Të hiqet baza e të dhënave të testimit dhe qasja në të? Y
• Rifresko tabelat e privilegjeve tani? Y

Rritni sigurinë e XWiki duke modifikuar skedarin e konfigurimit XWiki.

Përdorni redaktorin vi për të hapur një skedar konfigurimi XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Gjeni dy rreshtat e treguar më poshtë:

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

Zëvendësoni vlerat e të dy parametrave me dy vargje të ndryshme të rastësishme dhe thjesht sigurohuni që gjatësia e secilit varg të jetë e njëjtë me atë të tjetrit, për shembull:

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

Ruani dhe hiqni dorë:

:wq!

Kuota e parazgjedhur e memories është shumë e ulët për ekzekutimin e Tomcat 8 dhe XWiki brenda. Ju duhet të rrisni kuotën e paracaktuar të memories si më poshtë përpara se të mund të filloni një shembull XWiki në Tomcat 8 siç duhet.

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

Gjeni rreshtin:

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

Ndryshoni rreshtin siç tregohet më poshtë:

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

Shënim: 1024 M memorie është vetëm kuota minimale për drejtimin e një sajti të vogël ose të mesëm XWiki. Mund t'ju duhet të bëni rregullime në këtë linjë në përputhje me kërkesat tuaja specifike.

Ruani dhe hiqni dorë:

:wq!

Rinisni Tomcat 8 për të vënë në fuqi të gjitha modifikimet tuaja:

sudo systemctl restart tomcat8.service

Modifikoni rregullat e murit të zjarrit UFW për të lejuar aksesin në ueb në port 8080:

sudo ufw allow 8080
sudo ufw enable

Inicializoni XWiki në Distribution Wizardndërfaqen e uebit " "

Në këtë pikë, ju keni vendosur një sajt XWiki funksional por bosh. Për të plotësuar përmbajtjen, duhet të përfundoni disa detyra vijuese, duke përfshirë krijimin e një përdoruesi administratori dhe instalimin e një shije dhe shtesash të nevojshme për këtë wiki, në ndërfaqen fillestare të uebit XWiki me emrin " Distribution Wizard".

Drejtojeni shfletuesin tuaj të preferuar të uebit http://203.0.113.1:8080/xwikinë " Distribution Wizard" dhe do të silleni automatikisht në ndërfaqen e uebit. Klikoni Continuebutonin " " për të filluar magjistarin.

Në faqen " Step 1 - Admin user", duhet të futni kredencialet e përdoruesit të administratorit, për shembull:

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

Pasi të keni plotësuar të gjitha fushat e kërkuara, klikoni Register and loginbutonin " " për të vazhduar më tej.

Në faqen tjetër që tregon " You are connected with user John Doe.", kliko Continuebutonin " " për të krijuar përdoruesin admin John Doeemri i përdoruesit të cilit është johndoedhe vazhdo.

Në faqen " Step 2 - Flavor", klikoni në zonën " XWiki Standard Flavor 9.11.2" për të theksuar këtë shije dhe më pas kliko Install this flavorbutonin " " për të vazhduar më tej.

Në faqen tjetër që detajon " XWiki Standard Flavor 9.11.2", klikoni Installbutonin " " për të kryer instalimin.

Pasi të keni instaluar shijen, të gjitha shtesat e kërkuara do të renditen në faqe, klikoni Continuebutonin " " për t'i instaluar të gjitha.

Pasi të keni instaluar shijen dhe të gjitha shtesat e kërkuara, klikoni Continuebutonin " " në këndin e poshtëm djathtas për të vazhduar.

Në faqen " Step 4 - Report", mund të rishikoni të gjitha faqet e krijuara.

Nëse është e nevojshme, mund të fshini çdo faqe jopopullore duke klikuar Xbutonin përkatës të kuq .

Në fund, klikoni Continuebutonin " " për të përfunduar " Distribution Wizard". Ju do të silleni në panelin e kontrollit të XWiki si përdoruesi i administratorit që kishit konfiguruar më parë.

(Opsionale) Shkurtoni URL-në e sajtit XWiki

Si parazgjedhje, duke qenë se Tomcat mund të shërbejë më shumë se një aplikacion në të njëjtën kohë, ju duhet të hyni në faqen tuaj XWiki në URL http://203.0.113.1:8080/xwiki. Megjithatë, nëse XWiki është i vetmi aplikacion që ekzekutohet në Tomcat dhe dëshironi të shkurtoni URL-në e faqes XWiki duke hequr /xwikiprapashtesën, duhet të modifikoni tre skedarë konfigurimi XWiki si më poshtë.

Modifikimi i skedarit 1:

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

Modifikimi i skedarit 2:

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

Gjeni rreshtin:

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

Ndryshoni vlerën e parametrit të rrugës:

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

Ruani dhe hiqni dorë:

:wq!

Modifikimi i skedarit 3:

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

Gjeni rreshtin:

# xwiki.webapppath=

Zhkomentojeni:

xwiki.webapppath=

Ruani dhe hiqni dorë:

:wq!

Më në fund, rinisni Tomcat 8 në mënyrë që të aplikoni të gjitha modifikimet tuaja:

sudo systemctl restart tomcat8.service

Që tani e tutje, ju do të vizitoni faqen tuaj XWiki nga http://203.0.113.1:8080/direkt.

(Opsionale) Vendosni një përfaqësues të kundërt Nginx

Si parazgjedhje, Tomcat 8 punon në port 8080dhe ju mund të vizitoni faqen tuaj XWiki vetëm nga i njëjti port. Nëse dëshironi të lehtësoni aksesin e vizitorëve duke hequr pjesën e numrit të portit, mund të instaloni Nginx si një përfaqësues të kundërt midis XWiki dhe vizitorëve.

Së pari, instaloni Nginx duke përdorur apt:

sudo apt install nginx -y

Më pas, konfiguroni Nginx si një përfaqësues të kundërt duke modifikuar konfigurimet e paracaktuar të sajtit:

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

Plotësoni skedarin me sa vijon:

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

Ruani dhe hiqni dorë:

:wq!

Nisni shërbimin Nginx dhe vendoseni që të fillojë automatikisht në fillimin e sistemit:

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

Së fundi, modifikoni rregullat e murit të zjarrit UFW në përputhje me rrethanat:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Që tani e tutje, vizitorët në faqen tuaj XWiki nuk kanë më nevojë të specifikojnë numrin e portit. Ata duhet të vizitojnë drejtpërdrejt http://203.0.113.1/.