Actualizacin de archivo web.

xml Octubre 2009

Informacin del Documento

Informacin General

Nombre Documento

del

Actualizacin de Archivo web.xml

Contenido

Actualizacin de archivo web.xml ..........................................................8 Justificacin ........................................................................................8 Implicaciones y riesgos .......................................................................8 Detalle de Actualizacin del archivo web.xml .....................................9 Proceso de actualizacin del archivo web.xml: ...................................10 Si se tiene acceso a los archivos del servidor por File System ........10 Desde el administrador de WebBuilder ............................................10 Proceso de actualizacin a WebBuilder 3.2.2.6 ..................................11 Resultado.............................................................................................12 Plan de respaldo y recuperacin Roll Back ......................................12

Actualizacin de archivo web.xml

Justificacin
En INFOTEC se est llevando a cabo una actualizacin de WebBuilder 3.2 que nos permite estandarizar todas las instancias de nuestros clientes encaminndonos a los estndares requeridos por ordenes de presidencia, y de manera adicional incrementar la eficiencia del desempeo e integridad, remplazando el archivo web.xml que se encuentra en la ruta /WEBINF. El remplazar el archivo web.xml en esta misma versin permite extraer la informacin de toda la estructura del sitio mostrndola en una pgina web en formato xml con el fin de que el programa Robot permita escanear esta informacin requerida del sito y ser valorada. Usted podr visitar esta informacin que se despliega desde el web escribiendo la ruta en la barra de direcciones del navegador web de preferencia ruta de su sitio seguido /sitemap.xml, y se desplegara la informacin en cdigo XML de toda la estructura de si sitio. Se mostrara en la pgina web en cdigo XML la estructura del sitio.

Implicaciones y riesgos
Esta actualizacin al efectuarse directamente al remplazar el archivo web.xml no presentan ningn tipo de afectacin o consecuencia con los archivos de contenidos, recursos o aplicaciones propietarias desarrolladas expreso para su portal y publicadas va el portalizador de WebBuilder, ya que se cuenta con integridad en los documentos, y como se menciona solamente es para efectuar la extraccin de la estructura del sitio por medio del programa Robot. Es una poltica de INFOTEC siempre que se realice algn tipo de actualizacin en la herramienta, mantener 100% la compatibilidad con todos los procesos, libreras, parmetros y dems funcionalidades preexistentes en la herramienta de forma que los cambios solo impliquen un proceso de mejora que permita eficientar de manera general el desempeo de la herramienta o de una funcionalidad especifica sin afectacin alguna a la funcionalidad o desarrollos particulares por lo que se trata en primer trmino de un proceso de homologacin de versiones entre nuestros clientes igual que las actualizaciones de cdigo de cualquier otra herramienta en el mercado, de manera transparente a la aplicacin de WebBuilder.

Detalle de Actualizacin del archivo web.xml

Antes de realizar cualquier actualizacin le recomendamos seguir los siguientes pasos de forma que est preparado adecuadamente: 1. De la pgina de WebBuilder en la siguiente direccin http://www.webbuilder.org.mx/OS/wb/COSWB/dnlds 2. Localice la actualizacin correspondiente a la versin 3.2.2.6 de WebBuilder 3. De la lista de opciones que se muestran ah le recomendamos descargar el archivo web.zip Cabe mencionar que los dems archivos que se encuentran ah contienen tambin la estructura de WebBuilder para procesos de instalacin. Le explicaremos brevemente la funcionalidad de cada uno de ellos:

Wb3.war

Contiene la instalacin completa de WebBuilder en un ambiente de trabajo pre configurado por el usuario.

web.zip

Contiene la el archivo web.xml.

4. Descomprimir el archivo web.zip en una instancia local donde pueda revisar adecuadamente la estructura del contenido y el archivo incluido a ser actualizado. 5. Observara un archivo principalmente web.xml.

Como podr observar el archivo aqu incluido es un archivo .XML del propio WebBuilder necesario para desplegar desde un navegador la estructura del sitio o los sitios de su instancia.

Proceso de actualizacin del archivo web.xml:

Si se tiene acceso a los archivos del servidor por File System
Si cuenta con acceso va Sistema Operativo al file system del equipo, localice la ruta donde haya instalado el WebBuilder versin 3.2.2.6 y ejecute los pasos siguientes: 1. Del archivo web.xml descargado, copiarlo y remplazarlo en la ruta \WEB-INF 2. Reiniciar el servicio del WebServer utilizado en su infraestructura de forma que se pueda recargar el WebBuilder y se apliquen los cambios realizados. 3. Revisar que la versin se 3.2.2.6 en la pgina de login al sitio Admin de WebBuilder.

