Sådan installeres XWiki 9.11.x på Ubuntu 16.04 LTS

XWiki er en populær open source wiki-platform på virksomhedsniveau skrevet i Java. Med udvidelsesmuligheder og brugervenlighed bliver XWiki implementeret i forskellige virksomheder som et videnlager, offentlig portal og mere.

I denne artikel vil jeg guide dig gennem processen med at installere XWiki 9.11.2 på en Ubuntu 16.04 LTS-serverinstans. OpenJDK 8, Tomcat 8 og MySQL 5.7 vil automatisk blive installeret som afhængigheder under installationsprocessen.

Forudsætninger

• En frisk Vultr Ubuntu 16.04 LTS x64-serverinstans med mindst 2 GB hukommelse, 4 GB eller mere anbefales. Sig, at dens IP-adresse er 203.0.113.1.
• En sudo-bruger .
• Serverforekomsten er blevet opdateret til den seneste stabile status ved hjælp af apt.

Konfigurer XWiki LTS APT-repoen

Log ind som sudo-bruger, og download og opsæt derefter XWiki LTS (Long Term Support) APT-repoen på din serverinstans:

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

Bemærk: Hvis du vil prøve den seneste stabile XWiki-udgivelse (men IKKE LTS), kan du downloade nedenstående XWiki APT-repo 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 (inklusive XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 og mere.)

Når XWiki installeres i produktionen, skal den arbejde med en Java Servlet-beholder og databasesoftware. Som en fleksibel wiki-platform tilbyder XWiki officielt forskellige integrationsmuligheder. Du kan bruge følgende kommando til at vise alle tilgængelige muligheder i XWiki LTS APT repo:

apt search xwiki

Søgeresultatet 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 bruge XWiki med de mest almindelige afhængigheder, kan du installere alle nødvendige komponenter i én kommando som følger:

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

Under installationsprocessen bliver du bedt om at konfigurere en ny adgangskode til MySQL root-brugeren flere gange. Lad blot adgangskodefeltet stå tomt, og tryk på for Enterat springe dette trin over indtil videre. Vi vil løse dette problem senere, mens vi sikrer installationen af ​​MySQL.

Når du bliver spurgt, om du vil Configure database for xwiki with dbconfig-common?, skal du vælge <Yes>og derefter trykke på ENTER.

Når du bliver bedt om at angive en MySQL application password for xwiki, kan du enten indtaste en specifik MySQL-applikationsadgangskode eller lade adgangskodefeltet stå tomt. Sidstnævnte vil fortælle XWiki at bruge en tilfældig MySQL-applikationsadgangskode.

Når XWiki og alle de nødvendige afhængigheder er installeret, skal du sikre installationen af ​​MySQL:

sudo /usr/bin/mysql_secure_installation

Under processen vil programmet stille dig et par spørgsmål. Svar til dem som nedenfor:

• Vil du konfigurere VALIDATE PASSWORD plugin? Y
• Indtast venligst 0 = LAV, 1 = MIDDEL og 2 = STÆRK: 2
• Nyt kodeord: a-strong-MySQL-root-password
• Indtast ny adgangskode igen: a-strong-MySQL-root-password
• Ønsker du at fortsætte med den angivne adgangskode? Y
• Vil du fjerne anonyme brugere? Y
• Vil du ikke tillade root-login eksternt? Y
• Vil du fjerne testdatabasen og få adgang til den? Y
• Genindlæse privilegietabeller nu? Y

Forbedre sikkerheden i XWiki ved at ændre XWiki-konfigurationsfilen.

Brug vi-editoren til at åbne en XWiki-konfigurationsfil:

sudo vi /etc/xwiki/xwiki.cfg

Find de to linjer vist nedenfor:

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

Erstat begge parametres værdier med to forskellige tilfældige strenge, og sørg bare for, at længden af ​​hver streng er den samme som den anden, for eksempel:

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

Gem og luk:

:wq!

Standardhukommelseskvoten er for lav til at køre Tomcat 8 og XWiki inden for. Du skal øge standardhukommelseskvoten som følger, før du kan starte en XWiki-instans i Tomcat 8 korrekt.

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

Find linjen:

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

Rediger linjen som vist nedenfor:

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

Bemærk: 1024M hukommelse er kun minimumskvoten for at køre et lille eller mellemstort XWiki-websted. Du skal muligvis foretage justeringer af denne linje i overensstemmelse med dine specifikke krav.

