Cómo instalar Liferay en un entorno local de desarrollo

Preparación entorno de trabajo

Antes de comenzar a instalar Liferay, debemos hacer unos pasos previos:

• Debemos tener JDK 8 instalado en el sistema. Para comprobarlo desde la consola de comandos ejecutamos el comando:

java -version

• En caso de no estar ya instalado, podemos descargar JDK 8 desde la web:

• Una vez se haya descargado, instalaremos JDK 8 con el ejecutable.

• Al finalizar el proceso crearemos una variable de entorno llamada “JAVA_HOME”, con la ruta de la instalación de JDK.

• A continuación añadiremos al “PATH” el valor “%JAVA_HOME%\bin” .

Descarga de Eclipse

Después de tener instalado JDK 8 e instanciadas las variables, pasamos a la instalación de Eclipse siguiendo estos pasos:

• Descargamos Eclipse, que ya contiene Liferay IDE preinstalado, desde la web:

• Lo descargamos en la carpeta “C:\liferay\IDE-7.2” y en la misma carpeta crearemos otra con el nombre “eclipse”.
• Ejecutamos el archivo descargado y elegimos como directorio de instalación el que hemos creado previamente con el nombre de “eclipse”.

• Al finalizar el proceso, o durante el mismo, creamos una nueva carpeta llamada “workspace-eclipse” dentro de “C:\liferay\IDE-7.2”, que será el espacio de trabajo de Eclipse.
• En el momento que se haya instalado totalmente Eclipse, accedemos a la carpeta “liferay-developer-studio” que se ha creado, y ejecutamos DeveloperStudio.
• El programa nos solicitará el directorio del workspace, que vamos a indicar el que habíamos creado anteriormente:

Instalación de Liferay

Una vez tengamos Eclipse ya instalado, seguiremos con el proceso de descarga e instalación de Liferay.

• Descargamos el bundled de Liferay, con Tomcat ya incluido, desde la URL:

• Tras realizar la descarga, descomprimimos el archivo en la carpeta “C:\liferay”.

• A continuación descargaremos el código fuente de Liferay desde:

• El archivo descargado hay que descomprimirlo dentro de una carpeta llamada “src” dentro de “C:\liferay”.
• Seguidamente descargaremos MySQL 5.7 y WorkBench en Windows desde la web:

• Finalizada la descarga procedemos a instalar MySQL y WorkBench.

Inicialización de Liferay

Liferay por defecto incluye Hypersonic, una base de datos que funciona como un filesystem en memoria.

Este sistema no es adecuado para un entorno productivo, y tampoco está recomendado para usar en desarrollo, por lo que solo se utiliza para alguna demostración o para alguna prueba puntual, y lo siempre es muy recomendable utilizar MySQL o PostgreSQL.

Una vez tenemos instalado todo lo indicando en el paso anterior, vamos a pasar a crear la base de datos en MySQL, lo que haremos en varios pasos:

• Abrimos MySQL WorkBench para crear nuestro schema para Liferay.
• Creamos la siguiente query:

CREATE DATABASE lportal
DEFAULT CHARACTER SET utf8
DEFAULT COLLATE
utf8_general_ci;

• Ejecutamos la query una vez creada:

• Creamos un nuevo servidor en Eclipse, clicando el botón derecho del ratón en la ventana “Servers”. Configuramos el tipo como “Liferay 7.x”.

• Pasamos a la siguiente pantalla y elegimos la carpeta en la que tenemos Liferay Tomcat instalado, además de elegir la carpeta en la que hemos instalado el JDK:

• Una vez finalizado el proceso, aparece el nuevo servidor disponible, el cual vamos a arrancar. La primera vez que se arranca tardará sobre diez minutos, ya que tiene que generar toda la estructura, y ya las veces posteriores tardarán menos tiempo.
• Cuando haya acabado de inicializarse el servidor, nos aparecerá un mensaje indicándolo.

Configuración Liferay

El siguiente paso será configurar Liferay. Para ello hacemos los siguientes pasos:

• Abrimos el navegador y entramos en localhost:8080, el puerto por defecto que usa Liferay.
• Podemos elegir el nombre del portal, nombre y apellidos del administrador y su email.
• En la configuración de base de datos cambiamos Hypersonic, que es la que viene elegida por defecto, y seleccionamos MySQL.
• Debemos introducir el nombre de usuario y la contraseña que se eligieron durante la instalación de MySQL en local.
• Finalizamos la configuración y reiniciamos Liferay para que los cambios surtan efectos.

Archivo de configuración de Liferay

Podemos ver el archivo de configuración accediendo a la ruta que nos indicaba el mensaje anterior de Liferay y editando el archivo portal-setup-wizard.

En el mismo podemos ver todas las conexiones de la base de datos, el esquema que se está usando, la codificación empleada, el usuario y la contraseña que se está utilizando, los datos del administrador, el lenguaje elegido y muchos otros datos.

Comenzando a usar Liferay

Cuando finalice el reinicio del servidor, volvemos a abrir el navegador y entramos en localhost:8080, y vemos que ya tenemos nuestro entorno Liferay arrancado y preparado para utilizar.

Accedemos con el usuario y contraseña para el administrador que habíamos elegido previamente, aceptamos las condiciones de uso e introducimos un recordatorio de la contraseña, y a continuación ya tenemos acceso a nuestro entorno de desarrollo con Liferay.