Hur man installerar XWiki 9.11.x på Ubuntu 16.04 LTS

XWiki är en populär wikiplattform med öppen källkod på företagsnivå skriven i Java. Med utökningsbarhet och användarvänlighet distribueras XWiki i olika företag som ett kunskapsförråd, offentlig portal och mer.

I den här artikeln kommer jag att guida dig genom processen att installera XWiki 9.11.2 på en Ubuntu 16.04 LTS-serverinstans. OpenJDK 8, Tomcat 8 och MySQL 5.7 kommer automatiskt att installeras som beroenden under installationsprocessen.

Förutsättningar

• En fräsch Vultr Ubuntu 16.04 LTS x64-serverinstans med minst 2 GB minne, 4 GB eller mer rekommenderas. Säg att dess IP-adress är 203.0.113.1.
• En sudo-användare .
• Serverinstansen har uppdaterats till den senaste stabila statusen med apt.

Ställ in XWiki LTS APT-repo

Logga in som sudo-användare och ladda sedan ner och ställ in XWiki LTS (Long Term Support) APT-repo 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

Obs: Om du vill prova den senaste stabila XWiki-utgåvan (men INTE LTS), kan du ladda ner nedanstående XWiki APT-repo istället:

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

Installera allt i ett XWiki-paket (inklusive XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 och mer.)

När XWiki används i produktionen måste den fungera med en Java Servlet-behållare och databasprogramvara. Som en flexibel wiki-plattform erbjuder XWiki officiellt olika integrationsalternativ. Du kan använda följande kommando för att visa alla tillgängliga alternativ i XWiki LTS APT-repo:

apt search xwiki

Sökresultatet kommer att likna följande:

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

Om du vill använda XWiki med de vanligaste beroenden kan du installera alla nödvändiga komponenter i ett kommando enligt följande:

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

Under installationsprocessen kommer du att bli ombedd att ställa in ett nytt lösenord för MySQL root-användaren flera gånger. Lämna bara lösenordsfältet tomt och tryck på för Enteratt hoppa över detta steg tills vidare. Vi kommer att ta itu med det här problemet senare samtidigt som vi säkrar installationen av MySQL.

När du får frågan om du vill Configure database for xwiki with dbconfig-common?, välj <Yes>och tryck sedan på ENTER.

När du blir ombedd att ange ett MySQL application password for xwiki, kan du antingen ange ett specifikt MySQL-programlösenord eller lämna lösenordsfältet tomt. Den senare kommer att berätta för XWiki att använda ett slumpmässigt MySQL-programlösenord.

Säkra installationen av MySQL med XWiki och alla nödvändiga beroenden installerade:

sudo /usr/bin/mysql_secure_installation

Under processen kommer programmet att ställa några frågor till dig. Svara dem enligt nedan:

• Vill du konfigurera pluginet VALIDATE PASSWORD? Y
• Ange 0 = LÅG, 1 = MEDIUM och 2 = STARK: 2
• Nytt lösenord: a-strong-MySQL-root-password
• Ange nytt lösenord igen: a-strong-MySQL-root-password
• Vill du fortsätta med det angivna lösenordet? Y
• Ta bort anonyma användare? Y
• Vill du inte tillåta root-inloggning på distans? Y
• Ta bort testdatabasen och få tillgång till den? Y
• Ladda om privilegietabeller nu? Y

Förbättra säkerheten för XWiki genom att ändra XWiki-konfigurationsfilen.

Använd vi-redigeraren för att öppna en XWiki-konfigurationsfil:

sudo vi /etc/xwiki/xwiki.cfg

Hitta de två raderna som visas nedan:

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

Ersätt båda parametrarnas värden med två olika slumpmässiga strängar, och se bara till att längden på varje sträng är densamma som den andra, till exempel:

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

Spara och avsluta:

:wq!

Standardminneskvoten är för låg för att köra Tomcat 8 och XWiki inom. Du måste öka standardminneskvoten enligt följande innan du kan starta en XWiki-instans i Tomcat 8 ordentligt.

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

Hitta raden:

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

Ändra raden enligt nedan:

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

Obs: 1024 miljoner minne är bara den minsta kvoten för att köra en liten eller medelstor XWiki-sajt. Du kan behöva göra justeringar av denna linje i enlighet med dina specifika krav.

