Cómo instalar XWiki 9.11.x en Ubuntu 16.04 LTS

• Prerrequisitos
• Configurar el repositorio XWiki LTS APT
• Instale el paquete XWiki todo en uno (incluidos XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 y más).
• Inicialice XWiki en la interfaz web "Asistente de distribución"
• (Opcional) Acorte la URL del sitio XWiki
• (Opcional) Configurar un proxy inverso Nginx

XWiki es una popular plataforma wiki de código abierto de nivel empresarial escrita en Java. Con extensibilidad y facilidad de uso, XWiki se está implementando en varias compañías como repositorio de conocimiento, portal público y más.

En este artículo, lo guiaré a través del proceso de instalación de XWiki 9.11.2 en una instancia de servidor Ubuntu 16.04 LTS. OpenJDK 8, Tomcat 8 y MySQL 5.7 se instalarán automáticamente como dependencias durante el proceso de instalación.

Prerrequisitos

• Una nueva instancia de servidor Vultr Ubuntu 16.04 LTS x64 con al menos 2 GB de memoria, se recomiendan 4 GB o más. Digamos que su dirección IP es 203.0.113.1.
• Un usuario de sudo .
• La instancia del servidor se ha actualizado al último estado estable mediante apt.

Configurar el repositorio XWiki LTS APT

Inicie sesión como usuario de sudo y luego descargue y configure el repositorio APT XWiki LTS (Soporte a largo plazo) en la instancia de su 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 desea probar la última versión estable de XWiki (pero NO LTS), puede descargar el siguiente repositorio XWiki APT en su lugar:

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

Instale el paquete XWiki todo en uno (incluidos XWiki LTS 9.11.2, Tomcat 8, MySQL 5.7 y más).

Cuando se implementa en producción, XWiki necesita trabajar con un contenedor Java Servlet y un software de base de datos. Como plataforma wiki flexible, XWiki ofrece oficialmente varias opciones de integración. Puede usar el siguiente comando para mostrar todas las opciones disponibles en el repositorio XWiki LTS APT:

apt search xwiki

El resultado de la búsqueda será similar al siguiente:

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 desea utilizar XWiki con las dependencias más comunes, puede instalar todos los componentes necesarios en un comando de la siguiente manera:

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

Durante el proceso de instalación, se le pedirá que configure una nueva contraseña para el usuario root de MySQL varias veces. Simplemente deje el campo de contraseña en blanco y presione Enterpara omitir este paso por ahora. Abordaremos este problema más adelante mientras aseguramos la instalación de MySQL.

Cuando se le pregunte si desea Configure database for xwiki with dbconfig-common?, elija <Yes>y luego presione ENTER.

Cuando se le MySQL application password for xwikisolicite que proporcione un , puede ingresar una contraseña de aplicación MySQL específica o dejar el campo de contraseña en blanco. Este último le dirá a XWiki que use una contraseña de aplicación MySQL aleatoria.

Con XWiki y todas las dependencias necesarias instaladas, asegure la instalación de MySQL:

sudo /usr/bin/mysql_secure_installation

Durante el proceso, el programa le hará algunas preguntas. Responda de la siguiente manera:

• ¿Desea configurar el complemento VALIDATE PASSWORD? Y
• Ingrese 0 = BAJO, 1 = MEDIO y 2 = FUERTE: 2
• Nueva contraseña: a-strong-MySQL-root-password
• Re-ingrese nueva contraseña: a-strong-MySQL-root-password
• ¿Desea continuar con la contraseña provista? Y
• ¿Eliminar usuarios anónimos? Y
• ¿No permitir el inicio de sesión root de forma remota? Y
• ¿Eliminar la base de datos de prueba y acceder a ella? Y
• ¿Recargar tablas de privilegios ahora? Y

Mejore la seguridad de XWiki modificando el archivo de configuración XWiki.

Use el editor vi para abrir un archivo de configuración XWiki:

sudo vi /etc/xwiki/xwiki.cfg

Encuentra las dos líneas que se muestran a continuación:

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

Reemplace los valores de ambos parámetros con dos cadenas aleatorias diferentes, y solo asegúrese de que la longitud de cada cadena sea la misma que la otra, por ejemplo:

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

Guardar y Salir:

:wq!

La cuota de memoria predeterminada es demasiado baja para ejecutar Tomcat 8 y XWiki dentro. Debe aumentar la cuota de memoria predeterminada de la siguiente manera antes de poder iniciar una instancia de XWiki en Tomcat 8 correctamente.

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

Encuentra la línea:

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

