HowTo cambiar la base hypersonic por otra base

Contexto

En ambientes de producción se recomienda utilizar una Base de Datos para almacenar información de configuración de componentes de O3, tales como el Enterprise Portal, la configuración del Servidor y los usuarios.

La Base de Datos Hypersonic que va preconfigurada con O3 en su distribución, tiene por finalidad permitir una rápida puesta en funcionamiento de la instalación, tanto para aprendizaje, demostración y hasta desarrollo, pero para entornos de producción se recomienda la configuración de otra base de datos.

Este HowTo describe como se hace el cambio de Base de Datos del Enterprise Portal (Liferay).

Podemos distinguir 2 situaciones:

Ya tenemos armado un sitio usando hypersonic y queremos migrar a otra base.
No tenemos nada armado y queremos desde el vamos usar otra base

Ambas situaciones tienen pasos en común y pasos específicos para cada situación

1- Elección de la base de datos

Liferay funciona con varias bases de datos, nostros la hemos probado con exito en:

MS-SQL
MySQL
Postgres
Oracle

pero hay otras posibildades de Bases, en http://downloads.sourceforge.net/lportal/liferay-portal-sql-5.1.2.zip se puede ver los tipos soportado de acuerdo a los scripts de creación de bases.

Una vez que hayamos elegido la base, deberemos crear un base nueva y un usuario que sea dueño de la base o con permisos suficientes.

A los efectos de este HowTo supondremos que usaremos MySQL, que creamos una base que se llamará liferay y un usario liferay con una password liferaykey

Por temas de licenciamiento el driver de mysql hay que bajarlo del sitio de mysql. Luego hay que colocar el driver (.jar) en <o3>/classes/jdbc y en

<o3>/jboss/server/default/lib

El usuario liferay tiene solo derechos de
SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, EXECUTE sobre la base liferay

2- Exportar la comunidad

Si ya tenemos armado una/s comunidad/es debemos de exportarlas para luego importarlas en el eportal con la nueva base de datos

Loguearse como el administrador.
Ir a Panel de Control.
En la sección Portal ir a Comunidades.
En el botón Acciones elegir Administrar Páginas.
Eligiendo Páginas Públicas o Privadas, según el caso, ir a Exportar/Importar, guardar el archivo .lar clieando el botón Exportar.
Repetir el proceso para cada comunidad.
Bajar el Jboss al terminar de exportar la/s comunidad/es.

3- Cambiando el datasource de liferay

Es necesario indicarle a liferay que usar para conectarse, para ello copiamos del directorio de ejemplos el datasource correspondiente a mysql.

cp <o3>/jboss/docs/examples/jca/mysql-ds.xml <o3>/jboss/server/default/deploy/liferay-mysql-ds.xml

Luego borramos el archivo <o3>/jboss/server/default/deploy/liferay-hsqldb-ds.xml y editamos <o3>/jboss/server/default/deploy/liferay-mysql-ds.xml

Veremos algo como esto:

<datasources>
  <local-tx-datasource>
    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://mysql-hostname:3306/jbossdb</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>x</user-name>
    <password>y</password>
    <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name>
    <!-- should only be used on drivers after 3.22.1 with "ping" support
    <valid-connection-checker-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLValidConnectionChecker</valid-connection-checker-class-name>
    -->
    <!-- sql to call when connection is created
    <new-connection-sql>some arbitrary sql</new-connection-sql>
      -->
    <!-- sql to call on an existing pooled connection when it is obtained from pool - MySQLValidConnectionChecker is preferred for newer drivers
    <check-valid-connection-sql>some arbitrary sql</check-valid-connection-sql>
      -->

    <!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml -->
    <metadata>
       <type-mapping>mySQL</type-mapping>
    </metadata>
  </local-tx-datasource>
</datasources>

cambiamos

    <jndi-name>MySqlDS</jndi-name>
    <connection-url>jdbc:mysql://mysql-hostname:3306/jbossdb</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>x</user-name>
    <password>y</password>

por

    <jndi-name>jdbc/LiferayPool</jndi-name>
    <connection-url>jdbc:mysql://localhost:3306/liferay</connection-url>
    <driver-class>com.mysql.jdbc.Driver</driver-class>
    <user-name>liferay</user-name>
    <password>liferaykey</password>

Importante

Es crítico verificar que quede bien definido el dato jndi-name de la definición del datasource con el valor jdbc/LiferayPool , ya que es lo que identifica la base que va a usar el eportal. Si este nombre queda mal, el Eportal queda funcionando temporalmente con una base hypersonic embebida.

Recuerde

Recordar que usamos una base que se llama liferay, un usuario liferay

4- Iniciar el Jboss

Una vez iniciado el Jboss, Liferay se encargara de crear las tablas en la base y precargarle algunos datos.

5- Abrir el eportal

Colocamos en el navegador web http://localhost:8080/eportal y veremos algo como esto

Debemos loguearnos con el usuario test@liferay.com (sugerido) y la password test

veremos la siguiente pantalla

6- Recomponiendo el eportal

ATENCIÓN

No saltearse lo pasos que a continuación se detallan, o se corre el riesgo de no poder volver a entrar al eportal

Agregando el usuario admin

Vamos a al menú de opciones y elegimos Control panel (Panel de Control)

Una vez en el Panel de control vamos a buscar a la izquierda la sección Portal

Elegimos Users, luego Add (botón verde arriba al medio) y completamos como en la foto y apretamos salvar (botón a la derecha)

Notar que deben coincidir el screen name con el nombre de logueo en O3, en este caso admin. Pero para otros usuarios se debe mantener que los nombres sean iguales.

Luego ir a roles como muestra la imagen

Apretamos el botón con una cruz verde (Selec) y se despliega una pantalla en la que podemos selecionar el rol administrator

Luego volvemos a salvar (botón derecho abajos)

Si queremos le podemos sacar el rol powerUser (no olvidar salvar luego de sacarlo!)

Con esto ya tenemos a admin como administrador del eportal.

Agregando portlet de login en la comunidad guest

Arriba a la derecha debe haber un link que dice back to guest(volver a guest), lo cliqueamos y estaremos en la pantalla de inicio.

Acá debemos sacar los 2 portlets y agregar uno nuevo, para ello vamos de nuevo al menú y elegimos agregar aplicación (add application)

elegimos el portlet que esta en indefinidos (Undefined) Eportal Portlet y lo agregamos.

Desactivar el usuario test

Nos deslogueamos y entramos con el usuario admin.
Una vez logueados, vamos al menú->panel de control->usuarios

Apretamos el botón de acciones correspondiente al usario test y lo desactivamos.

Creando la comunidad

En el menú de la izquierda buscamos comunidades
Luego en el botón verde con una cruz le decimos agregar, completamos el formulario.

Agregando(importando) a la comunidad lo exportado al principio.

En la lista de Comunidades elegimos la creada y en el botón de acciones->manejar páginas.
Luego elegimos privadas y exportar/importar, a continuación importar,
seleccionamos el archivo y no cambiamos ninguna de las opciones.

Apretamos ver paginas y listo!!