Sun Java™ System Application Server Enterprise Edition Notas de la versi�n

Versi�n 8.1 2005Q1

N�mero de pieza 819-2024

Sun Java™ System Application Server Enterprise Edition 8.1 2005Q1 simplifica considerablemente la tarea de crear y administrar aplicaciones de servicios Web. Proporciona un rendimiento superior, funciones de cl�ster y una alta disponibilidad para servicios escalables que contin�an funcionando a pesar de que se produzcan fallos de software o hardware. Application Server proporciona una ruta de desarrollo para servicios Web que simplifica el proceso de desarrollo a la vez que proporciona oportunidades de crecimiento flexibles y exclusivas.

Estas notas de la versi�n contienen informaci�n importante disponible en el momento del lanzamiento de Sun Java System Application Server 8.1 2005Q1. Aqu� se tratan nuevas funciones y mejoras, limitaciones y problemas conocidos e informaci�n de otro tipo. Lea este documento antes de empezar a utilizar Application Server 8.1.

La versi�n m�s actualizada de estas notas de la versi�n se encuentra en el sitio Web de documentaci�n de Sun Java System: http://docs.sun.com/db/prod/s1appsrv#hic/. Consulte el sitio Web antes de instalar y configurar el software y, despu�s, vis�telo de forma peri�dica para ver los manuales y las notas de la versi�n m�s actualizados.

Este documento incluye los siguientes apartados:

Acerca de Application Server Enterprise Edition 8.1 2005Q1
Limitaciones y problemas conocidos
Informaci�n sobre problemas y respuestas de los clientes
Sun valora sus comentarios
Recursos adicionales de Sun

Se hace referencia a las direcciones URL de terceras partes para proporcionar informaci�n adicional relacionada.

Nota	Sun no se hace responsable de la disponibilidad de los sitios Web de terceras partes que se mencionan en este documento. Sun no respalda ni se hace responsable de ning�n contenido, anuncio, producto ni de cualquier otro material disponible en dichos sitios o recursos. Sun no se responsabiliza de ning�n da�o, real o supuesto, ni de posibles p�rdidas que se pudieran derivar del uso de los contenidos, bienes o servicios que est�n disponibles en dichos sitios o recursos.

---

Acerca de Application Server Enterprise Edition 8.1 2005Q1

Sun Java System Application Server Enterprise Edition 8.1 es un servidor compatible con la plataforma J2EE 1.4 que permite desarrollar e implementar aplicaciones J2EE y servicios Web basados en tecnolog�a Java en entornos de producci�n a gran escala.

Este apartado incluye:

Novedades de la versi�n 8.1
Requisitos de software y hardware
Versi�n independiente
Documentaci�n relacionada

Novedades de la versi�n 8.1

Sun Java System Application Server Enterprise Edition 8.1 2005Q1 cuenta con muchas funciones nuevas y otras mejoradas, que se describen en los siguientes apartados:

Mejoras de esta versi�n
Compatibilidad con J2EE
Alto rendimiento
Escalabilidad
Alta disponibilidad
Compatibilidad con JavaServer Faces 1.1

Mejoras de esta versi�n

Application Server Enterprise Edition 8.1 incluye las siguientes mejoras:

Administraci�n mejorada: Application Server admite la administraci�n segura y remota de implementaciones de empresa complejas en varios equipos mediante una consola basada en explorador o una interfaz de l�nea de comandos que permita la inclusi�n de secuencias de comandos. Tambi�n ofrece una eficaz API basada en JMX que permite el acceso seguro, remoto y programado a las funciones administrativas y de supervisi�n.
Agente de mensajes: Application Server incluye un agente integrado de mensajes de clase empresarial que proporciona un servicio de mensajer�a escalable y fiable, de alta disponibilidad y rendimiento.
Mayor compatibilidad con plataformas: ahora se admiten sistemas operativos, bases de datos, hardware y configuraciones regionales adicionales.
Sun Java Enterprise System: componente clave de Sun Java Enterprise System, Application Server ofrece una integraci�n s�lida con servicios de identidades de red y de portal.
Herramientas de migraci�n y actualizaci�n: estas herramientas le permiten comprobar si las aplicaciones J2EE se ajustan a los est�ndares de conformidad y portabilidad; le ayudan con la migraci�n desde otras instancias de Application Server J2EE (como JBoss, WebLogic, WebSphere, etc.), as� como a actualizar versiones previas de Sun ONE Application Server o iPlanet Application Server.
Compatibilidad con Java 2 Standard Edition 5.0: Application Server es compatible con Java 2 Standard Edition 5.0, que incluye funciones de supervisi�n y gesti�n mejoradas, as� como otros avances en cuanto a rendimiento y escalabilidad.
Controladores JDBC: Application Server incluye controladores Sun JDBC.
Seguridad en los servicios Web: los mecanismos de seguridad de mensajes de contenedores implementan autenticaci�n a nivel de los mensajes (por ejemplo, firma digital XML y cifrado) de invocaciones de servicios Web SOAP utilizando los perfiles de nombre de usuario o contrase�a X.509 del est�ndar de seguridad OASIS WS-Security.
WS-I Basic Profile 1.1: tal y como establece la especificaci�n J2EE 1.4, esta versi�n incluye Web Services Interoperability (WS-I) Basic Profile 1.1 para hacer posible la interoperabilidad entre aplicaciones de servicios Web.
Conectividad con servicios de fondo mediante adaptadores iWay: Sun Microsystems distribuye y admite ahora 22 adaptadores iWay para los sistemas de servicios de fondo fundamentales (SAP, Siebel, Oracle, CICS e IBM MQ Series) que permitir�n obtener un mayor rendimiento de sus aplicaciones de TI existentes desde el entorno de Application Server. Estos adaptadores admiten la especificaci�n J2EE Connector Architecture 1.5 y los est�ndares (SOAP) de servicios Web, e incluyen herramientas que permiten a los programadores reducir el tiempo de conexi�n con las aplicaciones de servicios de fondo.
Nuevo sistema de gesti�n HADB: las plataformas UNIX^� contienen el nuevo sistema HADB versi�n 4.4 de gesti�n de bases de datos de alta disponibilidad (HADB). De esta forma, se elimina la dependencia de SSH/RSH, pero se requiere que la red est� configurada para multidifusiones UDP. Consulte la gu�a de instalaci�n de Sun Java System Application Server Enterprise Edition 8.1 para obtener m�s detalles sobre los requisitos y las limitaciones de HADB.

Compatibilidad con J2EE

Sun Java System Application Server 8.1 2005Q1 es compatible con las plataformas J2EE 1.4. La siguiente tabla describe las API mejoradas que est�n disponibles en la plataforma J2EE 1.4.

Tabla 1  Cambios principales relacionados con la API efectuados en la plataforma J2EE 1.4 

API	Descripci�n
Componentes
Aplicaci�n y cliente de la aplicaci�n	Aplicaci�n de descriptores de implementaci�n est�ndar mediante esquemas XML
Enterprise JavaBeans (EJB) 2.1	Servicio de temporizadores y punto final del servicio Web EJB
Java Servlet 2.4	Filtro de punto final del servicio Web
Arquitectura JavaServer Pages (JSP) 2.0	Lenguaje de expresiones y biblioteca de etiquetas
J2EE Connector Architecture 1.5	Conectividad con adaptador de recursos entrantes y Java Message Service (JMS)
Servicios Web
Java Web Services Developer Pack 1.5	Paquete de herramientas integrado para crear, probar e implementar aplicaciones XML y servicios y aplicaciones Web
Java API for XML-based Remote Procedure Calls (JAX-RPC) 1.1	Asignaci�n para WSDL y tecnolog�a Java y compatibilidad con el desarrollo de puntos finales y clientes de servicios Web
WS-I Basic Profile 1.0	Elemento que activa la interoperabilidad usando WSDL y SOAP
SOAP with attachment API for Java (SAAJ) 1.2	Una API para mensajer�a basada en SOAP. Fomenta la creaci�n de mensajes SOAP con documentos adjuntos
Java APIs for XML Registries (JAXR) 1.0	Una API est�ndar y uniforme para acceder a los registros XML como, por ejemplo, el servicio de descubrimiento e integraci�n de descripciones universales, Universal Description Discovery and Integration (UDDI y ebXML)
Otro
J2EE Deployment 1.1	API est�ndar que hace posible la implementaci�n de aplicaciones y componentes J2EE
J2EE Management 1.0	Definiciones para el modelo de informaci�n destinadas a gestionar la plataforma J2EE
Java Management Extensions (JMX) 1.2	API de gesti�n est�ndar
Java Authorization Contract for Containers (JACC) 1.0	Definiciones de los contratos de seguridad establecidos entre Application Server J2EE y el proveedor de pol�ticas de autorizaciones
Java API for XML Processing (JAXP) 1.2	Una API mediante la cual las aplicaciones pueden analizar y transformar documentos XML. Tambi�n agrega compatibilidad con el procesamiento de esquemas XML
JMS 1.1	Un est�ndar de mensajer�a que hace posible que los componentes de aplicaciones J2EE creen, env�en, reciban y lean mensajes. Tambi�n agrega compatibilidad con API uniformes para colas y temas
JavaMail 1.3	Un conjunto de clases abstractas que sirven de modelo para un sistema de correo. Tambi�n incluye actualizaciones menores para las API

Alto rendimiento

Application Server incluye un contenedor EJB de alto rendimiento, servicios y contenedores Web, y admite el env�o simult�neo de mensajes con el software Sun Java System Message Queue.

Escalabilidad

Application Server admite una escalabilidad horizontal mediante el agrupamiento (cl�ster) de las instancias de servidor y el equilibrado de carga de las solicitudes. Tambi�n alcanza una escalabilidad vertical de clases gracias a su compatibilidad con equipos de gran tama�o y con varios procesadores. El agente de mensajes integrado se puede agrupar en cl�steres para obtener una mayor escalabilidad y disponibilidad. En el acceso de cliente desde clientes HTTP, aplicaciones de clientes enriquecidos basados en RMI/IIOP, clientes de servicios Web y clientes JRM se puede efectuar un equilibrado de carga hacia los cl�steres de Application Server.

Alta disponibilidad

Application Server incluye equilibrado de carga para los clientes HTTP, IIOP y JMS; compatibilidad con conmutaci�n por error de sesi�n HTTP; compatibilidad con la agrupaci�n en cl�steres de EJB y los servicios de conmutaci�n por error; temporizadores EJB de alta disponibilidad; recuperaci�n de transacciones distribuida; compatibilidad con actualizaciones de aplicaciones por turnos; y una base de datos de alta disponibilidad para el almacenamiento del estado transitorio de las aplicaciones J2EE.

La disponibilidad hace posible la conmutaci�n por error de las instancias de Application Server en un cl�ster. Si una instancia de Application Server pasa a estar inactiva, otra instancia de Application Server se har� cargo de las sesiones que tuviera asignadas el servidor que ya no est� disponible. La informaci�n de sesi�n se almacena en la base de datos HADB. HADB es compatible con la persistencia de las sesiones HTTP, los Stateful Session Beans y las credenciales de inicio de sesi�n �nico.

Compatibilidad con JavaServer Faces 1.1

Sun Java System Application Server Enterprise Edition 8.1 es compatible con la tecnolog�a JavaServer Faces 1.1. La tecnolog�a JavaServer Faces consiste en una serie de API de servidor que representan a los componentes de la interfaz de usuario que administran la validaci�n de las entradas, la gesti�n, los eventos y el estado. Las API tambi�n determinan la navegaci�n por la p�gina y admiten funciones de accesibilidad e internalizaci�n. Si lo desea, puede agregar componentes personalizados a la interfaz de usuario con una biblioteca de etiquetas personalizadas JSP.

Al realizar tareas de desarrollo con la tecnolog�a JavaServer Faces, los distintos miembros de un equipo de desarrollo pueden centrarse en una �nica parte del proceso. Un modelo de programaci�n sencillo enlazar� las distintas partes, lo que dar� como resultado un ciclo de desarrollo mucho m�s sencillo y eficaz.

Requisitos de software y hardware

En este apartado se enumeran los requisitos que se deben satisfacer antes de instalar el producto Sun Java System Application Server Enterprise Edition 8.1.

Requisitos de plataforma
Informaci�n importante sobre las revisiones
Bases de datos y controladores JDBC
Configuraci�n de Oracle
Configuraci�n de PointBase
Servidores Web
Exploradores
Limitaciones y requisitos de alta disponibilidad
Compatibilidad de HADB con los sistemas de archivos
Actualizaci�n de Sun Java System Application Server
Cambio a J2SE 5.0
Otros requisitos

Requisitos de plataforma

En la siguiente tabla se indican los sistemas operativos que se pueden utilizar con Sun Java System Application Server Enterprise Edition 8.1 2005Q1. Asimismo, se especifican las cantidades m�nimas y recomendadas de memoria para instalar y ejecutar Application Server.

Tabla 2  Requisitos de plataforma para Sun Java System Application Server 8.1 2005Q1 

Sistema operativo	Memoria m�nima	Memoria recomendada	Espacio en disco m�nimo	Espacio en disco recomendado	JVM
Sun Solaris 9, 10 (SPARC) Solaris 9, 10 (x86)	512 MB	1 GB	250 MB de espacio libre	500 MB de espacio libre	J2SE 1.4.2_06 J2SE 5.0
Redhat Enterprise Linux 2.1 Update 2, 3.0 Update 1	512 MB	1 GB	220 MB de espacio libre	300 MB de espacio libre	J2SE 1.4.2_06 J2SE 5.0
Microsoft Windows 2000� Advanced Server Service Pack 4+	512 MB	1 GB	250 MB de espacio libre	500 MB de espacio libre	J2SE 1.4.2_06 J2SE 5.0
Microsoft Windows Server� 2003	512 MB	1 GB	250 MB de espacio libre	500 MB de espacio libre	J2SE 1.4.2_06 J2SE 5.0

En UNIX, puede averiguar cu�l es su versi�n del sistema operativo usando el comando uname. El espacio en disco se puede comprobar con el comando df.

Requisitos de revisiones de Solaris

Es aconsejable que los usuarios de Solaris 9, 10 (x86, SPARC) tengan instalados los cl�steres de revisiones recomendados por Sun, que se encuentran en el apartado “Recommended and Security Patches” (Revisiones recomendadas y de seguridad) en:

