3.1.0 Community www.metaspaceportal.com Guía Rápida de Instalación Revisión 1.0
Guía de Instalación de la Plataforma Página 2 / 11 Índice 1. Introducción...3 2. Requisitos técnicos...3 3. Instalación rápida de la versión para JBoss + MySQL...3 3.1 Descarga del software...4 3.2 Ejecución del instalador...4 3.3 Arranque del servidor...4 3.4 Entrada a la aplicación...6 4. Configuración avanzada de la base de datos...7 4.1 Inicio de la base de datos MySQL sin arrancar JBoss...7 4.2 Inicio de JBoss sin arrancar la base de datos MySQL...7 4.3 Scripts de creación de la base de datos y cambio de idioma...7 4.4 Cambios en la configuración de la base de datos...8 4.5 Resolución de conflictos con instalaciones previas de MySQL...9 5. Desinstalación de la versión con JBoss...9 6. Acceso a los archivos de depuración...10 7. Configuración de parámetros de la aplicación...10
Guía de Instalación de la Plataforma Página 3 / 11 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 a conseguir una rápida instalación de MetaSpace Portal en uno de los posibles entornos de producción para los cuales está certificado, el servidor de aplicaciones gratuito y de código abierto JBoss y la base de datos MySQL también gratuita y de código abierto. 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 Community que contiene el servidor de aplicaciones gratuito JBoss y la base de datos MySQL incorporadas ya que el propio servidor de aplicaciones y base de datos se instalarán y configurarán automáticamente a la vez que se instala el producto. Si desea una descripción más detallada del proceso de instalación puede descargarse desde la página web de MetaSpace Portal la guía detallada de instalación de la plataforma, la cual le guiará con más detalle sobre el proceso a seguir incluyendo su instalación en el servidor de aplicaciones comercial BEA Weblogic. Requiisiitos técniicos Los requisitos técnicos de MetaSpace Portal son disponer de una base de datos MySQL 5, Oracle 8i o SQLServer 2005 o versiones superiores y de un servidor de aplicaciones certificado para el producto: JBoss o BEA Weblogic. La versión autoinstalable está preparada para arrancar directamente sin necesidad de configuración adicional usando MySQL 5 como base de datos y JBoss como servidor de aplicaciones. Si quiere probar con otra base de datos puede obtener una versión gratuita de Oracle 10g Express Edition en el siguiente enlace: http://www.oracle.com/technology/products/database/xe/index.html. Sin embargo para usarla necesitará configurar MetaSpace Portal adecuadamente dado que inicialmente está preconfigurado con MySQL lo cual puede ser complicado si no es un usuario avanzado. Los requisitos de utilización en la parte cliente se reducen a un navegador Firefox, o Internet Explorer 6 o superior. Aunque los portales generados por la plataforma son para cualquier navegador el panel de administración sólo puede ser operado utilizando Internet Explorer o Firefox para acceder al mismo. NOTA: 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. Installaciión rápiida de lla versiión para JBoss + MySQL La versión de MetaSpace Portal para JBoss con MySQL 5 integrada ha sido diseñada para que sea fácil de instalar de tal forma que no se requieran conocimientos ni de bases de datos ni de servidores de aplicaciones J2EE.
Guía de Instalación de la Plataforma Página 4 / 11 La versión para JBoss instalará junto con el sistema un servidor de aplicaciones JBoss y la base de datos MySQL completamente configurados y listos para funcionar. JBoss y MySQL son productos de código abierto y gratuitos 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 Dessccarrga dell ssoffttwarre Para descargar la versión para JBoss acceda a la página web de MetaSpace Portal en la dirección http://www.metaspaceportal.com y después de registrarse con sus datos (requiere una dirección de email válida) acceda al apartado de descargas y descargue la versión correspondiente. 3..2 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 Community 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. 3..3 Arrrranque 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 Community>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. [Fig 1] Consola con JBoss correctamente arrancado y a la escucha Simultáneamente a la ventana anterior nos aparecerá en pantalla (de forma minimizada) otra ventana que arranca la base de datos MySQL 5. La ventana en cuestión es la siguiente:
Guía de Instalación de la Plataforma Página 5 / 11 Pasados unos instantes podremos cerrar esa ventana previa confirmación en el administrador de tareas de que existe un proceso msqld-nt.exe ejecutándose. Dicho proceso se trata de la base de datos MySQL y por tanto si lo finalizamos nos quedaremos sin base de datos y el sistema no funcionará. Cerrar la ventana anterior de arranque de la base de datos no parará la base de datos, para pararla una vez arrancada deberíamos entrar al administrador de tareas y matar el proceso. Por otro lado finalizar la ejecución de JBoss tampoco parará la base de datos. Como regla práctica no es necesario comprobar en el administrador de tareas si el proceso de MySQL ha sido arrancado antes de cerrar la ventana. La ventana de arranque de base de datos puede intentar cerrarse usando el botón de cerrar ventana normal, en ese caso si el proceso no está arrancado todavía me saldrá un mensaje de que aún no se puede cerrar esa ventana, si la ventana cierra sin mensaje es que la base de datos ya está en ejecución. Puede suceder que al arrancar JBoss no me aparezca la ventana de base de datos, esto sucederá cuando el proceso de MySQL ya esté arrancado. Esto puede ser debido a que la base de datos continúa arrancada
Guía de Instalación de la Plataforma Página 6 / 11 de una sesión de trabajo anterior o bien a que ya tuviera previamente instalado MySQL en mi máquina antes de instalar MetaSpace Portal y configurado como servicio. Si ya tenemos arrancado MySQL en la máquina porque se esté usando para otro software entonces lógicamente la base de datos incorporada a MetaSpace no arrancará dado que ya existe un proceso de MySQL en ejecución. Podemos resolver este problema matando el proceso previo de base de datos antes de ejecutar JBoss teniendo en cuenta que entonces aún cuando MetaSpace funcione correctamente el software previo dejará de hacerlo. Lo lógico es que si tengo dos o más productos instalados en mi ordenador que utilizan MySQL entonces sólo tenga una instancia en ejecución de MySQL con todas las bases de datos necesarias. Consulte el apartado de esta guía en la que se explica como conseguir esto. En casos muy poco frecuentes también puede suceder que JBoss arranque tan rápido que no le de tiempo a inicializar la base de datos en MySQL y por tanto no pueda ejecutar la aplicación. En ese caso la solución más sencilla es cerrar JBoss y arrancarlo de nuevo dado que, como la base de datos no se cierra al cerrar JBoss, esta estará activa cuando lo arranquemos de nuevo. 3..4 Enttrrada a la l apliccacci ión A partir de ahora para entrar en la aplicación utilizaremos el enlace del menú de inicio Inicio>Programas >MetaSpace Portal Community>MetaSpace Portal Administration si lo hacemos en la maquina servidora o bien utilizando un navegador de Internet accediendo a la dirección web http://servidor:8001/metaspace 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. A continuación podemos ver el mensaje de entrada al sistema que nos aparece cuando nos conectamos una vez instalada la aplicación. Para entrar al sistema por primera vez usaremos el usuario administrador por defecto admin con contraseña admin. [Fig 5] Entrada al sistema
Guía de Instalación de la Plataforma Página 7 / 11 Conffiiguraciión avanzada de lla base de datos La mayor parte de los usuarios nunca realizarán las tareas aquí descritas. Sin embargo para aquellos usuarios más avanzados se detallan a continuación algunas opciones de configuración avanzadas que puede resultar útil conocer: 4..1 IIni icci io de la l basse de dattoss MySQL ssi in arrrranccarr JJBossss La base de datos MySQL 5 integrada en la versión autoinstalable de MetaSpace normalmente se arrancará automáticamente al arrancar JBoss. Sin embargo podemos arrancar la base de datos sin arrancar JBoss usando un archivo de proceso por lotes run.bat que se encuentra en la siguiente ruta: PATH\MetaSpace Portal Community\MySQL5\run.bat La ejecución del archivo anterior arrancará la base de datos integrada con el producto. Además es posible instalar como servicio la base de datos de forma sencilla con lo que se iniciará cada vez que arranquemos Windows. Para ello utilice el programa MySQLInstanceConfig.exe que se encuentra en la subcarpeta bin dentro de la carpeta MySQL5 en MetaSpace y acceda a la ayuda de MySQL en la web donde le explicarán como hacerlo. 4..2 IIni icci io de JJBossss ssi in arrrranccarr la l basse de dattoss MySQL Si desea arrancar JBoss sin arrancar la base de datos MySQL integrada, bien porque vaya a usar otro tipo de base de datos o bien por cualquier otra circunstancia, simplemente edite el contenido del archivo run.bat que se encuentra en PATH\MetaSpace Portal Community\bin\run.bat y elimine del mismo la línea 2 que contiene: cmd /c start /min cmd /c "../MySQL5/run inside jboss.bat" 4..3 Sccrri ipttss de ccrreacci ión de la l basse de dattoss y ccambi io de idii ioma Existen una serie de scripts de creación de la base de datos en la carpeta PATH\MetaSpace Portal Community\MySQL5\metaspace_scripts. En la carpeta anterior nos encontramos con dos archivos denominados setup_english_database.cmd y setup_spanish_database.cmd. Ejecutando uno u otro archivo procedemos al borrado de la base de datos actual y a su reinicialización en inglés o en español respectivamente. NOTA: tenga cuidado al ejecutar estos procesos dado que provocarán la pérdida de todos los datos que actualmente tuviera en el sistema. Los procesos anteriores utilizan los scripts SQL que existen en esa misma carpeta ejecutándolos dentro de MySQL. Estos procesos también están accesibles desde accesos directos en el menú de inicio usando la opcíon Inicio>Programas >MetaSpace Portal Community>Database scripts.
Guía de Instalación de la Plataforma Página 8 / 11 Además en la carpeta de scripts encontrará también un proceso denominado backup_database.cmd que genera un script SQL en la misma carpeta denominado backup.sql con el contenido de la base de datos. 4..4 Cambioss en la l cconffi igurracci ión de la l basse de dattoss Puede acceder a la base de datos de MySQL directamente con un editor SQL utilizando como usuario metaspace y como contraseña sadim. Un buen editor gratuito para MySQL denominado TOAD puede ser descargado de la siguiente dirección: http://www.quest.com/toad-for-mysql/ Si desea conectar como administrador de la base de datos use como usuario root y como contraseña sadim. De esta forma podrá efectuar cualquier opción de configuración avanzada en la base de datos. Si lo que desea es utilizar otra base de datos con MetaSpace o bien cambiar el usuario y contraseña de conexión a la base de datos deberá reconfigurar el DataSource utilizado por la aplicación dentro de JBoss. El fichero de configuración del DataSource que es necesario editar se encuentra en la ruta: PATH:\MetaSpace Portal Community\server\default\deploy\metaspace-ds.xml El contenido por defecto del archivo es el siguiente: <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>metaspacedb</jndi-name> <connection-url>jdbc:mysql://localhost:3306/metaspace</connection-url> <driver-class>com.mysql.jdbc.driver</driver-class> <user-name>metaspace</user-name> <password>sadim</password> <min-pool-size>50</min-pool-size> <max-pool-size>1000</max-pool-size> <exception-sorter-classname>com.mysql.jdbc.integration.jboss.extendedmysqlexceptionsorter</exceptionsorter-class-name> <valid-connection-checker-classname>com.mysql.jdbc.integration.jboss.mysqlvalidconnectionchecker</validconnection-checker-class-name> <metadata> <type-mapping>mysql</type-mapping> </metadata> </local-tx-datasource> </datasources> Como podemos ver se han marcado en amarillo aquellos parámetros que puede ser necesario modificar dependiendo de si deseamos cambiar el usuario de conexión a la base de datos o incluso el tipo de base de datos. Para más información consulte la ayuda de JBoss sobre configuración de DataSources. NOTA: Si cambia el tipo de base de datos (por ejemplo desea usar Oracle) entonces será necesario, además de modificar el archivo de configuración del DataSource, cambiar el archivo de configuración de Hibernate dentro de la aplicación denominado hibernate.cfg.xml. Dicho archivo se encuentra en la ruta siguiente: PATH:\MetaSpace Portal Community\server\default\deploy\metaspace.war\WEB-INF\ classes\sadim\metaspace\model\ hibernate.cfg.xml
Guía de Instalación de la Plataforma Página 9 / 11 Edite el archive anterior cambiando la propiedad hibernate.dialect por la correspondiente a la base de datos seleccionada, por defecto el valor que tiene es org.hibernate.dialect.mysql5dialect. Puede ver una lista de posibles dialectos en la siguiente dirección, elija el que corresponda con su base de datos: http://www.hibernate.org/hib_docs/v3/api/org/hibernate/dialect/package-summary.html 4..5 Ressol lucci ión de cconffl liccttoss ccon inssttal i lacci ioness prrevi iass de MySQL Como hemos visto en el apartado 3.3 la versión autoinstalable de MetaSpace Portal integra una base de datos MySQL 5 preconfigurada para su uso que se arranca automáticamente junto con el servidor de aplicaciones. Esta instalación permite ejecutar el sistema sin necesidad de configurar nada, sin embargo puede presentar problemas en el caso de que ya tengamos una base de datos de tipo MySQL previamente instalada y ejecutándose en nuestra máquina. Esto puede deberse a que sea necesaria por otro tipo de software que ta tengamos instalado. Una forma rápida de solucionar la situación descrita sería entrar al administrador de tareas y parar la base de datos MySQL previa ya que esto me permitiría arrancar MetaSpace Portal en JBoss con la base de datos integrada. Esta solución es válida para realizar una prueba rápida pero, lógicamente, parar la base de datos previa hará que la aplicación que la use deje de funcionar. Si queremos que ambas aplicaciones funcionen sobre la misma instancia de MySQL no nos quedará más remedio que crear las dos bases de datos, la ya preexistente y la de MetaSpace, sobre la misma instancia de MySQL. Si optamos por instalar MetaSpace sobre la instancia de MySQL preexistente deberíamos hacer lo siguiente: Entrar en la instancia de MySQL preexistente como administrador root usando una herramienta como TOAD o similar. Crear una nueva base de datos para MetaSpace que llamaremos metaspace. Crear un usuario llamado metaspace con contraseña sadim con permisos de acceso a esa nueva base de datos. Si cambiamos el nombre del usuario o la contraseña tendremos luego que configurar el DataSource de JBoss en el archivo metaspace-ds.xml tal y como se explica en el apartado 4.4 de este documento modificando las propiedades user-name y password. Salir de sesión con root y entrar con el usuario creado de acceso a la base de datos metaspace creada en el paso anterior. Ejecutar el script de creación de la base de datos descrito en el apartado 4.3 dependiendo del idioma deseado. Configurar JBoss para que no arranque la base de datos MySQL integrada al arrancar el sistema tal y como se describe en el apartado 4.2. 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 Community>Uninstall. Antes de ejecutar esta desinstalación automática debemos finalizar el proceso de base de datos de MySQL si este se encontrara activo. Para ello debemos comprobar si dicho proceso llamado msqld-nt.exe existe en el administrador de tareas.
Guía de Instalación de la Plataforma Página 10 / 11 Simplemente finalizaríamos dicho proceso y ejecutaríamos la opción de desinstalación de la aplicación tal y como mencionamos. 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. La configuración por defecto del sistema de log para JBos sitúa los archivos de log en la carpeta PATH:\MetaSpace Portal Community\server\default\log. 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. 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. Finalmente si es un usuario avanzado y desea cambiar la configuración del sistema de log de MetaSpace tenga en cuenta que está basado en Log4J y puede configurarlo a su gusto editando el archivo log4j.xml existente en la siguiente ruta: PATH:\MetaSpace Portal Community\server\default\deploy\metaspace.war\WEB-INF\ classes\log4j.xml 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
Guía de Instalación de la Plataforma Página 11 / 11 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\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\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. mail_server: dirección del servidor de email 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.
Guía de Instalación de la Plataforma Página 12 / 11 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.