MetaSpace Portal 2.4 Community

Transcripción

1 2.4 Community Guía de Instalación de la Plataforma Revisión 2.0

2 Guía de Instalación de la Plataforma Página 2 / 18 Índice 1. Introducción Requisitos técnicos Instalación de la versión con JBoss Instalación de la base de datos Descarga del software Ejecución del instalador Configuración de la base de datos Ejecución del servidor Importación de los datos Entrada a la aplicación Desinstalación de la versión con JBoss Instalación de versión para JBoss en un servidor existente Instalación de la versión para BEA Weblogic Instalación de la base de datos Descarga del software Configuración de la base de datos Despliegue dentro de Weblogic Ejecución del servidor Importación de los datos Configuración de parámetros de ejecución Entrada a la aplicación Configuración de parámetros de la aplicación Acceso a los archivos de depuración...18

3 Guía de Instalación de la Plataforma Página 3 / 18 Introducciión MetaSpace Portal Community es una plataforma para la gestión de portales web corporativos. MetaSpace Portal Community facilita el desarrollo y mantenimiento de portales web proporcionando una solución completa para la gestión integral de los mismos. Además la licencia del producto está basada en General Public License versión 2 por lo que se trata de un producto de software libre y código abierto. Para más información sobre los términos de la licencia acceda a los archivos de licencia existentes en la carpeta de instalación. La presente guía pretende ayudarle en la instalación de MetaSpace Portal en uno de los posibles entornos de producción para los cuales está certificado. Es posible instalar correctamente el software en otros entornos de producción diferentes de los aquí detallados pero para ello se requieren conocimientos avanzados de despliegue de aplicaciones J2EE así como conocer en profundidad el mecanismo de despliegue de aplicaciones en el servidor en el cual se quiere instalar el producto, y este no es le propósito de esta guía. Esta guía esta destinada a que un usuario no experto en servidores de aplicaciones J2EE pueda conseguir instalar el sistema sin problemas. El método más sencillo de instalación es descargar e instalar la versión de MetaSpace Portal que contiene el servidor de aplicaciones gratuito JBoss ya que el propio servidor de aplicaciones se instalará y configurará automáticamente a la vez que se instala el producto. Vaya al apartado de este documento donde se describe este proceso. Si usted dispone de un servidor de aplicaciones BEA Weblogic y conocimientos sobre como administrarlo puede descargar la versión para dicho servidor. Siga los pasos para realizar los ajustes necesarios en el apartado correspondiente. Requiisiitos técniicos Los requisitos técnicos de MetaSpace Portal son disponer de una base de datos Oracle 8i o superior y de un servidor de aplicaciones certificado para el producto: JBoss o BEA Weblogic. En estos momentos el sistema sólo está certificado para su uso con una base de datos de tipo Oracle 8i o superior. Si no dispone de este tipo de base de datos puede obtener una versión gratuita de Oracle 10g Express Edition en el siguiente enlace: Oracle 10g Express Edition es una base de datos gratuita proporcionada por Oracle sin ningún tipo de limitación funcional, solamente está limitada en el tamaño de la base de datos (4 Gb), el número de procesadores que usa (1) y el número de instancias permitidas (1). Estas limitaciones no suponen problemas para MetaSpace Portal excepto en el caso de requerir su instalación en grandes sistemas corporativos, siendo apropiado para la mayor parte de los casos. En cuanto a los servidores de aplicaciones J2EE certificados para su uso por el sistema tenemos los siguientes: JBoss Aplicación Server versión 4.0 o superior: se trata de un servidor de aplicaciones de clase empresarial gratuito y de código abierto (open source) que puede ser obtenido en la dirección Este servidor viene incluido con el producto si se descarga la versión para JBoss por lo que no es necesario que se lo descargue aparte. Le recomendamos que instale esta versión si no dispone de conocimientos de servidores J2EE o no desea pagar una licencia por un servidor J2EE comercial. BEA Weblogic Application Server versión 8.1 o superior: se trata de uno de los mejores servidores de aplicaciones del mercado. Es un producto comercial y aunque dispone de una versión gratuita denominada Express, MetaSpace Portal no puede instalarse en ella. Para más información puede acceder a la página Le recomendamos que instale esta versión de

