Notes de version de Sun Java System Application Server Enterprise Edition 8.1

Notes de version de Sun Java™ System Application Server Enterprise Edition

Version 8.1 2005T1

R�f�rence 819-2025

Sun Java™ System Application Server Enterprise Edition 8.1 2005T1 simplifie consid�rablement les t�ches de cr�ation et d’administration des applications de service Web. Il permet d’accro�tre les performances tout en offrant des fonctions de clustering et de disponibilit� �lev�e aux services �volutifs qui sont capables de fonctionner malgr� une d�faillance mat�rielle ou logicielle. Application Server offre une m�thode de d�veloppement des services Web qui simplifie le processus tout en fournissant des possibilit�s de croissance extr�mement flexibles.

Ces notes de version contiennent des informations importantes disponibles au moment de la commercialisation de Sun Java System Application Server 8.1 2005T1. Vous y trouverez des renseignements sur les nouvelles fonctions, les am�liorations, les restrictions et probl�mes connus, etc. Prenez connaissance de ce document avant de commencer � utiliser Application Server 8.1.

Pour obtenir la version la plus r�cente de ces notes de version, reportez-vous au site Web de la documentation de Sun Java System � l’adresse : http://docs.sun.com/db/prod/s1appsrv#hic/. Consultez ce site Web avant d’installer et de configurer votre logiciel, puis r�guli�rement pour vous procurer la documentation concernant le produit et les notes de version les plus r�centes.

Ce document se compose des sections suivantes :

Des URL de sites tiers, qui renvoient � des informations compl�mentaires connexes, sont r�f�renc�s dans ce document.


Remarque

Sun d�cline toute responsabilit� quant � la disponibilit� des sites tiers mentionn�s. Sun ne garantit pas le contenu, la publicit�, les produits et autres mat�riaux disponibles sur ces sites ou dans ces ressources, ou accessibles par leur interm�diaire, et ne saurait en �tre tenu pour responsable. Par ailleurs, la responsabilit� de Sun ne saurait �tre engag�e en cas de dommages ou de pertes, r�els ou suppos�s, occasionn�s par, ou li�s �, l’utilisation du contenu, des produits ou des services disponibles sur ces sites ou dans ces ressources, ou accessibles par leur biais, ou encore � la confiance qui a pu leur �tre accord�e.



À propos d’Application Server Enterprise Edition 8.1 2005T1

Sun Java System Application Server Enterprise Edition 8.1 est un serveur compatible avec la plate-forme J2EE 1.4 destin� au d�veloppement et au d�ploiement d’applications J2EE et de services Web bas�s sur la technologie Java dans des environnements de production � grande �chelle.

Cette section aborde les sujets suivants :

Nouveaut�s de la version 8.1

Les fonctions et am�liorations d�crites ci-dessous ont �t� ajout�es � Sun Java System Application Server Enterprise Edition 8.1 2005T1 :

Am�liorations apport�es � cette version

Application Server Enterprise Edition 8.1 propose les am�liorations suivantes :

Prise en charge de J2EE

Sun Java System Application Server 8.1 2005T1 prend en charge la plate-forme J2EE 1.4. Le tableau suivant d�crit les am�liorations des API disponibles sur la plate-forme J2EE 1.4.

Tableau 1  Principales am�liorations apport�es aux API de la plate-forme J2EE 1.4 

API

Description

Composants

Application et client d’application

Impl�mentation des descripteurs de d�ploiement standard � l’aide de sch�mas XML

Enterprise JavaBeans (EJB) 2.1

Service d’horloge et extr�mit� du service Web EJB

Java Servlet 2.4

Filtre de l’extr�mit� du service Web

Architecture de JavaServer Pages (JSP) 2.0

Langue d’expression et biblioth�que de balises

J2EE Connector Architecture 1.5

Caract�re enfichable de Java Message Service (JMS) et de l’adaptateur de ressource entrant

Services Web

Java Web Services Developer Pack 1.5

Bo�te � outils int�gr�e pour la conception, le test et le d�ploiement d’applications XML, d’applications et de services Web

Java API for XML-based Remote Procedure Calls (JAX-RPC) 1.1

Mappage pour le langage WSDL et la technologie Java et prise en charge du d�veloppement des extr�mit�s et des clients de service Web

WS-I Basic Profile 1.0

�l�ment d’activation pour l’interop�rabilit� via le langage WSDL et le protocole SOAP

SOAP with attachment API for Java (SAAJ) 1.2

API destin�e aux messageries SOAP permettant la cr�ation de messages SOAP avec des pi�ces jointes

Java APIs for XML Registries (JAXR) 1.0

API standard uniforme permettant d’acc�der aux registres XML, notamment les annuaires UDDI et ebXML

Autres

J2EE Deployment 1.1

API standard permettant le d�ploiement d’applications et de composants J2EE

J2EE Management 1.0

D�finitions du mod�le d’informations pour la gestion de la plate-forme J2EE

Java Management Extensions (JMX) 1.2

API de gestion standard

Java Authorization Contract for Containers (JACC) 1.0

D�finition des contrats de s�curit� entre un serveur Application Server J2EE et un fournisseur de strat�gie d’autorisation

Java API for XML Processing (JAXP) 1.2

API utilis�e par des applications pour analyser et convertir des documents XML ainsi que pour g�rer le traitement de sch�mas XML

JMS 1.1

Messagerie standard permettant d’activer les composants de l’application J2EE pour cr�er, envoyer, recevoir et lire des messages et permettant �galement de g�rer les API uniformes pour les files d’attente et les rubriques

JavaMail 1.3

Ensemble de classes abstraites permettant de conditionner un syst�me de messagerie et comportant �galement des mises � jour moindres pour les API

Hautes performances

Application Server inclut des services Web, des conteneurs Web et EJB de hautes performances, et prend en charge la livraison simultan�e des messages avec le logiciel Sun Java System Message Queue.

�volutivit�

Application Server prend en charge l’�volutivit� horizontale via le clustering des instances de serveur et l’�quilibrage de charge des requ�tes. Il permet �galement une �volutivit� verticale de premier ordre, prenant en charge les grandes machines multiprocesseurs. Il vous est possible de clusteriser le courtier de messages int�gr� afin d’obtenir une meilleure �volutivit� et une meilleure disponibilit�. En outre, les clusters d’Application Server vous offre la possibilit� d’�quilibrer la charge de l’acc�s aux clients, notamment les clients HTTP, les applications client enrichi RMI/IIOP, les clients de services Web et les clients JRM.

Haute disponibilit�

Application Server inclut l’�quilibrage de charge pour les clients HTTP, IIOP et JMS, la prise en charge du basculement de la session HTTP, la prise en charge du basculement et du clustering EJB, les services d’horloge EJB haute disponibilit�, la r�cup�ration des transactions distribu�es, la prise en charge des mises � niveau d’applications progressives, ainsi qu’une base de donn�es haute disponibilit� pour le stockage de l’�tat transitoire des applications J2EE.

La disponibilit� assure le basculement des instances d’Application Server mises en cluster. Lorsqu’une panne est d�tect�e, la session que supervisait le serveur non disponible est r�affect�e � une autre instance d’Application Server. Les informations relatives � la session sont stock�es dans la base de donn�es HADB. Le syst�me HADB prend en charge la persistance des sessions HTTP, des beans de session avec �tat et des r�f�rences li�es � la connexion unique.

Prise en charge de JavaServer Faces 1.1

Sun Java System Application Server Enterprise Edition 8.1 prend en charge la technologie JavaServer Faces 1.1. Cette technologie s’appuie sur un ensemble d’interfaces API c�t� serveur repr�sentant les composants de l’interface utilisateur qui g�rent leur �tat, leur �v�nement, leur gestion et la validation des entr�es. De plus, les API d�finissent la navigation entre les pages et prennent en charge l’internationalisation et l’accessibilit�. Il vous est possible d’ajouter des composants d’interface utilisateur personnalis�s � l’aide de la biblioth�que de balises personnalis�e JSP.

Au cours de la phase de d�veloppement, la technologie JavaServer Faces permet � chaque membre d’une �quipe de d�veloppement de se consacrer � une partie sp�cifique du processus. Un mod�le de programmation simple relie ensuite les diff�rentes parties, facilitant et am�liorant ainsi le cycle de d�veloppement.

Configurations mat�rielle et logicielle requises

Cette section d�crit la configuration syst�me requise pour pouvoir installer Sun Java System Application Server Enterprise Edition 8.1.

Configuration requise par la plate-forme

Le tableau ci-dessous contient la liste des syst�mes d’exploitation qui sont pris en charge par Sun Java System Application Server Enterprise Edition 8.1 2005T1. De plus, la m�moire minimale requise et la m�moire recommand�e sont indiqu�es pour l’installation et l’ex�cution d’Application Server.

Tableau 2  Configuration requise par la plate-forme Sun Java System Application Server 8.1 2005T1  

Syst�me d’exploitation

M�moire minimum

M�moire recommand�e

Espace disque minimum

Espace disque recommand�

JVM

Sun Solaris 9, 10 (SPARC)
Solaris 9, 10 (x86)

512 Mo

1 Go

250 Mo disponibles

500 Mo disponibles

J2SE 1.4.2_06
J2SE 5.0

Redhat Enterprise Linux 2.1 Update 2, 3.0 Update 1

512 Mo

1 Go

220 Mo disponibles

300 Mo disponibles

J2SE 1.4.2_06
J2SE 5.0

Microsoft Windows 2000 Advanced Server Service Pack 4+

512 Mo

1 Go

250 Mo disponibles

500 Mo disponibles

J2SE 1.4.2_06
J2SE 5.0

Microsoft Windows Server 2003

512 Mo

1 Go

250 Mo disponibles

500 Mo disponibles

J2SE 1.4.2_06
J2SE 5.0

Sous UNIX, vous pouvez v�rifier la version du syst�me d’exploitation en utilisant la commande uname et l’espace disque en utilisant la commande df.

Patchs requis pour Solaris

Sun conseille aux utilisateurs de Solaris 9, 10 (x86, SPARC) d’installer le groupe de patchs recommand�s. Ce dernier est disponible dans la section des patchs s�curis�s et recommand�s � l’adresse :

Exigences li�es au package suppl�mentaire de RedHat Enterprise Linux 3.0

Pour ex�cuter des composants natifs de ce produit, y compris le programme d’installation, le package suivant, qui ne fait pas partie de la distribution RedHat Enterprise Linux 3.0 standard, doit �tre install� : compat-libstdc++-7.3-2.96.118.i386.rpm