Modifique la línea como se muestra a continuación:

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

Nota: 1024M de memoria es solo la cuota mínima para ejecutar un sitio XWiki pequeño o mediano. Es posible que deba hacer ajustes a esta línea de acuerdo con sus demandas específicas.

Guardar y Salir:

:wq!

Reinicie Tomcat 8 para que todas sus modificaciones surtan efecto:

sudo systemctl restart tomcat8.service

Modifique las reglas de firewall de UFW para permitir el acceso web en el puerto 8080:

sudo ufw allow 8080
sudo ufw enable

Inicialice XWiki en la " Distribution Wizard" interfaz web

En este punto, ha configurado un sitio XWiki funcional pero vacío. Para completar el contenido, debe completar varias tareas de seguimiento, incluida la creación de un usuario administrador e instalar un sabor y extensiones necesarias para este wiki, en la interfaz web inicial de XWiki llamada " Distribution Wizard".

Apunte su navegador web favorito http://203.0.113.1:8080/xwiki, y se lo dirigirá automáticamente a la " Distribution Wizard" interfaz web. Haga clic en el Continuebotón " " para comenzar el asistente.

En la Step 1 - Admin userpágina " ", debe ingresar las credenciales del usuario administrador, por ejemplo:

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

Después de completar todos los campos obligatorios, haga clic en el Register and loginbotón " " para continuar.

En la página siguiente que muestra " You are connected with user John Doe.", haga clic en el botón " Continue" para crear el usuario administrador John Doecuyo nombre de usuario es johndoey seguir adelante.

En la Step 2 - Flavorpágina " ", haga clic en el XWiki Standard Flavor 9.11.2área " " para resaltar este sabor y luego haga clic en el botón " Install this flavor" para continuar.

En la página siguiente que detalla el " XWiki Standard Flavor 9.11.2", haga clic en el botón " Install" para realizar la instalación.

Una vez instalado el sabor, todas las extensiones requeridas se enumerarán en la página, haga clic en el botón " Continue" para instalarlas todas.

Una vez instalado el sabor y todas las extensiones necesarias, haga clic en el botón " Continue" en la esquina inferior derecha para continuar.

En la Step 4 - Reportpágina " ", puede revisar todas las páginas creadas.

Si es necesario, puede eliminar las páginas impopulares haciendo clic en el Xbotón rojo correspondiente .

Finalmente, haga clic en el botón " Continue" para finalizar el " Distribution Wizard". Se lo llevará al panel de control de XWiki como el usuario administrador que configuró anteriormente.

(Opcional) Acorte la URL del sitio XWiki

De manera predeterminada, dado que Tomcat puede servir más de una aplicación al mismo tiempo, debe acceder a su sitio XWiki en la URL http://203.0.113.1:8080/xwiki. Sin embargo, si XWiki es la única aplicación que se ejecuta en Tomcat y desea acortar la URL del sitio XWiki eliminando el /xwikisufijo, debe modificar tres archivos de configuración de XWiki de la siguiente manera.

Modificación de archivo 1:

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

Modificación de archivo 2:

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

Encuentra la línea:

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

Modifique el valor del parámetro de ruta:

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

Guardar y Salir:

:wq!

Modificación de archivo 3:

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

Encuentra la línea:

# xwiki.webapppath=

Descomentarlo:

xwiki.webapppath=

Guardar y Salir:

:wq!

Finalmente, reinicie Tomcat 8 para aplicar todas sus modificaciones:

sudo systemctl restart tomcat8.service

A partir de ahora, visitará su sitio XWiki http://203.0.113.1:8080/directamente.

(Opcional) Configurar un proxy inverso Nginx

De forma predeterminada, Tomcat 8 funciona en el puerto 8080, y solo puede visitar su sitio XWiki desde el mismo puerto. Si desea facilitar el acceso de los visitantes eliminando la parte del número de puerto, puede instalar Nginx como proxy inverso entre XWiki y los visitantes.

Primero, instale Nginx usando apt:

sudo apt install nginx -y

A continuación, configure Nginx como proxy inverso modificando las configuraciones predeterminadas del sitio:

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

Complete el archivo con lo siguiente:

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

Guardar y Salir:

:wq!

Inicie el servicio Nginx y configúrelo para que se inicie automáticamente al iniciar el sistema:

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

Finalmente, modifique las reglas de firewall de UFW en consecuencia:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

A partir de ahora, los visitantes de su sitio XWiki ya no necesitan especificar el número de puerto. Deben visitar directamente http://203.0.113.1/.