Cómo instalar XWiki en Ubuntu 18.04

XWiki es un software Wiki avanzado gratuito y de código abierto que está escrito en Java. Se ejecuta en contenedores de servlets como JBoss, Tomcat, etc. Utiliza una base de datos como MySQL o PostgreSQL para almacenar su información.

En este tutorial, explicaré cómo instalar el software XWiki en Ubuntu 18.04, usando su distribución independiente, que es la forma más rápida y sencilla porque todos los componentes que XWiki necesita se instalan automáticamente en el servidor. Este software XWiki proporciona un XWiki integrado, con una base de datos portátil (HSQLDB) y un contenedor Java ligero (Jetty).

XWiki viene con muchas funciones útiles como:

  • Un editor WYSIWYG muy robusto para la edición de páginas
  • Una potente sintaxis de wiki
  • Organización de contenido
  • Crea tus propias aplicaciones
  • Control de versiones
  • Búsqueda avanzada y mucho más

Requisitos de hardware y software

  • Java 1.8.0_101 o superior instalado para XWiki> = 8.1 (Java 7 o superior para XWiki <8.1, Java 6 o superior para versiones de XWiki <6.0).
  • Un contenedor de servlet compatible con Servlet 3.0.1 (Servlet 2.4 para versiones de XWiki <7.0)
  • Una base de datos y un controlador JDBC 4 para su base de datos
  • Suficiente memoria, al menos 2 GB de RAM (o 1 GB para wikis pequeños)

Pasos de instalación de XWiki

Antes de comenzar cualquier instalación, recomendaría actualizar el software de su sistema usando apt-update. Y puedes instalar wget y screen paquete si no están instalados antes.

#apt-get update -y
#apt install wget screen

Paso 1: instalar Java

Como se mencionó anteriormente, Xwiki es una aplicación basada en Java, por lo que deberá instalar Java 8 o superior para cumplir con sus requisitos de software. De forma predeterminada, Java 8 no está disponible en el repositorio predeterminado de Ubuntu. Por lo tanto, puede instalar Java compatible agregando el repositorio PPA webupd8team a su sistema.

#add-apt-repository ppa:webupd8team/java
#apt-get update -y

Después de agregar el repositorio de PPA, debe actualizar los paquetes del repositorio. Una vez hecho esto, puede instalar el Java 8 requerido ejecutando este comando a continuación:

#apt-get install oracle-java8-installer -y

You can confirm the Java version installed.
~# java -version
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)

Paso 2: Descarga e instala XWiki

En primer lugar, debe iniciar una nueva sesión de pantalla para esta instalación de XWiki. Ahora necesitamos descargar el instalador genérico que funciona en todas las plataformas. Solo requiere que Java esté instalado en su sistema. Puede descargar el Instalador genérico de XWiki archivo con este comando a continuación:

#screen -U -S xwiki
#wget https://download.forge.ow2.org/xwiki/xwiki-enterprise-installer-generic-8.1-standard.jar

Una vez que haya descargado este instalador, puede instalar este paquete descargado usando Java. El instalador lo lleva a varias secciones interactivas, como se muestra a continuación, donde exige una salida como ingresar 1 (accept or proceed)/ 2 (quit) /3 (redisplay) de usted para continuar con la instalación. La mayoría de las indicaciones se pueden responder con 1 (accept or proceed). El instalador se explica por sí mismo, por lo que solo debe seguir las instrucciones.

# java -jar xwiki-enterprise-installer-generic-8.1-standard.jar
Aug 7, 2018 10:08:33 AM INFO: Logging initialized at level 'INFO'
Aug 7, 2018 10:08:33 AM INFO: Commandline arguments:
Aug 7, 2018 10:08:33 AM INFO: Detected platform: ubuntu_linux,version=4.15.0-29-generic,arch=x64,symbolicName=null,javaVersion=1.8.0_181
Welcome to the installation of XWiki Enterprise 8.1!
The homepage is at: https://xwiki.org/

Press 1 to continue, 2 to quit, 3 to redisplay

Mientras presiona 1 para continuar, te proporcionará XWiki Enterprise - Readme Note como a continuación:

Please read the following information:
XWiki Enterprise - Readme

XWiki Enterprise is a second generation Wiki engine, features professional features like
XWiki Enterprise also includes an advanced form and scripting engine which makes it an ideal
development environment for constructing data-based intranet applications. It has powerful extensibility features, supports scripting, extensions and is based on a highly modular
architecture. The scripting engine allows to access a powerful API for accessing the XWiki repository in read and write mode.
XWiki Enterprise is used by major companies around the world and has strong Support for a professional usage of XWiki.
Here are some pointers to get you started with XWiki once you have finished installing it:
The documentation can be found on the XWiki.org web site
If you wish to talk to XWiki users or developers please use our
You can also access XWiki's
If you need commercial support please visit the
Support page

Press 1 to continue, 2 to quit, 3 to redisplay
1

Una vez que presione 1 para continuar, lo llevará al aviso del Acuerdo de licencia.

Press 1 to continue, 2 to quit, 3 to redisplay
1
See the NOTICE file distributed with this work for additional information regarding copyright ownership.
This is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this software; if not, write to the Free
Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA, or see the FSF site: https://www.fsf.org.

Press 1 to accept, 2 to reject, 3 to redisplay
1

Después de aceptar el Acuerdo de licencia, lo llevará a través de varias etapas de instalación para configurar la carpeta de instalación, el instalador automático, los accesos directos del escritorio, los accesos directos del usuario, etc. Continuaré con la ruta predeterminada seleccionada por el instalador. Si lo necesita, puede establecer rutas personalizadas durante esta sección.

Select the installation path: [/usr/local/XWiki Enterprise 8.1]