4 Guía de Instalación de la Plataforma Página 4 / 18 MetaSpace si desea un entorno de producción de alto rendimiento y dispone de conocimientos de administración de servidores de base de datos y servidores de aplicaciones J2EE. Los requisitos de utilización en la parte cliente se reducen a un navegador Internet Explorer 6 o superior. Aunque los portales generados por la plataforma son válidos tanto para Internet Explorer como para Mozilla/Firefox el panel de administración sólo puede ser operado utilizando Internet Explorer para acceder al mismo. Installaciión de lla versiión con JBoss La versión de MetaSpace Portal para JBoss ha sido diseñada para que sea fácil de instalar de tal forma que no se requieran conocimientos avanzados ni de bases de datos Oracle, ni de servidores de aplicaciones J2EE. La versión para JBoss instalará junto con el sistema un servidor de aplicaciones JBoss completamente configurado y listo para funcionar. JBoss es un servidor de aplicaciones de código abierto y gratuito por lo que no tiene que pagar ningún tipo de licencia por su uso. Veamos cuales son los pasos para la instalación de esta versión: 3..1 IInssttal lacci ión de la l basse de dattoss Antes de proceder a la instalación del sistema es necesario que disponga de una base de datos Oracle 8i o superior correctamente instalada en alguno de sus equipos (no necesariamente el equipo en el que va a instalar MetaSpace Portal). Si no dispone de ella puede datos obtener una versión gratuita de Oracle 10g Express Edition en el siguiente enlace: A continuación planifique su esquema de interconexión entre la base de datos y su servidor de aplicaciones. Si va a instalar la base de datos en la misma máquina que el servidor de aplicaciones no tendrá ningún problema. Si el servidor de aplicaciones se instala en una máquina distinta del servidor de base de datos Oracle necesitará tener abiertos los puertos de conexión de Oracle (puerto 1521 por defecto) en el servidor de base de datos, además deberá instalar un cliente de Oracle en la máquina donde instale el servidor de aplicaciones (el cliente de Oracle se instala de igual manera que el servidor simplemente seleccionando la opción de instalar sólo el cliente). Al instalar Oracle recuerde la contraseña que da al usuario system pues luego será necesaria para continuar la instalación. Si pone como contraseña la palabra manager los comandos de creación de base de datos preconfigurados funcionarán sin problemas. Si no tiene experiencia en este tipo de instalaciones le recomendamos que instale la base de datos Oracle en la misma máquina en la que instalará el servidor de aplicaciones y el resto del sistema. Esto facilitará su configuración y puesta en marcha posterior haciéndola muy sencilla. Una vez instalado Oracle deberá crear en la máquina donde va a instalar la aplicación un nombre de servicio de red para ser utilizado por el cliente de Oracle al conectarse con el servidor. El nombre de servicio puede ser creado interactivamente utilizando la herramienta Net Configuration Assistant de Oracle. Lamentablemente la versión gratuita de Express no dispone de esta herramienta, por lo que su configuración debe hacerse manualmente editando el archivo denominado network\admin\tnsnames.ora. Simplemente editamos ese archivo y añadimos las siguientes líneas: NOMBRE = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = IP)(PORT = 1521)) ) (CONNECT_DATA =

5 Guía de Instalación de la Plataforma Página 5 / 18 (SERVICE_NAME = orcl) ) ) En esta líneas deberemos modificar el texto marcado en rojo sustituyendo NOMBRE por el nombre del servicio que luego utilizaremos (recomendamos poner LOCALHOST ya que luego no será necesario cambiar la configuración de JBoss), IP por la dirección IP o el DNS del servidor donde está instalado Oracle (si está en la misma máquina se puede poner ), 1521 por el puerto de Oracle (por defecto el 1521), y orcl por el SID identificador de Oracle (la Express Edition utiliza xe como valor del SID). Así por defecto tendríamos que poner: LOCALHOST = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = )(PORT = 1521)) ) (CONNECT_DATA = (SERVICE_NAME = xe) ) ) ATENCION! Si va a utilizar Oracle 10g Express Edition utilice la palabra xe en vez del valor del SID por defecto que es orcl en el parámetro SERVICE_NAME del servicio de red. Esta forma de configurar el servicio también es válida para el resto de versiones de Oracle (no sólo para la versión gratuita Express) Dessccarrga dell ssoffttwarre Para descargar la versión para JBoss acceda a la página web de MetaSpace Portal en la dirección y después de registrarse con sus datos (requiere una dirección de válida) acceda al apartado de descargas y descargue la versión correspondiente Ejeccucci ión dell inssttal i ladorr La versión para JBoss del sistema se compone de un archivo ejecutable de instalación por lo que simplemente ejecute dicho archivo y seleccione la ruta dentro de su equipo donde se instalará el software. El instalador creará en su menú de inicio una nueva entrada denominada MetaSpace Portal así como dos iconos en su escritorio para arrancar el servidor JBoss y para acceder a las páginas de administración del sistema una vez arrancado Conffi igurracci ión de la l basse de dattoss Antes de ejecutar el servidor de aplicaciones es necesario crear dentro del servidor de Oracle la base de datos que utilizará el sistema y configurar el servidor para que la use. El sistema viene preconfigurado para conectarse a una base de datos utilizando el nombre de usuario metaspace y la contraseña mtsp. Si lo desea usted puede utilizar otro usuario y contraseña pero entonces deberá modificarlos adecuadamente en el archivo de configuración del DataSource dentro de JBoss como veremos más adelante.

