En esta sección, se describen problemas conocidos relacionados con la utilidad de actualización, junto con las soluciones pertinentes.
Los dominios creados en una ruta personalizada distinta del directorio install_dir /domains no se actualizan directamente al actualizar de Application Server Enterprise Edition 8 a Application Server Enterprise Edition 8.1.
Al ejecutar la utilidad de actualización e identificar install_dir como el directorio de instalación de origen, el proceso de actualización actualiza sólo los dominios que se crean en el directorio install_dir/domains. Los dominios creados en otras ubicaciones no se actualizan.
Antes de iniciar el proceso de actualización, copie todos los directorios del dominio desde sus ubicaciones en el directorio install_dir/domains .
Este problema se ha observado en varios sistemas Linux y es más frecuente en Java Desktop System 2, pero también se ha detectado en distribuciones Red Hat.
Después de hacer clic en el botón que permite iniciar la herramienta de actualización en la pantalla final del instalador, éste no logra iniciarla para completar el proceso y se bloquea de forma indefinida, por lo que no consigue volver a la línea de comandos.
Este problema no se produce si se utiliza el modo de instalación mediante línea de comandos para llevar a cabo la actualización "in situ".
Si realiza dicha actualización en modo de GUI y se encuentra con este problema, salga del instalador pulsando Ctrl+C en la ventana de terminal en la que se inició el instalador.
Inicie la herramienta de actualización desde la ventana de terminal usando los siguientes comandos:
install_dir/bin/asupgrade --source install_dir/domains --target install_dir --adminuser adminuser --adminpassword adminpassword --masterpassword changeit |
adminuser y adminpassword deben coincidir con los valores usados para la instalación que esté actualizando.
Cuando la herramienta de actualización complete el proceso, podrá iniciar también el explorador y especificar la siguiente URL para visualizar la página que muestra información acerca del producto:
file://install_dir/docs-ee/about.html |
Si seleccionó la opción pertinente para registrar el producto, siga el enlace a la página de registro que se mostrará en la página de información sobre el producto.
Elimine las siguientes entradas del destino domain.xml (después de la actualización) y reinicie el servidor:
<jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot} /config/keystore.jks</jvm-options>- <jvm-options>Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot} /config/cacerts.jks</jvm-options>
La herramienta de actualización sobrescribe cualquier archivo index.html existente de cualquier instancia de servidor.
Haga copias de seguridad de sus archivos index.html antes de ejecutar la herramienta de actualización y después restaure los archivos.
Al actualizar Application Server 8.0PE a 9.1, se genera un error avisando que el servidor no tiene ningún conector de sistema llamado null, y muestra la información del usuario no válida que aparece en sbs-manual. Incluso después de cambiar los valores codificados, sigue apareciendo el mismo mensaje de error. Esto se produce porque el archivo domain.xml ha cambiado en el paso de 8.0 a 9.1.
Sólo se encontrará con este problema al actualizar de una versión 8.0 PE a otra 9.1. La solución alternativa es actualizar primero a 8.1, 8.2, o a 9.0 y después pasar a la 9.1.
Al realizar una actualización "in situ" cuando hay varios dominios en la fuente, el instalador invoca la herramienta de actualización aunque se aborte el proceso. Esto sucede cuando se invoca en el modo GUI.
Instale la actualización in situ en el modo CLI y salga cuando el instalador le pida que seleccione la herramienta de actualización al final del proceso de instalación. Si hace lo indicado, no se eliminará ninguno de los dominios presentes en el directorio de dominios. La herramienta de actualización debería invocarse manualmente desde el directorio bin.
Si instala la actualización in situ en el modo GUI, haga una copia de seguridad de los dominios que se encuentren en la raíz de dominios para evitar perder alguno en el proceso. Al final del proceso de instalación, salga cuando el instalador le pida que invoque la herramienta de actualización. Copie en el directorio de dominios las copias de seguridad de los dominios que se hayan perdido. Inicie la herramienta de actualización manualmente para hacer una actualización.
Al actualizar de AS 8.2 a 9.1, la contraseña maestra de la instalación 8.2 no se hereda en la instalación 9.1. Por ello se produce un error de autenticación en el siguiente inicio de sesión del administrador.
La contraseña administrativa predeterminada de Application Server 9.1 sigue siendo changeit . Para evitar problemas al iniciar sesión en el servidor 9.1 tras actualizar desde 8.2, siga alguna de las siguientes instrucciones:
Cambie la contraseña de administración de 8.2 a changeit antes de realizar la actualización.
No debe aceptar la contraseña de administración predeterminada que se le propone durante el proceso de actualización, sino introducir la contraseña que desea utilizar.
Inicie sesión en 9.1 con la contraseña predeterminada y cámbiela después inmediatamente.
La herramienta de actualización no gestiona de ninguna forma las bases de datos en proceso de actualización ni las tablas de las bases de datos, ni tampoco admite estas operaciones. Se transfieren las configuraciones de las referencias de los recursos y Application Server debería continuar trabajando con las bases de datos y las tablas originales. Si desea cambiar la base de datos o transferir las tablas de éstas, utilice herramientas que funcionen con las bases de datos que está utilizando.
Siga los siguientes pasos para migrar el almacén MQ:
Siga estos pasos DESPUÉS de cerrar AS 8.2 y DESPUÉS de ejecutar la herramienta de actualización AS9.1 pero ANTES de iniciar AS9.1 por PRIMERA vez. Si ya ha iniciado AS 9.1 después de la instalación o la actualización de IFR, entonces NO realice estos pasos ya que podrían desestabilizar el almacén de mensajes de MQ.
Copie el sudirectorio domains/domain1/imq entero del directorio de dominios x de AS 8 al directorio de dominios de AS 9.1.
Asegúrese de que la propiedad del directorio y los archivos coinciden con el usuario que va a ejecutar Application Server.
Una vez realizados los pasos anteriores, podrá iniciar Application Server 9.1 y el almacén de MQ en Application Server 9.1. El directorio domains migrará de su formato JES5 U1 al formato MQ 4.1. Tenga en cuenta que el almacén JES5 U1 MQ de AS 8.2 se conserva y no se modifica con este procedimiento, ni con MQ4.1 al iniciarse con AS 9.1
Al actualizar JES5 (Application Server 8.2) a Application Server 9.1, la muestra de Portal Server Community deja de funcionar y genera muchos errores javax.faces.application.ApplicationFactory .
La actualización de Application Server 8.2 a 9.1 no se admite si Application Server 8.2 se instaló con JES5 Portal Server. Es necesario actualizar Portal Server a Java ES 5 Update 1 antes de actualizar Application Server a 9.1.
Al actualizar Application Server 8.2 a 9.1 con el instalador IFR en las plataformas Linux mediante la opción Instalar JDK, pero después de completar correctamente la instalación, la mayoría de los componentes JES dejan de funcionar.
Este problema sólo afecta a la instalación IFR de Application Server 9.1 en las plataformas Linux y sólo cuando se selecciona la opción Instalación JDK. Para solucionar temporalmente este problema, enlace /usr/jdk/entsys-j2se al directorio /usr/java/jdk1.5.0_12 inmediatamente después de la instalación.
Al realizar una actualización IFR de Application Server 9.1 en Windows, la copia de seguridad in situ no se integra correctamente con los valores de forma de asupdate.bat. En concreto, si introduce información incorrecta en una pantalla GUI de ASupdate.bat y después pulsa Siguiente, el instalador de la actualización intenta detectar si se trata de una actualización in situ. Si lo es, mueve domain1 a un directorio de copia de seguridad antes de la actualización. A medida que continúa la actualización, aparece un mensaje de error debido a la información incorrecta. Si intenta corregir el error inmediatamente, aparece un error de ruta porque domain1 se ha movido.
Cambie el directorio fuente al directorio domain1_ {marca de fecha y hora} en {ruta de fuente actual}/backup o salga del instalador con el botón Cancelar y empiece de nuevo.
(sólo Windows) Si se instaló una versión anterior de Application Server con caracteres especiales o con nombres cortos al estilo DOS en la ruta del directorio del programa, las actualizaciones in situ posteriores de Application Server 9.1 fallarán si se utilizan estos mismos nombres de ruta de directorios.
Por ejemplo, si se instaló Application Server 8.2 en alguno de estos directorios:
C:\Program Files (x86)\dirs\appserver c:\progra~2\dirs\appserver |
Cualquier intento de realizar una actualización in situ a 9.1 fallará porque el instalador no puede convertir los nombres cortos o caracteres especiales al formato de nombres largos necesario.
No le recomendamos que instale Application Server en una ruta que contenga caracteres especiales o truncados de nombres cortos al estilo DOS (como progra~2), ya que impide las posteriores instalaciones de las actualizaciones. Si existe esta instalación, puede volver a instalarlo con nombres de ruta largos antes de la actualización o instalar la versión nueva de Application Server en un directorio totalmente nuevo.
Después de una actualización de Application Server, la etiqueta <jsp:forward> no funciona como se espera en Authenticate.jsp. La llamada <jsp:forward> produce un error en los registros del servidor y aparece una página en blanco en la interfaz de usuario de la web. El problema es que el <jsp:forward> de Authenticate.jsp necesita un atributo de página como <jsp:forward page="${redirectPage}"/>, pero el valor que se transmite es una ruta relativa como /registry/thin/{pagename}.jsp, que no funciona ni cuando Authenticate.jsp es una página JSP pura.
Tras completar la actualización Application Server, utilice la herramienta asadmin para ejecutar los siguientes comandos y establecer el <auth-realm> en domain.xml:
Vaya a <appserver9.1-install-dir>/bin y ejecute el siguiente comando:
./asadmin delete-auth-realm --host localhost --port 6489 certificate |
Al hacerlo, se elimina el certificado auth-realm antiguo, si es que existe.
Ejecute el comando siguiente:
./asadmin create-auth-realm --terse=false --echo=true --interactive=true \ --user admin --host localhost --port 6489 --classname \ com.sun.enterprise.security.auth.realm.certificate.CertificateRealm \ --property assign-groups=have.client.cert certificate |
Al hacerlo, se crea el nuevo <auth-realm> con la propiedad assign-groups .
Detenga y reinicie el dominio Application Server registry.
Al ejecutar la interfaz de usuario de asupgrade en un idioma que no sea el inglés, la ayuda en línea de la interfaz de usuario no está traducida al idioma seleccionado.
Ninguna por el momento. Se planea traducir la ayuda en línea a todos los idiomas meta distintos al inglés.