Press 1 to continue, 2 to quit, 3 to redisplay
1

[x] Pack 'Core' required
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
[x] Include optional pack 'Default Wiki'
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Enter Y for Yes, N for No:
Y
Done!

Press 1 to continue, 2 to quit, 3 to redisplay
1
[ Starting to unpack ]
[ Processing package: Core (1/2) ]
[ Processing package: Default Wiki (2/2) ]
[ Unpacking finished ]
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Create shortcuts in the Start-Menu
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Enter Y for Yes, N for No:
Y
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Create additional shortcuts on the desktop
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Enter Y for Yes, N for No:
Y
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
create shortcut for: all users
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Enter Y for Yes, N for No:
Y
Aug 7, 2018 10:11:08 AM WARNING: Shortcut 'Go to my wiki' has URL but type ('Application') is not 'Link'
Aug 7, 2018 10:11:08 AM WARNING: Shortcut 'Go to my wiki' has URL but type ('Application') is not 'Link'
Aug 7, 2018 10:11:08 AM WARNING: Shortcut 'Documentation' has URL but type ('Application') is not 'Link'
Aug 7, 2018 10:11:08 AM WARNING: Shortcut 'Documentation' has URL but type ('Application') is not 'Link'
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Generate an automatic installation script
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Enter Y for Yes, N for No:
Y
Select the installation script (path must be absolute)[/usr/local/XWiki Enterprise 8.1/auto-install.xml]

Installation was successful
application installed on /usr/local/XWiki Enterprise 8.1
[ Writing the uninstaller data ... ]
[ Console installation done ]

Una vez que se realiza la instalación, mostrará la carpeta de instalación de la aplicación como se muestra en nuestro resultado que está en /usr/local/XWiki Enterprise 8.1. Ahora debe ir a la carpeta de la aplicación y ejecutar el script de inicio de XWiki como se muestra a continuación:

# cd /usr/local/XWiki Enterprise 8.1/
1:/usr/local/XWiki Enterprise 8.1# bash start_xwiki.sh
Starting Jetty on port 8080, please wait...
2018-08-09 09:31:08.832:INFO::main: Logging initialized @692ms
2018-08-09 09:31:09.354:INFO:oejs.Server:main: jetty-9.2.13.v20150730
2018-08-09 09:31:09.378:INFO:oejs.AbstractNCSARequestLog:main: Opened /usr/local/XWiki Enterprise 8.1/data/logs/2018_08_09.request.log
2018-08-09 09:31:09.383:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:/usr/local/XWiki%20Enterprise%208.1/jetty/contexts/] at interval 0
2018-08-09 09:31:32,621 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Starting embedded Solr server...
2018-08-09 09:31:32,633 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Using Solr home directory: [data/solr]
2018-08-09 09:31:38,070 [coreLoadExecutor-6-thread-1] WARN o.a.s.c.SolrCore - [xwiki] Solr index directory '/usr/local/XWiki Enterprise 8.1/data/solr/xwiki/data/index' doesn't exist. Creating new index...
2018-08-09 09:31:39,756 [main] INFO o.x.s.s.i.EmbeddedSolrInstance - Started embedded Solr server.
2018-08-09 09:31:41.705:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@6df97b55{/xwiki,file:/usr/local/XWiki%20Enterprise%208.1/webapps/xwiki/,AVAILABLE}{/xwiki}
2018-08-09 09:31:41.802:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@389a9ff6{/,file:/usr/local/XWiki%20Enterprise%208.1/webapps/root/,AVAILABLE}{/root}
2018-08-09 09:31:41.862:INFO:oejs.ServerConnector:main: Started ServerConnector@6a6b8692{HTTP/1.1}{0.0.0.0:8080}
2018-08-09 09:31:41.862:INFO:oejs.Server:main: Started @33722ms
2018-08-09 09:31:41.862:INFO:oxtjl.NotifyListener:main: ----------------------------------
2018-08-09 09:31:41.869:INFO:oxtjl.NotifyListener:main: Server started, you can now open https://ubuntu18.example.com:8080/ in your browser to access your wiki.
2018-08-09 09:31:41.871:INFO:oxtjl.NotifyListener:main: ----------------------------------

La aplicación se iniciará automáticamente en el puerto 8080. Debe esperar unos minutos para iniciar la aplicación. Y una vez hecho esto, puede visitar XWiki a través de su dominio o IP de servidor en el puerto 8080. No lo haga close nuestra ventana de terminal de pantalla que aparece. Es necesario para que nuestro servidor XWiki esté funcionando. Puede detener este servidor XWiki cerrando este terminal de pantalla.

PD: De forma predeterminada, la aplicación se ejecuta en el puerto 8080. Pero si desea usar el puerto personalizado 8081, asegúrese de que no haya nada ejecutándose en el puerto 8081 e inicie XWiki con el siguiente comando:

#bash start_xwiki.sh -p 8081

Paso 3: inicia la aplicación

Una vez que se inicia XWiki, puede apuntar su navegador a https://ServerIP or Hostname:8080/ para acceder a la interfaz web.

Puede iniciar sesión en el Panel de administración utilizando el Admin usuario (la primera letra está en mayúscula) y su contraseña predeterminada es admin (minúsculas).

Inicio de sesión de Xwiki

Panel de Xwiki

Conclusión

¡Viva! Hemos instalado y configurado correctamente nuestro XWiki. Espero que este tutorial te ayude a configurar tu propia Wiki autohospedada usando XWiki. Publique sus valiosas sugerencias y comentarios al respecto.

Leer también:

  • 15 Comando de pantalla de Linux para negociar sesiones de terminal
  • Cómo instalar Java 8 en Ubuntu 18.04