Hvernig á að setja upp XWiki 9.11.x á Ubuntu 16.04 LTS

XWiki er vinsæll, opinn uppspretta wiki vettvangur á fyrirtækjastigi skrifaður á Java. Með stækkanleika og auðveldri notkun er XWiki notað í ýmsum fyrirtækjum sem þekkingargeymsla, opinber vefgátt og fleira.

Í þessari grein mun ég leiðbeina þér í gegnum ferlið við að setja upp XWiki 9.11.2 á Ubuntu 16.04 LTS netþjónstilviki. OpenJDK 8, Tomcat 8 og MySQL 5.7 verða sjálfkrafa sett upp sem ósjálfstæði meðan á uppsetningarferlinu stendur.

Forkröfur

• Nýtt Vultr Ubuntu 16.04 LTS x64 netþjónstilvik með að minnsta kosti 2GB af minni, 4GB eða meira mælt með. Segðu að IP tölu þess sé 203.0.113.1.
• A sudo notandi .
• Netþjónstilvikið hefur verið uppfært í nýjustu stöðugu stöðuna með því að nota apt.

Settu upp XWiki LTS APT endurhverfan

Skráðu þig inn sem sudo notandi og halaðu síðan niður og settu upp XWiki LTS (Long Term Support) APT endurhverfan á netþjóninum þínum:

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

Athugið: Ef þú vilt prófa nýjustu stöðugu XWiki útgáfuna (en EKKI LTS), geturðu hlaðið niður XWiki APT endurhverfum í staðinn:

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

Settu upp allt í einu XWiki búnt (þar á meðal XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 og fleira.)

Þegar það er notað í framleiðslu þarf XWiki að vinna með Java Servlet ílát og gagnagrunnshugbúnað. Sem sveigjanlegur wiki vettvangur býður XWiki opinberlega upp á ýmsa samþættingarvalkosti. Þú getur notað eftirfarandi skipun til að sýna alla tiltæka valkosti í XWiki LTS APT endurhverfu:

apt search xwiki

Leitarniðurstaðan mun líkjast eftirfarandi:

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

Ef þú vilt nota XWiki með algengustu ósjálfstæði geturðu sett upp alla nauðsynlega hluti í einni skipun sem hér segir:

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

Meðan á uppsetningarferlinu stendur verður þú beðinn um að setja upp nýtt lykilorð fyrir MySQL rót notandann nokkrum sinnum. Skildu lykilorðareitinn eftir auðan og ýttu á Entertil að sleppa þessu skrefi í bili. Við munum takast á við þetta vandamál síðar á meðan við tryggjum uppsetningu MySQL.

Þegar spurt er hvort þú viljir það Configure database for xwiki with dbconfig-common?skaltu velja <Yes>og ýta svo á ENTER.

Þegar þú ert beðinn um að gefa upp MySQL application password for xwiki, geturðu annað hvort sett inn ákveðið MySQL forritslykilorð eða skilið lykilorðareitinn eftir auðan. Hið síðarnefnda mun segja XWiki að nota handahófskennt MySQL forritslykilorð.

Að hafa XWiki og allar nauðsynlegar ósjálfstæði uppsett, tryggðu uppsetningu MySQL:

sudo /usr/bin/mysql_secure_installation

Meðan á ferlinu stendur mun forritið spyrja þig nokkurra spurninga. Svaraðu þeim eins og hér að neðan:

• Viltu setja upp VALIDATE PASSWORD viðbótina? Y
• Vinsamlega sláðu inn 0 = LÁGT, 1 = miðlungs og 2 = STERKT: 2
• Nýtt lykilorð: a-strong-MySQL-root-password
• Sláðu inn nýtt lykilorð aftur: a-strong-MySQL-root-password
• Viltu halda áfram með uppgefið lykilorð? Y
• Fjarlægja nafnlausa notendur? Y
• Banna rótarinnskráningu fjarstýrt? Y
• Fjarlægja prófunargagnagrunn og aðgang að honum? Y
• Endurhlaða forréttindatöflur núna? Y

Auktu öryggi XWiki með því að breyta XWiki stillingarskránni.

Notaðu vi ritstjórann til að opna XWiki stillingarskrá:

sudo vi /etc/xwiki/xwiki.cfg

Finndu tvær línur sem sýndar eru hér að neðan:

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

Skiptu um gildi beggja færibreytanna fyrir tvo mismunandi handahófskennda strengi og vertu viss um að lengd hvers strengs sé sú sama og hins, til dæmis:

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

Vista og hætta:

:wq!

Sjálfgefinn minniskvóti er of lágur til að keyra Tomcat 8 og XWiki innan. Þú þarft að auka sjálfgefna minniskvótann eins og hér segir áður en þú getur byrjað XWiki dæmi í Tomcat 8 almennilega.

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

Finndu línuna:

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

Breyttu línunni eins og sýnt er hér að neðan:

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

Athugið: 1024M af minni er aðeins lágmarkskvóti til að reka litla eða meðalstóra XWiki síðu. Þú gætir þurft að gera breytingar á þessari línu í samræmi við sérstakar kröfur þínar.