http://sunsolve.sun.com/

RedHat Enterprise Linux 3.0 requiere un paquete adicional

Para ejecutar los componentes nativos de este producto, incluido el instalador, es necesario instalar el siguiente paquete, que no forma parte del paquete de distribuci�n est�ndar de RedHat Enterprise Linux 3.0: compat-libstdc++-7.3-2.96.118.i386.rpm

Dicho paquete se puede descargar de:

http://mirrors.kernel.org/redhat/redhat/linux/9/en/os/i386/RedHat/RPMS/compat-libstdc++-7.3-2.96.118.i386.rpm

Informaci�n importante sobre las revisiones

Para conocer la lista actual de revisiones requeridas por Sun Java System Application Server Enterprise Edition 8.1, acceda a http://sunsolve.sun.com y seleccione “Patches” (Revisiones) o “Patch Portal” (Portal de revisiones). Siga los enlaces de Sun Java System Application Server Enterprise Edition 8.1. A medida que cambien los requisitos de revisiones para el sistema operativo y est�n disponibles las revisiones para los componentes de Java Enterprise System, se podr�n obtener las actualizaciones desde SunSolve, inicialmente como cl�steres de revisiones recomendadas.

Bases de datos y controladores JDBC

El producto Sun Java System Application Server est� dise�ado para admitir la conectividad con cualquier dispositivo DBMS con un controlador JDBC correspondiente. Consulte la siguiente tabla, donde se enumeran los componentes que Sun ha probado y encontrado aceptables para la creaci�n de una configuraci�n de bases de datos compatible con J2EE.

Tabla 3  Controladores JDBC compatibles con J2EE 

Proveedor de JDBC	Tipo de controlador JDBC	Servidor de base de datos admitido
i-net Software	Tipo 4	Oracle (R) 8.1.7, 9i, 9.2.0.3 Sybase ASE 12.5.2 Microsoft SQL Server 2000 4.0 Service Pack 1
IBM	Tipo 2	IBM DB2 8.1 Service Pack 3+
PointBase	Tipo 4	PointBase Network Server 4.8
DataDirect	Tipo 4	Oracle (R) 8.1.7, 9i, 9.2.0.3 Sybase ASE 12.5.2 Microsoft SQL Server IBM DB2 8.1 Service Pack 3+
Controlador JDBC Sun Java System para Oracle	Tipo 4	Oracle (R) 9.2.0.3, 10G
Controlador JDBC Sun Java System para DB2	Tipo 4	IBM DB2 8.1 Service Pack 3+
Controlador JDBC Sun Java System para Sybase	Tipo 4	Sybase ASE 12.5.2
Controlador Sun Java System JDBC para Microsoft SQL Server	Tipo 4	Microsoft SQL Server 2000 4.0 Service Pack 1
Oracle	Tipo 4, Tipo 2	Oracle (R) 9.2.0.3, 10G

Para obtener m�s informaci�n sobre i-net Software, consulte:

http://www.inetsoftware.de/

Para obtener m�s informaci�n sobre DataDirect Technologies, consulte:

http://www.datadirect.com/

Configuraci�n de Oracle

Los controladores JDBC para Oracle deben estar correctamente configurados para que sean compatibles con J2EE 1.4. Use la siguiente configuraci�n para los controladores del tipo 2 y 4:

Use el controlador JDBC 9.2.0.3 o posterior.
La base de datos de Oracle debe tener el valor compatible=9.0.0.0.0 o superior en el archivo de par�metros (init.ora).
Use el archivo ojdbc14.jar.
Configure Application Server para que defina la siguiente propiedad JVM:

-Doracle.jdbc.J2EE13Compliant=true

Adem�s de los controladores de tipo 2, es necesario definir las variables ORACLE_HOME y LD_LIBRARY_PATH (que deben incluir $ORACLE_HOME/lib) en el entorno en el que se inicie Application Server. Por ejemplo, puede agregarlas al archivo asenv.conf y asegurarse de que se exportan.

Configuraci�n de PointBase

Muchas aplicaciones de ejemplo usan el servidor de base de datos de PointBase incluido en Application Server. Cuando use Application Server Enterprise Edition, deber� configurar el servidor de base de datos de PointBase antes de usarlo. No obstante, antes de usar PointBase con Application Server, tenga en cuenta la combinaci�n de configuraciones admitida.

Tabla 4  Combinaciones admitidas de J2SE/PointBase

Application Server	PointBase
Admitido
J2SE 1.4 J2SE 5.0	J2SE 1.4 J2SE 1.4
No admitido
J2SE 5.0	J2SE 5.0

Hay dos maneras de configurar PointBase:

Defina la variable de entorno JAVA_HOME en la ubicaci�n de J2SE. La implementaci�n de PointBase integrada en Application Server 8.1 s�lo se admite con J2SE 1.4.2.
Edite el archivo de configuraci�n de PointBase de Application Server.

Para usar el primer m�todo:

Aseg�rese de que tiene instalado el J2SE que desea usar.

Descargue J2SE 1.4.2 si todav�a no lo ha hecho.

S�rvase del comando adecuado para su sistema operativo y de su int�rprete de comandos para definir la variable de entorno JAVA_HOME en el directorio en el que est� instalado J2SE, por ejemplo:

% setenv JAVA_HOME "/opt/SUNWappserver/jdk"

Para usar el segundo m�todo, el procedimiento depende del sistema operativo.

Solaris y Linux

En el archivo de configuraci�n dir_instalaci�n/pointbase/tools/serveroption/pbenv.conf, cambie la l�nea:

PB_JAVA=%%%PB_JAVA%%%

por

PB_JAVA=ubicaci�n_J2SE

donde ubicaci�n_J2SE es el directorio en el que est� instalado J2SE. Si instal� J2SE con Application Server, estar� instalado de forma predeterminada en dir_instalaci�n/jdk. Despu�s de efectuar este cambio, puede iniciar PointBase usando la secuencia de comandos startserver.

Windows

En el archivo de configuraci�n dir_instalaci�n\pointbase\tools\serveroption\pbenv.bat, cambie la l�nea:

set PB_JAVA=%%%PB_JAVA%%%

por

set PB_JAVA=ubicaci�n_J2SE

donde ubicaci�n_J2SE es el directorio en el que est� instalado J2SE. Si instal� J2SE con Application Server, estar� instalado de forma predeterminada en dir_instalaci�n\j2se1.4. Despu�s de realizar este cambio, puede iniciar PointBase ejecutando startserver.bat.

Servidores Web

En este apartado se enumeran los servidores Web que se pueden usar con Sun Java System Application Server Enterprise Edition 8.1 2005Q1.

Tabla 5  Servidores Web compatibles 

Web Server	Versi�n	Sistema operativo
Sun Java System Web Server	6.1+	Solaris SPARC 8, 9, 10 Solaris x86 9, 10 Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1
Apache Web Server	1.3+, 1.4, 2.0	Solaris SPARC 9, 10 Solaris x86 10 Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1
Microsoft IIS�	5.0+	Windows Server 2003 Windows 2000 Advanced Server Service Pack 4+

La compatibilidad con plataformas adicionales, incluidos Windows y HP-UX, estar� disponible pr�ximamente.

Exploradores

En este apartado se enumeran los exploradores que se pueden usar con Sun Java System Application Server Enterprise Edition 8.1 2005Q1.

Tabla 6  Exploradores Web compatibles

Explorador	Versi�n
Mozilla	1.4, 1.5, 1.6, 1.7.x
Netscape Navigator	4.79, 6.2, 7.0
Internet Explorer	5.5 Service Pack 2, 6.0

Limitaciones y requisitos de alta disponibilidad

Los siguientes requisitos de alta disponibilidad se deben satisfacer antes de configurar el componente de alta disponibilidad de Sun Java System Application Server:

HADB requiere como m�nimo 512 MB de memoria. Para obtener un funcionamiento �ptimo con Application Server se recomienda disponer de 1 GB.
HADB es compatible s�lo con IPv4.
La red debe configurarse para la multidifusi�n UDP.
No utilice direcciones IP din�micas (DHCP) para hosts usados en los comandos create domain, extend domain, hadbm create o hadbm addnodes.
Si ejecuta HADB en Red Hat Linux 3.0, deber� instalar la actualizaci�n n�mero 4 (Update 4) para evitar problemas de intercambios excesivos en el sistema operativo. Tenga en cuenta que AS no se ha probado con Red Hat Update 4.

Compatibilidad de HADB con los sistemas de archivos

Hay varias consideraciones importantes que hay que tener en cuenta a la hora de configurar HADB para que utilice uno de los siguientes sistemas de archivos:

ext2 y ext3: HADB es compatible con los sistemas de archivos ext2 y ext3 para Red Hat Application Server 3.0. En el caso de Red Hat Application Server 2.1, HADB es compatible s�lo con el sistema de archivos ext2.
Veritas: si se usa el sistema de archivos Veritas en una plataforma Solaris, se mostrar� el siguiente mensaje en el archivo de historial “WRN: Direct disk I/O mapping failed” (Advertencia: falla la asignaci�n directa de E/S de disco). Este mensaje indica que HADB no puede activar la funci�n de E/S directa de los datos y los dispositivos de registro. La funci�n de E/S directa es una mejora del rendimiento que reduce el costo de la CPU a la hora de escribir p�ginas de disco. Esto tambi�n provoca que haya una menor carga para administrar las p�ginas de datos no �tiles en el sistema operativo.

Para usar la funci�n de E/S directa con el sistema de archivos Veritas, siga uno de estos procedimientos:

Cree los datos y los dispositivos de registro en un sistema de archivos que est� montado con la opci�n mincache=direct. Esta opci�n se aplica a todos los archivos creados en el sistema de archivos. Consulte el comando mount_vxfs(1M) para obtener m�s detalles.
Use la utilidad Veritas Quick I/O para realizar entradas y salidas sin formato en los archivos del sistema de archivos. Consulte VERITAS File System 4.0 Administrator's Guide for Solaris para obtener m�s informaci�n.

Tenga en cuenta que estas configuraciones no se han probado con Application Server 8.1.

Consulte Sun Java System Application Server Enterprise Edition 8.1 Installation Guide para obtener informaci�n detallada acerca de la instalaci�n y configuraci�n de HADB con el software Application Server 8.1.

Actualizaci�n de Sun Java System Application Server

Consulte la gu�a de instalaci�n para obtener todas las instrucciones acerca de la actualizaci�n desde una versi�n anterior de Application Server a Sun Java System Application Server Enterprise Edition 8.1 2005Q1.

Cambio a J2SE 5.0

Sun Java System Application Server 8.1 2005Q1 es compatible con J2SE 5.0 como JVM subyacente, sin embargo, la base de datos PointBase integrada no lo es. Si desea utilizar J2SE 5.0 en lugar de la aplicaci�n integrada J2SE 1.4.2 para ejecutar Application Server, lleve a cabo los siguientes pasos (Windows y Unix):

Descargue J2SE 5.0 SDK (no la versi�n JRE) e inst�lelo en el sistema si no lo ha hecho todav�a.

J2SE 5.0 SDK se puede descargar de http://java.sun.com/j2se/1.5.0/.

Detenga por completo Application Server.

Puede utilizar la siguiente l�nea de comandos:

instalaci�n_as/bin/asadmin stop-domain

o la interfaz gr�fica de usuario de la consola de administraci�n:

Haga clic en el nodo “Application Server”.
Haga clic en “Detener instancia”.
En el archivo dir_instalaci�n/config/asenv.conf (asenv.bat en Windows), cambie el valor de AS_JAVA para que haga referencia al directorio de inicio de J2SE 5.0:
En el archivo instalaci�n_as/samples/common.properties, cambie la l�nea que empieza por “com.sun.aas.javaRoot...” para que haga referencia a J2SE 5.0.
Reinicie Application Server.

instalaci�n_as/bin/asadmin start-domain

Nota	Si est� actualizando desde una versi�n de JDK anterior a la versi�n integrada (JDK 1.4.2_06), no podr� realizar la actualizaci�n a J2SE 5.0 usando los pasos indicados previamente. Adem�s de los pasos especificados, deber� eliminar todos los dominios existentes y volver a crearlos.

Otros requisitos

Los requisitos adicionales siguientes deben cumplirse antes de instalar el software Sun Java System Application Server.

Espacio libre: el directorio temporal debe tener un m�nimo de 35 MB libres para la instalaci�n de Sun Java System Application Server y 250 MB para la de SDK.
Uso del programa de desinstalaci�n: si necesita eliminar Application Server del sistema, es fundamental que utilice el programa de desinstalaci�n que se incluye con el software. Si intenta utilizar cualquier otro m�todo, surgir�n problemas cuando intente reiniciar la misma versi�n o cuando desee instalar una versi�n nueva.
Puertos libres: debe disponer de 7 puertos libres.
El programa de instalaci�n detecta autom�ticamente los puertos que est�n en uso y sugiere puertos libres para los ajustes predeterminados. Por defecto, los puertos predeterminados son 8080 para HTTP, 8181 para HTTPS y 4849 para Administration Server.
El programa de instalaci�n detectar� si los puertos est�n en uso y, en su caso, asignar� otros: Sun JavaTM System Message Queue (de forma predeterminada, 7676) e IIOP (de forma predeterminada, 3700 para IIOP y 1060 y 1061 para IIOP/SSL). Si estos n�meros de puertos predeterminados est�n en uso, el programa de instalaci�n asignar� un n�mero de puerto aleatorio del intervalo de puertos din�micos (es posible que no se asigne el puerto siguiente que est� disponible).
Inicio de servidores previamente instalados (UNIX): a menos que desee sustituir el servidor previamente instalado, deber� iniciarlo antes de comenzar el proceso de instalaci�n de Sun Java System Application Server 8.1. Esto permite que el programa de instalaci�n detecte los puertos que est�n en uso y no los asigne para otras aplicaciones.
Sustituci�n de servidores previamente instalados (UNIX): si dispone de una versi�n anterior de Sun Java System Application Server instalada y desea sustituirla por la versi�n actual de Application Server, deber� detenerla antes de instalar el servidor nuevo. Use el asistente de actualizaci�n del programa de instalaci�n para actualizar el servidor.
Cierre del firewall (Microsoft Windows): deber� detener cualquier software de firewall antes de instalar Sun Java System Application Server, puesto que algunos firewall deshabilitan los puertos de forma predeterminada. El programa de instalaci�n debe determinar con precisi�n qu� puertos est�n disponibles.

