Slik installerer du XWiki 9.11.x på Ubuntu 16.04 LTS

XWiki er en populær åpen kildekode-wiki-plattform på bedriftsnivå skrevet i Java. Med utvidbarhet og brukervennlighet blir XWiki distribuert i forskjellige selskaper som et kunnskapslager, offentlig portal og mer.

I denne artikkelen vil jeg veilede deg gjennom prosessen med å installere XWiki 9.11.2 på en Ubuntu 16.04 LTS-serverforekomst. OpenJDK 8, Tomcat 8 og MySQL 5.7 vil automatisk bli installert som avhengigheter under installasjonsprosessen.

Forutsetninger

• En fersk Vultr Ubuntu 16.04 LTS x64-serverforekomst med minst 2 GB minne, 4 GB eller mer anbefales. Si at IP-adressen er 203.0.113.1.
• En sudo-bruker .
• Serverforekomsten har blitt oppdatert til siste stabile status ved hjelp av apt.

Sett opp XWiki LTS APT-repoen

Logg på som sudo-bruker, og last ned og konfigurer XWiki LTS (Long Term Support) APT-repo på serverforekomsten din:

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

Merk: Hvis du vil prøve den siste stabile XWiki-utgivelsen (men IKKE LTS), kan du laste ned XWiki APT-repoen nedenfor i stedet:

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

Installer alt i én XWiki-pakke (inkludert XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 og mer.)

Når den brukes i produksjon, må XWiki fungere med en Java Servlet-beholder og databaseprogramvare. Som en fleksibel wiki-plattform tilbyr XWiki offisielt ulike integreringsalternativer. Du kan bruke følgende kommando for å vise alle tilgjengelige alternativer i XWiki LTS APT-repoen:

apt search xwiki

Søkeresultatet vil ligne følgende:

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

Hvis du vil bruke XWiki med de vanligste avhengighetene, kan du installere alle nødvendige komponenter i én kommando som følger:

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

Under installasjonsprosessen vil du bli bedt om å sette opp et nytt passord for MySQL root-brukeren flere ganger. Bare la passordfeltet stå tomt og trykk for Enterå hoppe over dette trinnet for nå. Vi vil takle dette problemet senere mens vi sikrer installasjonen av MySQL.

Når du blir spurt om du vil Configure database for xwiki with dbconfig-common?, velg <Yes>og trykk deretter ENTER.

Når du blir bedt om å oppgi en MySQL application password for xwiki, kan du enten skrive inn et spesifikt MySQL-applikasjonspassord eller la passordfeltet stå tomt. Sistnevnte vil fortelle XWiki å bruke et tilfeldig MySQL-applikasjonspassord.

Når XWiki og alle nødvendige avhengigheter er installert, sikrer du installasjonen av MySQL:

sudo /usr/bin/mysql_secure_installation

I løpet av prosessen vil programmet stille deg noen spørsmål. Svar dem som nedenfor:

• Vil du sette opp VALIDATE PASSWORD-plugin? Y
• Vennligst skriv inn 0 = LAV, 1 = MIDDELS og 2 = STERK: 2
• Nytt passord: a-strong-MySQL-root-password
• Skriv inn nytt passord på nytt: a-strong-MySQL-root-password
• Ønsker du å fortsette med passordet som er oppgitt? Y
• Vil du fjerne anonyme brukere? Y
• Vil du ikke tillate root-pålogging eksternt? Y
• Vil du fjerne testdatabasen og få tilgang til den? Y
• Laste inn rettighetstabeller på nytt nå? Y

Forbedre sikkerheten til XWiki ved å endre XWiki-konfigurasjonsfilen.

Bruk vi-editoren til å åpne en XWiki-konfigurasjonsfil:

sudo vi /etc/xwiki/xwiki.cfg

Finn de to linjene vist nedenfor:

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

Erstatt begge parameternes verdier med to forskjellige tilfeldige strenger, og sørg bare for at lengden på hver streng er den samme som den andre, for eksempel:

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

Lagre og avslutt:

:wq!

Standard minnekvote er for lav for å kjøre Tomcat 8 og XWiki innenfor. Du må øke standard minnekvote som følger før du kan starte en XWiki-forekomst i Tomcat 8 riktig.

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

Finn linjen:

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

Endre linjen som vist nedenfor:

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

Merk: 1024M minne er bare minimumskvoten for å kjøre et lite eller mellomstort XWiki-nettsted. Det kan hende du må gjøre justeringer på denne linjen i samsvar med dine spesifikke krav.