6 Guía de Instalación de la Plataforma Página 6 / 18 Cree ahora un tablespace y un usuario en su servidor Oracle para albergar los datos que utilizará el sistema. Para ayudarle en esta tarea puede utilizar un comando de consola denominado Create database.cmd que encontrará en la carpeta metaspace_database dentro de la carpeta donde instaló el producto. Este comando también está accesible desde la opción siguiente de su menú de inicio: Inicio>Programas>MetaSpace Portal>Database scripts>create MetaSpace Database. Para poder ejecutar correctamente este comando deberá de disponer de un cliente de Oracle instalado en la máquina desde la que desea ejecutar el comando. Como ya le indicamos en el primer paso si está instalando el software en el mismo ordenador donde tiene instalado Oracle entonces no tendrá ningún problema ya que tendrá instalado dicho cliente, en caso contrario instale el cliente de Oracle. El comando que le hemos indicado asume que el superusuario de Oracle system tiene como contraseña manager, y que se está ejecutando en la misma máquina en la que se encuentra Oracle. Si este no es el caso el comando fallará y le pedirá que suministre un nombre de usuario con permisos para crear usuarios y tablespaces y una contraseña válidas. En el caso de que este ejecutando el comando en una máquina diferente a aquella en la que está instalado Oracle deberá indicar el nombre del servicio de red al introducir el nombre del usuario de la forma usuario@nombre_servicio_red. El comando anterior creará un tablespace (archivo de datos) denominado METASPACE.ORA dentro de la carpeta metaspace_database en el directorio donde se instaló la aplicación, y creará un usuario denominado metaspace con contraseña mtsp para acceder a la base de datos Ejeccucci ión dell sserrvi idorr Una vez finalizada su instalación debe iniciar la ejecución del servidor de aplicaciones JBoss, para ello acceda a la opción siguiente de su menú de inicio: Inicio>Programas>MetaSpace Portal>JBoss Server with MetaSpace. Esta opción arrancará el servidor JBoss en una ventana de consola, y se mostrarán los mensajes de inicialización del servidor hasta que el servidor finalice el proceso de arranque y muestre el mensaje de Started. El servidor recibirá las conexiones por el puerto 8001 por lo que dicho puerto debe estar libre, si se desea cambiar este puerto será necesario modificar el parámetro Connector dentro del archivo server\default\deploy\jbossweb-tomcat55.sar\server.xml y reiniciar el sevidor JBoss cerrando la ventana de consola y volviendo a ejecutarlo. [Fig 1] Consola con JBoss correctamente arrancado y a la escucha Una vez arrancado el servidor ya podemos iniciar la ejecución de MetaSpace Portal, para ello accedemos a la opción siguiente de su menú de inicio: Inicio>Programas>MetaSpace Portal>MetaSpace Portal Administration y nos aparecerá un navegador de Internet con la página de inicio del sistema. A continuación vemos el mensaje que se nos muestra al iniciar por primera vez la aplicación:

7 Guía de Instalación de la Plataforma Página 7 / 18 [Fig 2] Mensaje de licencia al entrar por primera vez Debemos aceptar la licencia para continuar con la instalación IImporrttacci ión de loss l dattoss Una vez aceptada la licencia en el paso anterior el sistema intentará conectar con la base de datos. Si todo ha ido bien nos aparecerá una página para proceder a importar los datos de partida del sistema. Sin embargo si se ha producido algún error obtendremos una página con el siguiente mensaje: [Fig 2] Mensaje de error al conectar con la base de datos El mensaje de error anterior indica que no ha podido conectar con la base de datos, esto puede ser debido a varias razones (el mensaje suele dar pistas sobre lo que ha sucedido), veamos cuales son las más comunes y la solución al problema: Si ha obtenido el mensaje con el código de error de Oracle ORA entonces suele deberse a que está utilizando como base de datos Oracle 10g Express Edition y por tanto debe de cambiar el SID que por defecto es orcl por la palabra xe en el archivo server\default\deploy\metaspaceds.xml de configuración del DataSource dentro de JBoss. Vea más adelante en esta misma página como editar este archivo. Si ha obtenido el mensaje con el código de error de Oracle ORA entonces lo más probable es que no ha creado una base de datos correctamente en el sistema. Por favor repase los pasos