Gem og luk:

:wq!

Genstart Tomcat 8 for at sætte alle dine ændringer i kraft:

sudo systemctl restart tomcat8.service

Rediger UFW firewall regler for at tillade webadgang på porten 8080:

sudo ufw allow 8080
sudo ufw enable

Initialiser XWiki på " Distribution Wizard" webgrænsefladen

På dette tidspunkt har du opsat et funktionelt, men tomt XWiki-websted. For at udfylde indhold skal du afslutte adskillige opfølgningsopgaver, herunder oprettelse af en administratorbruger og installation af en variant og nødvendige udvidelser til denne wiki, på den indledende XWiki-webgrænseflade med navnet " Distribution Wizard".

Peg din yndlingswebbrowser til http://203.0.113.1:8080/xwiki, og du vil automatisk blive bragt til " Distribution Wizard" webgrænsefladen. Klik på knappen " Continue" for at starte guiden.

På siden " Step 1 - Admin user" skal du indtaste administratorbrugerens legitimationsoplysninger, for eksempel:

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

Efter at have udfyldt alle de påkrævede felter, klik på knappen " Register and login" for at gå videre.

På den næste side, der viser " You are connected with user John Doe.", skal du klikke på knappen " Continue" for at oprette den admin-bruger, John Doehvis brugernavn er, johndoeog gå videre.

På siden " Step 2 - Flavor" skal du klikke på området " XWiki Standard Flavor 9.11.2" for at fremhæve denne smag, og derefter klikke på knappen " Install this flavor" for at gå videre.

På den næste side, som beskriver " XWiki Standard Flavor 9.11.2", skal du klikke på knappen " Install" for at udføre installationen.

Når smagen er installeret, vil alle de nødvendige udvidelser blive vist på siden, klik på knappen " Continue" for at installere dem alle.

Når smagen og alle de nødvendige udvidelser er installeret, skal du klikke på knappen " Continue" i nederste højre hjørne for at komme videre.

På siden " Step 4 - Report" kan du gennemgå alle de oprettede sider.

Om nødvendigt kan du slette upopulære sider ved at klikke på den tilsvarende røde Xknap.

Klik til sidst på knappen " Continue" for at afslutte " Distribution Wizard". Du vil blive bragt ind i XWiki-dashboardet som den admin-bruger, du havde konfigureret tidligere.

(Valgfrit) Forkort XWiki-webstedets URL

Som standard, da Tomcat kan betjene mere end én applikation på samme tid, skal du tilgå dit XWiki-websted på URL'en http://203.0.113.1:8080/xwiki. Men hvis XWiki er det eneste program, der kører i Tomcat, og du ønsker at forkorte XWiki-webstedets URL ved at fjerne /xwikisuffikset, bør du ændre tre XWiki-konfigurationsfiler som følger.

Filændring 1:

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

Filændring 2:

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

Find linjen:

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

Rediger værdien af ​​stiparameteren:

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

Gem og luk:

:wq!

Filændring 3:

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

Find linjen:

# xwiki.webapppath=

Fjern kommentarer:

xwiki.webapppath=

Gem og luk:

:wq!

Til sidst skal du genstarte Tomcat 8 for at anvende alle dine ændringer:

sudo systemctl restart tomcat8.service

Fra nu af vil du besøge dit XWiki-websted http://203.0.113.1:8080/direkte fra .

(Valgfrit) Konfigurer en Nginx omvendt proxy

Som standard fungerer Tomcat 8 på port 8080, og du kan kun besøge dit XWiki-websted fra den samme port. Hvis du vil lette besøgendes adgang ved at fjerne portnummerdelen, kan du installere Nginx som en omvendt proxy mellem XWiki og besøgende.

Først skal du installere Nginx ved hjælp af apt:

sudo apt install nginx -y

Dernæst skal du konfigurere Nginx som en omvendt proxy ved at ændre dens standardwebstedskonfigurationer:

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

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

Gem og luk:

:wq!

Start Nginx-tjenesten og indstil den til automatisk at starte ved systemstart:

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

Til sidst skal du ændre UFW firewall-reglerne i overensstemmelse hermed:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Fra nu af behøver besøgende på dit XWiki-websted ikke længere at angive portnummeret. De bør besøge direkte http://203.0.113.1/.