Lagre og avslutt:

:wq!

Start Tomcat 8 på nytt for å få alle endringene dine i kraft:

sudo systemctl restart tomcat8.service

Endre UFW-brannmurregler for å tillate nettilgang på porten 8080:

sudo ufw allow 8080
sudo ufw enable

Initialiser XWiki på " Distribution Wizard" webgrensesnittet

På dette tidspunktet har du satt opp en funksjonell, men tom XWiki-side. For å fylle ut innhold, må du fullføre flere oppfølgingsoppgaver, inkludert å opprette en admin-bruker og installere en smak og nødvendige utvidelser for denne wikien, på det første XWiki-nettgrensesnittet kalt " Distribution Wizard".

Pek på favorittnettleseren din http://203.0.113.1:8080/xwiki, og du kommer automatisk til " Distribution Wizard" nettgrensesnittet. Klikk på " Continue"-knappen for å starte veiviseren.

På siden " Step 1 - Admin user" må du skrive inn administratorbrukerens legitimasjon, for eksempel:

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

Etter å ha fylt ut alle de obligatoriske feltene, klikk på Register and loginknappen " " for å gå videre.

På neste side som viser " You are connected with user John Doe.", klikker du på " Continue"-knappen for å opprette administratorbrukeren John Doehvis brukernavn er johndoeog gå videre.

På " Step 2 - Flavor"-siden klikker du på " XWiki Standard Flavor 9.11.2"-området for å markere denne smaken, og klikker deretter på " Install this flavor"-knappen for å gå videre.

På neste side med detaljer om " XWiki Standard Flavor 9.11.2", klikk på " Install"-knappen for å utføre installasjonen.

Når smaken er installert, vil alle de nødvendige utvidelsene bli oppført på siden, klikk på " Continue"-knappen for å installere dem alle.

Når du har smaken og alle nødvendige utvidelser installert, klikker du på Continueknappen " " nederst til høyre for å gå videre.

På siden " Step 4 - Report" kan du se gjennom alle sidene som er opprettet.

Om nødvendig kan du slette eventuelle upopulære sider ved å klikke på den tilsvarende røde Xknappen.

Til slutt klikker du på " Continue"-knappen for å fullføre " Distribution Wizard". Du vil bli brakt inn i XWiki-dashbordet som administratorbrukeren du hadde konfigurert tidligere.

(Valgfritt) Forkort XWiki-nettstedets URL

Som standard, siden Tomcat kan betjene mer enn én applikasjon samtidig, må du få tilgang til XWiki-siden din på URL-en http://203.0.113.1:8080/xwiki. Men hvis XWiki er det eneste programmet som kjører i Tomcat og du ønsker å forkorte XWiki-nettstedets URL ved å fjerne /xwikisuffikset, bør du endre tre XWiki-konfigurasjonsfiler som følger.

Filendring 1:

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

Filendring 2:

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

Finn linjen:

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

Endre verdien til baneparameteren:

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

Lagre og avslutt:

:wq!

Filendring 3:

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

Finn linjen:

# xwiki.webapppath=

Fjern kommentaren:

xwiki.webapppath=

Lagre og avslutt:

:wq!

Til slutt, start Tomcat 8 på nytt for å bruke alle endringene dine:

sudo systemctl restart tomcat8.service

Fra nå av vil du besøke XWiki-siden din http://203.0.113.1:8080/direkte fra.

(Valgfritt) Sett opp en Nginx omvendt proxy

Som standard fungerer Tomcat 8 på port 8080, og du kan bare besøke XWiki-siden din fra samme port. Hvis du ønsker å lette besøkendes tilgang ved å fjerne portnummerdelen, kan du installere Nginx som en omvendt proxy mellom XWiki og besøkende.

Installer først Nginx med apt:

sudo apt install nginx -y

Deretter konfigurerer du Nginx som en omvendt proxy ved å endre standardkonfigurasjonene for nettstedet:

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

Fyll ut filen med følgende:

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

Lagre og avslutt:

:wq!

Start Nginx-tjenesten og sett den til å starte automatisk ved systemstart:

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

Til slutt, endre UFW-brannmurreglene tilsvarende:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Fra nå av trenger ikke besøkende på XWiki-nettstedet lenger å spesifisere portnummeret. De bør besøke direkte http://203.0.113.1/.