Desde el administrador de WebBuilder

Si cuenta con acceso va Documentos del Servidor en el Sitio administrador del propio WebBuilder ejecute los pasos siguientes: 1. En el sitio de Administracin de WebBuilder deber localizar el men

herramientas/Documentos del servidor 2. En la estructura de rbol que se muestra localice la carpeta \WEB-INF y de clic para que se muestren los archivos. 3. Del lado derecho de la utilera vera la lista de archivos contenidos en esta carpeta 4. Haga clic derecho y localice la opcin Agregar Archivo y en la caja de dialogo que se muestra localice en la ruta donde descomprimi el archivo web.xml. Seleccione el archivo y haga clic en Guardar 5. El sistema le pedir confirmar la sobre escritura del archivo. Indique Si 6. Cierre la utilera y cierre su administrador Web 7. Reiniciar el servicio del WebServer utilizado en su infraestructura de forma que se pueda recargar el WebBuilder y se aplique el cambio realizado. 8. Revisar que la versin se 3.2.2.6 en la pgina de login al sitio Admin de WebBuilder.

Proceso de actualizacin a WebBuilder 3.2.2.6

Si se cuenta con una versin de WebBuilder 3.2.2.5 o anterior, es necesario actualizar a la versin 3.2.2.6 para que se tome en cuenta el cambio del archivo web.xml. Siga los siguientes pasos para actualizar a WebBuilder 3.2.2.6. 1. De la pgina de WebBuilder en la siguiente direccin http://www.webbuilder.org.mx/OS/wb/COSWB/dnlds 2. Localice la actualizacin correspondiente a la versin 3.2.2.6 de WebBuilder 3. De la lista de opciones que se muestran, descargar el archivo wb3.war 4. Descomprima el archivo wb3.war con el descompresor WinRar. 5. Dentro del directorio de wb3 dirjase a la ruta wb3\WEB-INF\lib y copie las siguientes libreras: WBAdmin.jar WBAdminResources.jar WBAppfw.jar WBCore.jar WBLDAP.jar WBOffice.jar WBPortlet.jar WBResources.jar WBSearch.jar

6. Si tiene la versin 3.2.1.9 o anterior, tambin se agregan las siguientes libreras en la ruta \WEB-INF\lib lucene-core-2.4.0.jar lucene-snowball-2.3.2.jar xalan.jar Y eliminar las siguientes libreras en la misma ruta. lucene-core-1.9.1.jar snowball0.1.jar De lo contrario ignore este punto.

7. Remplace las libreras copiadas en el directorio de la ruta \WEB-INF\lib 8. En la ruta wb3\WEB-INF\ copiar el archivo web.xml y remplazarlo en la ruta \WEB-INF 9. Reiniciar el servicio del WebServer utilizado en su infraestructura de forma que se pueda recargar el WebBuilder y se apliquen los cambios realizados. 10. Revisar que la versin se 3.2.2.6 en la pgina de login al sitio Admin de WebBuilder.

Resultado
Una vez que se haya remplazado el archivo web.xml de la ruta WEB-INF y se haya reiniciado el servidor Web de la aplicacin. Realice una prueba escribiendo en la barra de direcciones la ruta de su sitio seguido de /sitemap.xml, ejemplo: http://www.Mi_Sitio/sitemap.xml Se mostrara en la pgina web en cdigo XML la estructura del sitio.

Plan de respaldo y recuperacin Roll Back

Aunque los procesos aqu descritos son muy seguros y no implican un riesgo real de operacin, funcionalidad o afectacin a la informacin contenida, es recomendable en todo proceso de actualizacin como una buena prctica para evitar que se llegara a tener una situacin en la que la actualizacin no se completo de manera adecuada, le sugerimos realizar los pasos siguientes antes de comenzar con el proceso de actualizacin: 1. Respaldar ya sea mediante una copia a otra carpeta o mediante la generacin de un archivo empaquetado (zip, war, pkzip, etc.) la carpeta de WEB-INF\lib 2. Respaldar la base de datos (solo preventivo) 3. Si al reinicio la operacin no funciona y verifico la correcta realizacin de los pasos descritos baje el servicio del Application server 4. Descomprima los archivos respaldados Si su cambio fue de una versin 3.2.2.0 o anterior borre tambin los archivos: lucenecore-2.4.0.jar, lucene-snowball-2.3.2.jar, de lo contrario ignore este punto 5. Reinicie el servicio de su Web Server 6. Revisar que la versin sea la que usted tenia y no la 3.2.2.6 en la pgina de login al sitio Admin de WebBuilder.