8 Guía de Instalación de la Plataforma Página 8 / 18 previos 3.1 y 3.4 para asegurarse de que ha creado un tablespace y un usuario en Oracle y dispone de un nombre de servicio de red correcto apuntando a la máquina. El DataSource (conexión a la base de datos ) de JBoss no está correctamente configurado. Por defecto este DataSource está configurado para conectarse a Oracle utilizando localhost como nombre de servicio de red, y usando como nombre de usuario metaspace con contraseña mtsp. Si ha cambiado alguno de estos parámetros por otros valores en los pasos anteriores deberá configurar el DataSource editando el archivo server\default\deploy\metaspace-ds.xml que está dentro de la carpeta donde instaló el producto. El formato del archivo es el siguiente, compruebe y corrija los parámetros marcados (compruebe también el puerto 1521 y el SID orcl o xe dependiendo de la versión de Oracle): <datasources> <local-tx-datasource> <jndi-name>metaspacedb</jndi-name> <connection-url>jdbc:oracle:thin:@localhost:1521:orcl</connection-url> <driver-class>oracle.jdbc.driver.oracledriver</driver-class> <user-name>metaspace</user-name> <password>mtsp</password> <min-pool-size>50</min-pool-size> <max-pool-size>1000</max-pool-size> <valid-connection-checker-classname>org.jboss.resource.adapter.jdbc.vendor.oraclevalidconnectionchecker</valid-connectionchecker-class-name> <exception-sorter-classname>org.jboss.resource.adapter.jdbc.vendor.oracleexceptionsorter</exception-sorter-classname> <metadata> <type-mapping>oracle9i</type-mapping> </metadata> </local-tx-datasource> </datasources> Vuelva a entrar en la aplicación, si todo está correcto después de aceptar la licencia debería obtener una página con el siguiente mensaje: [Fig 3] Preparados para importar los datos iniciales En la pantalla anterior debemos introducir la contraseña del usuario system de la base de datos que por defecto es manager) y al pulsar el botón se iniciará un proceso de importación de Oracle que cargará en

9 Guía de Instalación de la Plataforma Página 9 / 18 base de datos los datos iniciales de la aplicación. Si el idioma del navegador es español se cargará los datos en español, en caso contrario se cargarán los datos en inglés. El proceso de carga puede llevar algo de tiempo. Si se produce un error por algún motivo se obtendrá una pantalla de error y se puede intentar una importación manual de los datos utilizando los comandos accesibles desde el menú de inicio Inicio>Programas>MetaSpace Portal>Database scripts>setup spanish data o bien Setup english data. ATENCIÓN! Si utiliza Oracle 10g Express Edition puede producirse al realizar la importación un error esporádico con código ORA En ese caso cierre JBoss y realice la importación manual de los datos utilizando los scripts anteriormente comentados. Si aún se produce el error utilizando el script reinicie el sistema y antes de arrancar el JBoss ejecute el script (espere primero unos instantes a que el servicio de Oracle se inicie). Si utiliza los scripts para crear la base de datos, al entrar en la aplicación le dirá que la base de datos no está vacía porque ya dispone de una creada (la que creó utilizando el script) pulse entonces en el botón de finalizar para usar dicha base de datos y entrar en la aplicación. Si la importación es correcta aparecerá una pantalla con el siguiente mensaje: [Fig 4] Importación de datos inicial finalizada correctamente En la pantalla anterior basta pulsar el botón finalizar para acabar la instalación Enttrrada a la l apliccacci ión Si hemos conseguido una correcta instalación de la aplicación al final obtendremos una pantalla con un mensaje que nos informa de ello y que nos dice que podemos acceder a la aplicación utilizando el usuario administrador por defecto admin con contraseña admin. A partir de ahora para entrar en la aplicación utilizaremos el enlace del menú de inicio Inicio>Programas >MetaSpace Portal>MetaSpace Portal Administration si lo hacemos en la maquina servidora o bien utilizando un navegador de Internet accediendo a la dirección web donde servidor es la dirección o nombre del servidor en el que se está ejecutando y 8001 es el puerto de escucha por defecto (en el paso 2.5 se explica como cambiarlo si hubiera algún conflicto). A continuación podemos ver el mensaje de entrada al sistema que nos aparece cuando nos conectamos una vez instalada la aplicación:

10 Guía de Instalación de la Plataforma Página 10 / 18 [Fig 5] Entrada al sistema Desiinstallaciión de lla versiión con JBoss La desinstalación de la versión con JBoss es directa utilizando la opción correspondiente del menú de inicio Inicio>Programas >MetaSpace Portal>Uninstall. Antes de ejecutar esta desinstalación automática debemos eliminar la base de datos utilizada por MetaSpace Portal con el fin de no dejar basura en el sistema. Para ayudarnos en esta tarea podemos utilizar un comando denominado Remove database.cmd que encontrará en la carpeta metaspace_database dentro de la carpeta donde instaló el producto. Este comando también está accesible desde la opción siguiente de su menú de inicio: Inicio>Programas>MetaSpace Portal>Database scripts>remove MetaSpace Database. Para ejecutar dicho comando debemos seguir los pasos detallados en el apartado 3.4 de este documento para ejecutar el comando de creación de la base de datos. Consulte de nuevo dicho apartado si se encuentra con problemas. Installaciión de versiión para JBoss en un serviidor exiistente Si usted ya dispone de un servidor JBoss 4.0 o superior y desea instalar MetaSpace Portal en él como nueva aplicación siga los pasos detallados en el apartado 4 anterior hasta obtener una versión operativa de la plataforma tal y como se instala por defecto. A continuación haga lo siguiente: Copie toda la carpeta server\default\deploy\metaspaceportal dentro del directorio donde instalo el sistema a su servidor JBoss existente en la nueva carpeta correspondiente. Copie el archivo server\default\deploy\metaspace-ds.xml a la carpeta server\default\deploy de su servidor JBoss. Modifique el archivo server\default\deploy\jbossweb-tomcat55.sar\meta-inf\jboss-service.xml cambiando el valor de los atributos Java2ClassLoadingCompliance y UseJBossWebLoader a true.

11 Guía de Instalación de la Plataforma Página 11 / 18 Modifique el sistema de log de su servidor JBoss para interceptar los mensajes de MetaSpace de la forma apropiada editando su archivo server\default\conf\log4j.xml, como referencia vea la configuración existente en la instalación por defecto. Installaciión de lla versiión para BEA Webllogiic La instalación de MetaSpace Portal para BEA Weblogic asume que usted dispone de un servidor de BEA Weblogic correctamente instalado y conoce como desplegar aplicaciones y servicios en el mismo. No es propósito de esta guía el enseñar como desplegar aplicaciones en BEA Weblogic, por lo que no se entrará a explicar en profundidad cada una de las opciones disponibles. Veamos cuales son los pasos para la instalación de esta versión: 6..1 IInssttal lacci ión de la l basse de dattoss Este paso es común al proceso descrito para el caso del servidor de aplicaciones JBoss por lo que le remitimos al apartado 3.1 de este documento para realizar esta tarea Dessccarrga dell ssoffttwarre Para descargar la versión para BEA Weblogic acceda a la página web de MetaSpace Portal en la dirección y después de registrarse con sus datos (requiere una dirección de válida) acceda al apartado de descargas y descargue la versión correspondiente. La versión para BEA Weblogic del sistema se compone de un archivo ZIP comprimido que contiene todos los archivos de la aplicación. Este archivo debe ser desplegado dentro del servidor de aplicaciones Weblogic para lo cual como primer paso descomprimimos el contenido del archivo dentro de la carpeta applications del servidor de aplicaciones Weblogic. Esta carpeta esta situada bajo la carpeta con el nombre del dominio gestionado por el servidor Conffi igurracci ión de la l basse de dattoss Antes de ejecutar el servidor de aplicaciones es necesario crear dentro del servidor de Oracle la base de datos que utilizará el sistema y configurar el servidor para que la use. El sistema viene preconfigurado para conectarse a una base de datos utilizando el nombre de usuario metaspace y la contraseña mtsp. Si lo desea usted puede utilizar otro usuario y contraseña pero entonces deberá modificarlos adecuadamente cuando cree su DataSource dentro de Weblogic como veremos más adelante. Cree ahora un tablespace y un usuario en su servidor Oracle para albergar los datos que utilizará el sistema. Para ayudarle en esta tarea puede utilizar un comando de consola denominado Create database.cmd que encontrará en la carpeta database dentro de la carpeta donde descomprimió el producto. Para poder ejecutar correctamente este comando deberá de disponer de un cliente de Oracle instalado en la máquina desde la que desea ejecutar el comando. Como ya le indicamos en el primer paso si está instalando el software en el mismo ordenador donde tiene instalado Oracle entonces no tendrá ningún problema ya que tendrá instalado dicho cliente, en caso contrario instale el cliente de Oracle. El comando que le hemos indicado asume que el superusuario de Oracle system tiene como contraseña manager, y que se está ejecutando en la misma máquina en la que se encuentra Oracle. Si este no es el caso el comando fallará y le pedirá que suministre un nombre de usuario con permisos para crear usuarios y