Vous pouvez t�l�charger ce package � partir du site :

Informations importantes concernant les patchs

Pour obtenir la liste actuelle des patchs requis pour Sun Java System Application Server Enterprise Edition 8.1, acc�dez au site http://sunsolve.sun.com et s�lectionnez � Patches � ou � Patch Portal �. Suivez ensuite les liens de Sun Java System Application Server Enterprise Edition 8.1. Des mises � jour seront plac�es sur le site SunSolve, d’abord sous la forme de groupes de patchs recommand�s, d�s que les patchs de syst�mes d’exploitation seront modifi�s et que de nouveaux patchs corrigeant les composants Java Enterprise System seront disponibles.

Pilotes JDBC et bases de donn�es

Sun Java System Application Server a �t� con�u pour prendre en charge la connectivit� des SGBD avec les pilotes JDBC correspondants. Pour obtenir une liste des composants test�s par Sun et jug�s adapt�s � la cr�ation de configurations de bases de donn�es conformes J2EE, reportez-vous au tableau suivant :

Tableau 3  Pilotes JDBC compatibles J2EE 

Fournisseur JDBC

Type de pilote JDBC

Serveur de base de donn�es pris en charge

Logiciel i-net

Type 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

Type 2

IBM DB2 8.1 Service Pack 3+

PointBase

Type 4

PointBase Network Server 4.8

DataDirect

Type 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+

Pilote JDBC Sun Java System pour Oracle

Type 4

Oracle (R) 9.2.0.3, 10G

Pilote JDBC Sun Java System pour DB2

Type 4

IBM DB2 8.1 Service Pack 3+

Pilote JDBC Sun Java System pour Sybase

Type 4

Sybase ASE 12.5.2

Pilote JDBC Sun Java System pour Microsoft SQL Server

Type 4

Microsoft SQL Server 2000 4.0 Service Pack 1

Oracle

Type 4, type 2

Oracle (R) 9.2.0.3, 10G

Pour plus d’informations sur le logiciel i-net, acc�dez au site :

Pour plus d’informations sur les technologies DataDirect, acc�dez au site :

Configuration d’Oracle

Les pilotes JDBC Oracle doivent �tre correctement configur�s pour �tre compatibles avec J2EE 1.4. Configurez les pilotes de type 2 et 4 de la mani�re suivante :

  1. Utilisez le pilote JDBC version 9.2.0.3 ou version ult�rieure.
  2. Le fichier de param�tres (init.ora) de la base de donn�es Oracle doit contenir le param�tre compatible=9.0.0.0.0 ou sup�rieur.
  3. Utilisez le fichier ojdbc14.jar.
  4. Configurez Application Server de fa�on � d�finir la propri�t� JVM suivante :
  5. -Doracle.jdbc.J2EE13Compliant=true

    Par ailleurs, pour les pilotes de Type-2 , les variables ORACLE_HOME et LD_LIBRARY_PATH (devant inclure $ORACLE_HOME/lib) doivent �tre d�finies dans l’environnement dans lequel Application Server est ex�cut�. Ajoutez-les par exemple au fichier de configuration asenv.conf et assurez-vous qu’elles sont export�es.

Configuration de PointBase

Un grand nombre d’applications utilisent le serveur de base de donn�es PointBase fourni avec Application Server. Si vous utilisez Application Server Enterprise Edition, vous devez au pr�alable configurer le serveur de base de donn�es PointBase. Cependant, pour pouvoir utiliser PointBase avec Application Server, prenez connaissance des versions compatibles.

Tableau 4  Compatibilit� J2SE/PointBase

Application Server

PointBase

Pris en charge

J2SE 1.4

J2SE 5.0

J2SE 1.4

J2SE 1.4

Non pris en charge

J2SE 5.0

J2SE 5.0

Vous pouvez configurer PointBase de deux mani�res :

Si vous choisissez la premi�re m�thode :

  1. Assurez-vous d’avoir install� la version J2SE de votre choix.
  2. T�l�chargez J2SE 1.4.2 si ce n’est pas d�j� fait.

  3. À l’aide de la commande correspondant � votre syst�me d’exploitation et � votre shell, d�finissez la variable d’environnement JAVA_HOME sur le r�pertoire dans lequel J2SE est install� ; par exemple :
  4. % setenv JAVA_HOME "/opt/SUNWappserver/jdk"

Si vous choisissez la seconde m�thode, la proc�dure d�pend de votre syst�me d’exploitation.

Sous Solaris et Linux

Modifiez le fichier de configuration r�p_install/pointbase/tools/serveroption/pbenv.conf en rempla�ant la ligne :

PB_JAVA=%%%PB_JAVA%%%

o� J2SE_location repr�sente le r�pertoire d’installation de J2SE. Si vous avez install� J2SE avec Application Server, celui-ci est install� par d�faut dans le r�pertoire r�p_install/jdk. Une fois la modification effectu�e, lancez PointBase � l’aide du script startserver.

Sous Windows

Modifiez le fichier de configuration r�p_install\pointbase\tools\serveroption\pbenv.bat en rempla�ant la ligne :

set PB_JAVA=%%%PB_JAVA%%%

o� J2SE_location repr�sente le r�pertoire d’installation de J2SE. Si vous avez install� J2SE avec Application Server, celui-ci est install� par d�faut dans le r�pertoire r�p_install\j2se1.4. Une fois la modification effectu�e, lancez PointBase en ex�cutant startserver.bat.

Serveurs Web

Cette section r�pertorie les serveurs Web qui sont pris en charge par Sun Java System Application Server Enterprise Edition 8.1 2005T1.

Tableau 5  Serveurs Web pris en charge 

Serveur Web

Version

Syst�me d'exploitation

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 prise en charge de plate-formes suppl�mentaires, notamment Windows et HP-UX, seront disponibles � une date ult�rieure.

Navigateurs

Cette section r�pertorie les navigateurs qui sont pris en charge par Sun Java System Application Server Enterprise Edition 8.1 2005T1.

Tableau 6  Navigateurs Web pris en charge

Navigateur

Version

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

Restrictions et exigences li�es � la haute disponibilit�

Les exigences d�crites ci-dessous concernant la haute disponibilit� doivent �tre satisfaites pour pouvoir configurer le composant HA (High Availability) de Sun Java System Application Server.

Prise en charge du syst�me de fichiers HADB

Plusieurs param�tres sont � prendre compte si vous configurez HADB dans le but d’utiliser l’un des syst�mes de fichiers suivants :

Pour plus d’informations sur l’installation et la configuration du syst�me HADB � l’aide du logiciel Application Server 8.1, consultez le manuel Sun Java System Application Server Enterprise Edition 8.1 Installation Guide.

Mise � niveau de Sun Java System Application Server

Pour obtenir des instructions compl�tes sur la mise � niveau d’une version pr�c�dente d’Application Server vers Sun Java System Application Server Enterprise Edition 8.1 2005T1, reportez-vous au guide d’installation.

Mise � niveau vers J2SE 5.0

Contrairement � la base de donn�es PointBase int�gr�e, Sun Java System Application Server 8.1 2005T1 prend en charge J2SE 5.0 comme machine JVM sous-jacente. Si vous souhaitez mettre � niveau la version J2SE 1.4.2 int�gr�e vers la version J2SE 5.0 pour ex�cuter Application Server, suivez les �tapes suivantes (Windows et Unix) :

  1. T�l�chargez le SDK J2SE 5.0 (et non JRE) et installez-le sur votre syst�me si ce n’est pas d�j� fait.
  2. Celui-ci est disponible � l’adresse http://java.sun.com/j2se/1.5.0/.

  3. Arr�tez Application Server.
  4. Pour cela, vous pouvez utiliser la ligne de commande suivante :

    as-install/bin/asadmin stop-domain

    ou l’interface graphique de la console d’administration :

    1. Cliquez sur le nud Application Server.
    2. Cliquez sur Arr�ter l’instance.
  5. Modifiez le fichier r�p_install/config/asenv.conf (asenv.bat sous Windows), de mani�re � ce que la valeur AS_JAVA corresponde au r�pertoire personnel de J2SE 5.0.
  6. Modifiez le fichier as-install/samples/common.properties en modifiant la ligne commen�ant par � com.sun.aas.javaRoot... � de fa�on � indiquer le r�pertoire personnel de J2SE 5.0.
  7. Red�marrez Application Server � l’aide de la commande suivante :
  8. as-install/bin/asadmin start-domain


    Remarque

    Si vous effectuez une mise � niveau � partir d’une version JDK ant�rieure � la version int�gr�e (JDK 1.4.2_06), il ne vous pas possible d’effectuer la mise � niveau vers J2SE 5.0 en effectuant les �tapes d�crites ci-dessus. En plus des �tapes mentionn�es ci-dessus, vous devez supprimer la totalit� des domaines existants, puis les recr�er.


Autres exigences

Il est n�cessaire de satisfaire les exigences suppl�mentaires d�crites ci-apr�s avant de proc�der � l’installation du logiciel Sun Java System Application Server.

Pour davantage d’informations sur la compatibilit�, reportez-vous au Guide de migration et de mise � niveau disponible � l’adresse suivante :

Version autonome

La version autonome de Sun Java System Application Server Enterprise Edition 8.1 diff�rent en plusieurs points de Java ES Enterprise Edition. Parmi ces diff�rences, on notera :

Documentation connexe

En plus de ces notes de version, Application Server comprend une documentation compl�te disponible � l’adresse suivante :

Le tableau suivant contient la liste les manuels fournis avec Application Server.

Tableau 7  Manuels composant cette documentation 

Titre de l’ouvrage

Description

Guide de d�marrage rapide

D�marrage de Sun Java System Application Server.

Guide d’installation

Installation du logiciel Sun Java System Application Server et de ses composants.

Guide de planification du d�ploiement

Evaluation des besoins du syst�me et de l’entreprise pour assurer le bon d�ploiement de Sun Java System Application Server sur votre site. Vous y trouverez �galement des questions plus g�n�rales concernant le d�ploiement d’un serveur d’applications.

Developer’s Guide

Cr�ation et impl�mentation d’applications sur la plate-forme Java™ 2, Enterprise Edition (plate-forme J2EE™) destin�es � fonctionner sous Sun Java System Application Server suivant le mod�le des normes Java ouvertes pour les composants J2EE et les API. Ce manuel comprend des informations g�n�rales sur les outils de d�veloppement, la s�curit�, l’assemblage, le d�ploiement, le d�bogage et la cr�ation de modules de cycle de vie.

