manual de actualización de agrega v3.0.2
Contents
1. 5 3 Apendice C Migraci n de Licencias Si la versi n que tiene instalada la comunidad es anterior a la versi n 1 2 habr que ejecutar un script de migraci n de las licencias como paso de la migraci n Este script a ade un fichero licencia txt dentro del ode con el texto legal de la licencia asociada Este script de migraci n consta de los siguientes ficheros migracionOdesRepositorio zip Contiene los textos legales de todas las licencias soportadas por Agrega y el programa Java que se va a ejecutar durante la migraci n migracion properties Fichero de propiedades en el que se definir la ruta donde se encuentra el repositorio con los odes publicados migracionOdes sh script que lanza la llamada al programa Java Los pasos previos a realizar antes de lanzar el script de migraci n son los siguientes mkdir url_carpeta donde url_carpeta es el directorio f sico donde se copiar n los tres ficheros detallados anteriormente cp migraci n url carpeta dos2unix url carpeta chown R jboss user jboss group url carpeta cd url carpeta migracionOdes sh indra e agrega 25 Tambi n es muy importante realizar antes de la ejecuci n una copia de seguridad de todo el indra repositorio de odes publicados Durante la ejecuci n del script aparte de preguntar al usuario si ha realizado la copia de feum seguridad de la carpeta repositorio le pregunta si quiere sobrescribir la licencia en el2. MANUAL DE ACTUALIZACI N DE AGREGA V3 0 2 Plataforma de objetos digitales educativos AGREGA Autores Daniel Gonz lez Versi n 1 0 Fecha 07 05 2010 SECRETARIA OX ESTADO indra ONES Y FARA LA SODEDAD OK LA INFONMAO ON HISTORIA DEL DOCUMENTO e Versi n v1 0 Descripci n Creaci n del documento agrega Elaborado por Daniel Gonz lez D az Fecha 07 05 2010 Fernando Soto Revisado por Fecha 10 05 2010 Calidad Aprobado por LISTA DE DISTRIBUCI N Nombre Localizaci n Fernando Soto fsotoO indra es Manuel Canabal josemanuel canabal Red es Juan Carlos Sacrist n Heras JuanCarlos Sacristan Q Red es Carolina Morera cmorera indra es EXP 843 08 SD Evoluci n De La Plataforma De Objetos Digitales Educativos Agrega Actualizaci n a Agrega 3 0 0 INDICE 1 INTRODUCCI N INE riadas id ad 1 2 Definiciones acr nimos y abreviaturas oooocccconoccccnononcccnononcncnononnncnanonnncnann nn nn naar nnnnnnanns 3 E S 3 1 4 Nomenclatura de alias paths f sicos sssssssseeeenmeene 3 2 ee decidere aa 5 2 1 Mejoras incorporadas a 5 3 Contenidos del entregable Agrega 3 0 2 6 4 Actualizaci n de Agrega 2 0 1 a 3 0 2 sssssssssssssssesee entere nennen enne 7
3. im genes y ficheros servidos por Apache Ejemplos de configuraci n de Apache para Agrega Scripts para configurar los archivos de Agrega Plantillas de informes de Agrega Ficheros de configuraci n de Agrega Ficheros para desplegar en SUPLOADS Carpeta de im genes para la Wiki de Agrega Recursos de instalacion y configuraci n de ESB Scripts de creaci n y poblado de base de datos Scripts de migraci n de base de datos Dumps de la base de datos de la Wiki Agrega Utilidad de migraci n para modificar registro indra agrega 4 Actualizaci n de Agrega 2 0 1 a 3 0 2 4 1 Copia de seguridad previa a la migraci n Antes de comenzar la migraci n de versi n se recomienda realizar la copia de seguridad de los siguientes elementos Este paso es imprescindible para una marcha atr s en caso de que surjan problemas durante la migraci n Copia de los desplegables de la aplicaci n WARs Realice una copia de los war desplegados en el directorio WAR Estilos CSS e im genes Realice una copia de los ficheros de la aplicaci n servidos por Apache STATIC Configuracion de Apache Relice una copia de la configuraci n de Apache para Agrega etc httpd vhosts nodo vhost Ficheros de configuraci n de Agrega Realice una copia de la configuraci n de Jboss para Agrega BOSS CONF Informes de Agrega Realice una copia de las plantillas de informes de Agrega INFORMES plantillasInformes Ficheros de Agrega
4. im genes y recursos est ticos de Agrega a la localizaci n servida por Apache Previamente debe borrar los de la versi n anterior Borrado de los ficheros de versi n anterior rm rf S STATIC common Copia de los ficheros de la nueva versi n Xcp rf SDIR resources apache estaticos STATIC common La estructura de directorios de la carpeta de estaticos a cambiado sensiblemente con la versi n 3 0 1 por lo que se requiere eliminar los enlaces simb licos creados en STATIC ccaa nodo y crear nuevos enlaces simb licos Situese en el directorio STATIC ccaa nodo y ejecute los siguientes comandos ba o5 ood CITN bm lum enden 39 Sit ese en el directorio SSTATIC ccaa nodo css y ejecute los siguientes comandos ln s eommon css red sitio css red css ln s common css globales globales Donde red_sitio css es la hoja de estilos correspondiente a su nodo por ejemplo si se trata del nodo de Asturias apunte a red asturias css La hoja red css es la hoja de estilos por defecto de Agrega indra e agrega 10 Modifique la configuraci n de Apache etc httpd nodo vhost A continuaci n se muestra un indra vhost de ejemplo con las nuevas l neas resaltadas en negrita recuerde que en el caso de los comandos Rewriterule el orden en que est n dispuestos afectan al funcionamiento de la t m plataforma Los par metros PARAMETRO corresponden a informaci n pa
5. n Cada Comunidad Aut noma a la hora de realizar la actualizaci n tendr en su disposici n tanto el manual de instalaci n y operaci n como el documento de certificaci n de la instalaci n del nodo en donde se encontrar n fielmente reflejadas todas las configuraciones y rutas a tener en cuenta durante la actualizaci n documento de actualizaci n pretende ser una gu a en la que se resumen los pasos a realizar no siendo un manual de paso a explotaci n particularizado para cada Comunidad dada la diversidad de entornos en los que la plataforma Agrega se encuentra instalada Si bien junto al manual se facilitar a cada Comunidad Aut noma todos los ficheros entregables necesarios que sean comunes para todas las comunidades y aquellos de configuraci n o propiedades particularizados para cada nodo 1 2 Definiciones acr nimos y abreviaturas T RMINO DESCRIPCI N ARQ Arquitectura t cnica DES Desarrollo SEG Seguridad PRO Producci n SIS Sistemas S3 Simple Storage Service 1 3 Referencias Los documentos que se utilizar n como referencia para la actualizaci n ser n los siguientes DOCUMENTO OBSERVACIONES Manual de instalaci n y operaci n de la plataforma PODPL GIN Manual de Instalaci n y operaci n doc PODIN PLI 03 Certificado de instalaci n del Certificado instalaci n nodo de producci n doc nodo de producci n 1 4 Nomenclatura de alias paths f sicos Puesto que cada nodo de cada comuni
6. visualizador 1 1N jsp PT L RewriteRule visualizar va N html visualizador 1 1N html PT L RewriteRule visualizar va N js visualizador 1 1N js PT L RewriteRule visualizar va N swf visualizador 1 1N swf PT L RewriteRule visualizar gl X jsp 9 visualizador 1 11 3sp PT L RewriteRule visualizar gl N html visualizador 1 1N html PT L RewriteRule visualizar gl X Js 9 visualizador 1 51X 3s PT L RewriteRule visualizar gl N swf visualizador 1 1N swf PT L RewriteRule v suadldzar xk CES visualizador 1 Visualizar Visualizar do idioma 1 amp identificador 2 amp secuencia 3 amp comunidadAgrega tru e L ET Reglas de rewriting para las NOTICIAS RewriteRule portada noticias visualizadorcontenidos Portada NoticiasVer do id 2 PT L RewriteRule portada noticiasCategorias visualizadorcontenidos Portada NoticiasCategoria do idCategoria 2 RewriteRule noticias visualizadorcontenidos Noticias Noticias do RewriteCond QUERY STRING idCategoria amp PT L PT L indra e agrega 13 RewriteRule noticias categorias visualizadorcontenidos Noticia NoticiaCategoria do idCategoria 1 amp 2 PT L RewriteCond S QUERY_STRING amp idCategoria RewriteRule noticias categorias visualizadorcontenidos Noticia NoticiaCategoria do 1 amp idCategoria 2 PT L RewriteRule 4 noti
7. 4 1 Copia de seguridad previa a la migraci n sssssssseeeenee 7 4 2 Actualizaci n desde versi nes anteriores a 2 0 1 7 4 2 1 Pasos requeridos de la migraci n de 1 1 X a 1 2 0 8 4 2 2 Pasos requeridos de la migraci n de 1 2 0 a 1 2 1 8 4 2 9 Pasos requerido de la migraci n de 1 2 1 a 2 0 0 sss 8 4 2 4 X Pasos requeridos de la migraci n de 2 0 0 a 2 0 1 sssssssssssss 9 43 Migraci n de 2 0 1 a 3 0 1 a e Era kao stade ed 9 4 3 5 Configuraci n de los ficheros de Agrega sssessseee 9 4 3 6 Reemplazo mediante install sh ssseeeneen 10 4 3 7 Migraci n de los ficheros de Apache ssssssssseeeeemeene 10 4 3 8 Actualizaci n de los ficheros de propiedades de 55 14 4 3 9 X Actualizaci n de los ficheros de generaci n de im genes para la galeria 15 4 3 40 Copia de las plantillas de informes ssseeeeeene 15 4 3 11 Actualizaci n de la base de datos ooooncccnnccinnocococcccconnnononnnanonnnnncnnnnn eee 15 4 3 12 Migraci n de la base de datos para incluir huella MD5 de los objetos publicados 16 44 Migraci n de 3 0 1 3 0 2 eter ede Do n ideo e Fett e DL E ER EU na cus 18 4 4 13 Apagado de los servidores ooomoccccnnnncicinnnncccnnnnnccnnnnnccrrnnn nera 18 4 4 44 Copia de los desplegables de la aplicaci n sss 18 4 4 15 Actualizac
8. Realice una copia de las siguientes carpetas disponibles en UPLOADS xmls xslt utilidades sitemaps searchPlugin schemas schemaslmsp schemasScorm12 schemasVdex rss licencias HTML y galerialmg common Indices Realice una copia de los ndices de b squeda Se recomienda una copia comprimida tar cvzf BACKUP DIR indices tgz Base de datos Realice una copia de seguridad de la base de datos Dump El siguiente ejemplo es v lido para una base de datos MySQL Para otras bases de datos consulte el manual del proveedor mysqldump Gen E e 0 m SDBUSER password DBPASSWORD SDBNAME gt SBACKUP DIR SDBNAME sql Repositorio Realice una copia comprimida del repositorio de objetos de Agrega SUPLOADS repositorio tar cvzf BACKUP DIR repositorio tgz SUPLOADS repositorio 4 2 Actualizaci n desde versi nes anteriores a 2 0 1 La presente gu a de actualizaci n de Agrega est pensada para realizar una migraci n desde la versi n 2 0 0 En caso de que su nodo tenga instalada una versi n anterior deber realizar unos pasos adicionales en caso contrario salte a la secci n 4 3 A continuaci n se resumen brevemente los pasos necesarios para migrar desde la versi n 1 2 1 1 2 0 y la 1 1 2 previos a los pasos que se detallan en este documento Si su nodo es anterior a la versi n 1 1 2 se recomienda actualizar primero a la versi n 1 1 2 para poder seguir los pasos de
9. caso de que ya contenga el fichero licencia txt agrega 26
10. este documento Para mas informaci n sobre las migraciones consultar los documentos de migraci n de las versiones correspondientes e agrega indra 4 2 1 Pasos requeridos de la migraci n de 1 1 X a 1 2 0 feum Los pasos requeridos de la migraci n de Agrega 1 1 X a 1 2 0 son los siguientes agrega Ejecutar el script SQL de migraci n de base de datos migracion 1 1 x 1 2 0 sgl Modifica el esquema de la tabla TAGGING Modificar el fichero de configuraci n de Apache etc Rttpd vhost nodo vhost para incluir un nuevo alias Alias export export nodo uploads export Las versiones anteriores a la 1 2 0 requieren eliminar por completo los contenidos del directorio UPLOADS xmls y copiar los nuevos ficheros distribuidos en la carpeta uploads xmls del entregable 4 2 2 Pasos requeridos de la migraci n de 1 2 0 a 1 2 1 Los pasos requeridos de la migraci n de Agrega 1 2 0 a 1 2 1 son los siguientes Sobre la base de datos de Agrega ejecutar el script SQL de migraci n de base de datos migracion 1 2 0 1 2 1 sql Este script a ade una nueva tabla a la base de datos de Agrega tabla CACHE FICHEROS A adir al fichero de configuraci n de los pools de conexi n de base de datos de Jboss 4 BOSS HOME Server default deploy nodo ds xml un nuevo datasource entregarDS Sustituir los datos entre llaves por los especificos en la comunidad ver otros datasources del fichero Incluir el texto siguiente al fi
11. property gt property name vendor Jdk allowed pattern aix gt IBM lt property gt property name 1iop mutualauth port gt 3920 lt property gt property name iiop ssl port 3820 property property name vendor jdk allowed pattern macosx Apple property lt properties gt product product platform windows linux solaris sparc solaris x86 macosx ppc macosx x86 aix status to be installed uid openesb version 2 0 0 090514 0 gt properties property name installation location opt GlassFishESBv21 glassfish addons jbi components lt property gt lt properties gt lt product gt lt product platform windows linux solaris sparc solaris x86 macosx ppc macosx x86 aix status to be installed uid jbicomponents version 2 0 0 090515 0 properties property name installation location opt GlassFishESBv21 glassfish addons jbi components lt property gt lt properties gt lt product gt lt components gt lt state gt Lance la instalaci n de Glassfish mediante la ejecuci n del siguiente comando glassfishesb v2 1 full installer linux sh silent state ESBAgrega state xml Inicie el servidor Glassfish introduciendo usuario y password de administraci n Por defecto Glassfish crea un usuario admin con contrase a adminadmin Se le solicitar un tercer password que por defecto es changeit Estas contrase as podr n ser cambiadas desde la consola de ad
12. En la migraci n de 1 2 1 a 2 0 0 s lo cambian los agrega siguientes ficheros Ficheros modificados agrega properties authbackend properties importedServices properties Ficheros eliminados cas properties dependentServer properties e Nuevos ficheros logos resources properties Ejecute el script migracion_1 2 1 2 0 0 sql migraci n oracle 1 2 1 2 0 0 sgl para bases de datos Oracle usando su gestor de base de datos habitual Se recomienda verificar el contenido del script SQL para comprobar los cambios que se realizar n en la base de datos La versi n 2 0 de Agrega incorpora ficheros de licencia Creative Commons y EUPL traducidos al castellano Para poder incorporar los nuevos textos de licencia a los objetos del repositorio se proporciona un patch Aunque este paso no es imprescindible para migrar a la versi n 2 0 se recomienda ejecutar este patch durante la migraci n Descargue el fichero patch migracion licencias zip de la Forja de Agrega http forge morfeo project org frs group_id 81 y siga las instrucciones detalladas en el apendice C 4 2 4 Pasos requeridos de la migraci n de 2 0 0 a 2 0 1 Los pasos requeridos de la migraci n de Agrega 2 0 0 a 2 0 1 son los siguientes Modifique la configuraci n de Apache etc httpd vhost nodo vhost para incluir un nuevo parametro resaltado en negrita en la siguiente Rewriterule ya existente RewriteRule il telis eue Lok Los Cose visualizador 1 Visualiz
13. L PT TWIDGETS RewriteRule L PT RewriteMap escape int escape RewriteRule widgets grupo WidgetsGrupo grupo escape 1 amp numOdes 2 L PT widgets usuario 4 4 8 WidgetsUsuario usuario 1 amp numOdes 2 rewrite rule para los flash RewriteRule visualizar es N jsp visualizador 1 1N jsp PT L RewriteRule visualizar es N html visualizador 1 S 1N html PT L RewriteRule visualizar es N js visualizador 1 1N js PT L RewriteRule visualizar es N swf visualizador 1 1N swf PT L RewriteRule visualizar en N jsp visualizador 1 1N jsp PT L RewriteRule visualizar en N html visualizador 1 1N html PT L RewriteRule visualizar en N js visualizador 1 1N js PT L RewriteRule visualizar en N swf visualizador 1 1N swf PT L RewriteRule visualizar eu N jsp visualizador 1 1N jsp PT L RewriteRule visualizar eu N html visualizador 1 1N html PT L RewriteRule visualizar eu N js visualizador 1 1N js PT L RewriteRule visualizar eu N swf visualizador 1 1N swf PT L RewriteRule visualizar ca N jsp visualizador 1 1N jsp PT L RewriteRule visualizar ca N html visualizador 1 1N html PT L RewriteRule visualizar ca N js visualizador 1 1N js PT L RewriteRule visualizar ca N swf visualizador 1 1N swf PT L RewriteRule visualizar va N jsp
14. ads Por ejemplo si la carpeta uploads se encuentra en export nodo uploads el valor a configurar es export nodo Los datos que siguen son los relativos a la base de datos El caso mas habitual es que los bloques localizador y odePublicado sean iguales donde 16 db conexion driver Controlador JDBC para el acceso a la base de datos Introduzca MySQL si su base de datos es MySQL Oracle si su base de datos es Oracle o el nombre de la clase Java del driver de la base de datos si su base de datos es otra por ejemplo si su base de datos es Sybase el valor a introducir es com sybase jdbc SybDriver db conexion dialecto Dialecto de SQL que hibernate usara para comunicarse con la base de datos Para MySQL y Oracle los valores son MySQL y Oracle respectivamente Para otras bases de datos consultar http docs boss org hibernate core 3 3 reference en html session configuration htmlzzconfiguration optional dialects db conexion url Url de conexi n a la base de datos Este parametro tiene formatos diferentes en funci n de la base de datos a la que es necesario acceder Para MySQL la url es del tipo jdbc mysql host puerto esquema por ejemplo jdbc mysal dbserver com 3306 agrega Para Oracle la cadena de conexi n es del tipo jdbc oracle thin Q host puerto esquema por ejemplo jabc oracle thin Odbserver com 1521 agrega db conexion usuario Usuario de la base de datos db conexion clave Constrase a d
15. ar mediante el comando ps ef grep i java 2 Comprobar que en el fichero LOGS server log aparece la traza INFO org jboss system server Server Shutdown complete 4 4 14 Copia de los desplegables de la aplicaci n Copie los desplegables de la aplicaci n al directorio correspondiente del servidor de aplicaciones cp f SDIR bin wars plataforma war SWAR 4 4 15 Actualizaci n de los ficheros de propiedades de Jboss Copie los ficheros de propiedades de Jboss a la localizaci n correspondiente en el servidor de aplicaciones BOSS CONF En la migraci n de 3 0 1 a 3 0 2 s lo cambian los siguiente ficheros Ficheros modificados agrega properties Se afiade la propiedad secuencia sin logar con valor por defecto false 4 4 16 Actualizaci n de los ficheros de generaci n de im genes para la galeria En la migraci n de 3 0 1 a 3 0 2 cambian los siguiente ficheros Ficheros modificados generateimg sh Se a aden neas para generar ficheros de log 4 4 17 Copia de la carpeta uploads Copie los ficheros de Agrega a la carpeta UPLOADS Xcp rf SDIR resources uploads SUPLOADS 18 4 5 Instalaci n del ESB de Agrega Como novedad de la versi n 3 0 de Agrega se incorpora un ESB Enterprise Service Bus feum para exponer servicios de Agrega como la b squeda federada RSS REST o OAI ORE ESB de Agrega est basado en Open ESB de Sun y requiere un servidor de aplicac
16. ar Visualizar do idioma 1 amp identificador 2 amp secuencia 3 amp comunidadAgrega tru e L PT Ejecute el script de migraci n migraci n 2 0 0 2 0 x sql migraci n oracle 2 0 2 0 x sgl para bases de datos Oracle para modificar el esquema de base de datos 4 3 Migraci n de 2 0 1 a 3 0 1 4 3 5 Configuraci n de los ficheros de Agrega Copiar el TGZ de la forja al directorio de actualizaci n del servidor Descomprimir y se generaran los siguientes resources sql bin La plataforma Agrega dispone de un conjunto de ficheros de configuraci n y utilidades que requieren ser modificados para incorporar datos expl citos del nodo donde se va a instalar La relaci n de ficheros que tienen que ser modificados es la siguiente rutas relativas al ZIP o TGZ de agrega entregado resources jboss conf agrega properties resources jboss conf authbackend properties resources jboss conf springldap xml resources informes plantillasInformes rptdesign resources uploads rss opml resources uploads sitemaps estatico resources uploads searchPlugin searchPlugin xml Los valores que deben ser reemplazados dentro de los ficheros aparecen con los caracteres por ejemplo nodoj Para el reemplazo se proporcionan dos m todos reemplazo manual editando todos los ficheros para reemplazar los valores o reemplazo mediante el script resources bin install sh proporcionado con los entregables 4 3 6 Reemplazo mediante install
17. bin asadmin create jbi application variable component sun http binding configuracionESB properties indra e agrega 20 4 5 19 Despliegue de los componentes ESB de Agrega Una vez instalado y configurado el servidor ya se pueden desplegar los componentes ESB ic cm despliegue es tan sencillo como copiar los ficheros en el directorio autodeploy del servidor Glassfish agrega cp DIST bin zips esb zip opt GlassFishESBv21 glassfish domain domainl autodeploy servidor registra los mensajes de log en el fichero opt GlassFishESBv21 glassfish domain domainl logs server log 4 5 20 Configuraciones opcionales Dependiendo de su entorno puede ser necesario configurar un Proxy de salida al exterior el servidor Glassfish necesita acceso a Internet para las busquedas federadas Para esto desde su puesto de trabajo con acceso a la m quina donde se encuentra el servidor Glassfish abra un navegador web e introduzca la URL httpz ruta a glassfish 4848 Por ejemplo si la ruta a la maquina que alberga el servidor es servidor nodo es la ruta a la consola de administraci n ser a http servidor nodo es 4848 Glassfish le solicitar usuario y contrase a de administrador Estos son Usuario admin Password adminadmin Master Password changeit A continuaci n navegue hasta la configuraci n del Proxy de acceso para el componente sub http binding tal y como se muestra en la sig
18. cias categorias visualizadorcontenidos Noticia NoticiaCategoria do idCategoria 2 PT L HPAGINA PUBLICA RewriteRule A usuarios visualizadorcontenidos PaginaUsuarioPublico PaginaUsuarioPublico do usuario 1 L PT RewriteRule A grupos visualizadorcontenidos PaginaGrupoPublico PaginaGrupoPublico do nombre 1 L PT fJkLogLevel debug RewriteRule NN t 51 52 PT d Redirecciones al ESB ProxyPass rest2 http esb_host 81 rest ProxyPassReverse rest2 http esb_host 81 rest ProxyPass rss2 http esb_host 81 rss ProxyPassReverse rss2 http esb host 81 rss ProxyPass rssCompatibilidad rss http esb host 81 rssCompatibilidad rss ProxyPassReverse rssCompatibilidad rss http esb host 81 rssCompatibilidad rss ProxyPass WidgetsUsuario http esb host 81 WidgetsUsuario ProxyPassReverse WidgetsUsuario http esb host 81 WidgetsUsuario ProxyPass WidgetsGrupo http esb host 81 WidgetsGrupo ProxyPassReverse WidgetsGrupo http esb host 81 WidgetsGrupo ProxyPass buscar 1 http esb host 18001 buscar 1 ProxyPassReverse buscar 1 http esb host 18001 buscar 1 JkMount visualizadorcontenidos server name JkMount PortalEmpaquetador server name JkMount catalogadorWeb server name JkMount visualizador 1 server name JkMount portaladministracion server name JkMount buscador server name JkMount f drei lf server na
19. dad tendr instalado el software en directorios diferentes es necesario definir previamente una relaci n entre unos alias l gicos que se emplear n en la actualizaci n de este manual de los directorios y los paths f sicos y reales donde se encuentran A partir del documento de certificaci n del nodo de producci n podemos obtener las equivalencias simplemente consultando las entradas especificadas en la siguiente tabla Entrada en doc e Alias l gico certificado agrega JBOSS HOME PICO d optjboss boss ubicaci n de Jboss UPLOADS Directorio uploads opt jboss jboss uploads Directorio ficheros JBOSS_CONF opt jboss jboss server default conf configuraci n INDICES Directorio ndices opt jboss jboss indices INFORMES Directorio informes opt jboss jboss informes LOGS Directorio logs opt jboss jboss server default log Directorio d ubicaci n WAR opt jboss jboss server default deploy agrega de m dulos STATIC Directorio est ticos lopt static Directorio donde se DIST ls home agrega dist Agrega EXP 843 08 SD Evoluci n De La Plataforma De Objetos Digitales Educativos Agrega Actualizaci n a Agrega 3 0 0 2 Control de cambios La versi n 3 0 2 de Agrega contiene los siguientes cambios respecto a la versi n anterior e 3 0 1 agrega 2 1 Mejoras incorporadas Se permite login con identificadores de tipo correo electr nico Cambios en logos Selecci n de
20. dificado para contener algunas rutas propias del entorno donde va a ser instalado Estas rutas son la carpeta de instalaci n de Glassfish y la ruta a la m quina virtual de Java AVA HOME A continuaci n se muestra el contenido de ESBAgrega state xml con las l neas a modificar resaltadas en negrita state xmlns xsi http www w3 0rg 2001 XMLSchema instance xsi noNamespaceSchemaLocation state file xsd components product platform linux Status to be installed uid glassfish version 9 1 0 60e 20080411 gt lt properties gt lt property name password gt adminadmin lt property gt property name gt 3Jmx admin port gt 8686 lt property gt lt property name username gt admin lt property gt lt property name vendor jdk allowed pattern Sun Microsystems property property name jms port 7676 property property name maximum 3Jdk version gt 1 6 99 lt property gt property name minimum jdk version gt 1 5 0 lt property gt property name jdk location opt jdk property property name installation location gt opt GlassFishESBv21 glassfish lt property gt lt property name http port gt 9090 lt property gt lt property name https port gt 9191 lt property gt property name preferred jdk version macosx 1 5 0 13 0 property indra e agrega 19 property name admin port gt 4848 lt property gt property name iiop port gt 3100 lt
21. e acceso a la base de datos Una vez que haya configurado el fichero arreglatorMD5 properties puede ejecutar la migraci n mediante el comando migracionMD5 sh script le har dos preguntas que deber responder afirmativamente para poder continuar Tras un tiempo que depender del hardware disponible y del tama o del repositorio del nodo Agrega el script finalizar insertando en base de datos los codigos correspondientes a cada objeto Para comprobar que la migraci n ha funcionado correctamente puede entrar en la base de datos con su cliente habitual y ejecutar la sentencia SQL select ID O D E MD5 from ODE PUBLICADO La columna MD5 deber a tener valor para todos los objetos registrados en base de datos e agrega 17 4 4 Migraci n de 3 0 1 a 3 0 2 4 4 13 Apagado de los servidores e agrega Antes de realizar la migraci n de los archivos y base de datos de Agrega pare el servidor de Aplicaciones Para evitar que los usuarios que accedan a Agrega durante el apagado del servidor se recomienda modificar la configuraci n de Apache para redirigir las peticiones de Agrega a una p gina informando de los trabajos de actualizaci n Este paso no es imprescindible para la migraci n de Agrega Para comprobar que el servidor de aplicaciones se encuentra parado podemos seguir los dos siguientes pasos 1 Comprobar que el proceso no se encuentra en ejecuci n En Linux se podr a realiz
22. generateimg sh IMAGE FINAL SIZE 100x100 carrusel begin IMAGE MEDIUM SIZE 200x125 carrusel end carrusel begin echo Generando imagen medium date convert resize SIMAGE MEDIUM SIZE SUPLOADS_PATH 3 MD5PATH 1 1_captured jpg SUPLOADS PATH 3 MD5PATH 1 1 medium jpg carrusel end IS COMMON echo 2 grep uploads galeriaimg common resizeimg sh constantes UPLOADS PATH uploads galeriaimg IMAGE FINAL SIZE 100x100 carrusel begin IMAGE MEDIUM SIZE 200x125 carrusel end echo OK Imagen convertida correctamente date carrusel begin echo Generando imagen medium date convert resize SIMAGE MEDIUM SIZE SUPLOADS PATH 3 MD5PATH 1 1 captured jpg SUPLOADS PATH 3 MD5PATH 1 1 medium jpg carrusel end it echo o2 grep q uploads galeriaimg common 4 3 10 Copia de las plantillas de informes Copie las plantilas para los informes de Agrega en la localizaci n correspondiente del servidor de aplicaciones Ncp r SDIR resources informes plantillasInformes INFORMES 4 3 11 Actualizaci n de la base de datos Ejecute el script migracion_2 0 1 3 0 1 sql migraci n oracle_2 0 1 3 0 1 sql para bases de datos Oracle usando su gestor de base de datos habitual Se recomienda verificar el contenido del script SQL para comprobar los cambios que se realizar n en la base de datos 15 indra e agrega 4 3 12 Migraci n de la base de datos para incl
23. i n de los ficheros de propiedades de 55 18 4 4 16 Actualizaci n de los ficheros de generaci n de im genes para la galeria 18 4 4 17 Copia de la carpeta uploads sse 18 4 5 Instalaci n del ESB de Agrega sssssssssssseseseeeenneeeen enne 19 4 5 18 Instalaci n y configuraci n de Glassfish ssssssssssesee 19 4 5 19 Despliegue de los componentes ESB de Agrega ccocoocccnonocccononoccnonononcnnnanonnnnnos 21 4 5 20 Configuraciones opcionales cooooocinncnnncccnoncnnononnnoneccnnnnnn arc nana cnn nennen nennen 21 4 6 Instalaci n de Terracotta sssssssssssseseseeeeneenne enne nnne nnns snnt nnns 22 4 6 21 Configuraciones adicionales sess 22 4 6 22 Consideraciones de configuraci n del cluster 23 4 7 Arranque de los servicios secsi ernia anA EREEREER 23 4 8 Lanzar tareas de actualizaci n a la versi n S3 23 EE Tge e E 24 5 1 Apendice A Crear un EAR sssssssssssssssseseeeee nennen entren tens tenni nnns nnne 24 5 2 Apendice B Integraci n con LDAP ssssssssssseseeneneneeen nennen nen 24 5 3 Apendice C Migraci n de Licencias sssssssssssseseeeeeenenenen nennen 25 1 INTRODUCCI N 1 1 Objetivo agrega En este documento se describe la actualizaci n de versi n del portal Agrega en un nodo en producci
24. iones Glassfish para su funcionamiento independiente del Jboss o Apache Tomcat en que se instala Agrega Si se actualiza desde la versi n 3 0 1 no hace falta tocar la configuraci n del ESB A continuaci n se detallan los pasos necesarios para la instalaci n del servidor Glassfish y para el despliegue de los componentes Java Bussiness Integration que conforman el ESB de Agrega 4 5 18 Instalaci n y configuraci n de Glassfish Descargue el servidor Glassfish de la siguiente URL Entornos Linux http dlc cdn sun com jbi binaries glassfishesb v2 1 promoted rc2 glassfishesb v2 1 full installer linux sh Entornos Solaris http dlc cdn sun com jbi binaries glassfishesb v2 1 promoted rc2 glassfishesb v2 1 full installer solaris sparc sh fichero debera ser descargado al directorio donde se desea hacer la instalaci n del servidor por defecto opt Por ejemplo ope wget http dlc cdn sun com jbi binaries glassfishesb v2 1 promoted rc2 glassfishesb ya lacas cul late cla A continuaci n copie el fichero ESBAgrega state xml proporcionado con la distribuci n de Agrega al directorio de instalaci n de Glassfish 4 Entornos Linux cp SDIST resources esb instalacion ESBAgrega state xml opt ESBAgrega state xml Entornos Solaris cp SDIST resources esb instalacion ESBAgrega Solaris SPARC state xml opt ESBAgrega state xml fichero ESBAgrega state xml debe ser mo
25. iteRule ODE 4 Cose S buscador DetallarODECU DetallarODECU do idioma 1 amp identificadorODE 2 L PT rewrite rule para los rss de b squeda indra agrega 12 RewriteRule Ce feed2 1 amp tipoLayoutBuscador 2 amp idTesauro 3 amp nomTesauros 4 amp nivelAgreg 5 amp destinatari os 6 amp keyword 7 amp tipoBusqueda 8 amp tipoRSS 9 C RewriteRule o Yo o 7 67 5 feed3 S 1 amp diaPublic 2 amp mesPublic 3 amp anyoPublic 4 amp c s secuencia 5 amp valoracion 6 amp enla ceTaxSelec 7 amp enlaceComuSelec 8 9 C RewriteRule PA PAPA EADEM DEAE APA feed4 S 1 amp formato 2 amp idODE 3 amp recurso 4 amp procesoCognitivo 5 amp contexto 6 amp edad 7 amp auto r 8 9 C RewriteRule Quies Cep ee e e Ge HS buscador BuscarAvanzadoCU MostrarResultadosImagenesGenerarRSS do feedNum 1 amp buscConte nido 2 amp idioma 3 amp pagina 4 5 L PT REST RewriteRule REST rest2 1 Q0 L PT 48558 RewriteCond S QUERY STRING 2 amp 2 amp 2 RewriteRule obtenerRss rss2 params 31 2 3 4 5 56 Q L PT RewriteCond QUERY STRING 2 amp 2 RewriteRule obtenerRss rss2 params 1 2 5 3 5 4 L PT RewriteCond QUERY STRING RewriteRule obtenerRss rss2 params 1 2 Q L PT RSS COMPATIBILIDAD CON VERSION 1 RewriteRule rss xml rssCompatibilidad rss 1
26. jboss las siguientes l neas Script de arranque de cada instancia jboss run sh bin sh f4Configuracion TERRACOTTA TC_INSTALL_DIR opt terracotta terracotta 2 7 3 TC CONFIG PATH opt terracotta terracotta 2 7 3 bin tc config xml STC INSTALL DIR bin dso env sh q JAVA OPTS Xmn100M Xms256M Xmx768M XX MaxPermSize 384M Djava awt headless true export JAVA OPTS SJAVA OPTS TC JAVA OPTS indra e agrega 22 Fin configuracion TERRACOTTA Como se ve la instalaci n de Terracotta tiene que ser tal que el directorio de instalaci n donde se encuentra el software se comparta para todas las instancias del cluster ya que tanto los ficheros de Terracotta como el fichero de configuraci n se han de poder leer por todos los nodos 4 6 22 Consideraciones de configuraci n del cluster Para el correcto funcionamiento de Agrega en cluster de ndices se tienen que tener en cuenta los siguienes aspectos de instalaci n para que los ndices sean correctamente compartidos e Para cada nododel cluster la configuraci n de la localizaci n f sica de los ndices en disco tiene que ser tal que todos los nodos vean los mismos ficheros f sicos ya que los ficheros se comparten e La base de datos que utilizan los nodos tiene que ser com n para mantener la coherencia sobe la informaci n de los ODEs que se publican en el cluster y el indice de b squeda compartido 4 7 Arranque de los servicios Arranque el ser
27. las comunidades que as lo deseen La forma en la que se integra Agrega con el Idap es la siguiente Cuando un usuario registrado en el Idap de la comunidad intenta acceder a Agrega sin estar registrado se le proceder a dar de alta autom ticamente en la plataforma sin necesidad de interacci n por parte del administrador de la comunidad los datos necesarios para el registro nombre apellidos dni email se obtendr n del servidor Idap en el caso de que alguno de los anteriores valores no se encuentre en el se mostrar una pantalla informando del error Estos usuarios registrados autom ticamente se les asignar n unos valores por defecto para la cuota tipo de empaquetador y tipo de catalogador si as lo desea el administrador de la plataforma puede modificar estos valores a los usuarios que considere oportuno Para el correcto funcionamiento de esta funcionalidad ser necesario la configuraci n de los siguientes ficheros agrega properties atributo integracionLdap deber valer true 11111 4 Integracion ldap FHH FEFE FEAE AE FE FE AE AE FE FE FE FE FE FE E E EE E integracionLdap true authbackend properties Se han a adido unas nuevas variables para almacenar los atributos del Idap de donde se obtendr n la informaci n necesaria para el registro los nuevos campos a adidos son los siguientes 44448 Atributos para la integracion con el ldap de las comunidades 444 apellidos sn atributo del
28. ldap donde se encuentran los apellidos del usuario nombre name atributo del ldap donde se almacena el nombre del usuario usuario cn atributo del ldap donde este el login del usuario email mail atributo donde se almacena el email nif employeeNumber atributo donde esta el nif 24 Atributos necesarios para la obtenci n de los apellidos en el caso de que no existe en el ldap un atributo espec fico para ellos 3484444 en el caso de que exista un atributo en el ldap para almacenar los apellidos los tres atributos siguientes deber n aparecer vac os 48 patronApellido posicionApellidol posicionApellido2 Los ltimos tres atributos son necesarios en el caso de que la comunidad no tenga un atributo concreto en el Idap para almacenar los apellidos del usuario sino que aparezcan junto otro como el nombre para estos casos habr que especificar el valor de patronApellido para indicar qu car cter separa a los apellidos y la posicionApellido1 y posicionApellido2 A continuaci n detallamos un ejemplo Supongamos que los apellidos del usuario se encuentran almacenados en un atributo name junto con el nombre name nombre apellido1 apellido2 la configuraci n correcta del fichero ser a la siguiente apellidos name nombre uid patronApellido tel car cter que separa los nombres de los apellidos es el punto posicionApellidol 2 4en la posici n 1 se encuentra el nombre posicionApellido2 3
29. me JkMount gestorFlujo server name JkMount dL server name JkMount reputacion server name JkMount auditoria server name JkMount ModificadorWeb server name JkMount oaipmh server name JkMount TaggingWeb server name JkMount adminusuarios services SrvlIdentidadFederadaService server name JkMount casy server name JkMount contenidosportal Fl services SrvDescargas server name LogFormat h 1 t WV rN gt s b extendedlog CustomLog logs S server name access log extendedlog ErrorLog logs server name error log lt VirtualHost gt 4 3 8 Actualizaci n de los ficheros de propiedades de Jboss Entre la versi n 2 0 1 y 3 0 1 se cambian los siguientes ficheros Ficheros modificados agrega properties authbackend properties 18n properties logos resources properties importedServices properties Ficheros a adidos correos resources properties indra e agrega 14 4 3 9 Actualizaci n de los ficheros de generaci n de indra im genes para la galeria dr m Modificar los ficheros de generaci n de im genes de Jboss localizados en JBOSS_CONF bin Se genera una nueva imagen con tama o 200x125 para el carrusel En la migraci n de 2 0 1 a 3 0 1 cambian los siguiente ficheros e agrega Ficheros modificados generateimg sh resizeimg sh A adir las l neas que se encuentran entre las etiquetas carrusel Begin y carrusel end
30. ministraci n de Glassfish ver Ap ndice D fArranque de Glassfish cd opt GlassFishESB21 glassfish domains domainl bin sh startserv A continuaci n es necesario configurar algunos par metros de servidor Esto se puede hacer por l nea de comandos Configuracion de parametros opt GlassFishESBv21 glassfish bin asadmin delete jvm options my m XXNN MaxPermSize 128m NN XXNN PermSize 128m NN XXN NV MaxPermSize 192m NN Xmx512m NN XXNN NewRatio 2 opt GlassFishESBv21 glassfish bin asadmin create jvm options TS XXNN MaxPermSize 256m NN XXN NV PermSize 256m NN Duser language en NN Duser country US NM Xmx1536m WV NV Xms 768m f Reinicio del servidor cd opt GlassFishESB21 glassfish domains domainl bin sh stopserv sh startserv El siguiente paso es arrancar el componente http del ESB y configurar los par metros necesarios para el correcto funcionamiento de los componentes ESB de Agrega Los par metros se encuentran definidos en el fichero DIST resources esb instalacion configuracionESB properties Previamente es necesario haber realizado los pasos indicados en la secci n 4 3 6 ya que este fichero tiene algunos par metros dependientes de su entorno URLs y puertos Una vez que se hayan sustituido estos par metros introduzcalos en la configuraci n del servidor opt GlassFishESBv21 glassfish bin asadmin start jbi component sun http binding opt GlassFishESBv21 glassfish
31. mostrar secuencia o no para usuarios an nimos por fichero de configuraci n propiedad secuencia sin logar en agrega properties Correcci n de bug 1137 Catalogador no pod a consultar hist rico de un ODE Correcci n de bug 1140 Scripts de Oracle eran incorrectos Correcci n de bug 1141 Publicador no puede cambiar im gen Correcci n de bug 1121 y 1144 Se interceptan llamadas a LMS en ODEs descargados como HTML Correcci n de bug 1151 Se perd an items con hijos y recurso asociados a la vez Correcci n de bug 1155 Publicador no pod a rechazar ODEs pendientes Correcci n de bug Fallaba visualizaci n con secuencia de algunos ODEs Correcci n de bug 1179 No se pod a visualizar varios ODEs a la vez Correcci n de bug 1181 Men lateral en visualizador reaparec a aunque se ocultase Mayor tolerancia a falta de propiedades en ficheros de configuraci n Se permite proxy entre JBoss y Apache 3 Contenidos del entregable Agrega 3 0 2 El paquete de ficheros disponible para la instalaci n de Agrega contiene los siguientes ficheros bin war S plataforma war bin esb resources apache static resources apache vhost resources bin resources informes resources jboss conf resources uploads resources wiki resources esb sql bbdd S plataforma sql migraci n sql Wiki ScriptsMigracion MigracionMD5 del repositorio Los 29 desplegables de la aplicaci n Desplegables JBI para el ESB Agrega CSSs
32. nal del fichero nodo ds xml antes de la etiqueta datasources datasources lt local tx datasource gt jndi name jdbc entregarDS jndi name connection url jdbc mysql ip mysqlNodo 3306 agrega connection url driver class com mysql jdbc Driver driver class user name agrega user user name password password password exception sorter classname org jboss resource adapter jdbc vendor MySQLExceptionSorter c exception sorterclass name sql to call when connection is created new connection sql some arbitrary sql lt new connection sql gt sql to call on an existing pooled connection when it is obtained from pool check valid connection sgl some arbitrary sql lt check valid connection sql gt lt corresponding type mapping in the standardjbosscmp jdbc xml optional metadata type mapping mySQL type mapping metadata local tx datasource datasources 4 2 3 Pasos requerido de la migraci n de 1 2 1 a 2 0 0 Los pasos requeridos de la migraci n de Agrega 1 2 1 a 2 0 0 son los siguientes Modifique la configuraci n de Apache etc httpd nodo vhost para incluir dos nuevos alias Alias logos SUPLOADS logos Alias imagenesPortada SUPLOADS imagenesPortada Copie los ficheros de propiedades de Jboss a la localizaci n correspondiente en el servidor a de aplicaciones BOSS CONF
33. ne Order Deny Allow Allow from all php flag engine on Directory Directory S wiki_path wiki eu gt Options None AllowOverride None Order Deny Allow Allow from all php flag engine on Directory Directory S wiki path wiki gl Options None AllowOverride None Order Deny Allow Allow from all php flag engine on Directory Directory wiki path wiki va Options None AllowOverride None Order Deny Allow Allow from all php flag engine on Directory RewriteEngine on RewriteRule robots txt sitemaps robots txt L PT RewriteRule sitemap xml sitemaps sitemap index xml RewriteRule sitemap xml sitemaps sitemap 1 xml RewriteRule visualizadorcontenidos R permanent L RewriteRule layout visualizador 1 layout 1 L P i IPTE fRewriteRule 1 0 914 7 visualizador 1 Visualizar Visualizar do identificador 1 amp secuencia false L PT RewriteRule 5 visualizador 1 Visualizar Visualizar do identificador 1 amp secuencia false L PT fAcceso a ficha desde embed ODE idioma identificadorODE origen Example http nodo agrega es ODE es es 20080206 3 9220808 embed RewriteRule 7 Les Ce 5 buscador DetallarODECU DetallarODECU do idioma 1 amp identificadorODE 2 amp origen 3 L PT fAcceso a ficha ODE idioma identificadorODE Example http nodo agrega es ODE es es 20080206 3 9220808 Rewr
34. ne que esta en el classpath localizador db conexion driver MySQL Dialecto de hibernate con el que se habla con la BD Ej MySQL utilizar el que se quiera Tienen que ser compatible con Hibernate localizador db conexion dialecto MySQL MySQL Tambi n se puede poner la clase Oracle Se puede Conexion de la instancia de la tabla de localizador Cadena de conexion con la instancia de la BD donde reside la tabla de LOCALIZADOR Ej jdbc mysql pruebas 3306 devel localizador localizador db conexion url jdbc mysql mysqlsever 3306 agrega localizador db conexion usuario DBUser localizador db conexion clave DBPassword Driver de conexion con la BD Ej Oracle 0jo tiene que esta en el classpath odePublicado db conexion driver MySQL Dialecto de hibernate con el que se habla con la BD Ej MySQL utilizar el que se quiera Tienen que ser compatible con Hibernate odePublicado db conexion dialecto MySQL MySQL Tambi n se puede poner 18 clase Oracle Se puede Conexion de la instancia de la tabla de ODEPublicado Cadena de conexion con la instancia de la BD donde reside la tabla de ODE_PUBLICADO Ej jdbc mysql pruebas 3306 devel publicacion odePublicado db conexion url jdbc mysql mysqlsever 3306 agrega odePublicado db conexion usuario DBUser odePublicado db conexion clave DBPassword En negrita se marcan los par metros a configurar path base odes Ruta donde se encuentra la carpeta uplo
35. o Alias galeriaimg S uploads_path galeriaimg Alias imgcommon S uploads_path galeriaimg common Alias imagenesInformes uploads_path imagenesInformes Alias rss uploads path rss Alias utilidades uploads_path utilidades Alias searchPlugin uploads_path searchPlugin Alias sitemaps fuploads_path sitemaps Alias informesPortada uploads_path informesPortada Alias descargas S uploads_path descargas Alias export S uploads_path export Alias logos S tfuploads_path logos Alias imagenesPortada S uploads_path imagenesPortada Alias imagenesUsuariosPublicos uploads path imagenesUsuariosPublicos Alias imagenesGruposPublicos uploads path imagenesGruposPublicos security forbid default access to filesystem locations Directory Order Deny Allow Deny from all AllowOverride None php flag engine off Directory Directory opt static gt Order Deny Allow Allow from all 11 AllowOverride None Directory Directory S iuploads path Order Deny Allow Allow from all AllowOverride None php flag engine off Directory Directory S wiki_path wik1 gt Options None AllowOverride None Order Deny Allow Allow from all php flag engine on Directory Directory S wiki_path wiki ca gt Options None AllowOverride None Order Deny Allow Allow from all php flag engine on Directory Directory S wiki_path wiki en gt Options None AllowOverride No
36. pe Allowed p pe e 3 and DIREC Y m E Shared Libraries Proxy Host XS 555 zi A valid proxy host name This configuration it used tor outgong HTTPISOAP cent invocati n ect EXP 843 08 SD Evoluci n De La Plataforma De Objetos Digitales Educativos Agrega Actualizaci n a Agrega 3 0 0 N En la pesta a Configuraci n se muestra un formulario con los datos relacionados con el Proxy que da acceso a Internet y los dominios que quedan excluidos del Proxy Recuerde rellenar los dominios excluidos para evitar que los accesos dentro del entorno no vayan a traves del Proxy 4 6 Instalaci n de Terracotta Terracotta es el software que utiliza Agrega para conseguir una configuraci n clusterizada de la plataforma en la que se comparten los ndices de b squeda Con esta soluci n varias instancias de Agrega pueden trabajar en cluster compartiendo la informaci n indexada y los cambios que introduce una instancia son inmediatamente distruibuidos entre todas las instancias del cluster Terracotta es un sistema de compartici n de memoria que integrado con compass y luecene permiten a varias instancias de Agrega compartir un mismo ndice y mantenerlo coherente en el tiempo ante las operaciones de modificaci n sin perder la potencia de b squeda del motor que implementa lucene La instalaci n de Terracotta implica a adir un nuevo proceso servidor que hace las veces de coordinador entre las diferentes instancias de Agrega q
37. rticular de su entorno que debe ser reemplazada manualmente e agrega Fichero de configuracion del VHOST de apache para Agrega Revise el fichero para adaptar la configuracion a su nodo Reemplazar host por el hostname de su nodo p ej nodo agrega es Reemplazar uploads path por la ruta absoluta en disco al directorio uploads de Agrega Reemplazar static css por la ruta absoluta en disco al directorio que contiene los CSSs de Agrega Reemplazar static path por la ruta absoluta en disco contiene los estilos de agrega Mo es Mittal Reemplazar wiki path por la ruta absoluta en disco que contiene la wiki de Agrega Reemplazar server name por el nombre del servidor Reemplazar esb host por el hostname del esb vVirtualHost s0 gt Para que encuentre el fichero crossdomain xml necesario para la carrusel de odes en la portada DocumentRoot S uploads path ServerName server name ServerAlias server name host TimeOut 300 Alias static css SH ene cenE dle cse alias seais static_path Alias log icon usr local awstats wwwroot icon Alias wiki S wik1_path wiki Alias wiki ca wiki path wiki ca Alias wiki en S wik1_path wiki en Alias wiki eu S wik1_path wiki eu Alias wiki gl S wiki_path wiki gl Alias wiki va S wik1_path wiki va Alias taller S uploads_path taller Alias noticias S uploads_path noticias Alias repositorio S uploads_path repositori
38. sh Para configurar los ficheros de Agrega mediante el script install sh proporcionado con el entregable siga los siguientes pasos Descomprima el entregable a una localizaci n en el servidor en adelante DIR Reuna toda la informaci n necesaria para contestar a las preguntas que se le van a hacer durante la ejecuci n de install sh ver secci n Error No se encuentra el origen de la referencia Sit ese en el directorio DIF resources bin Ejecute el script install sh Conteste a las preguntas que se le hacen durante la ejecuci n del script Al finalizar los ficheros originales antes de la configuraci n estar n copiados en DIR resources bin templates y los ficheros distribuidos estar n listos para copiarse a su localizaci n correspondiente en el servidor Editar los ficheros resources jboss conf agrega properties y comprobar si son correctos los datos de la nueva configuraci n En el punto 4 7 se explica como copiar la nueva configuraci n al servidor IMPORTANTE fichero agrega properties contiene la configuraci n de la plataforma Aquellas propiedades que no dependen del nodo se distribuyen con una configuraci n por defecto Si en versiones anteriores se particulariz este fichero para su instalaci n verifique los campos modificados antes de desplegar el agrega properties de la versi n 3 0 1 En caso de duda consulte con el CAU Agrega 4 3 7 Migraci n de los ficheros de Apache Copie los ficheros CSSs
39. ue comparten el mismo ndice Para instalar Terracotta tan solo es necesario copiar el software suministrado en la distribuci n en el directorio de instalaci n correspondiente A continuaci n copie el directorio terracotta 2 7 3 proporcionado con la distribuci n de Agrega al directorio de instalaci n de terracotta Entornos Linux cp DIST resources terracotta 2 7 3 opt terracotta 2 7 3 La ejecuci n del servidor de terracotta se ejecuta mediante la siguiente l nea f Arranque Terracotta cd opt terracotta 2 7 3 bin nohup start tc server sh amp 4 6 21 Configuraciones adicionales Para que el despliegue de Agrega en cluster sea completo hay que tener en cuenta modificaciones en los scripts de arranque de las instancias de Jboss que se quieran clusterizar asi como la direcci n del propio servidor de Terracotta La configuraci n del servicio de terracotta se modifica en el fichero tc config xml dentro del directorio bin del directorio de instalaci n de terracotta En las siguientes l neas se especifica el host donde reside el servidor Terracotta y el puerto donde ofrece el servicio Una configuraci n de ejemplo puede ser la siguiente tc config xml server host localhost gt sSuso port 95J0e dso port server Los scripts de arranque de jboss de las instancias que se quieran adherir al cluster se tienen que modificar a adiendo al comienzo del script de arranque de cada
40. uiente pantalla Home Version User admi Domain domani Server pruebas agrega ndra e Sun GlassFish Enterprise Server v2 1 sun http binding Configuraci n 0 web Application a onsute la documertaci n del componette para conocer tus propiedades de conturaci n de tiempo de esecuci n EB Modules E Connector Modues General Configurar componente Number of Outbound Threads 15 Maritim number ot threisds to process outgorg HTTP SOAP chert eivocations concurenti Web Services niwed lig e Number of inbound Threads 106 E Service Assemblies Maximum mbar ot threeds to process incoming HTTPISOAP client Requests concurmenty a c alowed Humber of InboundRepty 100 pn gt Threads Mart b thwesds to process resp r iter p sun tie biodng ed d sun Default HTTP Port Humber 3081 comm H t between ard ghiy recommended 10 avad gt Default HTTPS Port Number 3161 CompetibikdadSA Ip binding iei et sut value is oj RestSA sun http binding T N mmended to acid pj SSL Client authentication lake gt H enabled pecifies wheih enable e jeta HTTPS po Eg san schedaer bindng Sun Access Manager gt 3 sun bpei engine Configuration Directory Sun Access Manager contra abon directory contelrira the AM configuration properties tie sun edm engine Sun Access Manager Classpath m s s Manage y crema separates to E t Aspa Mana 2T sun jsvsee engne Proxy Type Ur zl A dp mat proxy ty
41. uir huella MD5 de los objetos publicados Una de las nuevas funcionalidades de Agrega v3 0 1 requiere registrar en base de datos la huella MD5 de los contenidos publicados en el nodo Para poder hacer este calculo se proporciona una aplicaci n de migraci n que deber ser ejecutada antes de arrancar el servidor de aplicaciones Los pasos para realizar esta migraci n son los siguientes Dentro de la carpeta donde ha descomprimido el entregable de Agrega situese en la carpeta ScriptMigracion MigracionMD5 Aseg rese de haber realizado una copia de seguridad de la base de datos ver secci n 4 1 Si hace un listado de los contenidos del directorio ver los siguientes ficheros S lg la roes 12392 drwxrwxr x 2 agregabuild agregabuild 4096 dic 1 17 41 drwxrwxr x 3 agregabuild agregabuild 40968 dic 111511 rw rw r 1 agregabuild agregabuild 1589 dic 1 11 01 arreglatorMD5 properties rwxr xr x 1 agregabuild agregabuild 2807 dic 1 11 01 migracionMD5 sh rw rw r 1 agregabuild agregabuild 12648448 dic 1 17 41 MigracionMD5 zip rw rw r 1 agregabuild agregabuild 251 dic 1115011 readme txt Edite el fichero arreglatorMD5 properties para configurar la aplicaci n de migraci n con los datos de su entorno path base del lugar donde parten los localizadores de los ODES path base odes export ccaa comunidad HHHHHHHRConfiguracion de conexion a BD 4S434434444 Driver de conexion con la BD Ej Oracle 0jo tie
42. vidor de aplicaciones y todos los sistemas que se hayan apagado antes de la migraci n 4 8 Lanzar tareas de actualizaci n a la versi n 3 En la versi n 3 0 1 se hace uso de un nuevo tama o de im genes destinado a presentar los ODEs del carrusel de la portada Para generar estas im genes de los ODEs publicados es necesario lanzar una tarea de regeneraci n de im genes en el planificador de tareas del menu de administraci n Para la presentaci n de la nueva informaci n de la ficha es necesario lanzar una tarea de reindexaci n de cada idioma Esta tarea no es necesaria si se actualiza desde la 3 0 1 a la 3 0 2 y se realiz previamente indra e agrega 23 indra 5 Apendices k 5 1 Apendice A Crear un EAR agrega Las comunidades de Canarias y Andalucia tienen que generar un EAR para poder desplegar la aplicaci n los pasos a seguir son los siguientes Descomprimir el antiguo EAR agrega ear en una carpeta temporal Se obtiene una carpeta agrega con los Wars y un subdirectorio META INF con el manifest xml y el application xml que contiene las rutas con path Borrar los wars y el manifest xml y copiar los wars de la actualizaci n Ejecutar el comando java jar cvf agrega ear war META INF Esta operaci n agregar el nuevo manifest y los nuevos wars al agrega ear 5 2 Apendice B Integraci n con LDAP Como parte de la versi n 2 0 se ha realizado un desarrollo para que Agrega se integre con el Idap de
Download Pdf Manuals
Related Search