12 Guía de Instalación de la Plataforma Página 12 / 18 tablespaces y una contraseña válidas. En el caso de que este ejecutando el comando en una máquina diferente a aquella en la que está instalado Oracle deberá indicar el nombre del servicio de red al introducir el nombre del usuario de la forma usuario@nombre_servicio_red. El comando anterior creará un tablespace (archivo de datos) denominado METASPACE.ORA dentro de la carpeta database en el directorio donde se instaló la aplicación, y creará un usuario denominado metaspace con contraseña mtsp para acceder a la base de datos Desspl liegue denttrro de Weblogicc En el paso 5.2 descomprimimos el archivo ZIP que contiene todos los archivos de la aplicación dentro de la carpeta applicacions de Weblogic. Para desplegar dentro del servidor de aplicaciones Weblogic la aplicación realizaremos las siguentes tareas: Accedemos a la consola web de administración de weblogic con nuestro usuario y contraseña de administración. En el árbol de la izquierda seleccionamos Deployments>Applications accediendo a nuestra lista de aplicaciones instaladas. Si el servidor está en modo desarrollo entonces nos habrá detectado la nueva aplicación y nos la habrá desplegado automáticamente dándole un nombre automático, en ese caso la borramos pulsando en el icono a la izquierda del nombre y seleccionamos la opción Deploy a new application. Seleccionamos la carpeta donde hemos descomprimido la aplicación y pulsamos el botón continue. Dejamos el nombre de la aplicación por defecto a metaspaceportal y pulsamos el botón deploy para desplegarla. [Fig 6] Opciones para desplegar una nueva aplicación en Weblogic Configuramos ahora un nuevo pool de conexiones a la base de datos. Para ello en el árbol de la izquierda seleccionamos Services>JDBC>Connection Pools accediendo a nuestra lista de pools de base de datos. Seleccionamos la opción Configure a new JDBC Connection Pool y rellenamos los datos de la conexión que como por defecto se recomienda que sean: Name=metaspacePool Database type=oracle Database driver=oracle s driver (thin) version 9.0.1

13 Guía de Instalación de la Plataforma Página 13 / 18 Database name=orcl (o xe si la base de datos es Oracle Express Edition) Host name=localhost (si la base de datos está en la misma máquina) Port=1521 Database Username=metaspace Password=mtsp [Fig 7] Creación de un nuevo pool de conexiones Una vez introducidos los parámetros pulse el botón de Test Driver Configuration para comprobar que la conexión es correcta. A continuación pulse el botón de Create and deploy para crear y desplegar el pool. El pool recién creado debe de ser modificado para mejorar su rendimiento para ello se selecciona el pool por su nombre en el árbol de la izquierda, y en la pestaña Connections se configuran los siguientes parámetros con estos valores (algunos de estos parámetros son avanzados y debe mostrarlos pulsando sobre Show en la sección de Advanced Options): Initial capacity=10 Maximum capacity=150 Capacity increment=50 Test Reserved Connections=true Test Created Connections=true Test Released Connections=true Test Table Name=configuration Init SQL=SQL ALTER SESSION SET NLS_SORT=SPANISH (solo si la base de datos se va a inicializar para español) Una vez introducidos estos valores pulsamos el botón Apply para aplicar los cambios. Finalmente configuramos un nuevo DataSource para que la aplicación se conecte a la base de datos a través de el. Para ello en el árbol de la izquierda seleccionamos Services>JDBC>Data Sources accediendo a nuestra lista de fuentes de datos. Seleccionamos la opción Configure a new JDBC Data Source y rellenamos los datos de la conexión que obligatoriamente deben ser: Name=metaspaceDataSource JNDI Name=metaspacedb Pool Name=metaspacePool (creado previamente)