Vista og hætta:

:wq!

Endurræstu Tomcat 8 til að koma öllum breytingum þínum í gildi:

sudo systemctl restart tomcat8.service

Breyttu UFW eldveggsreglum til að leyfa vefaðgang á höfn 8080:

sudo ufw allow 8080
sudo ufw enable

Frumstilla XWiki á " Distribution Wizard" vefviðmótinu

Á þessum tímapunkti hefurðu sett upp virka en tóma XWiki síðu. Til að fylla út efni þarftu að klára nokkur eftirfylgniverk, þar á meðal að búa til stjórnandanotanda og setja upp bragðtegund og nauðsynlegar viðbætur fyrir þessa wiki, á upphaflegu XWiki vefviðmótinu sem heitir " Distribution Wizard".

Beindu uppáhalds vefvafranum þínum á http://203.0.113.1:8080/xwikiog þú færð sjálfkrafa inn á " Distribution Wizard" vefviðmótið. Smelltu á " Continue" hnappinn til að hefja töframanninn.

Á síðunni " Step 1 - Admin user" þarftu að slá inn skilríki stjórnanda notandans, til dæmis:

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

Eftir að hafa fyllt út alla nauðsynlega reiti, smelltu á " Register and login" hnappinn til að halda áfram.

Á næstu síðu sem sýnir " You are connected with user John Doe.", smelltu á " Continue" hnappinn til að búa til admin notanda John Doesem hefur notandanafnið johndoeog halda áfram.

Á síðunni " Step 2 - Flavor", smelltu á " XWiki Standard Flavor 9.11.2" svæðið til að auðkenna þessa bragðtegund og smelltu síðan á " Install this flavor" hnappinn til að halda áfram.

Á næstu síðu sem sýnir " XWiki Standard Flavor 9.11.2", smelltu á " Install" hnappinn til að framkvæma uppsetninguna.

Þegar bragðið hefur verið sett upp verða allar nauðsynlegar viðbætur skráðar á síðunni, smelltu á " Continue" hnappinn til að setja þær allar upp.

Þegar þú hefur bragðið og allar nauðsynlegar viðbætur settar upp skaltu smella á " Continue" hnappinn neðst í hægra horninu til að halda áfram.

Á síðunni " Step 4 - Report" geturðu skoðað allar þær síður sem búið er til.

Ef nauðsyn krefur geturðu eytt óvinsælum síðum með því að smella á samsvarandi rauða Xhnappinn.

Að lokum skaltu smella á " Continue" hnappinn til að klára " Distribution Wizard". Þú verður færður inn á XWiki mælaborðið sem stjórnandanotandinn sem þú hafðir sett upp áðan.

(Valfrjálst) Styttu vefslóð XWiki síðunnar

Sjálfgefið, þar sem Tomcat getur þjónað fleiri en einu forriti á sama tíma, þarftu að komast inn á XWiki síðuna þína á slóðinni http://203.0.113.1:8080/xwiki. Hins vegar, ef XWiki er eina forritið sem keyrir í Tomcat og þú vilt stytta vefslóð XWiki síðunnar með því að fjarlægja /xwikiviðskeyti, ættir þú að breyta þremur XWiki stillingarskrám sem hér segir.

Skráarbreyting 1:

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

Skráarbreyting 2:

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

Finndu línuna:

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

Breyttu gildi slóðarbreytunnar:

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

Vista og hætta:

:wq!

Skráarbreyting 3:

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

Finndu línuna:

# xwiki.webapppath=

Afskrifaðu það:

xwiki.webapppath=

Vista og hætta:

:wq!

Að lokum skaltu endurræsa Tomcat 8 til að beita öllum breytingum þínum:

sudo systemctl restart tomcat8.service

Héðan í frá muntu heimsækja XWiki síðuna þína http://203.0.113.1:8080/beint frá .

(Valfrjálst) Settu upp Nginx öfugt umboð

Sjálfgefið er að Tomcat 8 virkar á höfn 8080og þú getur aðeins heimsótt XWiki síðuna þína frá sömu höfn. Ef þú vilt auðvelda aðgang gesta með því að fjarlægja gáttarnúmershlutann geturðu sett upp Nginx sem öfugt umboð milli XWiki og gesta.

Settu fyrst upp Nginx með því að nota apt:

sudo apt install nginx -y

Næst skaltu setja Nginx upp sem öfugt umboð með því að breyta sjálfgefnum síðustillingum:

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

Fylltu út skrána með eftirfarandi:

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

Vista og hætta:

:wq!

Ræstu Nginx þjónustuna og stilltu hana þannig að hún ræsist sjálfkrafa við ræsingu kerfisins:

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

Að lokum, breyttu UFW eldveggsreglunum í samræmi við það:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Héðan í frá þurfa gestir á XWiki síðunni þinni ekki lengur að tilgreina gáttarnúmerið. Þeir ættu að heimsækja beint http://203.0.113.1/.