J2EE 1.4 Tutorial

Utilisation des technologies de la plate-forme J2EE 1.4 et des API pour le d�veloppement d’applications J2EE et le d�ploiement d’applications sur Sun Java System Application Server.

Guide d’administration

Configuration, gestion et d�ploiement des composants et des sous-syst�mes de Sun Java System Application Server � partir de la console d’administration.

High Availability Administration Guide

Instructions de configuration et d’administration postinstallation pour la base de donn�es haute disponibilit�.

Administration Reference

Modification du fichier de configuration de Sun Java System Application Server, domain.xml.

Guide de migration et de mise � niveau

Migration des applications vers le nouveau mod�le de programmation de Sun Java System Application Server, notamment � partir d’Application Server 6.x et 7. Ce guide d�crit �galement les diff�rences existant entre les versions adjacentes et les options de configuration pouvant aboutir � une incompatibilit� avec les sp�cifications du produit.

Performance Tuning Guide

R�glage de Sun Java System Application Server afin d’en am�liorer les performances.

Troubleshooting Guide

R�solution des probl�mes de Sun Java System Application Server.

Error Message Reference

R�solution des messages d’erreur de Sun Java System Application Server.

Reference Manual

Commandes des utilitaires disponibles avec Sun Java System Application Server (en style manpage). Ce manuel d�crit �galement l’interface de la ligne de commande asadmin.


Probl�mes connus et restrictions

Cette section d�crit les probl�mes connus de Sun Java System Application Server Enterprise Edition 8.1 2005T1 ainsi que les solutions associ�es. Si aucune plate-forme particuli�re n’est pr�cis�e dans le r�capitulatif, cela signifie que le probl�me s’applique � toutes les plates-formes. Ces informations sont regroup�es dans les sections ci-dessous :

Administration

Cette section traite des probl�mes connus li�s � l’administration et les solutions associ�es.

Le script package-appclient ne fonctionne pas si le domaine domain1 n’existe pas (ID 6171458).

Par d�faut, une valeur cod�e en dur, asenv.conf, existe dans $INSTALL/lib/package-appclient.xml pour la variable AS_ACC_CONFIG du domaine domain1. Si le domaine domain1 est supprim� et qu’un autre domaine est cr��, la variable AS_ACC_CONFIG n’est pas mise � jour avec le nouveau nom de domaine, ce qui entra�ne l’�chec du script package-appclient.

Solution

Vous avez deux possibilit�s :

Impossible de restaurer un domaine enregistr� sous un autre nom (ID 6196993).

La mise en miroir d’un domaine sur la m�me installation d’Application Server ne peut pas �tre effectu�e � l’aide des commandes backup-domain et restore-domain, car le domaine ne peut pas �tre restaur� � l’aide d’un nom diff�rent de celui d’origine m�me si la commande asadmin restore-domain comprend une option permettant de renommer le domaine. Il semble que l’attribution d’un nouveau nom au domaine enregistr� ait �t� correctement effectu�e, mais les tentatives de d�marrage de ce domaine n’aboutissent pas, car les entr�es li�es � la configuration du domaine n’ont pas �t� modifi�es et les commandes startserv et stopserv utilisent toujours le nom de domaine d’origine pour d�finir les chemins.

Solution

Le nom de domaine utilis� pour restore-domain doit �tre le m�me que celui utilis� pour la commande d’origine backup-domain. Les commandes backup-domain et restore-domain d’Application Server 8.1 servent uniquement � la sauvegarde et � la restauration d’un m�me domaine sur une m�me machine.

Le d�marrage d’Application Server avec un agent JMX suppl�mentaire n’est pas pris en charge (ID 6200011).

La version J2SE 1.4.x, 5.0 ou version ult�rieure peut �tre configur�e sur Application Server. La fonction de d�marrage d’un agent JMX est int�gr�e � la plate-forme J2SE 5.0. Un agent est activ� lorsque vous d�finissez explicitement les propri�t�s syst�me lors du d�marrage du serveur.

Voici quelques exemples de valeurs :

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

Apr�s avoir configur� les propri�t�s JMX et d�marr� le serveur, un nouveau serveur jmx-connector d�marre au sein de la machine virtuelle (VM) d’Application Server. Cependant, cette op�ration a un effet n�gatif sur les fonctions d’administration et les interfaces graphiques (IG) et de ligne de commande (CLI) administratives d’Application Server peuvent g�n�rer des r�sultats inattendus. Le probl�me provient du fait qu’il existe des conflits entre le serveur jmx-connector int�gr� et le nouveau serveur jmx-connector.

Solution

Si vous utilisez la console jconsole (ou tout autre client compatible JMX), vous pouvez r�utiliser le serveur JMX Connector Server standard ex�cut� au d�marrage d’Application Server.

Lorsque le serveur d�marre, une ligne similaire � celle indiqu�e ci-dessous s’affiche dans le fichier journal server.log. Vous pouvez vous connecter � l’adresse JMXServiceURL et effectuer les m�mes op�rations de gestion ou de configuration une fois les r�f�rences correctement fournies. Par exemple :