14 Guía de Instalación de la Plataforma Página 14 / Ejeccucci ión dell sserrvi idorr Una vez finalizada su instalación debe reiniciar la ejecución del servidor de aplicaciones Weblogic. Una vez arrancado el servidor ya podemos iniciar la ejecución de MetaSpace Portal, para ello accedemos utilizando un navegador de Internet a la dirección web donde servidor es la dirección o nombre del servidor en el que se está ejecutando y puerto es el puerto de escucha del servidor (por defecto en Weblogic dicho puerto es el 7001). A continuación vemos el mensaje que se nos muestra al iniciar por primera vez la aplicación: [Fig 8] Mensaje de licencia al entrar por primera vez Debemos aceptar la licencia para continuar con la instalación IImporrttacci ión de loss l dattoss Una vez aceptada la licencia en el paso anterior el sistema intentará conectar con la base de datos. Si todo ha ido bien nos aparecerá una página para proceder a importar los datos de partida del sistema. Sin embargo si se ha producido algún error obtendremos una página con el siguiente mensaje: [Fig 9] Mensaje de error al conectar con la base de datos

15 Guía de Instalación de la Plataforma Página 15 / 18 El mensaje de error anterior indica que no ha podido conectar con la base de datos, esto puede ser debido a varias razones (el mensaje suele dar pistas sobre lo que ha sucedido), veamos cuales son y la solución al problema: No ha creado una base de datos correctamente en el sistema. Por favor repase los pasos previos 2.1 y 2.4 para asegurarse de que ha creado un tablespace y un usuario en Oracle y dispone de un nombre de servicio de red correcto apuntando a la máquina donde tiene Oracle instalado. El DataSource (conexión a la base de datos ) de Weblogic no está correctamente configurado. Compruebe de nuevo el pool de conexiones (utilice la opción que proporciona Weblogic para comprobar si la conexión es correcta) y compruebe que el nombre JNDI del DataSource es metaspacedb. Una vez realizados los cambios reinicie el servidor Weblogic. Vuelva a entrar en la aplicación, si todo está correcto después de aceptar la licencia debería obtener una página con el siguiente mensaje: [Fig 10] Preparados para importar los datos iniciales En la pantalla anterior debemos introducir la contraseña del usuario system de la base de datos que por defecto es manager) y al pulsar el botón se iniciará un proceso de importación de Oracle que cargará en base de datos los datos iniciales de la aplicación. Si el idioma del navegador es español se cargará los datos en español, en caso contrario se cargarán los datos en inglés. El proceso de carga puede llevar algo de tiempo. Si se produce un error por algún motivo se obtendrá una pantalla de error y se puede intentar una importación manual de los datos utilizando los comandos existentes dentro de la carpeta database donde instaló la aplicación denominados Import english data o bien Import spanish data. Si la importación es correcta aparecerá una pantalla con el siguiente mensaje:

16 Guía de Instalación de la Plataforma Página 16 / 18 [Fig 11] Importación de datos inicial finalizada correctamente En la pantalla anterior basta pulsar el botón finalizar para acabar la instalación Conffi igurracci ión de parrámettrross de ejeccucci ión Los datos que se cargan inicialmente en la base de datos preconfiguran la aplicación para su uso con JBoss. Si lo que deseamos es utilizar Weblogic será necesario cambiar las rutas de tres parámetros de configuración existentes dentro de la tabla configuration en la base de datos de la aplicación. Estos tres parámetros son: logs_directory, cache_directory, y temporal_directory. Vaya al apartado 7 de este documento para aprender a realizar esta tarea Enttrrada a la l apliccacci ión Si hemos conseguido una correcta instalación de la aplicación al final obtendremos una pantalla con el un mensaje que nos informa de ello y que nos dice que podemos acceder a la aplicación utilizando el usuario administrador por defecto admin con contraseña admin. A continuación podemos ver el mensaje de entrada al sistema que nos aparece cuando nos conectamos una vez instalada la aplicación: [Fig 5] Entrada al sistema