Para obtener m�s informaci�n acerca de la compatibilidad, consulte la gu�a de migraci�n y actualizaci�n, que est� disponible en:

http://docs.sun.com/app/docs/doc/819-0083

Versi�n independiente

La versi�n independiente de Sun Java System Application Server Enterprise Edition 8.1 difiere en varios aspectos de la versi�n Java ES Enterprise Edition, en concreto:

El producto independiente 8.1 puede instalarlo cualquier usuario, mientras que Java ES s�lo puede instalarlo el usuario ra�z.
El componente HADB se muestra como un subcomponente en la versi�n independiente, mientras que en una instalaci�n de Java ES es un componente compartido.
La versi�n independiente instala todos los componentes compartidos que se requieren para Application Server en un directorio de instalaci�n, a diferencia de JES, donde dichos componentes se instalan en otros directorios.
Los datos de configuraci�n, los dominios y los archivos del producto de Application Server se almacenan de forma predeterminada en un �nico directorio con el instalador independiente, pero en Java ES se almacenan en varios directorios.
La versi�n independiente permite instalar en un sistema en el que ya haya una instalaci�n de Application Server, ya sea de la misma versi�n o de una diferente, sin necesidad de desinstalarla. Esto se logra manteniendo directorios de instalaci�n exclusivos en las distintas versiones o en las diferentes instancias de la misma versi�n.
La versi�n independiente es compatible con la actualizaci�n “in situ” de una instalaci�n existente de Sun Java System Application Server Platform Edition 8.0 o de Sun Java System Application Server Platform Edition 8.1 a Sun Java System Application Server Enterprise Edition 8.1.

Documentaci�n relacionada

Adem�s de estas notas de la versi�n, el producto Application Server incluye un paquete de documentaci�n completo que se halla en esta ubicaci�n:

http://docs.sun.com/app/docs/coll/ApplicationServer8_pe_04q4

En la siguiente tabla se enumeran los manuales incluidos en el paquete de documentaci�n de la aplicaci�n Application Server.

Tabla 7  Manuales incluidos en el paquete de documentaci�n 

T�tulo de la gu�a	Descripci�n
Gu�a de inicio r�pido	C�mo iniciarse en el uso del producto Sun Java System Application Server.
Gu�a de instalaci�n	Instalaci�n del software de Sun Java System Application Server y sus componentes.
Gu�a de planificaci�n de la implementaci�n	Evaluaci�n de las necesidades del sistema y de su empresa para garantizar que Sun Java System Application Server se implementa del modo que mejor satisfaga dichas necesidades. Tambi�n se tratan aqu� otros asuntos generales que se deben tener en cuenta a la hora de implementar un servidor de aplicaciones.
Gu�a del desarrollador	Creaci�n e implementaci�n de aplicaciones de Java™ 2 Platform, Enterprise Edition (J2EE™ Platform) destinadas a ejecutarse en Sun Java System Application Server que siguen el modelo de est�ndares abiertos de Java para las API y los componentes J2EE. Incluye informaci�n general acerca de las herramientas de desarrollo, la seguridad, el ensamblaje, la implementaci�n, la depuraci�n de errores y la creaci�n de m�dulos de ciclo de vida.
Tutorial de J2EE 1.4	Uso de las tecnolog�as de plataformas J2EE 1.4 y API para desarrollar aplicaciones J2EE e implementarlas en Sun Java System Application Server.
Administration Guide	Configuraci�n, gesti�n e implementaci�n de subsistemas y componentes de Sun Java System Application Server desde la consola de administraci�n.
Gu�a de administraci�n de alta disponibilidad	Tareas de configuraci�n posteriores a la instalaci�n e instrucciones de administraci�n para la base de datos de alta disponibilidad.
Referencia de administraci�n	Edici�n del archivo de configuraci�n de Sun Java System Application Server, domain.xml.
Gu�a de migraci�n y actualizaci�n	Migraci�n de aplicaciones al nuevo modelo de programaci�n de Sun Java System Application Server, en concreto desde Application Server 6.x y 7. Esta gu�a tambi�n ilustra las diferencias entre versiones de productos adyacentes y opciones de configuraci�n que pueden generar incompatibilidades con las especificaciones del producto.
Performance Tuning Guide	Establecimiento de ajustes en Sun Java System Application Server para mejorar el rendimiento.
Gu�a de resoluci�n de problemas	Sugerencias para solucionar problemas de Sun Java System Application Server.
Referencia de mensajes de error	C�mo solucionar los mensajes de error de Sun Java System Application Server.
Reference Manual	Comandos de utilidades que est�n disponibles en Sun Java System Application Server (est�n escritos en el estilo de p�ginas de comando man). Incluye la interfaz de l�nea de comandos asadmin.

---

Limitaciones y problemas conocidos

Este apartado describe los problemas conocidos del software Sun Java System Application Server Enterprise Edition 8.1 2005Q1 y las soluciones asociadas. Si no se especifica una plataforma concreta para un problema, significa que �ste se aplica a todas las plataformas. Esta informaci�n est� organizada en las siguientes secciones:

Administraci�n
Cliente de la aplicaci�n
Controladores JDBC de Sun integrados
Conectores
Persistencia administrada mediante contenedor
Deploytool
Documentaci�n
Alta disponibilidad
Instalaci�n
Tutorial de J2EE
Gesti�n del ciclo de vida
Registro
Message Queue
Supervisi�n
PointBase
Ejemplos
Seguridad
Utilidad de actualizaci�n
Contenedor Web

Administraci�n

Este apartado describe problemas conocidos relacionados con la administraci�n, junto con las soluciones pertinentes.

La secuencia de comandos package-appclient no funciona si domain1 no est� presente. (ID 6171458)

De forma predeterminada, hay un valor codificado en $INSTALL/lib/package-appclient.xml para la variable AS_ACC_CONFIG de domain1 que hace referencia a asenv.conf. Si domain1 se elimina y se crea un nuevo dominio, la variable AS_ACC_CONFIG no se actualiza con el nombre del dominio nuevo, lo que provoca que falle la secuencia de comandos package-appclient.

Soluci�n

Lleve a cabo una de las siguientes acciones:

Deje intacto domain1 y cree los dem�s dominios en torno a �l.
Elimine domain1 y sustituya el valor codificado por domain1 en $INSTALL/lib/package-appclient.xml por el nuevo nombre de dominio. Deber� llevar a cabo este procedimiento cada vez que cree un dominio nuevo si domain1 no est� presente.

No se puede restaurar con otro nombre un dominio del que se haya hecho una copia de seguridad. (ID 6196993)

La duplicaci�n de un dominio en la misma instalaci�n de Application Server no se puede realizar utilizando los comandos backup-domain y restore-domain porque el dominio no se puede restaurar usando un nombre distinto del original, a pesar de que el comando asadmin restore-domain proporcione una opci�n para cambiar el nombre al dominio. Parece que el cambio de nombre del dominio del que se ha hecho una copia de seguridad es correcto, pero al intentar iniciar el dominio en cuesti�n se producen fallos porque las entradas de la configuraci�n del dominio no se han cambiado y startserv y stopserv usan el nombre de dominio original para definir las rutas.

Soluci�n

El nombre de dominio utilizado para restore-domain debe ser el mismo que se us� para el comando original backup-domain. Los comandos backup-domain y restore-domain de Application Server 8.1 funcionan s�lo para hacer copias de seguridad y restaurar el mismo dominio en el mismo equipo.

No se puede iniciar Application Server con un agente JMX adicional. (ID 6200011)

J2SE 1.4.x, 5.0, o versiones posteriores se pueden configurar en Application Server. Una funci�n integral de la plataforma J2SE 5.0 es la capacidad para iniciar un agente JMX. Esta funci�n se activa definiendo expl�citamente propiedades de sistema al iniciar el servidor.

Entre los valores de ejemplo se incluyen:

name="com.sun.management.jmxremote" value="true"
name="com.sun.management.jmxremote.port" value="9999"
name="com.sun.management.jmxremote.authenticate" value="false"
name="com.sun.management.jmxremote.ssl" value="false"

Despu�s de configurar las propiedades JMX e iniciar el servidor, se inicia un nuevo servidor jmx-connector en la m�quina virtual de Application Server. Un efecto colateral de este hecho es que las funciones de administraci�n se ven afectadas negativamente y la GUI (interfaz gr�fica de usuario) y la CLI (interfaz de l�nea de comandos) de administraci�n de Application Server pueden generar resultados inesperados. El problema es que se producen algunos conflictos entre el servidor integrado jmx-connector y el nuevo servidor jmx-connector.

Soluci�n

Si utiliza jconsole (o cualquier otro cliente compatible con JMX), puede reutilizar el servidor est�ndar JMX Connector Server que se ejecuta al iniciar Application Server.