[#|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://nom_h�te:8686/management/rmi-jmx-connector]. This is where the remote administrative clients should connect using the JSR 160 JMX Connectors.|#]

Pour plus d’informations, reportez-vous au manuel Sun Java System Application Server 8.1 Administration Guide.

Droits d’ex�cution trop restrictifs dans les scripts start et stop d’Application Server (UNIX uniquement) (ID 6206176).

Si vous ex�cutez la commande asadmin restore-domain lorsque vous �tes connect� en tant qu’utilisateur � A �, les scripts seront dot�s d’autorisations 744 (rwxr--r--). Si vous tentez par la suite de d�marrer ou d’arr�ter un domaine en tant qu’utilisateur � B �, l’op�ration risque d’�chouer (m�me si celui-ci est d�fini en tant que superutilisateur), car les scripts ne peuvent �tre ex�cut�s que par l’utilisateur � A �.

Solution

Modifiez les autorisations des scripts :

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

Client d’application

Cette section d�crit les probl�mes connus des clients d’application et les solutions associ�es.

La biblioth�que JAR fournie avec les archives du client d’application �crase le fichier manifeste (ID 6193556).

Si vous poss�dez un fichier JAR de niveau sup�rieur dans votre JAR client (dans notre cas, reporter.jar), le fichier manifeste de ce JAR �crase celui du JAR client lorsque vous d�ployez ce dernier.

Solution

Aucune pour l’instant.

Pilotes Sun JDBC int�gr�s

Cette section d�crit les probl�mes connus du pilote Sun JDBC int�gr� et les solutions associ�es.

Les applications utilisant le niveau d’isolement TRANSACTION_SERIALIZABLE avec le pilote Sun int�gr� de Microsoft SQL Server risquent de s’interrompre lors de l’utilisation d’une instruction pr�par�e pour la mise � jour si deux transactions parall�les sont en cours d’ex�cution et que l’une d’entre elles est annul�e (ID 6165970).

Pour d�finir le niveau d’isolement d’une connexion, le pool de connexions correspondant doit �tre cr�� sur le m�me niveau d’isolement. Pour obtenir plus d’informations sur la configuration des pools de connexions, reportez-vous au manuel Application Server 8.1 2005T1 Administration Guide.

Solution

Aucune

Erreurs PreparedStatement (ID 6170432).

Description 1

Si une application g�n�re plus de 3 000 objets PreparedStatement au cours d’une transaction, il se peut que l’erreur suivante se produise avec DB2 :

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

Solution 1

Ajoutez les propri�t�s suivantes � la d�finition du pool de connexions de sorte que le pilote r��dite les liens des packages DB2 avec une valeur de sections dynamiques sup�rieure :

createDefaultPackage=true
replacePackage=true
dynamicSections=1000

Pour obtenir plus d’informations sur la configuration des pools de connexions, reportez-vous au manuel Application Server 8.1 2005T1 Administration Guide.

Description 2

Outre l’erreur PrepardStatement mentionn�e ci-dessus, le message d’erreur suivant peut �tre g�n�r� :

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

Solution 2

Augmentez la valeur du param�tre de configuration APPLHEAPSZ pour le serveur DB2. 4096 constitue une valeur correcte.

Description 3

Niveau d’isolement TRANSACTION_SERIALIZABLE.

Si votre application utilise le niveau d’isolement TRANSACTION_SERIALIZABLE avec l’un des param�tres indiqu�s ci-dessus, elle peut s’interrompre lors de la tentative de connexion.

Solution 3

Pour d�finir le niveau d’isolement d’une connexion, le pool de connexions correspondant doit �tre cr�� sur le m�me niveau d’isolement. Reportez-vous au manuel Application Server 8.1 2005T1 Administration Guide pour plus d’informations.

Dans Application Server Enterprise Edition 8.1, le pilote JDBC Sun DB2 int�gr� ne fonctionne pas dans la configuration par d�faut. Cela est d� au fait que les classes du pilote JDBC DB2 requi�rent une autorisation charsetProvider RuntimePermission explicite (ID 6183492).

Solution

Modifiez le fichierserver.policy de mani�re � fournir les autorisations suivantes � une application d�ploy�e utilisant le pilote JDBC :

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

Cette op�ration est requise uniquement pour le pilote JDBC Sun DB2 int�gr�.

Probl�mes rencontr�s lors du param�trage du niveau d’isolement � l’aide du pilote Sun int�gr� pour Sybase Adaptive Server (ID 6189199).

Solutions

Aucune

Connecteurs

Cette section d�crit les probl�mes connus de l’architecture de connecteurs J2EE et les solutions associ�es.

L’attribut connection-validation ne peut pas �tre reconfigur� dynamiquement dans le pool de connexions jdbc-connection-pools (ID 4930792).

Suite � la cr�ation d’un pool de connexions JDBC, l’attribut is-connection-validation-required n’est pas reconfigurable de mani�re dynamique. Autrement dit, dans le cadre d’un pool de connexions d�j� cr��, il est impossible de d�finir directement la validation sur on (ou sur off). Cela s’applique �galement � l’attribut validation-method du pool.

Solution

Il existe trois solutions possibles ayant un impact plus ou moins important sur l’ex�cution des applications :

  1. Cr�ez un pool de connexions jdbc-connection-pools avec l’attribut validation d�fini sur on.
  2. Supprimez jdbc-connection-pool et recr�ez-le avec l’attribut validation d�fini sur on.
  3. Cette op�ration affecte seulement quelques applications d�ploy�es qui d�pendent de ce pool sp�cifique.

  4. Modifiez la propri�t� validation et red�marrez Application Server.
  5. Cette op�ration affecte l’ensemble des applications d�ploy�es.

Apr�s avoir red�marr� une instance DAS, l’annulation du d�ploiement du module connecteur �choue lorsque l’option en cascade est d�finie sur false (ID 6188343).

Dans ce sc�nario, un module connecteur autonome ou imbriqu� est d�ploy� dans l’instance DAS et les pools de connexions du connecteur, et des ressources sont cr��es pour le module d�ploy�. Apr�s avoir red�marr� l’instance DAS, l’annulation du d�ploiement du module connecteur �choue lorsque l’option en cascade est d�finie sur � false �, g�n�rant l’exception suivante :

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

Solution

Utilisez l’annulation de d�ploiement en cascade (en d�finissant l’option cascade sur true) afin d’annuler le d�ploiement des connecteurs autonomes et imbriqu�s apr�s le red�marrage de l’instance DAS.

Persistance g�r�e par les conteneurs

Cette section d�crit les probl�mes connus de persistance g�r�e par les conteneurs et les solutions associ�es.

Une requ�te EJBQL ne peut contenir tous les r�sultats correspondants si la clause where comporte un op�rateur OR et une option de navigation cmr � valeur unique (ID 6184864).

Si tel est le cas, le r�sultat de la requ�te ne va pas concerner les lignes pour lesquelles le chemin de navigation est null, m�me si celui-ci se trouve dans une clause OR diff�rente.

Prenons l’exemple d’un sch�ma comprenant des attributs Employee, Department et Insurance. L’attribut Employee a une relation de type � un � plusieurs � avec l’attribut Department et une relation de type � un � un � avec l’attribut Insurance :

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

La requ�te ci-dessus ne recherche pas les employ�s qui s’appellent John ou qui ne font partie d’aucun service.

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

La requ�te ci-dessus ne recherche pas les employ�s qui ont xyz pour assurance ou qui ne font partie d’aucun service. Elle n’affiche pas non plus les employ�s qui appartiennent au service Engineering ou qui n’ont pas d’assurance.

Solution

Ex�cutez la requ�te pour chaque condition OR s�par�ment, et fusionnez les r�sultats.

Outil de d�ploiement

Cette section d�crit les probl�mes connus de l’outil de d�ploiement (deploytool) et les solutions associ�es.

En r�gle g�n�rale, l’outil de d�ploiement ne cr�e pas d’�l�ment message-destination dans les descripteurs de d�ploiement Sun ci-dessous (ID 6197393).

Une ressource destination JMS d�finie comme nom JNDI dans l’onglet Destinations de message ne peut pas �tre enregistr�e dans le descripteur Sun. Apr�s avoir pr�cis� le nom de la destination (par exemple, PhysicalQueue, destination physique cr��e � l’aide de la commande create-jmsdest) et appuy� sur la touche Entr�e, le nom de la destination s’affiche dans la zone Nom d’affichage tandis que le nom du client ou du bean s’affiche dans la liste Producteurs. Apr�s avoir saisi � jms/Queue � dans la zone de texte Nom JNDI sp�cifique � Sun, l’application ne s’affiche pas comme � (changed) � dans la barre de titre, et une erreur est consign�e dans le fichier journal ~/.deploytool/logfile. Lorsque vous enregistrez l’application et que vous cliquez de nouveau sur l’onglet, le champ Nom JNDI est vide. Lorsque vous cliquez sur Outils>Afficheur de descripteur>Visionneur du descripteur du serveur d’applications afin d’afficher le descripteur Sun, l’�l�ment <message-destination> inclus dans l’�l�ment <jndi-name> n’a pas encore �t� cr��.

Lorsqu’une valeur est saisie pour la premi�re fois dans le champ correspondant au nom JNDI de destination de message au cours d’une session deploytool, une exception IllegalArgumentException est g�n�r�e par org.netbeans.modules.schema2beans.BeanProp.setElement() m�me si la valeur semble correcte dans le descripteur Sun. Les modifications ou ajouts ult�rieurs d’un nom JNDI de destination de message dans la m�me application ou dans d’autres applications ne seront pas enregistr�s dans le descripteur Sun.

Solution

Pour modifier le nom JNDI d’une destination de message :

  1. Supprimez le nom JNDI existant en laissant la zone de texte correspondante vide et en appuyant sur la touche Entr�e.
  2. Saisissez le nouveau nom JNDI, puis appuyez sur Entr�e.
  3. V�rifiez le descripteur Sun en cliquant sur Outils>Afficheur de descripteur>Visionneur du descripteur du serveur d’applications.
  4. Enregistrez l’application en cliquant sur Fichier>Enregistrer.

Si le nom JNDI n’est pas enregistr� dans le descripteur Sun :

  1. Red�marrez l’outil de d�ploiement (deploytool).
  2. Sous l’onglet Destinations de message, s�lectionnez une destination de message existante ou ajoutez-en une nouvelle.
  3. Entrez le nom JNDI de la destination de message dans la zone de texte Nom JNDI sp�cifique � Sun, puis appuyez sur Entr�e.
  4. V�rifiez le descripteur Sun en cliquant sur Outils>Afficheur de descripteur>Visionneur du descripteur du serveur d’applications.
  5. Enregistrez l’application en cliquant sur Fichier>Enregistrer.

R�p�tez les �tapes mentionn�es ci-dessus chaque fois qu’une valeur doit �tre entr�e dans la zone de texte Nom JNDI sp�cifique � Sun sous l’onglet Destinations de message, except� lorsqu’une valeur est saisie pour la premi�re fois dans la zone de texte Nom JNDI au cours d’une session deploytool.

Probl�me relatif � l’affichage des panneaux dans l’assistant de cr�ation de service Web (ID 6198981).

Ce probl�me appara�t dans les deux cas suivants :

L’origine de ce probl�me r�side dans le fait que le fichier xalan.jar qui contient la classe XPathAPI.class est absent du chemin CLASSPATH. Notez que ce probl�me n’appara�t pas dans la version JDK 5.0.

Solution

Ajoutez le fichier xalan.jar � la variable CLASSPATH includes pour le processus s1as-deploytool de r�p_install/lib/processLauncher.xml. Par exemple :

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"

Traduction incorrecte, en chinois simplifi�, du terme � Accueil � par � r�pertoire d’installation � dans l’outil de d�ploiement (ID 6203658).

Lorsque vous cr�ez un bean entreprise dans l’outil de d�ploiement (deploytool) et que vous acc�dez ensuite � l’onglet Transaction ou S�curit� correspondant au nud du bean, les titres � Accueil local � et � Accueil distant � sont traduits de mani�re incorrecte par � R�pertoire d’installation local � et � R�pertoire d’installation distant �.

Documentation

Cette section d�crit les probl�mes d�tect�s dans la documentation et les solutions associ�es.

Erreurs dans les documents index.html et QuickStart.html (ID 6193749).

Deux types d’erreurs ont �t� relev�s dans le fichier index.html de la documentation sur Application Server 8.1 et le fichierdocs-ee/QuickStart.html.

  1. Le chemin de la page par d�faut index.html qui est copi�e dans le r�pertoire docroot de chaque domaine est incorrect. Le chemin correct est :
  2. instance_as/domains/nom_domaine/docroot/

    et non

    r�p_install/domains/nom_domaine/docroot/index.html

  3. Le Guide de d�marrage rapide contient des informations erron�es sur les �quilibreurs de charge et les serveurs Web. Pour obtenir les nouvelles instructions, consultez le Guide de d�marrage rapide en ligne � l’adresse suivante :
  4. http://docs.sun.com/app/docs/doc/819-1260

Ces errata figurent uniquement dans Sun Java ES Application Server Enterprise Edition 8.1 et non dans la Version autonome.

La commande - asadmin create-domain --help est la cause d’une utilisation incorrecte et une option non valide est document�e (--admin.jmxport) (ID 6207862).

La commande d’aide pour asadmin create-domain offre une description de l’option --admin.jmxport qui est une option non valide pour cette commande.

Solution

L’option --admin.jmxport ne peut pas �tre utilis�e avec la commande asadmin create-domain.

Incoh�rences Javadoc (plusieurs ID)

Une documentation Javadoc est absente ou incorrecte pour plusieurs interfaces et m�thodes AMX :

Haute disponibilit�

Cette section d�crit les probl�mes connus de base de donn�es haute disponibilit� (HADB) et les solutions associ�es.

Les exigences relatives � l’utilisation d’un serveur Apache avec Sun Java System Application Server, qui figurent dans l’appendice � Compiling and Configuring Apache Web Server � du manuel Administration Guide, sont obsol�tes.

Vous trouverez ci-dessous la configuration logicielle requise pour l’utilisation du logiciel serveur Web Apache avec une base de donn�es HADB.

Une �tape suppl�mentaire est requise pour pouvoir effectuer la compilation : sur la plate-forme Solaris 10, vous devez ex�cuter la commande ci-dessous avant d’ex�cuter la commande make d’OpenSSL.

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

De plus, les informations sur les modifications � apporter au serveur Web Apache dans la section � Configuring Load Balancing and Failover � du manuel Administration Guide sont incompl�tes.

Sur toutes les plates-formes :

  1. Cr�ez un r�pertoire nomm� sec_db_files sous r�p_install_apache.
  2. Copiez domaine/config/*.db dans r�p_install_apache/sec_db_files.

Sur la plate-forme Solaris :

Sur la plate-forme Linux :

Configuration HADB � double r�seau (aucun ID)

Sous Solaris SPARC, les bases de donn�es haute disponibilit� (HADB) � double r�seau fonctionnent parfaitement sur deux sous-r�seaux distincts. Cependant, du fait de probl�mes au niveau du syst�me d’exploitation ou des pilotes r�seau sur certaines plates-formes mat�rielles, retenez que les plates-formes Solaris x86 et Linux ne g�rent pas toujours correctement les doubles r�seaux. Cela cr�e les probl�mes suivants pour la base de donn�es HADB :

Les tables cr��es apr�s l’ajout de nouveaux nuds ne sont pas fragment�es sur ces nuds (ID 5042351).

Si vous cr�ez une instance de base de donn�es et que vous y ajoutez des nuds, les tables cr��es par la suite ne sont pas fragment�es sur les nuds ajout�s apr�s la cr�ation de la base de donn�es. Seules les tables cr��es avant l’ex�cution de la commande addnodes peuvent utiliser ces nuds lorsque la commande hadbm addnodes refragmente les tables. Cela est d� au fait que create table utilise le groupe de nuds sysnode qui est cr�� lors de l’ex�cution de hadbm create.

Solution

Ex�cutez hadbm refragment apr�s l’ajout de nouvelles tables ou cr�ez des tables dans le groupe de nuds all_nodes.

Les chemins h�t�rog�nes pour packagepath ne sont pas pris en charge (ID 5091349).

Il est impossible d’enregistrer un m�me package, portant le m�me nom, � divers emplacements et sur divers h�tes. Par exemple :

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.

Solution

La base de donn�es HADB ne prend pas en charge les chemins h�t�rog�nes sur plusieurs nuds d’un cluster de base de donn�es. Assurez-vous que le r�pertoire d’installation du serveur HADB (--packagepath) est le m�me pour tous les h�tes concern�s.

hadbm set ne v�rifie pas la disponibilit� des ressources (espace disque et m�moire) (ID 5091280).

Lorsque vous augmentez la taille des p�riph�riques ou du tampon � l’aide de la commande hadbm set, le syst�me de gestion v�rifie la disponibilit� des ressources lors de la cr�ation des bases de donn�es ou de l’ajout de nuds. Cependant, il ne v�rifie pas si un nombre suffisant de ressources est disponible lors de la modification de la taille des p�riph�riques ou du tampon de la m�moire principale.

Solution

V�rifiez qu’il y a suffisamment d’espace disque ou de m�moire disponible sur tous les h�tes avant d’augmenter les attributs de configuration devicesize ou buffersize.

Probl�me HADB avec RedHat AS 3.0 en mode colocalis� avec charges (ID 6158393).

HADB s’ex�cute sous un serveur RedHat 3.0, dont l’h�bergement est partag�, avec AS. Les transactions peuvent �tre interrompues, r�duisant ainsi les performances. Cela est provoqu� par les �changes (swapping) excessifs effectu�s par le syst�me d’exploitation.

Solution

Le probl�me a �t� corrig� dans la version Red Hat EL 3.0 Update 4. La base de donn�es HADB a �t� test�e avec Red Hat EL 3.0 Update 4 et il a �t� d�montr� que le probl�me de swapping excessif avait �t� r�solu. Notez cependant qu’Application Server 8.1 n’a pas �t� test� avec Update 4.

La commande configure-ha-cluste s’interrompt (ID 6159633).

La commande asadmin configure-ha-cluster peut s’interrompre lorsqu’elle est utilis�e afin de cr�er ou de configurer un cluster haute disponibilit� sur plusieurs h�tes. Aucune exception n’est renvoy�e � partir de l’agent de gestion HADB ni d’Application Server.

Solution

La base de donn�es HADB ne prend pas en charge les chemins h�t�rog�nes sur plusieurs nuds d’un cluster de base de donn�es. Assurez-vous que le r�pertoire d’installation du serveur HADB et le r�pertoire de configuration sont identiques pour tous les h�tes concern�s. Pensez � supprimer les r�pertoires de r�f�rentiel avant de r�ex�cuter la commande.

Performances d’Application Server avec HADB (ID 6172589).

Sur toutes les plates-formes, les performances li�es aux instances d’Application Server configur�es pour utiliser HADB seront moins �lev�es que celles obtenues avec la version ant�rieure, du fait des modifications apport�es aux pilotes JDBC utilis�s par HADB.

Solution

Contactez Sun imm�diatement afin de r�soudre ce probl�me.

�chec de la seconde commande addnodes lors de la refragmentation (ID 6175436).

La seconde commande addnodes (et celles qui suivent) peut �chouer lors de la refragmentation, renvoyant l’erreur suivante :

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

Solution

Refragmentez les tables manuellement � l’aide de la commande hadbm.

Impossible de cr�er un p�riph�rique de donn�es de plus de 2 Go sous Windows (ID 6181845).

L’erreur ci-dessous se produit si vous utilisez les commandes hadbm create ou hadbm set avec --NumberOfDataDevices=1 (par d�faut) et --devicesize avec une valeur sup�rieure � 2 Go :

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.

Solution

Pour cr�er un p�riph�rique de donn�es d’une taille sup�rieure � 2 Go sous Windows, divisez la valeur devizesize par 2 Go pour conna�tre le nombre de p�riph�riques dont vous avez besoin. Puis, cr�ez le nombre de p�riph�riques obtenu en utilisant l’option --NumberOfDataDevices. Par exemple, si vous devez cr�er un p�riph�rique de donn�es de 5 Go :

Arrondissez le nombre obtenu et d�finissez la valeur --NumberOfDataDevices=3.

Les informations contenues dans l’aide hadbm sont obsol�tes (ID 6190702).

Certaines informations du syst�me d’aide hadbm sont obsol�tes.

Solution

Reportez-vous au chapitre HADB du manuel Application Server 8.1 Administrator s Guide pour obtenir les derni�res informations.

La commande Addnodes �choue avec une erreur de type table non trouv�e (ID 6214601).

Dans ce sc�nario, la commande de refragmentation hadbm �choue avec l’erreur suivante :

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*

Solution

La solution consiste � refragmenter manuellement les tables App Srv � l’aide de la commande 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;

Installation

Cette section d�crit les probl�mes connus li�s � l’installation et les solutions associ�es.

Panne intermittente du bouton de navigation � Suivant � dans l’�cran de bienvenue du programme d’installation ou de d�sinstallation. Ce probl�me n’a d’incidence que sur la Version autonome du produit (ID 4977191).

Ce probl�me a �t� constat� de mani�re ponctuelle sur la plate-forme Solaris x86, mais il se peut qu’il se produise �galement sur les plates-formes Solaris SPARC et Linux.

Le premier �cran du programme d’installation ou de d�sinstallation affiche le texte complet ainsi que les boutons � Aide � et � Annuler �, mais le bouton � Suivant � utilis� pour naviguer vers l’�cran suivant n’est pas visible. Bien que ce bouton ne soit pas visible, la zone correspondante est active et si vous cliquez dessus, l’�cran suivant s’affiche normalement. Les diff�rents retra�ages de l’interface graphique J2SE sont � l’origine du probl�me.

Solution

Cliquez sur la zone du bouton � Suivant � situ�e � gauche du bouton � Aide �. Une autre solution consiste � forcer le retra�age de l’�cran en le redimensionnant l�g�rement ou en r�duisant et restaurant la fen�tre du programme d’installation. Une fois le retra�age effectu�, le bouton � Suivant � redevient visible.

Blocage lors de l’arr�t de l’installation sur certains syst�mes Linux apr�s avoir cliqu� sur le bouton � Terminer � (5009728).

Ce probl�me se produit sur plusieurs syst�mes Linux. Il est plus fr�quent sur Java Desktop System 2 mais survient �galement sur les distributions RedHat.

Lorsque vous cliquez sur le bouton � Terminer � du dernier �cran, le programme d’installation ne parvient pas � ouvrir une fen�tre de navigation dans laquelle est affich�e la page À propos de ou celle concernant l’enregistrement du produit et se bloque pour une p�riode ind�finie, sans renvoyer d’invite de commande.

Solution

Quittez le programme d’installation en appuyant sur les touches Ctrl+C dans la fen�tre du terminal dans laquelle le programme d’installation a �t� d�marr�. La page À propos de et celle concernant l’enregistrement du produit apparaissent. Dans le cas contraire, d�marrez le navigateur et saisissez l’URL suivant pour acc�der � la page À propos de :

Si vous avez s�lectionn� l’option d’installation permettant d’enregistrer le produit, suivez le lien menant � la page d’enregistrement disponible sur la page � À propos de � du produit.

D�tection ponctuelle de J2SE et probl�mes d’initialisation concernant le programme d’installation de Linux (6172980).

Le fichier ex�cutable setup destin� � lancer le programme d’installation de Linux se bloque de temps � autre. Au lieu de r�soudre l’emplacement J2SE et de d�marrer l’assistant d’installation, le programme d’installation s’interrompt et renvoie les messages suivants :

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

Ce probl�me concerne uniquement certaines versions de Linux et est fonction des param�tres d’environnement, en particulier de la pr�sence de la variable JAVA_HOME.

Solutions

Pour r�soudre ce probl�me :

  1. Annulez le param�trage de la variable JAVA_HOME � l’aide de la commande unset ou unsetenv selon votre shell.
  2. Ex�cutez la commande setup avec l’option -javahome de mani�re � pr�ciser la variable JAVA_HOME utilis�e par le programme d’installation.

Le r�pertoire imq doit �tre cr�� au cours de l’installation (Windows uniquement) (ID 6199697).

Imm�diatement apr�s avoir install� Application Server EE sous Windows, le courtier IMQ ne parvient pas � d�marrer et un message indiquant que le r�pertoire drive:\asomainsomain1\imq n’existe pas s’affiche.

Notez que le probl�me ne se produit pas si le courtier est d�marr� apr�s domain1, car le r�pertoire est cr�� par Application Server.

Solution

Cr�ez var_home_dir_location avant de cr�er le courtier :

$imqbrokerd -varhome var_home_dir_location

Par exemple :

$imqbrokerd -varhome D:\asomainsomain1\imq

Didacticiel J2EE

Pour ex�cuter le didacticiel J2EE 1.4 sous Sun Java System Application Server Enterprise Edition 8.1 2005T1, effectuez les t�ches ci-dessous :

Gestion du cycle de vie

Cette section d�crit les probl�mes connus de gestion du cycle de vie et les solutions associ�es.

Apr�s avoir d�fini l’intervalle minimum-delivery-interval de la propri�t� ejb-timer-service sur 9000, la tentative de d�finition de l’intervalle redelivery-interval-in-mills de la propri�t� ejb-timer-service sur 7000 entra�ne l’�chec de la commande set avec l’erreur ci-dessous (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.

La relation entre la propri�t� de l’intervalle de redistribution et celle de l’intervalle de livraison minimal n’�tant pas logique, il vous est impossible d’utiliser l’interface graphique (IG) ou l’interface de ligne de commande (CLI) pour d�finir un intervalle de livraison minimal sup�rieur � celui de redistribution.

L’intervalle minimum-delivery-interval-in-millis doit obligatoirement �tre sup�rieur ou �gal � l’intervalle redelivery-interval-in-millis de la propri�t� du service d’horloge ejb. Or, la v�rification de la validation dans Application Server, permettant de contr�ler que l’intervalle redelivery-interval-in-millis est sup�rieur � l’intervalle minimum-delivery-interval-in-millis, contient des erreurs.

Solution

Utilisez les valeurs par d�faut suivantes :

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

Toute autre valeur provoquera une erreur.

Consignation

Cette section d�crit les probl�mes connus de consignation et les solutions.

Le param�trage d’une instruction de d�bogage pour access,failure entra�ne un blocage au d�marrage d’Application Server (ID 6180095).

Le param�trage de l’option java.security.debug pour JVM entra�ne un blocage du d�marrage de l’instance du serveur. Ce probl�me se produit, par exemple, lorsque vous d�finissez les param�tres ci-dessous dans le fichier domain.xml.

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

Solution

Aucune pour l’instant. �vitez de param�trer cet indicateur.

Message Queue

Cette section d�crit les probl�mes connus li�s aux files d’attente des messages Java et les solutions associ�es.

Du fait de la synchronisation, la reconnexion JMS ne s’�tablit pas toujours correctement (ID 6173308, 6189645, 6208728, 6198481, 6199510, 6199510).

Dans des sc�narios faisant appel � la synchronisation, plusieurs causes peuvent �tre � l’origine de ce probl�me. Cela �tant, vous pouvez g�n�ralement le r�soudre de la mani�re suivante :

Le comportement du module d’�coute de message asynchrone a �t� modifi� dans le conteneur appclient de la version 8.1 (ID 6198465).

En raison d’une r�cente modification, lorsqu’un module d’�coute de message asynchrone est le seul thread actif du conteneur app-client, l’autre machine virtuelle (VM) appclient existe en tant que d�mon. Ce comportement constitue une r�gression par rapport aux applications pr�c�dentes qui effectuent des r�ceptions asynchrones dans ACC. Ce probl�me a une incidence sur les clients d’application qui d�finissent un module d’�coute de message JMS et arr�tent le thread principal.

Solution

Ne fermez pas le thread principal. Attendez que le module d’�coute du message avertisse le thread principal avant de fermer ce dernier.

Les journaux du courtier de message comportent des messages � Envoi impossible � (ID 6204180).

Dans un environnement clusteris�, lorsqu’un courtier dispose d’une m�moire insuffisante, les messages d’erreur suivants sont affich�s dans le journal du courtier :

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

Avec des consommateurs durables, m�me si un consommateur a accus� r�ception d’un message, ce dernier peut �tre redistribu� ult�rieurement � d’autres consommateurs (avec l’indicateur de redistribution d�fini).

Cette erreur se produit, car les donn�es n�cessaires au syst�me sont lib�r�es de mani�re incorrecte au moment o� la m�moire syst�me est limit�e. Celle-ci survient uniquement sur les messages envoy�s aux consommateurs qui sont associ�s au courtier mais qui ont �t� communiqu�s � un autre courtier du cluster.

Solution

Augmentez la taille maximale du tas Java pour le processus de courtier de messages (-Xmx) afin d’emp�cher le syst�me de fonctionner avec une m�moire trop faible.

Apr�s une d�faillance, le courtier s’ex�cutant dans un cluster manque de m�moire au red�marrage (ID 6205463).

Les courtiers de messages faisant partie int�grante d’un cluster manquent de m�moire lorsqu’ils sont red�marr�s. Deux facteurs peuvent �tre � l’origine de ce probl�me. Pour d�terminer si l’un ou l’autre de ces facteurs s’appliquent, consultez les fichiers journaux des serveurs d’applications et des courtiers de messages du cluster.

Solutions

Consultez les solutions concernant les bogues 6208621 et 6208728 (selon l’origine du probl�me).

Cr�ation de m�moire sur le courtier de messages lors du red�marrage d’un cluster suite � une panne (ID 6208621).

Lorsqu’un courtier de messages d’un cluster est red�marr� apr�s une panne, de la m�moire est cr��e sur le courtier, car les MDB non durables d’une destination de type rubrique n’ont pas �t� correctement propag�es.

Apr�s le d�marrage d’un courtier de messages en tant que partie int�grante d’un cluster actif, des exceptions sont g�n�r�es dans les fichiers journaux du serveur d’applications et du courtier. Au fur et � mesure du fonctionnement du courtier, la m�moire devient insuffisante. Lorsque cela se produit, apr�s le red�marrage du courtier, un message d’avertissement similaire � celui ci-dessous est g�n�r� dans un ou plusieurs journaux des serveurs d’applications du cluster.

[#|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>....

En outre, un message correspondant s’affiche g�n�ralement dans les fichiers journaux du courtier de messages au format suivant :

ERROR Internal Error: received ack twice on ...

Le probl�me est que lorsqu’un courtier de messages est associ� � un cluster actif, les informations concernant l’ensemble des consommateurs actifs sont transmises par d’autres courtiers du cluster. Si une MDB poss�de un abonn� non durable sur l’un des courtiers distants, des informations erron�es risquent d’�tre envoy�es lors du transfert des informations sur le consommateur. Lorsque le courtier red�marr� re�oit ces informations, il achemine plusieurs copies incorrectes du message � un autre courtier.

Dans ce cas, le consommateur distant consigne un message de type � [C4000]: Packet acknowledge failed � dans le journal d’ApplicationServer et une erreur � double ack � est consign�e dans le courtier distant. Chaque fois qu’un message � double ack � est enregistr� dans le journal du courtier, l’accus� de r�ception du courtier �metteur est invalide. La m�moire du courtier �metteur sera alors insuffisante ou satur�e.

Solutions

Si vous rencontrez ce probl�me, annulez le d�ploiement de la base MDB et red�ployez-la sur le syst�me afin de nettoyer les informations internes. Pour que ce probl�me n’ait aucune incidence sur le fonctionnement normal du courtier, proc�dez comme suit :

Contr�le

Cette section d�crit les probl�mes connus li�s au contr�le et les solutions associ�es.

Certaines statistiques de contr�le du service HTTP ne contiennent aucune information utile et doivent �tre ignor�es (ID 6174518).

Lors de l’affichage des statistiques de contr�le de certains �l�ments du service HTTP, certaines valeurs affich�es ne correspondent pas aux valeurs actuelles ou sont toujours �gales � 0. En particulier, les statistiques du service HTTP ci-apr�s ne contiennent aucune information concernant Application Server 8.1 et doivent �tre ignor�s :

Solution

Ces contr�les seront supprim�s dans les versions ult�rieures et remplac�s par des informations mieux adapt�es.

Le contr�le de mbean pour un module EJB dont le d�ploiement est annul� n’est pas supprim�, m�me si toutes les statistiques regroup�es sous ce nom de contr�le sont transf�r�es (ID 6191092).

Par exemple :

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

Cela s’applique aux applications ainsi qu’aux modules EJB. Un mbean de contr�le vide existe m�me lorsque le contr�le est effectu� par le programme (� l’aide de MBeanAPI) ou par les commandes asadmin list/get.

Diagnostics

L’option asadmin list -m "server.applications" affiche les r�sultats ci-dessous :

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

Vous pouvez consulter les statistiques :

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

Une fois le d�ploiement annul� :

_export_install_nov-11_domains_domain1_applications_j2ee-modules_sqe_ejb_s1_01

Lorsque vous ex�cutez une commande de liste, l’application est toujours visible :

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

Mais aucune statistique de contr�le n’appara�t :

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.

Pour obtenir les noms valides commen�ant par une cha�ne, utilisez le caract�re g�n�rique (*). Par exemple, pour �tablir une liste des noms de toutes les entit�s contr�lables qui commencent par server, indiquez list "server.*”.

Solution

Ce probl�me est sans cons�quence. Le module peut �tre red�ploy� en toute s�curit�. Le Mbean de contr�le root n’est pas supprim�, mais il est vide.

PointBase

Cette section d�crit les probl�mes connus de PointBase et les solutions associ�es.

Le param�trage des niveaux d’isolement pour le pool de connexions d’une application g�n�re des exceptions dans PointBase (ID 6184797).

Pour les pools de connexions JDBC faisant r�f�rence � une installation de base de donn�es PointBase, la d�finition de l’attribut du pool transaction-isolation-level sur une valeur diff�rente de celle par d�faut (Connection.TRANSACTION_READ_COMMITTED) g�n�re une exception. En revanche, pour les pools associ�s � d’autres bases de donn�es, aucune exception n’est g�n�r�e lors de la d�finition de ce m�me attribut sur des valeurs autres que celles par d�faut.

Solution

Ne d�finissez pas l’attribut transaction-isolation-level pour les pools de connexions JDBC faisant r�f�rence � une installation de base de donn�es PointBase.

PointBase g�n�re une exception lorsqu’un serveur r�seau est utilis� avec des pilotes imbriqu�s (ID 6204925).

Il arrive que la base de donn�es PointBase int�gr�e renvoie une exception lorsque le pilote du serveur r�seau et le pilote imbriqu� sont utilis�s en m�me temps.

Solution

N’utilisez pas les deux pilotes simultan�ment. Choisissez soit le pilote imbriqu�, soit le pilote du serveur r�seau.

Exemples

Cette section d�crit les probl�mes et les solutions li�s � l’exemple de code fourni avec Application Server 8.1.

La commande setup-one-machine-cluster �choue sous Windows, mais fonctionne sous Solaris. Vous devez appuyer sur Ctrl+C pour annuler la commande mqfailover, puis l’ex�cuter de nouveau (ID 6195092).

Pour reproduire l’erreur, consultez le fichier r�p_install\samples\ee-samples\failover\apps\mqfailover\docs\index.html et ex�cutez les commandes suivantes :

Si vous avez d�j� ex�cut� les commandes asant setup-one-machine-cluster-without-ha ou asant setup-one-machine-cluster-with-ha pour un autre exemple EE, ex�cutez ensuite les commandes asant configure-mq ou asant setup-one-machine-cluster-and-configure-mq. La commande semble alors aboutir :

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

N�anmoins, le syst�me se bloque pendant une p�riode ind�termin�e.

Solution

Aucune pour l’instant. Ce probl�me affecte de mani�re similaire tous les exemples EE qui utilisent cette cible ant sous Windows. L’une des solutions consiste � appuyer sur Ctrl+C pour annuler le processus de blocage, puis � red�marrer le syst�me.

Il n’est mentionn� nulle part dans la documentation que des ressources JMS doivent �tre cr��es avant d’ex�cuter l’exemple d’application de basculement MQ � l’aide de la commande de d�ploiement asadmin deploy (ID 6198003).

L’erreur g�n�r�e est la suivante :

/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 : Objet de destination JMS introuvable : jms/durable/TopicA
Nov 18, 2004 10:50:18 PM com.sun.enterprise.naming.NamingManagerImpl bindObjects
SEVERE: javax.naming.NameNotFoundException
javax.naming.NameNotFoundException

La documentation n’indique pas, de fa�on explicite, que des ressources JMS doivent �tre cr��es manuellement lorsque vous proc�dez au d�ploiement manuel � l’aide de la commande asadmin deploy, ni que vous devez utiliser les cibles ant fournies pour d�ployer l’exemple d’application.

Solutions

Utilisez la cible asant deploy pour le script build.xml afin de cr�er les ressources JMS n�cessaires � l’ex�cution de l’application.

Erreur d’ex�cution lors de la cr�ation de certificats dans les exemples de s�curit�/services Web sous Linux (ID 6198239).

Lors du d�ploiement de l’exemple r�p_install/samples/webservices/security (basicSSl) sous Linux, le certificat n’est pas cr�� et une erreur similaire � celle pr�sent�e ci-dessous est g�n�r�e :

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 trsut 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

Le probl�me est que les biblioth�ques NSS ne se trouvent pas dans les m�mes emplacements sous Linux et Solaris. Lors du d�ploiement sous Linux, assurez-vous que le chemin LD_LIBRARY_PATH correspond � celui des biblioth�ques NSS appropri�es. D�finissez la variable LD_LIBRARY_PATH dans votre environnement ou dans le script wrapper shell r�p_install/bin/asant.

Solutions

Vous avez deux possibilit�s :

La documentation relative � la commande - ee samples asadmin deploy ne tient pas compte de l’option availabilityenabled=true pour le d�ploiement de l’application, garantissant que les exemples d’applications sont activ�s par d�faut par HADB (ID 6198796).

Solutions

À l’aide de la commande asadmin :

  1. Acc�dez � la racine de l’exemple de r�pertoire :
  2. cd r�p_install/samples/ee-samples/failover/apps/dukesbookstore

  3. Ex�cutez la commande asadmin deploy pour d�ployer l’application sur l’instance locale d’Application Server, par exemple :
  4. r�p_install/bin/asadmin deploy -user utilisateur_admin -password mot_de_passe_admin --host h�te_DAS --port port_DAS --availabilityenabled=true --target nom_cluster dukesbookstore.ear

Fa�tes de m�me pour les commandes asadmin deploy de tous les autres exemples EE, � l’exception de r�p_install/samples/ee-samples/failover/apps/mqfailover. Notez que MQ n’utilise pas HADB.

Impossible d’ex�cuter le test failover avec le script asant pour l’exemple EE dukesbookstore (ID 6199076).

Une fois le param�trage d’un cluster compos� de deux machines termin�, l’exemple dukesbookstore failover g�n�re des erreurs. L’objectif est de disposer d’une base de donn�es par cluster. Actuellement, lors du d�ploiement d’un exemple � partir d’un stockage DAS sur un cluster dont les instances s’ex�cutent sur deux machines distinctes, les scripts utilisent l’h�te PointBase comme h�te local. Lorsqu’un exemple EE est d�ploy�, les ressources JDBC sont d�ploy�es avec l’h�te PointBase en tant qu’h�te local sur chacune des instances. Par cons�quent, le d�ploiement de la machine localhost:9092 sur les deux instances requiert que PointBase s’ex�cute sur les deux machines.

Le probl�me est que deux instances appartenant � un m�me cluster ne peuvent utiliser des bases de donn�es diff�rentes. Pour r�soudre ce probl�me, remplacez la valeur localhost du fichier database.properties par un nom d’h�te. Les deux instances du cluster sont alors en mesure d’acc�der � la base de donn�es : l’une via localhost et l’autre via le nom d’h�te que vous avez indiqu�.

Solutions

Modifiez le fichier r�p_install/samples/database.properties de l’h�te sur lequel le serveur PointBase s’ex�cute, en d�finissant la valeur du serveur pointbase.server sur le nom d’h�te sur lequel PointBase s’ex�cute et non sur localhost.

La configuration actuelle, � savoir pointbase.server=localhost, s’applique � un cluster compos� d’une seule machine, mais ne s’applique pas � un cluster regroupant deux machines pour lequel PointBase n’utilise pas la valeur localhost pour la seconde instance.

L’exemple d’application MQ-failover poss�de un nom de cluster cod� en dur (� cluster1 �) dans l’une des cibles de configuration Ant (ID 6202363).

L’exemple d’application MQ-failover contient le cluster1 cod� en dur dans une cible de configuration Ant. Par cons�quent, si vous remplacez nom_cluster contenu dans le fichier cluster.properties pour les exemples ee-samples du cluster1 par un nom diff�rent, l’exemple �choue lors de la tentative de d�finition de l’h�te par d�faut dans 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.

Le fichier r�p_install/samples/ee-samples/build.xml code en dur les r�f�rences � cluster1, alors qu’il devrait utiliser ${cluster.name} contenu dans r�p_install/samples/ee-samples/cluster.properties.

Solution

La cha�ne cod�e en dur cluster1 doit ${cluster.name} � la place. Modifiez manuellement r�p_install/samples/ee-samples/build.xml afin de remplacer set-default-jms-host-to-broker1 du cluster1 par ${cluster.name} ou par le nom de cluster customer sp�cifi� dans le fichier cluster.properties.

S�curit�

Cette section d�crit les probl�mes connus li�s aux certificats et � la s�curit� des applications Web sous Application Server et les solutions associ�es.

La d�finition d’un message cible par le biais de la m�thode java-method ne fonctionne pas avec les �l�ments client-side message-security-binding (ID 6155080).

Cet incident se produit, par exemple, lorsqu’un message cible faisant partie d’un �l�ment client-side message-security-binding est d�fini � l’aide de la m�thode java-method dans un �l�ment port-info se trouvant lui-m�me dans un �l�ment 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? )>

L’�l�ment message-security-binding permet ici de d�finir les strat�gies de protection du message pour les m�thodes sp�cifiques d’un point de terminaison du service Web.

Solution

Utilisez un �l�ment operation-name de l’�l�ment message pour identifier, � l’aide du nom d’op�ration WSDL, le message pour lequel s’appliquent les strat�gies de protection d�finies dans l’�l�ment message-security.

Exception de type CertificateNotYetVAlidException en cas de non-synchronisation des horloges de la machine d’un agent de nud distant avec celle de la machine DAS (ID 6181989).

Lorsque les agents de nud et le serveur DAS sont install�s sur des machines diff�rentes et que les horloges de ces deux machines ne sont pas synchronis�es, les tentatives d’ex�cution de la commande asadmin --start remote-node-agent �chouent avec l’erreur CertificateNotYetVAlidException.

Solution

Synchronisez l’horloge du serveur DAS avec celle de toutes les machines de l’agent de nud distant.

Impossible d’ex�cuter les applications WebServiceSecurity sur EE avec J2SE 5.0 (ID 6183318).

Les applications WebServiceSecurity ne peuvent �tre ex�cut�es avec J2SE 5.0. pour les raisons suivantes :

Les membres de l’�quipe J2SE ont inclus le message � CR 6190389: Add support for the RSA-PKCS1 and RSA-OAEP wrap/unwrap mechanisms � pour ce bogue.

Solution

Utilisez J2SE 1.4.2 avec tout autre fournisseur JCE (autre que celui inclus par d�faut). Retenez que cette configuration ne prend pas en charge l’acc�l�ration mat�rielle.

Impossible d’�tablir une communication SSL avec MQ si mq-scheme et mq-service sont d�finis dans jms-servicSSL. Impossible d’�tablir une communication avec MQ si mq-scheme et mq-service sont d�finis dans jms-service (ID 6202606).

Les informations utilis�es n’ont pas �t� d�finies dans l’adaptateur de ressources. Par cons�quent, les fabriques de connexion qui utilisent cet adaptateur et qui ont �t� cr��es par ce dernier ne disposent pas des informations SSL.

Solution

Si vous avez besoin d’utiliser une communication SSL entre Application Server et MQ, cr�ez la fabrique de connexion en indiquant addresslist de mani�re explicite avec la syntaxe SSL. Par exemple, addresslist de la fabrique de connexion pourrait �tre :

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

Une communication SSL peut s’av�rer n�cessaire lorsque MQ et Application Server sont situ�s dans des emplacements diff�rents et qu’un intrus risque d’utiliser la connectivit� r�seau.

L’URL du module d’�coute https ne comportant pas de num�ro de port est redirig� vers le module d’�coute http sur le port 80 (ID 6207297).

Lorsqu’un module d’�coute SSL est activ� sur le port par d�faut (443) et que vous tapez l’URL vers ce port s�curis� dans un navigateur sans pr�ciser le num�ro du port, le navigateur vous redirige vers le port 80 sur le module d’�coute non s�curis� (http).

Par exemple :

  1. Cr�ez un module d’�coute SSL sur le port 443 et red�marrez Application Server.
  2. Tapez https://nom_serveur:443 dans votre navigateur.
  3. La page est correctement charg�e.

  4. Tapez https://nom_serveur dans votre navigateur, sans pr�ciser de num�ro de port.
  5. Le navigateur charge la page http://nom_serveur:80 au lieu de charger la page https://nom_serveur.

Ce probl�me ne se produit pas lorsque le module d’�coute SSL est d�fini sur un port autre que le port par d�faut (443).

Solution

Choisissez l’une des deux solutions suivantes :

Utilitaire de mise � niveau

Cette section d�crit les probl�mes connus de l’utilitaire de mise � niveau et les solutions associ�es.

Les domaines cr��s � partir d’un chemin personnalis� autre que celui du r�pertoire r�p_install/domains ne sont pas automatiquement mis � niveau lors de la mise � niveau d’Application Server Enterprise Edition 8 vers Application Server Enterprise Edition 8.1 (ID 6165528).

Lors de l’ex�cution de l’utilitaire de mise � niveau et de l’identification de r�p_install comme r�pertoire d’installation source, seuls les domaines cr��s sous le r�pertoire r�p_install/domains sont mis � niveau par le processus de mise � niveau. Les domaines cr��s dans d’autres emplacements ne sont pas mis � niveau.

Solution

Avant de lancer le processus de mise � niveau, copiez tous les r�pertoires de domaine � partir de leurs emplacements respectifs dans le r�pertoire r�p_install/domains.

Lors de la mise � niveau de J2EE 1.4 SDK vers Application Server EE 8.1, l’installation J2SE int�gr�e n’est pas correctement mise � niveau. Ce probl�me n’a d’incidence que sur la Version autonome du produit (ID 6196741).

Ce probl�me survient durant la mise � niveau de J2EE 1.4 SDK vers Application Server 8.1 (installation autonome). Au cours de la mise � niveau, J2SE 1.4.2 int�gr� doit �tre mis � niveau vers J2SE 5.0. Cependant, certains fichiers JAR associ�s � l’installation J2SE 5.0 n’�tant pas correctement mis � niveau, l’installation de J2SE 5.0 est corrompue.

Le programme d’installation indiquant que la mise � niveau a �t� correctement effectu�e, vous ne devriez pas rencontrer de probl�mes lors de l’ex�cution de l’outil de mise � niveau. Cependant, toutes les tentatives de d�marrage de la version mise � niveau d’Application Server �chouent avec l’exception suivante :

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)

Solution

Il existe plusieurs solutions � ce probl�me :

Le programme d’installation effectuant la mise � niveau � son emplacement ne parvient pas � d�marrer l’outil de mise � niveau sur certains syst�mes Linux apr�s avoir cliqu� sur le bouton Start Upgrade Wizard (D�marrer l’assistant de mise � niveau) (6207337).

Ce probl�me a �t� observ� sur plusieurs syst�mes Linux. Bien qu’il soit plus fr�quent sur Java Desktop System 2, il se produit �galement sur des distributions RedHat.

Apr�s avoir cliqu� sur le bouton Start Upgrade Tool (D�marrer l’outil de mise � niveau) qui se trouve sur l’�cran final du programme d’installation, l’outil de mise � niveau n’est pas lanc� et le programme d’installation se bloque pendant une p�riode ind�termin�e, sans renvoyer d’invite de commande.

Solution

Ce probl�me ne survient pas lorsque le mode d’installation en ligne de commande est utilis� pour proc�der � la mise � niveau � son emplacement.

  1. Si vous effectuez la mise � niveau � son emplacement en mode d’interface graphique (IG) et que le probl�me se produit, quittez le programme d’installation en appuyant sur les touches Ctrl+C dans la fen�tre du terminal dans laquelle le programme d’installation a �t� d�marr�.
  2. D�marrez l’outil de mise � niveau � partir de la fen�tre du terminal en utilisant la commande suivante :
  3. r�p_install/bin/asupgrade --source r�p_install/domains --target r�p_install --adminuser utilisateur_admin
    --adminpassword mot_de_passe_admin --masterpassword changeit

    Les valeurs utilisateur_admin et mot_de_passe_admin doivent correspondre � celles utilis�es pour l’installation que vous mettez � niveau.

  4. Une fois le processus de mise � niveau termin�, vous pouvez �galement d�marrer votre navigateur Web et saisir l’URL suivant afin d’afficher la page À propos de :
  5. file://r�p_install/docs-ee/about.html

    Si vous avez s�lectionn� l’option d’installation permettant d’enregistrer le produit, suivez le lien menant � la page d’enregistrement disponible sur la page � À propos de � du produit.

Conteneur Web

Cette section d�crit les probl�mes connus li�s au conteneur Web et les solutions associ�es.

Le d�ploiement d’une application � l’aide de la commande --precompilejsp=true peut verrouiller les fichiers JAR de l’application, entra�nant l’�chec des red�ploiements et annulations de d�ploiement ult�rieurs (Windows uniquement) (ID 5004315).

Si vous devez effectuer une pr�compilation des pages JSP lors du d�ploiement d’une application sous Windows, les tentatives ult�rieures de red�ploiement ou d’annulation de d�ploiement de cette application (ou de toute autre application contenant le m�me ID de module) n’obtiendront pas le r�sultat attendu. L’origine de ce probl�me provient du fait que la pr�compilation des pages JSP ouvre les fichiers JAR de votre application, mais ne les referme pas. Windows emp�che alors que le processus d’annulation du d�ploiement supprime ces fichiers ou que le processus de red�ploiement ne les �crasent.

Il est � noter que l’annulation du d�ploiement r�ussit partiellement dans la mesure o� l’application est supprim�e d’Application Server. Notez aussi qu’aucun message d’erreur n’est retourn� par l’utilitaire asadmin, mais que le r�pertoire de l’application et les fichiers jar verrouill�s ne sont pas supprim�s du serveur. Le fichier journal du serveur contient les messages d�crivant l’�chec de la suppression des fichiers et du r�pertoire de l’application.

Toute tentative de red�ploiement de l’application suite � l’annulation du d�ploiement �choue, car le serveur essaie en vain de supprimer le r�pertoire et les fichiers existants. Cela peut se produire si vous essayez de d�ployer une application qui utilise le m�me ID de module que celui de l’application initialement d�ploy�e. En effet, le serveur utilise cet ID de module lors de la s�lection d’un r�pertoire destin� � contenir les fichiers de l’application.

Les tentatives de red�ploiement de l’application sans annulation pr�alable du d�ploiement �chouent pour les m�mes raisons.

Diagnostics

Si vous essayez de red�ployer l’application ou de la d�ployer apr�s avoir annuler son d�ploiement, l’utilitaire asadmin renvoie une erreur similaire � celle ci-dessous :

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

Solutions

Ce probl�me ne se produit pas si vous d�finissez le param�tre par d�faut --precompilejsps=false lors du d�ploiement d’une application. Lors de sa premi�re utilisation, l’application d�clenche la compilation des pages JSP. C’est pour cette raison que le temps de r�ponse de la premi�re requ�te est sup�rieur � celui des requ�tes suivantes.

Notez �galement qu’en cas de pr�compilation, vous devez arr�ter et red�marrer le serveur avant d’annuler le d�ploiement de l’application ou de red�ployer cette derni�re. L’arr�t du serveur permet de lib�rer les fichiers JAR qui �taient verrouill�s et d’effectuer correctement les op�rations d’annulation du d�ploiement ou de red�ploiement de l’application apr�s le red�marrage.

Impossible de d�ployer les archives WAR avec le fichier web.xml bas� sur le composant Servlet 2.4 comprenant un �l�ment <load-on-startup> vide (ID 6172006).

L’�l�ment facultatif load-on-startup inclus dans le fichier web.xml indique que le servlet correspondant doit �tre charg� et initialis� au d�marrage de l’application Web � laquelle il appartient.

Le contenu facultatif de cet �l�ment est un nombre entier pr�cisant en quelle position le servlet doit �tre charg� et initialis� par rapport aux autres servlets de l’application Web. Lorsque l’�l�ment <load-on-startup> est vide, l’ordre de d�marrage du servlet est inutile tant que celui-ci est charg� et initialis� au cours du d�marrage de l’application Web dont il d�pend.

Le sch�ma Servlet 2.4 du fichier web.xml ne prend plus en charge les �l�ments <load-on-startup> vides, ce qui signifie que vous devez obligatoirement indiquer un nombre entier. Si vous laissez l’�l�ment <load-on-startup> vide, tel que <load-on-startup/>, le fichier web.xml ne parvient pas � valider le sch�ma Servlet 2.4, provoquant l’�chec du d�ploiement de l’application Web.

Probl�me de compatibilit� ascendante : il vous est possible d’indiquer un �l�ment <load-on-startup> vide dans le fichier web.xml bas� sur Servlet 2.3.

Solution

D�finissez la valeur <load-on-startup>0</load-on-startup> lors de l’utilisation d’un fichier web.xml bas� sur Servlet 2.4 afin d’indiquer que l’ordre de chargement du servlet n’est pas important.

Lorsque vous supprimez, � l’aide de l’API AMX, une r�f�rence de l’application J2EE d’un serveur, l’application est supprim�e, mais elle reste n�anmoins accessible (ID 6173248).

Lorsque vous utilisez l’API AMX et que vous supprimez une r�f�rence d’une application sans arr�ter au pr�alable cette derni�re, l’application reste accessible. Ce comportement est normal et aurait d� �tre mentionn� dans la documentation.

Solution

Pour supprimer une application afin de la rendre inaccessible :

  1. Arr�tez l’application.
  2. Supprimez la r�f�rence � cette application.
  3. Annulez le d�ploiement de l’application.

Impossible de compiler la page JSP sur des serveurs limit�s en ressources (ID 6184122).

La page JSP est accessible mais ne peut pas �tre compil�e. Le journal du serveur contient le message d’erreur � Unable to execute command � avec le suivi de pile suivant :

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)

Solution

D�finissez le commutateur de compilation JSP fork sur false.

Vous pouvez effectuer cette op�ration de l’une des deux mani�res suivantes :

Ces deux param�tres emp�cheront ant de g�n�rer dynamiquement un nouveau processus pour la compilation javac.


Comment signaler des probl�mes et apporter des commentaires

Si vous rencontrez des probl�mes avec Sun Java System Application Server, contactez le service client�le Sun de l’une des mani�res suivantes :

Afin de vous aider � r�soudre votre probl�me, pensez � r�unir les informations suivantes lorsque vous contactez le support technique :


Sun attend vos commentaires

Afin d’am�liorer sa documentation, Sun vous encourage � faire des commentaires et � apporter des suggestions.

Pour nous faire part de vos commentaires, rendez-vous sur le site http://docs.sun.com, puis cliquez sur Envoyer des commentaires. Dans le formulaire en ligne, indiquez le titre et le num�ro du document. Ce num�ro est constitu� de sept ou neuf chiffres et figure sur la page de titre du manuel ou en haut du document. Par exemple, le titre de ce manuel est Notes de version Sun Java System Application Server Enterprise Edition 8.1 2005T1, et sa r�f�rence est 819-2025.


Ressources Sun suppl�mentaires

Vous pouvez obtenir des informations utiles sur les sites suivants :


Copyright � 2004-2005 Sun Microsystems, Inc. Tous droits r�serv�s.

Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuelle relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plusieurs des brevets am�ricains r�pertori�s � l’adresse http://www.sun.com/patents et un ou plusieurs des brevets suppl�mentaires ou demandes de brevet en attente aux �tats-Unis et dans d’autres pays.

Propri�t� de SUN/CONFIDENTIEL.

L’utilisation est soumise aux termes du contrat de licence.

La distribution du logiciel peut s’accompagner de celle de composants mis au point par des tiers.

Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD conc�d�s sous licence par l’Universit� de Californie.

Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux �tats-Unis et dans d’autres pays.

Toutes les marques SPARC sont utilis�es dans le cadre d’un contrat de licence et sont des marques ou des marques d�pos�es de SPARC International, Inc. aux �tats-Unis et dans d’autres pays.