17 Guía de Instalación de la Plataforma Página 17 / 18 Conffiiguraciión de parámetros de lla aplliicaciión Algunos de los parámetros de ejecución del sistema pueden personalizarse accediendo a la tabla configuration en la base de datos. Los parámetros de esta tabla están preconfigurados para la ejecución de MetaSpace Portal con JBoss, si usted está instalando la versión para Weblogic necesitará cambiar al menos los tres parámetros siguientes: logs_directory: carpeta donde se almacenarán los archivos de mensajes, por defecto apunta a la carpeta de JBoss server\default\log. En JBoss los archivos de log se configuran en el archivo server\default\conf\log4j.xml por lo que este parámetro debe apuntar a la carpeta configurada en Log4J. Para Weblogic modifique este valor así como el archivo de configuración de Log4J situado en applications\metaspaceportal\metaspace\web-inf\classes. temporal_directory: carpeta de trabajo temporal, ajuste la ruta a una carpeta del sistema válida. En JBoss s la carpeta por defecto es server/temp. Si esta carpeta no está correctamente ajustada no podrá cargar archivos (imágenes, documentos, etc) en el gestor de contenidos del sistema. Ajuste esta carpeta correctamente si está instalando la versión de Weblogic a la carpeta que usted prefiera. cache_directory: carpeta donde se creará la caché de archivos, ajuste la ruta a la carpeta donde se almacenará la caché de archivos. En JBoss la caché de archivos está en la carpeta server\default\deploy\metaspaceportal\metaspace.war\cache. La carpeta de caché debe de ser accesible desde un navegador de Internet dado que habrá enlaces a sus archivos dentro de las páginas web. Para el caso de Weblogic se recomienda cambie este valor a la ruta completa de la carpeta applications\metaspaceportal\metaspace\cache. Veamos ahora para que sirven el resto de parámetros de configuración: registersxpage_lists: número de registros por página en los listados de la aplicación. pagesxsector_lists: número de páginas visibles en la parte inferior de los listados. portlet_instance_expiration: número de segundos que se espera antes de invalidar de forma automática una instancia de un portlet. Este valor no tiene demasiada influencia en el sistema y se recomienda no cambiarlo. allowed_file_extension: lista de extensiones de archivo separadas por comas que se permiten cargar en el sistema mediante la consola de administración. El adaptador de WebDAV permite cargar cualquier tipo de archivo. Si se desea permitir la carga de un nuevo tipo de contenido (por ejemplo archivos EXE ejecutables) su extensión debe añadirse a esta lista. cache_url: dirección web relativa para acceder a la caché de archivos, por defecto si la caché se almacena en una carpeta denominada cache dentro de la aplicación web el valor de este parámetro será cache/. Esta es la configuración recomendada. rotation_logs_size: número de registros máximo permitido en las tablas de log de base de datos log_access (registro de los accesos a los portales), y log_operations (registro de las operaciones en el sistema) antes de comenzar a eliminar registros en las mismas. portlet_modes_supported: modos soportados por el gestor de portales compatible JSR-168. window_states_supported: estados de ventana de los portlets soportados por el gestor de portales compatible JSR-168. session_timeout: tiempo máximo de inactividad permitido antes de invalidar una sesión de trabajo con la aplicación. Si la sesión caduca se emite un mensaje y se retorna a la página principal.

18 Guía de Instalación de la Plataforma Página 18 / 18 mail_server: dirección del servidor de donde se enviarán notificaciones del sistema tales como por ejemplo cuando un usuario solicita una inscripción en un portal. mail_sender: dirección que aparecerá como remitente cuando se envían notificaciones del sistema tales como por ejemplo cuando un usuario solicita una inscripción en un portal. Los parámetros anteriores de configuración son cargados al arrancar la aplicación y por tanto si se cambia un valor deberá ser rearrancada o redesplegada la aplicación para que surta efecto. Para evitar esto y recargar los parámetros si cambia un valor, puede acceder al apartado de Gestión de Plataforma>Depuración dentro de la aplicación y pulsar la opción que está arriba a la derecha denominada Liberar cache y memoria. Esta opción forzará una liberación de memoria y recargará los datos de configuración de la base de datos. Acceso a llos archiivos de depuraciión A veces resulta útil acceder a los mensajes de depuración de la aplicación para detectar posibles errores de funcionamiento. Los archivos de depuración se gestionan mediante el producto Log4J por lo que para cambiar las opciones de depuración debe de conocerse como configurar dicho producto. Consulte la documentación de Log4J en el siguiente enlace: La configuración por defecto del sistema de log para JBoss sitúa los archivos de log en la carpeta server\default\log dentro de la carpeta donde se instaló la aplicación. En el caso de Weblogic se recomienda situar los archivos de log dentro de una carpeta denominada metaspace-logs que situaremos dentro de la carpeta con el nombre del dominio gestionado por Weblogic, al mismo nivel que la carpeta applications. Esta carpeta no existe en Weblogic y debemos de crearla. Por defecto el sistema de log está configurado para que se generen dos archivos de log denominados metaspace-web.log y metaspace-portal.log. El primer archivo recoge mensajes de funcionamiento de la aplicación mientras que en el segundo aparecen mensajes de funcionamiento de los portlets que componen las páginas de los portales. Si el parámetro logs_directory está correctamente configurado en la tabla configuration de la base de datos usted podrá leer el contenido de los archivos de log directamente desde la opción Gestión de Plataforma>Depuración dentro de MetaSpace Portal, sin necesidad de tener un acceso físico a los mismos dentro del servidor lo cual es útil para ver que está sucediendo en el sistema.