Com instal·lar XWiki 9.11.x a Ubuntu 16.04 LTS

XWiki és una plataforma wiki de codi obert popular a nivell empresarial escrita en Java. Amb extensibilitat i facilitat d'ús, XWiki s'està desplegant en diverses empreses com a dipòsit de coneixement, portal públic i molt més.

En aquest article, us guiaré pel procés d'instal·lació de XWiki 9.11.2 en una instància del servidor Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 i MySQL 5.7 s'instal·laran automàticament com a dependències durant el procés d'instal·lació.

Requisits previs

• Una nova instància de servidor Vultr Ubuntu 16.04 LTS x64 amb almenys 2 GB de memòria, 4 GB o més recomanats. Diguem que la seva adreça IP és 203.0.113.1.
• Un usuari de sudo .
• La instància del servidor s'ha actualitzat a l'estat estable més recent mitjançant apt.

Configura el repositori XWiki LTS APT

Inicieu sessió com a usuari sudo i, a continuació, descarregueu i configureu el repositori APT de XWiki LTS (Long Term Support) a la vostra instància de servidor:

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

Nota: si voleu provar l'última versió estable de XWiki (però NO LTS), podeu descarregar el repositori XWiki APT següent:

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

Instal·leu el paquet XWiki tot en un (incloent XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 i més.)

Quan es desplega en producció, XWiki necessita treballar amb un contenidor Java Servlet i un programari de base de dades. Com a plataforma wiki flexible, XWiki ofereix oficialment diverses opcions d'integració. Podeu utilitzar l'ordre següent per mostrar totes les opcions disponibles al repositori XWiki LTS APT:

apt search xwiki

El resultat de la cerca s'assemblarà al següent:

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

Si voleu utilitzar XWiki amb les dependències més habituals, podeu instal·lar tots els components necessaris en una ordre de la següent manera:

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

Durant el procés d'instal·lació, se us demanarà que configureu una nova contrasenya per a l'usuari root de MySQL diverses vegades. Deixeu el camp de la contrasenya en blanc i premeu Enterper ometre aquest pas de moment. Afrontarem aquest problema més endavant mentre assegurem la instal·lació de MySQL.

Quan se us pregunti si voleu Configure database for xwiki with dbconfig-common?, seleccioneu <Yes>i premeu ENTER.

Quan se us demani que proporcioneu un MySQL application password for xwiki, podeu introduir una contrasenya específica de l'aplicació MySQL o deixar el camp de la contrasenya en blanc. Aquest últim dirà a XWiki que utilitzi una contrasenya aleatòria d'aplicació MySQL.

Tenint instal·lat XWiki i totes les dependències necessàries, assegureu la instal·lació de MySQL:

sudo /usr/bin/mysql_secure_installation

Durant el procés, el programa us farà algunes preguntes. Respon-los de la següent manera:

• Voleu configurar el connector VALIDA LA CONTRASENYA? Y
• Introduïu 0 = BAIX, 1 = MITJÀ i 2 = FORT: 2
• Nova contrasenya: a-strong-MySQL-root-password
• Torneu a introduir la contrasenya nova: a-strong-MySQL-root-password
• Voleu continuar amb la contrasenya proporcionada? Y
• Vols suprimir usuaris anònims? Y
• No permeteu l'inici de sessió d'arrel de forma remota? Y
• Eliminar la base de dades de prova i accedir-hi? Y
• Torneu a carregar les taules de privilegis ara? Y

Milloreu la seguretat de XWiki modificant el fitxer de configuració de XWiki.

Utilitzeu l'editor vi per obrir un fitxer de configuració XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Busca les dues línies que es mostren a continuació:

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

Substituïu els valors dels dos paràmetres per dues cadenes aleatòries diferents i només assegureu-vos que la longitud de cada cadena sigui la mateixa que l'altra, per exemple:

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

Desa i surt:

:wq!

La quota de memòria predeterminada és massa baixa per executar Tomcat 8 i XWiki. Heu d'augmentar la quota de memòria predeterminada de la manera següent abans de poder iniciar correctament una instància XWiki al Tomcat 8.

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

Troba la línia:

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

Modifiqueu la línia tal com es mostra a continuació:

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

Nota: 1024 M de memòria són només la quota mínima per executar un lloc XWiki petit o mitjà. És possible que hàgiu de fer ajustos a aquesta línia d'acord amb les vostres demandes específiques.

Desa i surt:

:wq!

Reinicieu Tomcat 8 per tal d'aplicar totes les vostres modificacions:

sudo systemctl restart tomcat8.service

Modifiqueu les regles del tallafoc UFW per permetre l'accés web al port 8080:

sudo ufw allow 8080
sudo ufw enable

Inicialitzeu XWiki a la " Distribution Wizard" interfície web

En aquest punt, heu configurat un lloc XWiki funcional però buit. Per omplir el contingut, heu d'acabar diverses tasques de seguiment, inclosa la creació d'un usuari administrador i la instal·lació d'un tipus i les extensions necessàries per a aquest wiki, a la interfície web inicial de XWiki anomenada " Distribution Wizard".

Apunteu el vostre navegador web preferit a http://203.0.113.1:8080/xwiki, i se us portarà automàticament a la " Distribution Wizard" interfície web. Feu clic al Continuebotó " " per iniciar l'assistent.

A la Step 1 - Admin userpàgina " ", heu d'introduir les credencials de l'usuari administrador, per exemple:

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

Després d'omplir tots els camps obligatoris, feu clic al Register and loginbotó " " per continuar.

A la pàgina següent que mostra " You are connected with user John Doe.", feu clic al Continuebotó " " per crear l'usuari administrador John Doeel nom d' usuari del qual és johndoei seguir endavant.

A la Step 2 - Flavorpàgina " ", feu clic a l' XWiki Standard Flavor 9.11.2àrea " " per ressaltar aquest sabor i, a continuació, feu clic al Install this flavorbotó " " per continuar.

A la pàgina següent on es detalla el " XWiki Standard Flavor 9.11.2", feu clic al Installbotó " " per dur a terme la instal·lació.

Tenint el gust instal·lat, totes les extensions necessàries es mostraran a la pàgina, feu clic al Continuebotó " " per instal·lar-les totes.

Tenint el gust i totes les extensions necessàries instal·lades, feu clic al Continuebotó " " a l'extrem inferior dret per continuar.

A la Step 4 - Reportpàgina " ", podeu revisar totes les pàgines creades.

Si cal, podeu suprimir qualsevol pàgina no popular fent clic al Xbotó vermell corresponent .

Finalment, feu clic al Continuebotó " " per acabar el " Distribution Wizard". Se us portarà al tauler de control de XWiki com a usuari administrador que heu configurat anteriorment.

(Opcional) Escurceu l'URL del lloc XWiki

De manera predeterminada, com que Tomcat pot servir més d'una aplicació alhora, heu d'accedir al vostre lloc XWiki a l'URL http://203.0.113.1:8080/xwiki. Tanmateix, si XWiki és l'única aplicació que s'executa a Tomcat i voleu escurçar l'URL del lloc XWiki eliminant el /xwikisufix, haureu de modificar tres fitxers de configuració de XWiki de la següent manera.

Modificació del fitxer 1:

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

Modificació del fitxer 2:

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

Troba la línia:

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

Modifiqueu el valor del paràmetre de ruta:

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

Desa i surt:

:wq!

Modificació del fitxer 3:

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

Troba la línia:

# xwiki.webapppath=

Descomenta-ho:

xwiki.webapppath=

Desa i surt:

:wq!

Finalment, reinicieu Tomcat 8 per aplicar totes les vostres modificacions:

sudo systemctl restart tomcat8.service

A partir d'ara, visitareu el vostre lloc XWiki http://203.0.113.1:8080/directament des de .

(Opcional) Configura un servidor intermediari invers Nginx

Per defecte, Tomcat 8 funciona al port 8080, i només podeu visitar el vostre lloc XWiki des del mateix port. Si voleu facilitar l'accés dels visitants eliminant la part del número de port, podeu instal·lar Nginx com a servidor intermediari invers entre XWiki i els visitants.

Primer, instal·leu Nginx amb apt:

sudo apt install nginx -y

A continuació, configureu Nginx com a servidor intermediari invers modificant les seves configuracions de lloc predeterminades:

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

Ompliu el fitxer amb el següent:

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

Desa i surt:

:wq!

Inicieu el servei Nginx i configureu-lo perquè s'iniciï automàticament a l'inici del sistema:

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

Finalment, modifiqueu les regles del tallafoc UFW en conseqüència:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

A partir d'ara, els visitants del vostre lloc XWiki ja no hauran d'especificar el número de port. Han de visitar directament http://203.0.113.1/.