Spara och avsluta:

:wq!

Starta om Tomcat 8 för att sätta alla dina ändringar i kraft:

sudo systemctl restart tomcat8.service

Ändra UFW-brandväggsregler för att tillåta webbåtkomst på porten 8080:

sudo ufw allow 8080
sudo ufw enable

Initiera XWiki på " Distribution Wizard" webbgränssnittet

Vid det här laget har du skapat en funktionell men tom XWiki-webbplats. För att fylla i innehåll måste du slutföra flera uppföljningsuppgifter, inklusive att skapa en administratörsanvändare och installera en variant och nödvändiga tillägg för denna wiki, på det ursprungliga XWiki-webbgränssnittet med namnet " Distribution Wizard".

Peka på din favoritwebbläsare http://203.0.113.1:8080/xwikiså kommer du automatiskt till " Distribution Wizard" webbgränssnittet. Klicka på Continueknappen " " för att starta guiden.

På Step 1 - Admin usersidan " " måste du ange administratörens användaruppgifter, till exempel:

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

Efter att ha fyllt i alla obligatoriska fält, klicka på Register and loginknappen " " för att gå vidare.

På nästa sida som visar " You are connected with user John Doe.", klicka på Continueknappen " " för att skapa administratörsanvändaren John Doevars användarnamn är johndoeoch gå vidare.

På Step 2 - Flavorsidan " " klickar du på området " XWiki Standard Flavor 9.11.2" för att markera denna smak och klickar sedan på Install this flavorknappen " " för att gå vidare.

På nästa sida som beskriver " XWiki Standard Flavor 9.11.2", klicka på Installknappen " " för att utföra installationen.

När smaken är installerad kommer alla nödvändiga tillägg att listas på sidan, klicka på Continueknappen " " för att installera dem alla.

När du har smaken och alla nödvändiga tillägg installerade klickar du på Continueknappen " " i det nedre högra hörnet för att gå vidare.

På Step 4 - Reportsidan " " kan du granska alla skapade sidor.

Om det behövs kan du ta bort alla impopulära sidor genom att klicka på motsvarande röda Xknapp.

Klicka slutligen på Continueknappen " " för att avsluta " Distribution Wizard". Du kommer att tas in i XWiki-instrumentpanelen som administratörsanvändaren du hade konfigurerat tidigare.

(Valfritt) Förkorta webbadressen till XWiki-webbplatsen

Som standard, eftersom Tomcat kan tjäna mer än ett program samtidigt, måste du komma åt din XWiki-webbplats på URL:en http://203.0.113.1:8080/xwiki. Men om XWiki är det enda programmet som körs i Tomcat och du vill förkorta XWiki-webbplatsens URL genom att ta bort /xwikisuffixet, bör du ändra tre XWiki-konfigurationsfiler enligt följande.

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

Hitta raden:

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

Ändra värdet på sökvägsparametern:

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

Spara och avsluta:

:wq!

Filändring 3:

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

Hitta raden:

# xwiki.webapppath=

Avkommentera det:

xwiki.webapppath=

Spara och avsluta:

:wq!

Slutligen, starta om Tomcat 8 för att tillämpa alla dina ändringar:

sudo systemctl restart tomcat8.service

Från och med nu kommer du att besöka din XWiki-webbplats från http://203.0.113.1:8080/direkt.

(Valfritt) Ställ in en Nginx omvänd proxy

Som standard fungerar Tomcat 8 på port 8080, och du kan bara besöka din XWiki-webbplats från samma port. Om du vill underlätta besökarnas åtkomst genom att ta bort portnummerdelen kan du installera Nginx som en omvänd proxy mellan XWiki och besökare.

Installera först Nginx med apt:

sudo apt install nginx -y

Ställ sedan in Nginx som en omvänd proxy genom att ändra dess standardwebbkonfigurationer:

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

Fyll i filen med följande:

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

Spara och avsluta:

:wq!

Starta Nginx-tjänsten och ställ in den så att den startar automatiskt vid systemstart:

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

Ändra slutligen UFW-brandväggsreglerna i enlighet med detta:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

Från och med nu behöver besökare på din XWiki-webbplats inte längre ange portnumret. De bör besöka direkt http://203.0.113.1/.