Cuando el servidor se inicia, en server.log aparece una l�nea similar a la que se muestra a continuaci�n. Puede conectarse al JMXServiceURL especificado aqu� y realizar las mismas operaciones de gesti�n o configuraci�n despu�s de proporcionar correctamente las credenciales, por ejemplo:

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|javax.enterprise.system.tools.adm in|_ThreadID=10;|ADM1501: Here is the JMXServiceURL for the JMXConnectorServer: [service:jmx:rmi:///jndi/rmi://nombre_host:8686/management/rmi-jmx-connector]. This is where the remote administrative clients should connect using the JSR 160 JMX Connectors.|#]

Para obtener m�s informaci�n, consulte Sun Java System Application Server 8.1 Administration Guide.

Las restricciones ejecutan permisos en las secuencias de comandos Application Server start y stop. (S�lo UNIX) (ID 6206176)

Si ejecuta el comando asadmin restore-domain cuando est� registrado como el usuario “A”, las secuencias de comandos terminar�n con permisos como 744 (rwxr--r--). Si, posteriormente, intenta iniciar o detener un dominio usando el usuario “B” (incluso aunque “B” sea ra�z), se producir� un fallo porque las secuencias de comandos s�lo las podr� ejecutar el usuario “A”.

Soluci�n

Cambie los permisos de las secuencias de comandos:

chmod 755 <appserv>/domains/<domain-name>/bin/*

Cliente de la aplicaci�n

Este apartado describe problemas conocidos relacionados con los clientes de la aplicaci�n, junto con las soluciones pertinentes.

La biblioteca JAR incluida en el archivo del cliente de aplicaci�n sobrescribe el archivo MANIFEST. (ID 6193556)

Si dispone de un archivo JAR de nivel superior en el cliente JAR (en este caso, reporter.jar), al implementar el cliente JAR, el archivo MANIFEST de dicho JAR sobrescribe el archivo MANIFEST del cliente JAR.

Soluci�n

Ninguna por ahora.

Controladores JDBC de Sun integrados

Este apartado describe problemas conocidos relacionados con los controladores JDBC de Sun, junto con las soluciones pertinentes.

Es posible que se bloqueen las aplicaciones que utilizan el nivel de aislamiento TRANSACTION_SERIALIZABLE con el controlador de Sun integrado para Microsoft SQL Server cuando se utiliza una sentencia preparada para actualizar, en caso de que se est�n llevando a cabo dos transacciones paralelas y una de ellas se deshaga. (ID 6165970)

Para definir el nivel deseado de aislamiento para una conexi�n, el conjunto de conexiones correspondiente debe crearse en el mismo nivel de aislamiento. Consulte Application Server 8.1 2005Q1 Administration Guide para obtener informaci�n sobre c�mo configurar los conjuntos de conexiones.

Soluci�n

Ninguna.

Errores de PreparedStatement (ID 6170432)

Descripci�n 1

Si una aplicaci�n genera m�s de 3000 objetos PreparedStatement en una transacci�n, se puede producir el siguiente error con DB2:

[sunm][DB2 JDBC Driver]No more available statements. Please recreate your package with a larger dynamicSections value.

Soluci�n 1

Agregue las siguientes propiedades a la definici�n del conjunto de conexiones para que el controlador vuelva a relacionar los paquetes DB2 con valores mayores de secciones din�micas:

createDefaultPackage=true
replacePackage=true
dynamicSections=1000

Consulte Application Server 8.1 2005Q1 Administration Guide para obtener informaci�n sobre c�mo configurar los conjuntos de conexiones.

Descripci�n 2

En relaci�n con el error de PreparedStatement mencionado anteriormente, otro mensaje de error que se puede mostrar es:

[sunm][DB2 JDBC Driver][DB2]Virtual storage or database resource is not available

Soluci�n 2

Aumente el par�metro de configuraci�n APPLHEAPSZ del servidor DB2 Un valor adecuado es 4096.

Descripci�n 3

Nivel de aislamiento TRANSACTION_SERIALIZABLE.

Si una aplicaci�n utiliza un nivel de aislamiento TRANSACTION_SERIALIZABLE y emplea uno de los par�metros sugeridos anteriormente, es posible que se bloquee cuando intente obtener la conexi�n.

Soluci�n 3

Para definir el nivel deseado de aislamiento para una conexi�n, el conjunto de conexiones correspondiente debe crearse en el mismo nivel de aislamiento. Consulte Application Server 8.1 2005Q1 Administration Guide para obtener m�s instrucciones.

En Application Server Enterprise Edition 8.1, el controlador integrado JDBC DB2 de Sun no funciona con la configuraci�n predeterminada. Esto ocurre porque las clases del controlador JDBC DB2 requieren un permiso expl�cito charsetProvider RuntimePermission. (ID 6183492)

Soluci�n

Modifique el archivo server.policy para proporcionar los siguientes permisos a una aplicaci�n implementada que utilice el controlador JDBC:

grant codeBase "file:${DEPLOYED_APPLICATION_DIR}" { permission java.lang.RuntimePermission "charsetProvider";
};

Tenga en cuenta que esto s�lo es necesario para el controlador integrado JDBC DB2 de Sun.

Surgen problemas al definir el nivel de aislamiento con el controlador integrado de Sun para Sybase Adaptive Server. (ID 6189199)

Es posible que se bloqueen las aplicaciones que utilizan el nivel de aislamiento TRANSACTION_SERIALIZABLE con el controlador de Sun integrado para Sybase Adaptive Server cuando se utiliza una sentencia preparada para actualizar, en caso de que se est�n llevando a cabo dos transacciones paralelas y una de ellas se deshaga. El proceso para deshacer la conexi�n falla y se muestra el siguiente mensaje. Las conexiones deshechas no se pueden utilizar nunca m�s:

java.sql.SQLException: [sunm][Sybase JDBC Driver]Request cannot be submitted due to wire contention

Sybase Adaptive Server no es compatible con el nivel de aislamiento TRANSACTION_REPEATABLE_READ. No obstante, al realizar una consulta a DatabaseMetaData, el controlador integrado de Sun indica que dicho nivel de aislamiento s� es compatible con la base de datos. Las aplicaciones que utilizan este nivel de aislamiento fallar�n.
Las aplicaciones que usan el controlador integrado de Sun no pueden establecer el nivel de aislamiento TRANSACTION_READ_UNCOMMITTED. La aplicaci�n desencadena la siguiente excepci�n en el primer acceso DataBaseMetaData:

java.sql.SQLException: [sunm][Sybase JDBC Driver][Sybase]The optimizer could not find a unique index which it could use to perform an isolation level 0 scan on table 'sybsystemprocs.dbo.spt_server_info'.

Soluci�n

Ninguna.

Conectores

Este apartado describe problemas conocidos relacionados con la arquitectura de conectores J2EE, junto con las soluciones pertinentes.

connection-validation no se puede reconfigurar din�micamente en jdbc-connection-pools. (ID 4930792)

Despu�s de crear un conjunto de conexiones, el atributo is-connection-validation-required no se puede reconfigurar din�micamente. Esto supone que si hay un conjunto de conexiones ya creado, la validaci�n no se puede activar (on ) ni desactivar (off) sobre la marcha. Ocurre lo mismo con el atributo validation-method del conjunto.

Soluci�n

A continuaci�n, se exponen tres posibles soluciones en orden descendente en funci�n del grado de intrusismo con las aplicaciones que est�n en ejecuci�n:

Cree jdbc-connection-pools con validation activado (on).
Elimine el jdbc-connection-pool y vuelva a crearlo con validation activado (on).

Esto afectar� s�lo a unas cuantas aplicaciones implementadas que dependan del conjunto de conexiones concreto.

Cambie la propiedad validation y reinicie Application Server.

Esto afectar� a todas las aplicaciones implementadas (puesto que hay que efectuar un reinicio).

Despu�s de reiniciar la instancia DAS, la anulaci�n de la implementaci�n del m�dulo del conector falla cuando la opci�n de cascada est� definida en false. (ID 6188343)

En esta situaci�n, un m�dulo de conector independiente o integrado est� implementado en DAS y los conjuntos de conexiones del conector y los recursos se crean para el m�dulo implementado. Despu�s de reiniciar la instancia DAS, la anulaci�n de la implementaci�n del m�dulo del conector falla cuando la opci�n de cascada est� definida en falso con la siguiente excepci�n:

[#|2004-10-31T19:52:23.049-0800|INFO|sun-appserver-ee8.1|javax.enterprise.system
.core|_ThreadID=14;|CORE5023: Error while unloading application [foo]|#]

Soluci�n

Use la anulaci�n de implementaci�n en cascada (establezca la opci�n cascade en true) para anular la implementaci�n de los conectores integrados e independientes despu�s de reiniciar la instancia DAS.

Persistencia administrada mediante contenedor

Este apartado describe problemas conocidos relacionados con la persistencia administrada mediante contenedor, junto con las soluciones pertinentes.

Puede que una consulta EJBQL no contenga todos los resultados coincidentes si la cl�usula where contiene un operador OR y una navegaci�n cmr de valor �nico. (ID 6184864)

Si la cl�usula where de una consulta EJBQL contiene un operador OR y una navegaci�n cmr de valor �nico, el resultado de la consulta no contendr� el resultado para las filas en las que la ruta de navegaci�n sea null, aunque la ruta de navegaci�n est� en una cl�usula OR diferente.

Por ejemplo, suponga que un esquema consta de los elementos Empleado (Employee), Departamento (Department) y Seguro (Insurance). Employee mantiene una relaci�n uno a varios con Department y una relaci�n uno a uno con Insurance:

select Distinct Object(e) from Employee e
    where e.name = ’John’ OR e.department.name = ’Engineering’

La consulta anterior no devolver� los empleados cuyo nombre sea John y que no pertenezcan a ning�n departamento.

select Distinct Object(e) from Employee e
    where e.department.name = ’Engineering’ OR e.insurance.name = ’xyz’

La consulta anterior no devolver� los empleados cuyo seguro sea xyz y que no pertenezcan a ning�n departamento. Tampoco devolver� ning�n empleado cuyo nombre de departamento sea Ingenier�a (Engineering) y que no tenga ning�n seguro.

Soluci�n

Ejecute la consulta para cada condici�n OR por separado y fusione los resultados.

Deploytool

Este apartado describe problemas conocidos relacionados con Deploytool, junto con las soluciones pertinentes.

Deploytool a menudo no crea elementos message-destination en los siguientes descriptores de implementaci�n de Sun: (ID 6197393)

sun-application-client.xml
sun-ejb-jar.xml
sun-web.xml

Puede que un recurso de destino JMS especificado como “Nombre JNDI” en la ficha “Destinos de los mensajes” no se guarde en el descriptor de Sun. Despu�s de especificar un valor para “Nombre de destino”, como, por ejemplo, Cola f�sica (PhysicalQueue), que es un destino f�sico creado con create-jmsdest, y despu�s de pulsar Intro, el nombre del destino aparecer� debajo de “Nombre para mostrar” y el cliente o el nombre de bean aparecer�n en la lista “Productores”. Despu�s de escribir “jms/Queue” en el campo de texto espec�fico del nombre JNDI y de pulsar Intro, la aplicaci�n no indica en la barra de t�tulo que se haya producido un cambio “(changed)” y el error se escribe en ~/.deploytool/logfile. A la hora de guardar la aplicaci�n y de volver a la ficha, el campo del nombre JNDI estar� en blanco de nuevo. Cuando visualice el descriptor de Sun usando “Herramientas”>“Visor del descriptor”>“Descriptor del servidor de aplicaciones” (Application Server), el elemento <message-destination> no se habr� creado en <jndi-name>.

El problema es que durante una sesi�n de Deploytool, la primera vez que se especifica un valor para “Nombres JNDI del destino del mensaje”, el valor aparece como correcto en el descriptor de Sun, pero org.netbeans.modules.schema2beans.BeanProp.setElement() desencadena una excepci�n IllegalArgumentException. Los cambios posteriores o las adiciones de un nombre JNDI del destino del mensaje que se realicen en la misma aplicaci�n o en otras aplicaciones no se guardar�n en el descriptor de Sun.

Soluci�n

Para editar un nombre JNDI existente del destino del mensaje:

Elimine dicho nombre, deje el campo “Nombre JNDI” en blanco y pulse Intro.
Escriba el nuevo nombre JNDI y pulse Intro.
Visualice el descriptor de Sun haciendo clic en “Herramientas”>“Visor del descriptor”>“Descriptor del servidor de aplicaciones” (Application Server).
Guarde la aplicaci�n haciendo clic en “Archivo”>“Guardar”.

Si el nombre JNDI no se guarda en el descriptor de Sun:

Reinicie Deploytool.
En la ficha “Destinos de los mensajes”, seleccione el destino del mensaje o agregue un destino nuevo.
Especifique el nombre JNDI del destino del mensaje en el campo de texto “Nombre JNDI” espec�fico de Sun y, acto seguido, pulse Intro.
Visualice el descriptor de Sun haciendo clic en “Herramientas”>“Visor del descriptor”>“Descriptor del servidor de aplicaciones” (Application Server).
Guarde la aplicaci�n haciendo clic en “Archivo”>“Guardar”.

Repita los pasos anteriores cada vez que deba introducir un valor en el nombre JNDI espec�fico de Sun en la ficha “Destinos de los mensajes”, a menos que sea la primera vez que especifica un valor en el campo de texto “Nombre JNDI” durante una sesi�n de Deploytool.

Paneles truncados en el Asistente para un nuevo servicio Web (ID 6198981)

Este problema se hace evidente mediante dos tipos de s�ntomas:

Al hacer clic en “Siguiente” en el panel “Archivo WSDL” no se accede al siguiente panel y se desencadena una excepci�n:

java.lang.NoClassDefFoundError: com/sun/org/apache/xpath/internal/XPathAPI

En el panel “Crear punto final empaquetado”, seleccione “Crear punto final de servicio y empaquetarlo”. Al hacer clic en “Finalizar” en el panel “Pasos siguientes”, no se crea un m�dulo de punto final en el directorio de salida y se desencadena una excepci�n:

java.lang.NoClassDefFoundError: com/sun/org/apache/xpath/internal/XPathAPI.

El problema es xalan.jar, que contiene la clase XPathAPI.class, no est� incluido en CLASSPATH. Tenga en cuenta que este problema no se produce en JDK 5.0.

Soluci�n

Agregue xalan.jar a CLASSPATH includes para el proceso s1as-deploytool de dir_instalaci�n/lib/processLauncher.xml. Por ejemplo:

includes="appserv-assemblytool.jar,activation.jar,appserv-admin.jar,appserv-cmp.jar,appser v-rt.jar,j2ee.jar,jaxrpc-impl.jar,appserv-ext.jar,deployhelp.jar,admin-cli.jar,dom.jar,xer cesImpl.jar, xalan.jar"

“Home” est� traducido incorrectamente como “directorio de instalaci�n” (Installation Directory) en Deploytool en el idioma chino simplificado. (ID 6203658)

Cuando cree un Enterprise Bean en Deploytool y, despu�s, acceda a la ficha de transacciones o seguridad para el nodo del Bean, las etiquetas “Local Home” y “Remote Home” est�n traducidas incorrectamente como “Directorio de instalaci�n local” (Local Installation Directory) y “Directorio de instalaci�n remoto” (Remote Installation Directory).

Documentaci�n

Este apartado describe problemas conocidos relacionados con la documentaci�n, junto con las soluciones pertinentes.

Errores en index.html y en QuickStart.html (ID 6193749)

Hay dos tipos de errores en el archivo index.html relacionados con la documentaci�n de Application Server 8.1 y en el archivo docs-ee/QuickStart.html.

La p�gina predeterminada index.html copiada en el directorio docroot de cada dominio muestra una ruta incorrecta. La correcta es:

instancia_as/domains/nombre_dominio/docroot/

en lugar de

dir_instalaci�n/domains/nombre_dominio/docroot/index.html

La gu�a de inicio r�pido proporciona instrucciones de instalaci�n incorrectas para el equilibrador de carga y los servidores Web. Para obtener informaci�n actualizada, consulte dicha gu�a en:

http://docs.sun.com/app/docs/doc/819-1259

Tenga en cuenta que esto afecta s�lo a la versi�n Java ES Enterprise Edition de Application Server 8.1, no a Versi�n independiente.

El comando - asadmin create-domain --help genera un uso incorrecto y se indica una opci�n no v�lida (--admin.jmxport). (ID 6207862)

El comando de ayuda para asadmin create-domain describe --admin.jmxport, que no es una opci�n v�lida para este comando.

Soluci�n

--admin.jmxport no se puede utilizar con el comando asadmin create-domain.

Incoherencias en Javadoc (varios ID)

Falta Javadoc o es incorrecto para varios m�todos e interfaces AMX:

Los m�todos Getter para las estad�sticas NumConnAcquired y NumConnReleased no est�n incluidos en ConnectorConnectionPoolStats y AltJDBCConnectionPoolStats. Dichos m�todos se agregar�n en una versi�n futura con los nombres getNumConnAcquired() y getNumConnReleased().
Si intenta ejecutar los siguientes m�todos en EJBCacheStats se desencadenar� una excepci�n: getPassivationSuccesses(), getExpiredSessionsRemoved(), getPassivationErrors(), getPassivations(). Este error se solucionar� en una futura versi�n.
AMX MBeans necesitan varios segundos despu�s de que se inicie el servidor para registrarse y estar disponibles para su uso. En una versi�n futura ser� posible determinar si los AMX MBeans est�n totalmente cargados.
La constante XTypes.CONNNECTOR_CONNECTION_POOL_MONITOR contiene errores tipogr�ficos (“NNN”). Este error se solucionar� en una futura versi�n.

Alta disponibilidad

Este apartado describe problemas conocidos relacionados con la base de datos de alta disponibilidad (HADB), junto con las soluciones pertinentes.

Los requisitos para usar Apache con Sun Java System Application Server que figuran en el ap�ndice “Compiling and Configuring Apache Web Server” de Administration Guide est�n desfasados.

A continuaci�n, figuran los requisitos de software para utilizar el software de servidor Web de Apache con HADB.

Requisitos para Apache 1.3
openssl-0.9.7e (origen)
mod_ssl-2.8.16-1.3.33 (origen)
apache_1.3.33 (or�genes)
gcc-3.3-sol9-sparc-local packages (para Solaris 9 SPARC/ x86)
gcc-3.3-sol9-intel-local packages (para Solaris 9 x86)
flex-2.5.4a-sol9-sparc-local packages (para Solaris 9 SPARC)
flex-2.5.4a-sol9-intel-local packages (para Solaris 9 x86)

Requisitos para Apache 2.0
openssl-0.9.7e (origen)
httpd-2.0.49 (origen)
gcc-3.3-sol9-sparc-local packages (para Solaris 9 SPARC).
gcc-3.3-sol9-intel-local packages (para Solaris 9 x86)
flex-2.5.4a-sol9-sparc-local packages (para Solaris 9 SPARC)
flex-2.5.4a-sol9-intel-local packages (para Solaris 9 x86)

Tambi�n hay un paso adicional que se debe efectuar antes de compilar. En la plataforma Solaris 10, antes de ejecutar make para OpenSSL, ejecute el siguiente comando:

/usr/local/lib/gcc-lib/sparc-sun-solaris2.9/3.3/install-tools/mkheaders.

Por �ltimo, la informaci�n del apartado “Configuring Load Balancing and Failover” en Administration Guide referente a las modificaciones que debe realizar en el servidor Web Apache despu�s de que la instalaci�n est� incompleta.

Todas las plataformas

Cree un directorio llamado sec_db_files en apache_install_dir.
Copie dominio/config/*.db en apache_install_dir/sec_db_files.

Plataformas Solaris:

Agregue la ruta /usr/lib/mps/secv1 a LD_LIBRARY_PATH en la secuencia de comandos dir_instalaci�n_Apache/bin/apachectl. La ruta debe agregarla antes de /usr/lib/mps.

Plataformas Linux:

Agregue la ruta /opt/sun/private/lib a LD_LIBRARY_PATH en la secuencia de comandos dir_instalaci�n_Apache/bin/apachectl. La ruta debe agregarla antes de /usr/lib.

Configuraci�n HADB con redes dobles (sin ID)

La configuraci�n de HADB con redes dobles en dos subredes funciona correctamente en Solaris SPARC. Sin embargo, debido a problemas en el sistema operativo o a los controladores de red en algunas plataformas de hardware, se ha observado que las plataformas Linux y Solaris x86 no siempre gestionan correctamente las redes dobles. Esto provoca los siguientes problemas con HADB:

En Linux, algunos de los procesos de HADB se bloquean al enviar mensajes. Esto hace que el nodo de HADB se reinicie y se produzcan particiones en la red.
En Solaris x86, pueden surgir algunos problemas despu�s de un fallo de red que impidan cambiar a otras interfaces de red. Esto no ocurre siempre, por lo que sigue siendo mejor tener dos redes en lugar de una. Estos problemas est�n parcialmente resueltos en Solaris 10.
No se admite el truncamiento.
HADB no admite el uso de redes dobles en Windows 2003 (ID 5103186).

Las tablas nuevas creadas despu�s de agregar nodos nuevos no se fragmentan en los nodos agregados. (ID 5042351)

Si crea una instancia de base de datos y agrega nodos, todas las tablas que se creen posteriormente no se fragmentar�n en los nodos agregados despu�s de crear la base de datos. S�lo las tablas que se hayan creado antes que el comando addnodes podr�n usar los nodos agregados cuando hadbm addnodes lo vuelva a fragmentar. Esto se debe a que create table usa el grupo de nodos sysnode que se crea cuando se ejecuta hadbm create.

Soluci�n

Ejecute hadbm refragment despu�s de agregar las tablas nuevas o cree las tablas en el grupo de nodos all_nodes.

No se admiten las rutas heterog�neas para packagepath. (ID 5091349)

No se puede registrar el mismo paquete de software con el mismo nombre en distintas ubicaciones y en hosts diferentes, por ejemplo:

hadbm registerpackage test --packagepath=/var/install1 --hosts europa11
Package successfully registered.
hadbm registerpackage test --packagepath=/var/install2 --hosts europa12
hadbm:Error 22171: A software package has already been registered with the package name test.

Soluci�n

HADB no admite rutas heterog�neas en los nodos de un cl�ster de base de datos. Aseg�rese de que el directorio de instalaci�n de HADB (--packagepath) es el mismo para todos los hosts que participen.

hadbm set no comprueba la disponibilidad de los recursos (espacio de memoria y disco). (ID 5091280)

Al aumentar el tama�o de la memoria b�fer o de los dispositivos usando hadbm set, el sistema de gesti�n comprueba la disponibilidad de los recursos cuando se crean bases de datos o se agregan nodos, pero no comprueba si hay recursos suficientes cuando se cambia el tama�o de la memoria b�fer principal o del dispositivo.

Soluci�n

Compruebe si hay espacio de disco o de memoria suficiente en todos los hosts antes de aumentar los atributos de configuraci�n devicesize o buffersize.

Problemas entre HADB y RedHat AS 3.0 en el modo de ubicaci�n compartida en el directorio de carga. (ID 6158393)

HADB se ejecuta con RedHat 3.0 compartiendo ubicaci�n con AS. Las transacciones se pueden cancelar e influir en el rendimiento. Esto est� provocado por el intercambio excesivo realizado por el sistema operativo.

Soluci�n

El problema se ha solucionado en Red Hat EL 3.0 Update 4. HADB se ha probado con RedHat 3.0 Update 4 y se ha comprobado que el intercambio excesivo del sistema operativo ha desaparecido. Tenga en cuenta que Application Server 8.1 no se ha probado con la actualizaci�n 4.

El comando configure-ha-cluster puede quedarse bloqueado. (ID 6159633)

Cuando se usa el comando asadmin configure-ha-cluster para crear o configurar un cl�ster de alta disponibilidad en m�s de un host, el comando se queda bloqueado a veces. No se desencadenan excepciones desde el agente de gesti�n de HADB ni desde Application Server.

Soluci�n

HADB no admite rutas heterog�neas en los nodos de un cl�ster de base de datos. Aseg�rese de que el directorio de instalaci�n de HADB y el de configuraci�n son iguales para todos los hosts que participen. Aseg�rese de borrar los directorios del repositorio antes de ejecutar el comando de nuevo.

Rendimiento de Application Server con HADB. (ID 6172589)

En todas las plataformas, el rendimiento de las instancias de Application Server configuradas para usar HADB ser� peor que en la versi�n anterior debido a los cambios de los controladores JDBC que usa HADB.

Soluci�n

P�ngase en contacto inmediatamente con los servicios de asistencia de Sun para obtener ayuda.

El segundo comando addnodes falla durante la refragmentaci�n. (ID 6175436)

El segundo comando addnodes (y los siguientes) puede fallar durante la refragmentaci�n con el siguiente error:

hadbm:Error 22042: Database could not be refragmented. Please retry with hadbm refragment command to refragment the database. Caused by: HADB-E-11747: Nodegroup all_nodes exists already

Soluci�n

Refragmente las tablas manualmente usando hadbm.

No se puede crear un dispositivo de datos con un tama�o superior a los 2 GB en Windows. (ID 6181845)

Si usa hadbm create o hadbm set con --NumberOfDataDevices=1 (predeterminado) y --devicesize con un valor superior a 2 GB, se produce el siguiente error:

DEVINIT-ERROR: out of space, wrote -2147479552 B of -2036330496 B
An attempt was made to move the file pointer before the beginning of the file.

Soluci�n

Si necesita crear un dispositivo de datos con un tama�o superior a los 2 GB en Windows, divida el valor del comando devizesize entre 2 GB y averig�e el n�mero de dispositivos que necesita. A continuaci�n, cree los dispositivos de datos que necesite seg�n el c�lculo usando la opci�n --NumberOfDataDevices. Por ejemplo, si necesita crear un dispositivo de datos de 5 GB:

Deber� redondear el valor y definir --NumberOfDataDevices=3.

La informaci�n que figura en la ayuda de hadbm est� desfasada. (ID 6190702)

Parte de la informaci�n del sistema de ayuda de hadbm no est� actualizada.

Soluci�n

Consulte el cap�tulo sobre HADB en Application Server 8.1 Administrator s Guide para obtener la informaci�n m�s reciente.

El comando Addnodes falla y muestra el error de tabla no encontrada. (ID 6214601)

En esta situaci�n, el comando de refragmentaci�n hadbm falla y muestra el siguiente error:

hadbm:Error 22042: Database could not be refragmented. Please retry with hadbm refragment command to refragment the database.. Caused by: HADB-E-11701: *Table singlesignon not found*

Soluci�n

La soluci�n consiste en refragmentar manualmente las tablas App Srv usando el comando clusql:

> clusql <server:port list> system+<dbpassword specified at database create>
SQL: set autocommit on;
SQL: set schema haschema;
SQL: alter table sessionattribute nodegroup all_nodes;
SQL: alter table singlesignon nodegroup all_nodes;
SQL: alter table statefulsessionbean nodegroup all_nodes;
SQL: alter table sessionheader nodegroup all_nodes;
SQL: alter table blobsessions nodegroup all_nodes;
SQL: quit;

Instalaci�n

Este apartado describe problemas conocidos relacionados con la instalaci�n, junto con las soluciones pertinentes.

Fallo ocasional para visualizar el bot�n de desplazamiento “Siguiente” en las pantallas de bienvenida del instalador y el desinstalador. Este problema s�lo afecta a la Versi�n independiente del producto. (ID 4977191)

Se nos ha comunicado que este problema ocurre a veces en la plataforma Solaris x86, pero es posible que tambi�n afecte a las plataformas Solaris SPARC y Linux.

El problema consiste en que la primera pantalla del instalador o del desinstalador muestra correctamente el texto de los botones “Ayuda” y “Cancelar”, pero el bot�n “Siguiente”, que es imprescindible para acceder a la p�gina siguiente, no est� visible. Aunque el bot�n no est� visible, su �rea est� activa y si hace clic en ella, el desplazamiento a la pantalla siguiente se realizar� normalmente. Este hecho est� provocado por un problema ocasional con los colores pintados en la GUI de J2SE.

Soluci�n

Una soluci�n consiste en hacer clic en el �rea del bot�n “Siguiente”, que est� justo a la izquierda del bot�n “Ayuda”. Otra soluci�n es forzar los colores pintados en la pantalla, para ello debe cambiar levemente el tama�o de la ventana o minimizarla y volver a restaurarla. As�, todos los colores se volver�n a pintar y el bot�n “Siguiente” pasar� a estar disponible.

Al cerrar la instalaci�n, algunos sistemas Linux se quedan bloqueados tras hacer clic en el bot�n “Finalizar”. (5009728)

Se ha observado que este problema se ha producido en varios sistemas Linux. Es m�s habitual en Java Desktop System 2, pero tambi�n se ha registrado en distribuciones RedHat.

Despu�s de hacer clic en el bot�n “Finalizar” en la �ltima pantalla, el instalador no consigue iniciar una ventana del explorador que contiene la p�gina con informaci�n acerca del producto o la p�gina de registro. El instalador se bloquea completamente y no permite volver a la l�nea de comandos.

Soluci�n

Salga del instalador pulsando Ctrl+C en la ventana de terminal en la que se inici� el instalador. Despu�s de hacer esto, es posible que se muestre una ventana del explorador que contiene informaci�n acerca del producto o la pantalla de registro, de lo contrario, inicie el navegador y escriba la siguiente direcci�n URL para ver la informaci�n acerca del producto:

file://dir_instalaci�n/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.

Problemas intermitentes relacionados con la secuencia de arranque y la detecci�n J2SE en el empaquetador de instalaci�n en Linux. (6172980)

El ejecutable setup que inicia el instalador de Linux se bloquea a veces. En lugar de averiguar la ubicaci�n de J2SE e iniciar el asistente de instalaci�n, el empaquetador se bloquea y devuelve los siguientes mensajes:

Checking available disk space....
Checking Java(TM) 2 Runtime Environment....
Extracting Java(TM) 2 Runtime Environment....
Deleting temporary files.....

Este problema se ha producido s�lo en algunas versiones de Linux y parece que depende de la configuraci�n del entorno, especialmente de la presencia de la variable JAVA_HOME.

Soluci�n

Para solucionar este problema:

Anule la configuraci�n de la variable JAVA_HOME ejecutando el comando unset o unsetenv, en funci�n del int�rprete de comandos de que disponga.
Ejecute setup con la opci�n -javahome para especificar el JAVA_HOME que usa el instalador.

Es necesario crear el directorio imq durante la instalaci�n (s�lo Windows). (ID 6199697)

Justo despu�s de instalar Application Server EE en Windows, el agente IMQ falla en el inicio y muestra un mensaje que indica que el directorio unidad:\asomainsomain1\imq no existe.

Tenga en cuenta que si el agente se inicia despu�s de iniciar domain1, Application Server crear� el directorio y no habr� ning�n problema.

Soluci�n

Cree el ubicaci�n_dir_var_home antes de crear el agente:

$imqbrokerd -varhome ubicaci�n_dir_var_home

Por ejemplo:

$imqbrokerd -varhome D:\asomainsomain1\imq

Tutorial de J2EE

Para ejecutar el tutorial de J2EE 1.4 en Sun Java System Application Server Enterprise Edition 8.1 2005Q1, lleve a cabo estas tareas:

Cuando edite el archivo examples/common/build.properties, tal y como se describe en el apartado “About the Examples” del cap�tulo “About this Tutorial”, cambie el puerto 4848 por 4849.
Cuando use Deploytool, agregue el servidor localhost:4849 antes de implementar un ejemplo.
Cuando utilice la consola de administraci�n para crear un recurso, use la ficha “Destinos” para especificar que el servidor es el destino. Si utiliza la l�nea de comandos o un destino asant, el servidor es el destino predeterminado y no es necesario hacer nada m�s.

Gesti�n del ciclo de vida

Este apartado describe problemas conocidos relacionados con la gesti�n del ciclo de vida, junto con las soluciones pertinentes.

Despu�s de configurar la propiedad ejb-timer-service minimum-delivery-interval en 9000, cualquier intento por definir la propiedad ejb-timer-service redelivery-interval-in-mills en 7000 provoca que el comando set falle y muestre el siguiente error: (ID 6193449)

[echo] Doing admin task set
[exec] [Attribute(id=redelivery-interval-internal-in-millis) : Redelivery-Interval (7,000) should be greater than or equal to Minimum-delivery-interval-in-millis (9,000)]
[exec] CLI137 Command set failed.

minimum-delivery-interval es el intervalo m�nimo de duraci�n entre las entregas del mismo temporizador peri�dico.
redelivery-interval-in-mills es el tiempo que debe esperar el servicio del temporizador para volver a intentar la entrega despu�s de que se haya producido un fallo en ejbTimeout.

El problema es que la l�gica que relaciona la propiedad de intervalo de reentrega con la propiedad de entrega m�nima es incorrecta e impide que se utilice la GUI o la CLI para definir valores en los que el intervalo de entrega m�nimo sea superior al intervalo de reentrega.

El valor de minimum-delivery-interval-in-millis debe ser siempre igual o superior al de la propiedad ejb-timer-service redelivery-interval-in-millis. El problema es que hay una comprobaci�n de validaci�n err�nea en Application Server para comprobar que el valor de redelivery-interval-in-millis es superior al valor de minimum-delivery-interval-in-millis.

Soluci�n

Use los valores predeterminados para estas propiedades, tal y como se indica a continuaci�n:

minimum-delivery-interval(default)=7000
redelivery-interval-in-millis(default)=5000

Si utiliza valores que no sean los predeterminados, se generar� un error.

Registro

Este apartado describe problemas conocidos relacionados con el registro, junto con las soluciones pertinentes.

La configuraci�n de sentencias de depuraci�n para access,failure provoca que Application Server se bloquee al inicio. (ID 6180095)

Si configura la opci�n java.security.debug para la JVM, la instancia del servidor se bloquear� irreversiblemente al iniciarse; por ejemplo, si configura domain.xml, se generar� este problema:

<jvm-options>-Djava.security.debug=access,failure</jvm-options>

Soluci�n

Ninguna por ahora. Evite configurar este indicador.

Message Queue

Este apartado describe problemas conocidos relacionados con Java Message Queue, junto con las soluciones pertinentes.

Las reconexiones de JMS no se completan correctamente en ciertos casos que dependen de temporizadores. (ID 6173308, 6189645, 6208728, 6198481, 6199510 y 6199510)

Los fallos de reconexi�n en situaciones que dependen de temporizadores pueden estar causados por varios problemas. En general, sin embargo, podr� solucionarlos todos ellos de la siguiente forma:

Reinicie los agentes involucrados
Reinicie las instancias de Application Server involucradas

El comportamiento de las escuchas de mensajes as�ncronos ha cambiado en appclient de la versi�n 8.0 a la 8.1 (ID 6198465)

Debido a un cambio reciente, cuando una escucha de mensaje as�ncrono es el �nico subproceso activo en el contenedor app-client, el resto de la m�quina virtual (VM) appclient existe en forma de daemon. Esta conducta supone un regreso a las funciones de las aplicaciones antiguas que realizan recepciones as�ncronas en ACC. Este problema afecta a los clientes de aplicaciones que definen escuchas de mensajes JMS y salen del subproceso principal.

Soluci�n

No salga del subproceso principal. Espere a que la escucha del mensaje informe al subproceso principal antes de detenerlo.

El registro del agente de mensajes contiene mensajes acerca de la imposibilidad de realizar entregas. (ID 6204180)

Si est� trabajando en un entorno de cl�steres y un agente tiene poca memoria, es posible que se muestren los siguientes mensajes de error en el registro del agente:

Internal error, unable to deliver .....: java.lang.NullPointerException

Con consumidores duraderos, aunque un consumidor confirme el mensaje, �ste se reenviar� a todos los consumidores posteriormente (con el indicador de reentrega).

Este error se produce porque los datos que todav�a necesitaba el sistema se liberaron incorrectamente cuando la memoria del sistema se restringi�. Este error s�lo ocurre con mensajes que se env�an a los consumidores como adjuntos a este agente, pero que se propagaron a un agente diferente en el cl�ster.

Soluci�n

Aumente el tama�o del mont�n de Java para los procesos del agente de mensajes (-Xmx) para evitar que el sistema se quede sin memoria.

Un agente que se ejecuta en un cl�ster se queda sin memoria despu�s de llevar a cabo un reinicio tras un fallo. (ID 6205463)

Un agente de mensajes que se ejecuta como parte de un cl�ster se queda sin memoria despu�s de reiniciarse. Hay dos causas diferentes que pueden originar este problema. Para determinar si est� provocado por una u otra causa, examine los archivos de registro de Application Servers y Message Brokers en el cl�ster:

Si el archivo de registro de Application Server incluye mensajes de advertencia con el formato:

MQRA:OMR:Endpoint Unavailable:Marking OMR as invalid-omrId=1 for:ActvationSpec configuration ...

significa que el problema de la memoria est� ocasionado por el proceso que se describe en Las reconexiones de JMS no se completan correctamente en ciertos casos que dependen de temporizadores. (ID 6173308, 6189645, 6208728, 6198481, 6199510 y 6199510).

Si uno o varios de los archivos de registro de agente de los dem�s agentes del cl�ster muestran mensajes con el formato:

ERROR Internal Error: received ack twice on ...

significa que el problema de la memoria est� ocasionado por el proceso que se describe en Reconstrucci�n de la memoria en el agente de mensajes cuando el cl�ster se reinicia tras un fallo. (ID 6208621).

Soluci�n

Consulte las soluciones descritas para los problemas 6208621 o 6208728 (en funci�n de qu� origina el problema).

Reconstrucci�n de la memoria en el agente de mensajes cuando el cl�ster se reinicia tras un fallo. (ID 6208621)

Cuando un agente de mensajes de un cl�ster se reinicia tras un fallo, la memoria se puede reconstruir en el agente porque el estado de los MDB no duraderos en un destino de tema no se propaga correctamente.

Despu�s de que se inicie un agente de mensaje como parte de un cl�ster activo, se observan excepciones en los registros del servidor de aplicaciones y en los del agente. Con el tiempo, el agente reiniciado se ir� quedando sin memoria. En estos casos, uno o varios de los registros de los servidores de aplicaciones del cl�ster generar�n un mensaje de advertencia similar al siguiente despu�s de reiniciar el agente:

[#|2004-12-03T17:45:12.821-0800|WARNING|sun-appserver-ee8.1|javax.enterprise.system.stream .err|_ThreadID=12;|com.sun.messaging.jms.JMSException: [C4000]: Packet acknowledge failed. user=admin, broker=<brokername>....

Otro mensaje suele aparecer en los registros del agente de mensajes. Tiene el siguiente formato:

ERROR Internal Error: received ack twice on ...

El problema es que cuando un agente de mensajes se conecta a un cl�ster activo, la informaci�n acerca de todos los consumidores activos es reenviada por los dem�s agentes del cl�ster. Si los MDB no tienen suscriptores duraderos en uno de los agentes remotos, es posible que se env�e informaci�n incorrecta cada vez que se reenv�a informaci�n sobre consumidores. Cuando dicha informaci�n no v�lida la recibe el agente reiniciado, �ste redirigir� incorrectamente copias adicionales de los mensajes al otro agente.

Cuando esto ocurre, el consumidor remoto observar� el siguiente mensaje de error “[C4000]: Packet acknowledge failed” en el registro de ApplicationServer y un error “double ack” en el registro de agente remoto. Cada vez que se env�a un mensaje “double ack” al registro del agente, el agente que emite el mensaje no lo confirmar� correctamente. Con el paso del tiempo, el agente que emite el mensaje se ir� quedando sin memoria.

Soluci�n

Si el problema se est� produciendo actualmente, se puede anular la implementaci�n de los MDB y volver a implementarlos de nuevo en el sistema para limpiar la informaci�n interna. Para evitar que este problema afecte al agente durante el funcionamiento normal:

Si el rendimiento no es un problema, cambie los MDB para que utilicen suscriptores duraderos (en lugar de no duraderos).
Si el rendimiento s� es un problema, configure el sistema para que los mensajes de p�rdidas de memoria se limpien en caso de que no se reciba una confirmaci�n durante un per�odo de tiempo. Para ello:
Establezca un l�mite de conducta (limitBehavior) de REMOVE_OLDEST y un l�mite de mensajes en el destino usado por los MDB:

imqcmd update dst -n <dest name> -t t -o limitBehavior=REMOVE_OLDEST -o maxNumMsgs=<some limit>

Cambie el ajuste “time to live” en los mensajes que se propagan en el tema.

Supervisi�n

Este apartado describe problemas conocidos relacionados con la supervisi�n, junto con las soluciones pertinentes.

Algunas de las estad�sticas de supervisi�n del servicio HTTP no presentan informaci�n �til y es mejor hacer caso omiso de ellas. (ID 6174518)

A la hora de visualizar estad�sticas de supervisi�n de algunos elementos del servicio HTTP, algunos valores presentados no se corresponden con los valores reales o se muestran siempre como 0. Espec�ficamente, las siguientes estad�sticas del servicio HTTP no presentan informaci�n aplicable a Application Server 8.1 y es mejor hacer caso omiso de ellas:

http-service
load1MinuteAverage
load5MinuteAverage
load15MinuteAverage
rateBytesTransmitted
rateBytesReceived
pwc-thread-pool (el elemento)

Soluci�n

Estas funciones de supervisi�n se eliminar�n en versiones futuras y se sustituir�n por informaci�n m�s adecuada.

No se ha eliminado la supervisi�n mbean para un m�dulo EJB, a pesar de que todas las estad�sticas relacionadas con este nombre de supervisi�n se han movido. (ID 6191092)

Por ejemplo:

EJBModuleMonitorMap().size() = 1 eventhough ejb module is undeployed EJBModuleMonitor().getName() = sqe_ejb_s1_01

Este hecho es verdadero para aplicaciones y m�dulos EJB. Desde el punto de vista de la programaci�n (mediante MBeanAPI) y mediante asadmin list/get, sigue existiendo todav�a un mbean de supervisi�n vac�o.

Diagn�stico

asadmin list -m "server.applications" muestra el siguiente resultado:

server.applications.MEjbApp
server.applications.__ejb_container_timer_app
server.applications.adminapp
server.applications.admingui
server.applications.com_sun_web_ui
server.applications._export_install_nov-11_domains_domain1_applications_j2ee-modules_sqe_e jb_s1_01

Puede consultar las estad�sticas:

bin/asadmin list -m "server.applications._expo
rt_install_nov-11_domains_domain1_applications_j2ee-modules_sqe_ejb_s1_01"
server.applications._export_install_nov-11_domains_domain1_applications_j2ee-mod
ules_sqe_ejb_s1_01.SQEMessage
server.applications._export_install_nov-11_domains_domain1_applications_j2ee-mod
ules_sqe_ejb_s1_01.TheGreeter

Una vez que anule la implementaci�n:

_export_install_nov-11_domains_domain1_applications_j2ee-modules_sqe_ejb_s1_01

Si ejecuta un comando de enumeraci�n, seguir� viendo la aplicaci�n:

asadmin list -m "server.applications"
server.applications.MEjbApp
server.applications.__ejb_container_timer_app
server.applications._export_install_nov-11_domains_domain1_applications_j2ee-mod
ules_sqe_ejb_s1_01
server.applications.adminapp
server.applications.admingui
server.applications.com_sun_web_ui

pero no contiene estad�sticas de supervisi�n:

asadmin list -m "server.applications._expo
rt_install_nov-11_domains_domain1_applications_j2ee-modules_sqe_ejb_s1_01"
Nothing to list at server.applications.-export-install-nov-11-domains-domain1-ap
plications-j2ee-modules-sqe-ejb-s1-01.

Para obtener los nombres v�lidos que comiencen por una cadena, utilice el car�cter comod�n, (‘*’). Por ejemplo, para enumerar los nombres de todas las entidades que se pueden supervisar que comiencen por server, use list "server.*”.

Soluci�n

Es un problema inocuo. El m�dulo se puede volver a implementar con seguridad sin que se produzcan problemas. La supervisi�n ra�z Mbean no se elimina, sino que se queda vac�a.

PointBase

Este apartado describe problemas conocidos relacionados con PointBase, junto con las soluciones pertinentes.

La definici�n de los niveles de aislamiento en un conjunto de conexiones para una aplicaci�n genera excepciones en PointBase. (ID 6184797)

En un conjunto de conexiones JDBC que hace referencia a una instalaci�n de base de datos PointBase, si define el atributo de conjunto transaction-isolation-level en cualquier valor que no sea el predeterminado (Connection.TRANSACTION_READ_COMMITTED), se generar� una excepci�n. Sin embargo, si establece este mismo par�metro en un valor que no sea el predeterminado para los conjuntos que hacen referencia a otras bases de datos, no se producir� ninguna excepci�n.

Soluci�n

En el caso de los conjuntos de conexiones JDBC que hacen referencia a una instalaci�n de base de datos PointBase, no intente configurar la opci�n transaction-isolation-level.

PointBase desencadena una excepci�n si se usan juntos un controlador de servidor de red y un controlador integrado. (ID 6204925)

La base de datos PointBase integrada desencadena una excepci�n si se usan a la vez un controlador de servidor de red y uno integrado.

Soluci�n

Use el controlador integrado o uno de red, pero no los dos juntos.

Ejemplos

Este apartado describe problemas conocidos relacionados con el c�digo de ejemplo incluido en el producto Application Server 8.1.

setup-one-machine-cluster se bloquea en Windows, pero funciona en Solaris; mqfailover requiere que se pulse Ctrl+C para cancelar y despu�s hay que volver a ejecutarlo. (ID 6195092)

Para solucionar el error, consulte dir_instalaci�n\samples\ee-samples\failover\apps\mqfailover\docs\index.html y, a continuaci�n, ejecute los siguientes comandos:

Consola 1

cd dir_instalaci�n\samples\ee-samples asant start-mq-master-broker1

Consola 2

cd dir_instalaci�n\samples\ee-samples asant start-mq-cluster-broker1

Consola 3

cd dir_instalaci�n\samples\ee-samples asant start-mq-cluster-broker2

Consola 4

cd dir_instalaci�n\samples\ee-samples asadmin start-domain domain1

Si ya ha ejecutado asant setup-one-machine-cluster-without-ha o asant setup-one-machine-cluster-with-ha para otro ejemplo EE, entonces, ejecute asant configure-mq o bien asant setup-one-machine-cluster-and-configure-mq. En este caso, el comando parece que se ejecuta correctamente:

start_nodeagent: [echo] Start the node agent cluster1-nodeagent [exec] Command start-node-agent executed successfully.

Pero el sistema se bloquea definitivamente.

Soluci�n

Ninguna por ahora. Este problema afecta tambi�n a todos los ejemplos EE que usan este destino en Windows. Una soluci�n consiste en usar Ctrl+C en el proceso de bloqueo y volver a ejecutarlo.

La documentaci�n no indica expl�citamente que sea necesario crear recursos JMS antes de ejecutar MQ Failover Sample Application siguiendo las instrucciones de asadmin deploy. (ID 6198003)

El error que se produce es el siguiente:

/opt/SUNWappserver/domains/domain1/config/sun-acc.xml -name MQFailoverTestClient -textauth -user j2ee -password j2ee
Nov 18, 2004 10:50:17 PM com.sun.enterprise.naming.NamingManagerImpl bindObjects
SEVERE: NAM0006: JMS Destination object not found: jms/durable/TopicA
Nov 18, 2004 10:50:18 PM com.sun.enterprise.naming.NamingManagerImpl bindObjects
SEVERE: javax.naming.NameNotFoundException
javax.naming.NameNotFoundException

La documentaci�n no indica expl�citamente que los recursos JMS se deben crear manualmente si se lleva a cabo una implementaci�n manual usando comandos asadmin deploy y que hay que usar los destinos Ant especificados para implementar la aplicaci�n de ejemplo.

Soluci�n

Use el destino asant deploy para la secuencia de comandos build.xml, lo que crea los recursos JMS necesarios para ejecutar la aplicaci�n.

Error de tiempo de ejecuci�n durante la creaci�n de certificados en ejemplos de seguridad y servicios en Linux. (ID 6198239)

Cuando se implementa el ejemplo dir_instalaci�n/samples/webservices/security (basicSSl) en Linux, el certificado no se crea y se muestra un error similar al siguiente:

generate_certs: [echo] ***Exporting certificate from NSS database [exec] Result: 1 [echo] ***Generating Java Keystore from generated certificate [exec] keytool error: java.lang.Exception: Input not an X.509 certificate [exec] Result: 1 [echo] ***Generating Java trust store from generated certificate [exec] keytool error: java.lang.Exception: Input not an X.509 certificate [exec] Result: 1
.
.
.
generate_certs: [echo] ***Exporting server certificate from NSS database to a PKCS12 certificate file [exec] /opt/sun/appserver/lib/pk12util: /usr/lib/libnss3.so: version `NSS_3.9' not found (required by /opt/sun/appserver/lib/pk12util) [exec] /opt/sun/appserver/lib/pk12util: /usr/lib/libnss3.so: version `NSS_3.6' not found (required by /opt/sun/appserver/lib/pk12util) [exec] /opt/sun/appserver/lib/pk12util: /usr/lib/libnss3.so: version `NSS_3.7' not found (required by /opt/sun/appserver/lib/pk12util) [exec] Result: 1

El problema consiste en que las bibliotecas NSS, en las instalaciones Linux, est�n en ubicaciones distintas de las que tienen en las instalaciones Solaris. Debe asegurarse de que LD_LIBRARY_PATH hace referencia a las bibliotecas NSS adecuadas a la hora de realizar la implementaci�n en Linux. Defina LD_LIBRARY_PATH en su entorno o bien ajuste la secuencia de comandos del empaquetador del int�rprete de comandos dir_instalaci�n/bin/asant.

Soluci�n

Lleve a cabo una de las siguientes acciones:

Defina LD_LIBRARY_PATH=/opt/sun/private/lib.
Agregue la siguiente l�nea a la secuencia de comandos dir_instalaci�n/bin/asant:

LD_LIBRARY_PATH=$AS_NSS:$LD_LIBRARY_PATH;export LD_LIBRARY_PATH

La documentaci�n del comando - ee samples asadmin deploy omite la opci�n availabilityenabled=true para implementar la aplicaci�n, lo que garantiza que las aplicaciones de ejemplo est�n habilitadas para HADB de forma predeterminada. (ID 6198796)

Soluci�n

Usando el comando asadmin:

Acceda a la ra�z del directorio de ejemplo, como pudiera ser:

cd dir_instalaci�n/samples/ee-samples/failover/apps/dukesbookstore

Ejecute asadmin deploy para implementar la aplicaci�n en la instancia local de Application Server, por ejemplo:

dir_instalaci�n/bin/asadmin deploy -user usuarioadmin -password contrase�aadmin --host hostDAS --port puerto_DAS --availabilityenabled=true --target nombre_cl�ster dukesbookstore.ear

Haga lo mismo para los comandos asadmin deploy para todos los dem�s ejemplos EE, con excepci�n de dir_instalaci�n/samples/ee-samples/failover/apps/mqfailover. Tenga en cuenta que MQ no usa HADB.

No se pueden realizar pruebas de failover con la secuencia de comandos asant para el ejemplo EE dukesbookstore. (ID 6199076)

Despu�s de definir un cl�ster compuesto por dos equipos, el ejemplo dukesbookstore failover detecta errores. La idea aqu� es tener una base de datos por cl�ster. Actualmente, cuando se implementa un ejemplo desde DAS en un cl�ster con instancias que se ejecuten en dos equipos separados, las secuencias de comandos usan el host PointBase como localhost. Cuando se implementa un ejemplo EE, los recursos JDBC se implementan con el host PointBase como localhost en las dos instancias. En consecuencia, localhost:9092 en ambas instancias espera que PointBase se est� ejecutando en las dos m�quinas.

El problema es que dos instancias que pertenecen a un cl�ster no pueden usar bases de datos diferentes. Para solucionar este problema, si sustituye localhost en database.properties por un nombre de host, ambas instancias del cl�ster tendr�n acceso a la base de datos: una, mediante localhost y la otra, a trav�s del nombre de host que especifique.

Soluci�n

Edite el archivo dir_instalaci�n/samples/database.properties en el host en el que se est� ejecutando el servidor PointBase y establezca el valor para pointbase.server en el nombre de host en el que se est� ejecutando PointBase en lugar de especificar el localhost.

La configuraci�n actual, es decir, pointbase.server=localhost, funciona en un cl�ster de una m�quina, pero no en un cl�ster de dos m�quinas en las que PointBase puede que no se ejecute en localhost para la segunda instancia.

La aplicaci�n de ejemplo MQ-failover tiene el nombre de cl�ster codificado como “cluster1” en uno de los destinos configurados como Ant. (ID 6202363)

La aplicaci�n de ejemplo MQ-failover tiene el nombre de cl�ster (cluster1) codificado en un destino configurado como Ant. En consecuencia, si cambia cluster-name en cluster.properties en ee-samples de cluster1 a un nombre diferente, el ejemplo fallar� cuando intente establecer el host predeterminado en cluster1:

set-default-jms-host-to-broker1:
[echo] Setting default JMS host to samplesbroker1
[exec] No object matches the specified name "cluster1-config.jms-service.default-jms-host"
[exec] CLI137 Command set failed.

El archivo dir_instalaci�n/samples/ee-samples/build.xml codifica la referencia a cluster1, cuando lo que deber�a hacer es usar ${cluster.name} desde dir_instalaci�n/samples/ee-samples/cluster.properties.

Soluci�n

La cadena codificada cluster1 debe usar ${cluster.name} en su lugar. Modifique manualmente dir_instalaci�n/samples/ee-samples/build.xml para cambiar set-default-jms-host-to-broker1 de cluster1 a ${cluster.name} o el nombre de cl�ster customer especificado en cluster.properties.

Seguridad

Este apartado describe problemas conocidos relacionados con los certificados, la seguridad de las aplicaciones Web y Application Server, junto con las soluciones pertinentes.

La especificaci�n de un mensaje de destino mediante java-method no funciona en elementos client-side message-security-binding. (ID 6155080)

Este problema se produce, por ejemplo, cuando un mensaje de destino en un elemento client-side message-security-binding se especifica mediante java-method en un elemento port-info dentro de un elemento service-ref:

<!ELEMENT service-ref ( service-ref-name, port-info*, call-property*, wsdl-override?, service-impl-class?, service-qname? )>
<!ELEMENT port-info ( service-endpoint-interface?, wsdl-port?, stub-property*, call-property*, message-security-binding? )>
<!ELEMENT message-security-binding ( message-security* )>
<!ELEMENT message-security ( message+, request-protection?, response-protection? )>
<!ELEMENT message ( java-method? | operation-name? )>

El elemento message-security-binding se utiliza aqu� para definir las pol�ticas de protecci�n de mensajes para m�todos espec�ficos de un punto final de servicio Web.

Soluci�n

Use un elemento operation-name dentro del elemento message para identificar mediante el nombre de operaci�n WSDL el mensaje al que se aplican las pol�ticas de protecci�n definidas en el elemento message-security.

“Se produce la excepci�n CertificateNotYetVAlidException” si los relojes de las m�quinas de DAS y del agente de nodo remoto no est�n sincronizados. (ID 6181989)

En los casos en los que el servidor DAS y los agentes del nodo est�n instalados en m�quinas diferentes y los relojes de dichas m�quinas no est�n sincronizados, si intenta ejecutar el comando asadmin --start remote-node-agent, se producir� un fallo y se mostrar� el error CertificateNotYetVAlidException.

Soluci�n

Sincronice los relojes de las m�quinas del servidor DAS y del agente del nodo remoto.

No se pueden ejecutar aplicaciones WebServiceSecurity en EE con J2SE 5.0. (ID 6183318)

Las aplicaciones WebServiceSecurity no se pueden ejecutar con J2SE 5.0 por las siguientes razones:

J2SE 5.0 PKCS11 no es compatible con el modo UNWRAP
J2SE 5.0 PKCS11 no es compatible con RSA/ECB/OAEPWithSHA1AndMGF1Padding con PKCS11

El equipo de J2SE ha indicado acerca de este error que se agregue compatibilidad para los mecanismos de empaquetado y desempaquetado RSA-PKCS1 y RSA-OAEP (CR 6190389).

Soluci�n

Use J2SE 1.4.2 con cualquier otro proveedor JCE (no el que se incluye de forma predeterminada). Tenga en cuenta que la compatibilidad con el acelerador de hardware no est� presente en esta configuraci�n.

La comunicaci�n SSL con MQ no funciona si mq-scheme y mq-service est�n definidos en jms-servicSSL; la comunicaci�n con MQ no funciona si mq-scheme y mq-service est�n definidos en jms-service. (ID 6202606)

La informaci�n usada no definida en el adaptador de recursos la utilizan las f�bricas de conexi�n creadas a partir de �l. Por lo tanto, las f�bricas de conexi�n creadas de esta forma no tendr�n informaci�n SSL.

Soluci�n

Si necesita usar una comunicaci�n SSL entre Application Server y MQ, cree la f�brica de conexi�n indicando expl�citamente el valor de addresslist con sintaxis SSL. Por ejemplo, addresslist en la f�brica de conexi�n podr�a ser:

mq://mqserver-1:7676/ssljms,mq://mqserver-2:7676/ssljms

La comunicaci�n SSL entre Application Server y MQ puede ser necesaria cuando MQ y Application Server est�n en ubicaciones diferentes y la conectividad de red entre ellas puede verse afectada por un intruso.

Las URL para escuchas https que se especifican sin n�mero de puerto se redirigen a la escucha http en el puerto 80. (ID 6207297)

Cuando se habilita una escucha SSL en el puerto predeterminado (443), si se especifica una URL en un explorador para dicho puerto seguro sin indicar el n�mero de puerto, el explorador redirigir� la acci�n al puerto 80 en una escucha no segura (http).

Por ejemplo:

Cree una escucha SSL en el puerto 443 y reinicie Application Server.
Escriba en el explorador https://nombreservidor:443.

De esta forma, la p�gina se cargar� correctamente.

Escriba en el explorador https://nombreservidor (sin n�mero de puerto).

El explorador carga http://nombreservidor:80 en lugar de https://nombreservidor.

Este problema no se produce cuando la escucha SSL se realiza mediante un puerto que no es el predeterminado (443).

Soluci�n

Opte por una de estas soluciones:

Notifique este hecho a los usuarios que visiten los sitios y codifique todos los v�nculos para que se especifique siempre el n�mero de puerto a la hora de acceder a las escuchas SSL en el puerto https 443.
No utilice el puerto 443 para ninguna escucha SSL.

Utilidad de actualizaci�n

Este apartado describe problemas conocidos relacionados con la utilidad de actualizaci�n, junto con las soluciones pertinentes.

Los dominios creados en rutas personalizadas distintas del directorio dir_instalaci�n/domains no se actualizan directamente cuando se lleva a cabo el proceso para actualizar de Application Server Enterprise Edition 8 a Application Server Enterprise Edition 8.1. (ID 6165528)

Al ejecutar la utilidad de actualizaci�n e identificar dir_instalaci�n como el directorio de instalaci�n de origen, el proceso de actualizaci�n actualiza s�lo los dominios creados en el directorio dir_instalaci�n/domains. Los dominios creados en otras ubicaciones no se actualizan.

Soluci�n

Antes de iniciar el proceso de actualizaci�n, copie todos los directorios del dominio desde sus ubicaciones en el directorio dir_instalaci�n/domains.

Durante la actualizaci�n de J2EE 1.4 SDK a Application Server EE 8.1, la instalaci�n J2SE integrada no se actualiza correctamente. Este problema s�lo afecta a la Versi�n independiente del producto. (ID 6196741)

El problema se produce durante la actualizaci�n de J2EE 1.4 SDK a la instalaci�n independiente de Application Server 8.1. En el transcurso de esta actualizaci�n, hay que actualizar el J2SE 1.4.2 integrado a J2SE 5.0. Sin embargo, algunos archivos JAR de la instalaci�n J2SE 5.0 resultante se actualizan de forma incorrecta, lo que da como resultado una instalaci�n J2SE 5.0 corrupta.

El instalador indica que la actualizaci�n ha sido correcta, por lo que no se deber�a producir ning�n problema al ejecutar la herramienta de actualizaci�n durante el proceso de actualizaci�n. Sin embargo, si intenta posteriormente iniciar la versi�n actualizada de Application Server se producir� la siguiente excepci�n:

Exception in thread "main" [#|2004-11-17T18:12:24.033-0800|WARNING|sun-appserver-ee8.1|javax.enterprise.system.stream .err|_ThreadID=10;|java.lang.NoClassDefFoundError: javax/net/ssl/TrustManager at com.sun.enterprise.security.SecurityLifecycle.onInitialization(SecurityLifecycle.java:59) at com.sun.enterprise.server.ApplicationServer.onInitialization(ApplicationServer.java:215) at com.sun.enterprise.server.PEMain.run(PEMain.java:277) at com.sun.enterprise.server.PEMain.main(PEMain.java:219)

Soluci�n

Hay varias soluciones para este problema:

Instale un J2SE independiente de la versi�n adecuada. Durante la actualizaci�n de Application Server, elija la opci�n que permite reutilizar la versi�n existente de Java 2 SDK en la pantalla de configuraci�n de Java del instalador de Application Server, en lugar de elegir la opci�n predeterminada, que consiste en instalar Java 2 SDK 5.0. Proporciona la ruta a la instalaci�n independiente de J2SE.
Antes de ejecutar la actualizaci�n, elimine el subdirectorio existente J2EE 1.4 SDK dir_instalaci�n/jdk o c�mbiele el nombre. J2SE 5.0 se instalar� entonces correctamente durante el proceso de actualizaci�n de Application Server 8.1. Tenga en cuenta que debe eliminar este directorio (o cambiarle el nombre) s�lo despu�s de que se haya desplazado por la pantalla de selecci�n de directorio del instalador y de que se le haya preguntado si desea efectuar una actualizaci�n “in situ” de la instalaci�n existente.
Si la actualizaci�n se ha efectuado ya y ha detectado alg�n problema en el inicio del servidor, instale una versi�n independiente adecuada de J2SE y, a continuaci�n, modifique la variable AS_JAVA del archivo dir_instalaci�n/config/asenv.conf (Linux y Solaris) o del archivo dir_instalaci�n\config\asenv.bat (Windows). El valor de esta variable debe hacer referencia a la ubicaci�n de la nueva instalaci�n J2SE independiente.

El instalador que lleva a cabo la instalaci�n “in situ” falla al iniciar la herramienta de actualizaci�n en algunos sistemas Linux despu�s de hacer clic en el bot�n que permite iniciar el asistente de actualizaci�n. (6207337)

Este problema se ha detectado en varios sistemas Linux. Es m�s frecuente en Java Desktop System 2, pero tambi�n se ha producido en distribuciones RedHat.

Despu�s de hacer clic en el bot�n que permite iniciar la actualizaci�n en la pantalla final del instalador, �ste no logra iniciar la herramienta de actualizaci�n para completar el proceso y se bloquea de forma indefinida, por lo que no consigue volver a la l�nea de comandos.

Soluci�n

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:

dir_instalaci�n/bin/asupgrade --source dir_instalaci�n/domains --target dir_instalaci�n --adminuser usuarioadmin
--adminpassword contrase�aadmin --masterpassword changeit

usuarioadmin y contrase�aadmin 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://dir_instalaci�n/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.

Contenedor Web

Este apartado describe problemas conocidos relacionados con el contenedor Web, junto con las soluciones pertinentes.

Si implementa una aplicaci�n usando --precompilejsp=true, es posible que los archivos JAR se bloqueen, lo que provocar� fallos si en el futuro desea volver a implementar o anular la implementaci�n. (S�lo Windows) (ID 5004315)

Si solicita una precompilaci�n de JSP cuando implemente una aplicaci�n en Windows, los intentos posteriores para anular la implementaci�n de dicha aplicaci�n o para volver a implementarla (o cualquier aplicaci�n con el mismo ID de m�dulo) no se llevar�n a cabo correctamente. El problema es que la precompilaci�n JSP abre los archivos JAR en las aplicaciones, pero no los cierra y Windows impide la anulaci�n de la implementaci�n porque no puede eliminar estos archivos e impide su reimplementaci�n porque no puede sobrescribirlos.

Tenga en cuenta que la anulaci�n de la implementaci�n se realiza correctamente hasta el punto de que la aplicaci�n se elimina l�gicamente de Application Server. Tenga en cuenta tambi�n que la utilidad asadmin no muestra ning�n mensaje de error, a pesar de que los archivos jar bloqueados y el directorio de la aplicaci�n siguen estando en el servidor. El archivo de registro del servidor contiene mensajes en los que se indica que no se han podido eliminar los archivos ni el directorio de la aplicaci�n.

Fallar� cualquier intento que se efect�e para reimplementar la aplicaci�n despu�s de anular su implementaci�n porque el servidor intenta eliminar el directorio y los archivos existentes. Esto puede suceder si intenta implementar una aplicaci�n que utilice el mismo ID de m�dulo que la aplicaci�n que se implement� originalmente porque el servidor utiliza dicho ID de m�dulo cuando elige el nombre del directorio para conservar los archivos de la aplicaci�n.

Si intenta reimplementar la aplicaci�n sin anular su implementaci�n primero, se producir�n fallos por las mismas razones.

Diagn�stico

Si intenta volver a implementar la aplicaci�n o implementarla despu�s de haber eliminado la implementaci�n, la utilidad asadmin devuelve un error semejante al siguiente.

An exception occurred while running the command. The exception message is: CLI171 Command deploy failed : Deploying application in domain failed; Cannot deploy. Module directory is locked and can't be deleted

Soluci�n

Si especifica --precompilejsps=false (la configuraci�n predeterminada), cuando implemente una aplicaci�n, este problema no se producir�. Tenga en cuenta que el primer uso que haga de la aplicaci�n desencadenar� la compilaci�n JSP, por lo que el tiempo de respuesta para la primera solicitud ser� superior al de las solicitudes posteriores.

Tenga en cuenta tambi�n que si realiza una precompilaci�n, deber� detener y reiniciar el servidor antes de anular la implementaci�n o de volver a implementar la aplicaci�n. Al cerrar la aplicaci�n, se liberan los archivos JAR bloqueados, por lo que la anulaci�n de la implementaci�n o la reimplementaci�n se producir�n correctamente despu�s del reinicio.

No se puede implementar WAR con web.xml basado en Servlet 2.4, que contiene un elemento vac�o <load-on-startup>. (ID 6172006)

La opci�n de cargar el elemento de servlet al inicio en web.xml indica que el servlet asociado se debe cargar e iniciar como parte del proceso de inicio de la aplicaci�n que lo declara.

El contenido opcional de este elemento es un entero que indica el orden en el que se debe cargar e iniciar el servlet con respecto a los dem�s servlets de la aplicaci�n Web. Si <load-on-startup> est� vac�o, indica que el orden no es relevante, siempre y cuando el servlet se cargue e inicie durante el inicio de la aplicaci�n Web que lo contiene.

Servlet 2.4 Schema para web.xml no admite ya que se deje vac�o <load-on-startup>, lo que significa que hay que especificar un n�mero entero cuando se utilice web.xml basado en Servlet 2.4. Si se deja vac�o <load-on-startup> como, por ejemplo, en <load-on-startup/>, web.xml generar� errores en la validaci�n de Servlet 2.4 Schema para web.xml, lo que har� que la implementaci�n de la aplicaci�n Web falle tambi�n.

Problema de compatibilidad restrospectiva. En el caso de web.xml basado en Servlet 2.3, s� se puede dejar vac�o <load-on-startup>.

Soluci�n

Especifique <load-on-startup>0</load-on-startup> cuando utilice web.xml basado en Servlet 2.4 para indicar que el orden de carga del servlet no es importante.

El uso de AMX API para eliminar una referencia a una aplicaci�n J2EE de un servidor elimina la aplicaci�n, pero �sta sigue estando accesible. (ID 6173248)

Cuando use AMX API para eliminar una referencia a una aplicaci�n sin detener expl�citamente la aplicaci�n da como resultado que la aplicaci�n sigue estando accesible. Esta conducta se debe al dise�o y se trata de una omisi�n de la documentaci�n.

Soluci�n

Para eliminar una aplicaci�n para que deje de estar accesible:

Detenga la aplicaci�n.
Elimine la referencia a la aplicaci�n.
Anule la implementaci�n de la aplicaci�n.

No se puede compilar la p�gina JSP en servidores con restricciones de recursos. (ID 6184122)

Se puede acceder a la p�gina JSP, pero se producen fallos al compilar y el registro del servidor contiene el mensaje de error “Unable to execute command” con este seguimiento de pila:

at org.apache.tools.ant.taskdefs.Execute$Java13CommandLauncher.exec(Execute.java:655) at org.apache.tools.ant.taskdefs.Execute.launch(Execute.java:416) at org.apache.tools.ant.taskdefs.Execute.execute(Execute.java:427) at org.apache.tools.ant.taskdefs.compilers.DefaultCompilerAdapter.executeExternalCompile(Defa ultCompilerAdapter.java:448) at org.apache.tools.ant.taskdefs.compilers.JavacExternal.execute(JavacExternal.java:81) at org.apache.tools.ant.taskdefs.Javac.compile(Javac.java:842) at org.apache.tools.ant.taskdefs.Javac.execute(Javac.java:682) at org.apache.jasper.compiler.Compiler.generateClass(Compiler.java:396)

Soluci�n

Defina el conmutador de compilaci�n “fork” de JSP en “false”.

Esta acci�n puede realizarse de dos formas:

De forma global, estableciendo el par�metro fork init para JspServlet de ${S1AS_HOME}/domains/domain1/config/default-web.xml en false:

<servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class> .... <init-param> <param-name>fork</param-name> <param-value>false</param-value> </init-param> .... </servlet>

En cada aplicaci�n Web, configurando la propiedad de configuraci�n JSP fork de sun-web.xml en false:

<sun-web-app> <jsp-config> <property name="fork" value="false" /> </jsp-config> </sun-web-app>

Las dos configuraciones impedir�n que ant genere nuevos procesos para la compilaci�n javac.

---

Informaci�n sobre problemas y respuestas de los clientes

Si experimenta problemas con Sun Java System Application Server, p�ngase en contacto con el servicio de atenci�n al cliente de Sun usando uno de estos procedimientos:

Formulario de env�o de comentarios: se trata de un formulario mediante el que podr� enviar sus comentarios acerca del producto Application Server. Lo encontrar� aqu�:

http://java.sun.com/docs/forms/J2EE14SubmittalForm.html

Lista J2EE-INTEREST: se trata de una lista de correo para preguntas acerca de J2EE. Podr� encontrarla aqu�:

http://archives.java.sun.com/archives/j2ee-interest.html

Base de datos de errores sobre Java Developer Connection: si desea ver los errores registrados sobre Java Developer Connection Bug Parade o si desea registrar otros nuevos, acceda a:

http://developer.java.sun.com/servlet/SessionServlet?url=/developer/bugParade/index.jshtml

Foros de programadores de Sun: son tablones de mensajes que sirven para compartir informaci�n y dudas sobre las tecnolog�as Java y las t�cnicas de programaci�n. Use el foro sobre J2EE SDK para los asuntos relacionados con el producto Sun Java System Application Server Enterprise Edition 8.1. Se encuentra en:

http://forum.java.sun.com/

Servicios de atenci�n al cliente de software de Sun: podr� acceder a ellos mediante:

http://www.sun.com/service/sunone/software

Este sitio Web dispone de enlaces a la base de datos de soluciones, al centro de asistencia en l�nea y al rastreador de productos, as� como enlaces a programas de mantenimiento y n�meros de contacto de asistencia.

El n�mero de tel�fono del distribuidor asociado al contrato de mantenimiento.

Para que podamos ayudarle de forma �ptima en la resoluci�n de problemas, tenga a mano la siguiente informaci�n cuando se ponga en contacto con la asistencia:

descripci�n del problema, incluida la situaci�n en la que �ste se produce y la forma en que afecta al funcionamiento
Tipo de m�quina, versi�n del sistema operativo y versi�n del producto, incluida cualquier revisi�n del producto y otro software que pueda influir en el problema
Pasos detallados de los m�todos que haya seguido para solucionar el problema
Cualquier registro de error o volcado del n�cleo

---

Sun valora sus comentarios

Sun tiene inter�s en mejorar su documentaci�n y valora sus comentarios y sugerencias.

Para publicar sus comentarios, acceda a http://docs.sun.com y haga clic en “Send Comments” (Enviar comentarios). Se mostrar� un formulario en l�nea en el que deber� indicar el t�tulo del documento y el n�mero de pieza. El n�mero de pieza consta de siete o de nueve d�gitos y se encuentra en la p�gina que contiene el t�tulo de la gu�a o al principio del documento. Por ejemplo, el t�tulo de este libro es Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Notas de la versi�n y el n�mero de pieza, 819-2024.

---

Recursos adicionales de Sun

Puede encontrar informaci�n �til en las siguientes direcciones de Internet:

Informaci�n del producto Application Server:
http://wwws.sun.com/software/products/appsrvr/home_appsrvr.html
Documentaci�n del producto Application Server:
http://docs.sun.com/db/prod/s1appsrv#hic/
Documentaci�n de Sun Java System
http://docs.sun.com/prod/java.sys
Servicios profesionales de Sun Java System
http://www.sun.com/service/sunps/sunone
Servicio y productos de software de Sun Java System
http://www.sun.com/software
Servicios de asistencia al cliente de software de Sun Java System
http://www.sun.com/service/sunone/software
Base de datos de soluciones y asistencia al cliente de Sun Java System
http://www.sun.com/service/support/software
Servicios de formaci�n y asistencia al cliente de Sun
http://training.sun.com
Servicios profesionales y de consultor�a de Sun Java System
http://www.sun.com/service/sunps/sunone
Informaci�n para programadores de Sun Java System
http://developers.sun.com
Servicios de asistencia de programadores de Sun
http://www.sun.com/developers/support
Formaci�n sobre el software de Sun Java System
http://www.sun.com/software/training
Hojas de datos de software de Sun
http://wwws.sun.com/software
Documentaci�n de productos de Sun Microsystems:
http://docs.sun.com/

---

Copyright � 2004-2005 Sun Microsystems, Inc. Reservados todos los derechos.

Sun Microsystems, Inc. tiene derechos de propiedad intelectual relacionados con la tecnolog�a del producto que se describe en este documento. Especialmente, aunque sin limitarse a ello, estos derechos de propiedad intelectual pueden incluir una o varias patentes en los Estados Unidos, las cuales figuran en http://www.sun.com/patents, as� como una o varias patentes adicionales (o patentes pendientes de adjudicaci�n) en los Estados Unidos y en otros pa�ses.

PROPIEDAD/CONFIDENCIAL DE SUN

Derechos del gobierno de Estados Unidos: software comercial. Los usuarios gubernamentales est�n sujetos al acuerdo de licencia est�ndar de Sun Microsystems, Inc. y a las disposiciones aplicables de la regulaci�n FAR y sus suplementos.

El uso est� sujeto a las condiciones de la licencia.

Esta distribuci�n puede incluir materiales desarrollados por terceras partes.

Algunas de sus partes pueden proceder de sistemas Berkeley BSD, con licencia de la Universidad de California.

Sun, Sun Microsystems, el logotipo de Sun, Java y Solaris son marcas comerciales o marcas comerciales registradas de Sun Microsystems, Inc. en Estados Unidos y otros pa�ses. Todas las marcas comerciales de SPARC se utilizan bajo licencia y son marcas comerciales o marcas registradas de SPARC International, Inc. en EE.UU. y en otros pa�ses.