Sun Java System Application Server 7 � Notes de mise � jour

Notes de mise � jour de Sun™ Java System Application Server 7

(anciennement Sun ONE Application Server)

Version 7, Update 3

Num�ro de document 817-6313-10

F�vrier 2004

Ces notes de mise � jour contiennent des informations importantes disponibles lors de la publication de la mise � jour Update 3 du produit Sun Java System Application Server, version 7 (anciennement Sun™ Open Net Environment (ONE) Application Server).


Remarque

Dans ces notes, ainsi que dans d’autres documents de la documentation compl�te, ce produit continue � �tre d�sign� sous la d�nomination Sun ONE Application Server.


Ces notes pr�sentent les am�liorations, des notes relatives � l’installation, les probl�mes connus et d’autres informations de derni�re minute. Lisez ce document et les documents associ�s avant de commencer � utiliser le produit Sun ONE Application Server 7, Update 3.

Ce document comprend les sections suivantes :


Historique de r�vision des notes de mise � jour

Cette section r�pertorie les modifications apport�es � ces notes de mise � jour apr�s la version initiale du produit Sun ONE Application Server 7.

Tableau 1  Historique de r�vision 

Date

Description des modifications

F�vrier 2004

Version initiale du logiciel Sun ONE Application Server 7, Update 3.


À propos de Sun ONE Application Server, version 7, Update 3

Le logiciel Sun™ ONE Application Server 7 fournit une plate-forme J2EE haute performance adapt�e au d�ploiement � grande �chelle de services d’application et de services Web.

Cette section comprend :

Les nouveaut�s du produit Sun ONE Application Server 7

Vous trouverez des informations concernant les nouveaut�s du produit Sun ONE Application Server 7 dans le document Nouveaut�s de Sun ONE Application Server, � l’adresse suivante :

http://docs.sun.com/db/prod/s1.asse

La configuration requise et les limitations

Les informations relatives aux configurations de plate-forme requises pour le produit Sun ONE Application Server 7 Update 3 sont disponibles dans le document Sun ONE Application Server Platform Summary, � l’adresse suivante :

http://docs.sun.com/db/prod/s1.asse

Cette section aborde les th�mes suivants :

Configuration requise de la plate-forme

Le tableau suivant r�sume la configuration requise pour le produit Sun ONE Application Server 7, Update 3. Des informations compl�tes sur les plates-formes sont fournies dans le document Sun ONE Application ServerPlatform Summary, � l’adresse suivante :

http://docs.sun.com/db/prod/s1.asse

Tableau 2  Configuration requise de la plate-forme pour Sun ONE Application Server 

Syst�me d’exploitation

Architecture

M�moire minimum

M�moire recommand�e

Espace disque minimum

Espace disque recommand�

UNIX

Sun Solaris 8 ou 9 pour SPARC

32 et 64 bits

256 Mo sans Sun Java Studio

512 Mo avec Sun Java Studio

512 Mo

250 Mo disponibles

500 Mo disponibles

Solaris x86, Version 9

32 bits

Red Hat Linux 7.2, 7.3

Red Hat Enterprise Linux 2.1, 3.0

Microsoft Windows

Windows 2000 Advanced Server, SP2

Windows 2000 Server, SP2

Windows 2000 Professionnel, SP2

Windows XP Professionnel

Intel 32 bits

256 Mo sans Sun Java Studio

256 Mo avec Sun Java Studio

256 Mo sans Sun Java Studio

512 Mo avec Sun Java Studio

250 Mo disponibles

500 Mo disponibles

Correctifs Solaris

Les utilisateurs de Solaris 8 doivent installer le groupe de correctifs recommand� par Sun, disponible dans la section � Recommended and Security Patches � (Correctifs recommand�s et correctifs de s�curit�), � l’adresse suivante :

http://sunsolve.sun.com/

Les correctifs absolument requis pour Solaris 8 sont 109326-06, 108993-23 et 110934 (chaque r�vision, pour l’installation bas�e sur le progiciel uniquement). Sans ces correctifs, dont le programme d’installation v�rifie la pr�sence, vous ne pouvez ni installer ni ex�cuter le logiciel Sun ONE Application Server. Ces correctifs sont d�j� inclus dans le dernier groupe de correctifs recommand�.

Limitations de Solaris x86


Probl�mes r�solus dans cette version

Cette section r�pertorie les probl�mes signal�s par les clients et r�solus pour le produit Sun ONE Application Server 7, Update 3.

Tableau 3  Probl�mes r�solus dans Application Server 7, Update 3 

R�f�rence

Description

4724728

Lorsqu’une m�thode d�finie dans l’interface d’accueil est une simple red�finition d’une m�thode d�finie dans l’interface de niveau sup�rieur, Sun ONE Application Server g�n�re plusieurs fois le code de mise en uvre.

4811431

Impossible d’acc�der � un module Web si l’attribut d’emplacement contenu dans le fichier server.xml se termine par une barre oblique (/).

4818853

L’association LocalTransaction et ManagedConnection n’est pas conserv�e d’un EJB � un autre.

4830338

Les caract�res multi-octets dans les cookies ne fonctionnent pas et vous ne pouvez pas d�sactiver le codage des URL pour les cookies. Des informations suppl�mentaires sont disponibles dans le document � Internationalisation (i18n) � � la page 65.

4849513

Le rechargement dynamique ne pr�l�ve pas les modifications apport�es � sun-application.xml apr�s la premi�re fois.

4851218

La documentation n’explique pas l’utilisation des certificats auto-sign�s.

4853543

Pas de prise en charge pour une classe de cl� primaire dont certains champs publics sont d�clar�s dans une superclasse.

4860400

Le chargeur de classe EJB renvoie la valeur null lorsqu’il appelle Class.getPackage().

4861948

La commande getEJBMetaData() �choue avec une exception apr�s une r�initialisation du contexte.

4869664

Les caract�res � deux octets causent des probl�mes dans les URL HTTP GET.

4870233

Une page JSP contenant la directive � buffer=none � ne fonctionne pas si elle est plac�e derri�re un module d’�coute de proxy de transition.

4884552

La commande auth-method=CLIENT-CERT force l’authentification client SSL ind�pendamment de la structure de l’URI.

4886253

Impossible d’extraire le certificat client X509 Client derri�re un module d’�coute de proxy de transition.

4892587

Sun ONE Application Server n’impose pas la politique de � signature des octrois �.

4893954

La documentation n’explique pas que la rotation du journal bas� sur le cron red�marre Sun ONE Application Server.

4895814

La commande request.getRequestURI() renvoie des valeurs incoh�rentes.

4904100

Lorsqu’un client riche (sans ACC) acc�de directement � une application d�ploy�e sur Sun ONE Application Server, une exception est toujours g�n�r�e.

4907283

Lorsque JDK1.4.1 est utilis�, le JVM du serveur se bloque lorsque les requ�tes JSP ignorent la distinction minuscules/majuscules.

4909380

La d�sinstallation d’un produit non fourni en standard bas� sur un package ONE Application Server supprime les composants partag�s.

4910686

Sun ONE Application Server effectue une authentification diff�r�e si le port HTTP n’est pas configur� pour l’authentification du client.

4913290

La documentation n’indique pas que l’authentification bas�e sur un formulaire n’offre pas la m�me fonctionnalit� que dans iPlanet Application Server 6.x.

4913458

Les noms de threads de conteneurs Web ne sont pas uniques.

4917206

Impossible de d�finir un ACL pour autre chose que le serveur entier via l’interface utilisateur graphique d’administration.

4922884

Le service Web � partir d’un client JAX-RPC utilisant une m�thode proxy dynamique �met une erreur de serveur interne.

4925548

Le script appclient ne fonctionne pas avec JDK 1.4.2.

4930027

Probl�me de performance de Sun ONE Application Server avec jsp:useBean. Pour plus d’informations, voir la section � Compilateur JSP � � la page 36.

4937416

L’utilisation de la classe Principe de personnalisation g�n�re l’exception ClassCastException.

4958393

La commande ServletContext.getContext(String) ne renvoie pas d’autres contextes lorsqu’elle est appel�e � partir d’un contexte root.


Informations importantes

Cette section traite des th�mes suivants :

Documentation

L’ensemble de la documentation concernant les produits Sun Microsystems est disponible � l’adresse suivante :

http://docs.sun.com/

Cette section traite des th�mes suivants :

Documentation Sun ONE Application Server 7

Outre ces notes de mise � jour, le produit Sun ONE Application Server 7, Update 3 inclut une documentation compl�te. Les documents relatifs � Sun ONE Application Server 7 qui ont �t� mis � jour dans Update 3 poss�dent une nouvelle r�f�rence et sont indiqu�s dans la liste suivante avec la mention R�VIS�. Les documents qui n’ont pas �t� modifi�s depuis les versions de mise � jour pr�c�dentes ont conserv� la m�me r�f�rence.


Remarque

Un document peut �tre r�vis� pour signaler des probl�mes importants. Dans ce cas, la version r�vis�e sera ajout�e sur ce site. La date de derni�re mise � jour est affich�e avec les informations de copyright dans la version HTML du document.


La documentation relative au produit Sun ONE Application Server 7, Update 3 est disponible � l’adresse suivante :

http://docs.sun.com/db/prod/s1.asse

La liste suivante fournit la r�f�rence et une br�ve description de chaque document disponible pour Sun ONE Application Server :

Documentation r�f�renc�e

Il est souvent fait r�f�rence � la documentation d’autres produits Sun ONE dans la documentation de Sun ONE Application Server.

Documentation Sun ONE Message Queue

Le sous-syst�me Sun ONE Message Queue (�galement connu sous le nom de iPlanet Message Queue), int�gr� � Sun ONE Application Server, poss�de sa propre documentation, disponible � l’adresse suivante :

http://docs.sun.com/db?p=prod/s1.s1msgqu

Documentation Sun Java Studio 5, Standard Edition

Le produit Sun Java Studio 5, Standard Edition que vous pouvez utiliser avec Sun ONE Application Server poss�de sa propre documentation disponible aux adresses suivantes :

Accessibilit�

La documentation du produit Sun ONE Application Server est disponible dans des formats accessibles lisibles par des technologies d’assistance.

Le produit fournit de nombreuses fonctions d’accessibilit� qui permettent de lire les informations et d’utiliser le produit de la fa�on la mieux adapt�e � vos besoins. Ces fonctions incluent les suivantes :

Si vous voulez modifier l’aide en ligne HTML du produit Sun ONE Application Server, acc�dez au r�pertoire d’aide et modifiez la feuille de style situ�e � l’emplacement suivant :

racine_serveur/lib/install/applications/admingui/adminGUI_war/help

Red�marrez le serveur d’administration pour appliquer les modifications.

Notes sur la mise � niveau

Si vous effectuez une mise � niveau de la version existante du logiciel Sun ONE Application Server 7 vers la version Sun ONE Application Server 7, Update 3, vous souhaiterez s�lectionner les archives de mise � niveau sur le site de t�l�chargement. Des instructions compl�tes sur la mise � niveau vers Sun ONE Application Server, Update 3 sont contenues dans le document Sun ONE Application Server Installation Guide, disponible � l’adresse suivante :

http://docs.sun.com/db/prod/s1.asse


Remarque

Le programme de mise � jour n’est pas disponible pour le chinois simplifi� et le japonais. Ainsi, si vous effectuez une mise � niveau d’une installation existante vers Sun ONE Application Server 7, Update 3 en chinois simplifi� ou en japonais, vous devrez utiliser le programme de d�sinstallation pour d�sinstaller la version existante du logiciel Sun ONE Application Server, puis effectuer une installation compl�te du logiciel Sun ONE Application Server 7, Update 3. Les instructions compl�tes sont disponibles dans le manuel Sun ONE Application Server Installation Guide.



Probl�mes et limites connus

Cette section d�crit les probl�mes connus et les palliatifs associ�s au produit Sun ONE Application Server 7, Update 3.


Remarque

Si une d�claration de probl�me ne pr�cise pas de plate-forme particuli�re, cela signifie que le probl�me s’applique � toutes les plates-formes.


Ces informations sont regroup�es dans les sections ci-dessous :

Installation et d�sinstallation

Cette section d�crit les probl�mes connus d’installation et de d�sinstallation, et les solutions associ�es.

ID

R�sum�

4403166

Sous Microsoft Windows, les noms de package/chemin/application d’une longueur sup�rieure � 255 caract�res ne permettent pas de d�ployer les applications.

Sous Microsoft Windows uniquement, les noms longs de package/chemin ne sont pas pris en charge en raison de la limitation JDK™. Lors du d�ploiement, l’outil de d�ploiement essaiera d’extraire le fichier de classe � partir des archives. Si le nom d�velopp� contient plus de 255 caract�res, l’extraction �chouera.

  • Exemple d’un nom long d’application :

Nom d’application J2EE tel que servlet_jsh_HttpServletRequestWrapper.ear

  • Exemple de nom long de package :

Le servlet se trouve dans le package suivant :

servlet_jsh_HttpServletRequestWrapper_1\
servlet_jsh_HttpServletRequestWrapper_servlet_war\WEB-INF\classes\tests\
javax_servlet_http\HttpServletRequestWrapperHttpServletRequestWrapperConstructorTestServlet.class

  • Exemple de nom long de chemin :

Sun ONE Application Server est install� sous lecteur\:> Sun \ApplicationServer

Solution

Consid�rez les solutions suivantes :

1.  R�duisez la structure de r�pertoires pendant l’installation. Par exemple, lecteur:>App\ au lieu de l’emplacement par d�faut lecteur:\>Sun\Apsserver7.

2.  Utilisez la commande create_instance pour renommer l’instance et raccourcir son nom. Par exemple, /instance1/domain1/ peut �tre modifi� en /i/d.

3.  Utilisez des noms de package, des noms de chemin et des noms d’application plus courts.

4687768

Sous Solaris setup-SDK/JDK, une erreur se produit lors de l’installation en mode ligne de commande sur un ordinateur sans Xwindows.

Il est impossible d’ex�cuter le programme d’installation du logiciel Sun ONE Application Server, m�me en mode ligne de commande, sur un syst�me Solaris mat�rialis� ne contenant pas de biblioth�ques X Windows. L’installateur �met java.lang.UnsatisfiedLinkError lors de l’instanciation des objets AWT utilis�s par le cadre de travail de l’installateur de l’assistant SetupSDK/Webstart.

Solution

1.  Installez temporairement les packages de prise en charge X Windows, puis supprimez-les une fois le produit Sun ONE Application Server install�.

2.  Installez les packages Sun ONE Application Server � l’aide de la commande pkgadd, puis cr�ez le domaine initial � l’aide de commandes asadmin.

4719600

Des messages d’avertissement apparaissent pendant l’installation.

Pendant l’installation, certains messages d’erreur non valides peuvent �tre affich�s. Par exemple :

AVERTISSEMENT : Impossible de purger les pr�f�rences du syst�me : java.util.prefs.BackingStoreException : Impossible de verrouiller le fichier.
AVERTISSEMENT : Impossible de verrouiller le code d’erreur -223460600 Unix des pr�f�rences du syst�me.

Solution

Ignorez ces avertissements ou cr�ez un r�pertoire de pr�f�rences syst�me (par exemple, /etc/.java/.systemPrefs). Normalement, le script d’installation JDK effectue cette op�ration.

4737663

Sous Solaris, si vous installez l’installation bas�e sur le package et l’installation r�guli�re, un conflit se produit.

Si vous installez l’installation bas�e sur le package (int�gr� � Solaris 9) et la version du programme d’installation principal du produit, des conflits potentiels peuvent se produire. Le courtier de Sun ONE Message Queue pour ces deux installations sera partag�. Ainsi, si vous n’affectez pas un nom unique aux domaines et aux instances, les messages suivants peuvent s’afficher lors du d�marrage de la deuxi�me instance avec le m�me nom de domaine/instance :

GRAVE : JMS5024 : Le d�marrage du service JMS a �chou�.
GRAVE : CORE5071 : Une erreur s’est produite pendant l’initialisation.

En particulier, les noms de domaine et d’instance par d�faut sont les m�mes pour ces deux installations.

Solution

Suivez les instructions fournies dans le chapitre � JMS Administration � du manuel Sun ONE Application Server Administrator’s Guide.

4742038

Sun ONE Application Server ne d�marre pas si le r�pertoire d’installation contient des caract�res non-alphanum�riques.

Le d�marrage du logiciel Sun ONE Application Server �choue si le r�pertoire d’installation contient des caract�res tels que #, des espaces ou tout autre caract�re non-alphanum�rique. Dans ce cas, les fichiers journaux du serveur ne sont pas cr��s. Le r�pertoire d’installation du logiciel Sun ONE Application Server peut contenir uniquement les caract�res suivants : alphanum�riques, - (tiret) ou _ (soulignement). Cela s’applique �galement � la saisie du r�pertoire Java 2 SDK existant pendant l’installation.

Solution

Pendant l’installation, sp�cifiez un r�pertoire dans lequel les noms contiennent uniquement des caract�res alphanum�riques, des tirets ou des caract�res de soulignement.

4742828

Le programme d’installation silencieuse ne v�rifie pas les permissions d’utilisateur.

Bien que les installateurs interactifs (interface graphique utilisateur ou ligne de commande) v�rifient les permissions d’utilisateur appropri�es (utilisateur administrateur pour les plates-formes Microsoft Windows et utilisateur root pour l’installation bas�e sur le package Solaris), cette v�rification n’a pas lieu pendant l’installation silencieuse. Par cons�quent, l’installation �choue ult�rieurement dans le processus car vous n’avez pas de permissions suffisantes pour installer des packages (Solaris) ou cr�er des services (Microsoft Windows).

Solution

Assurez-vous que l’installation silencieuse est ex�cut�e pour l’utilisateur appropri�.

4741190

Sous Solaris, le programme d’installation accepte la valeur JDK_LOCATION m�me si l’emplacement contient une version ant�rieure (ant�rieure � Solaris 1.2).

Sun ONE Application Server 7 requiert une version Java 2 SDK ult�rieure ou �gale � la version 1.4.0_02. Cependant, sous Solaris, si un utilisateur choisit de r�utiliser une version Java 2 SDK existante (ant�rieure � la version 1.2), le programme d’installation peut ne pas afficher un message d’avertissement. L’installation peut se terminer avec succ�s, mais le logiciel Sun ONE Application Server peut ne pas fonctionner correctement. Cela est d� � la pr�sence d’une valeur JAVA_HOME dans votre environnement.

Solution

Avant de d�marrer le programme d’installation, r�initialisez JAVA_HOME de la mani�re suivante :

(Sous ksh) : unset JAVA_HOME
(Sous csh) : unsetenv JAVA_HOME

4742171

L’installation d’une installation de d�veloppement sur une installation d’�valuation existante en mode silencieux ne renvoie pas d’erreur.

Ceci affecte les programmes d’installation ex�cut�s en mode silencieux. Si l’utilisateur tente d’effectuer l’installation alors qu’une version d’�valuation de Sun ONE Application Server 7 est d�j� install�e (dans le m�me r�pertoire), l’installation silencieuse ne renvoie pas d’erreur et continue normalement. Les fichiers de l’installation d’�valuation existants sont conserv�s.

Solution

D�sinstallez les installations d’�valuation existantes avant d’installer une nouvelle installation de d�veloppement au m�me endroit.

4742552

La s�lection d’Application Server et des composants Sun ONE Studio 4 Enterprise Edition pour Java au cours de la m�me session d’installation en modes silencieux et ligne de commande ne fonctionne pas correctement.

Ceci affecte les installations d’exploitation et de d�veloppement. Lors de l’ex�cution de l’installation en mode silencieux ou ligne de commande, vous pouvez choisir d’installer le serveur d’applications et le support pour Sun ONE Studio 4, Enterprise Edition pour les composants Java durant la m�me session d’installation (en mode Interface graphique utilisateur, ces composants s’excluent mutuellement). Le programme d’installation ne traite pas correctement la d�pendance du composant et tente d’installer le composant Client d’administration au lieu du composant Sun ONE Application Server s�lectionn�.

Solution

Lors de la simulation du mode Interface graphique utilisateur, installez d’abord le composant du logiciel Sun ONE Application Server en mode silencieux ou ligne de commande, puis ex�cutez une autre installation et installez la prise en charge de Sun ONE Studio.

N/A

Sous Solaris, si le programme d’installation de Sun ONE Application Server effectue une mise � niveau de Sun ONE Message Queue 3.0 vers la version 3.0.1, l’installation g�n�r�e est supprim�e pendant la d�sinstallation du logiciel Sun ONE Application Server.

Ceci affecte le programme d’installation d’exploitation et de d�veloppement Solaris. Si une installation du logiciel Sun ONE Message Queue 3.0 est d�tect�e sur le syst�me, vous pouvez automatiquement la mettre � niveau vers la version 3.0.1. Si vous choisissez cette option, l’installation de Sun ONE Message Queue 3.0.1 g�n�r�e est d�sinstall�e pendant la d�sinstallation du logiciel Sun ONE Application Server.

Solution

Pour conserver l’installation du logiciel Sun ONE Message Queue apr�s la d�sinstallation du logiciel Sun ONE Application Server :

1.  Quittez le programme d’installation � l’invite de s�lection de la mise � niveau automatique.

2.  Mettez � niveau Sun ONE Message Queue vers la version 3.0.1 comme l’indique la documentation de Sun ONE Message Queue.

3.  Ex�cutez � nouveau l’installation du logiciel Sun ONE Application Server.

4746410

Sous Solaris, lors de l’installation du logiciel Sun ONE Application Server � des emplacements autres que ceux propos�s par d�faut, le programme d’installation bas� sur le package sous Solaris ne v�rifie pas l’espace disque aux emplacements corrects.

Lors de la tentative d’installation du logiciel Sun ONE Application Server sous Solaris (� l’aide du programme d’installation bas� sur le package) � des emplacements autres que ceux propos�s par d�faut, le programme d’installation ne v�rifie pas l’espace disque dans le r�pertoire cible sp�cifi�. Par contre, il v�rifie l’espace disque uniquement � l’emplacement par d�faut (/opt).

Solution

Avant de d�marrer l’installation, assurez-vous de disposer de l’espace disque suffisant (85 Mo) dans /opt m�me si vous n’avez pas pr�vu d’installer le produit dans /opt. De plus, veillez � disposer d’un espace disque suffisant (85 Mo) dans le r�pertoire cible.

4748404

Sous Microsoft Windows XP, impossible d’installer progressivement des exemples d’applications et des composants PointBase 4.2.

Ce probl�me affecte la plate-forme Windows XP. Si vous tentez d’installer progressivement des exemples d’applications et/ou des composants PointBase 4.2 sur un composant Sun ONE Application Server install�, le programme d’installation ne d�tecte pas correctement l’installation existante du logiciel Sun ONE Application Server et renvoie l’erreur Application Server introuvable. L’installation est interrompue.

Solution

Installez les exemples d’applications et les composants PointBase 4.2 avec le composant du logiciel Sun ONE Application Server. Si le logiciel Sun ONE Application Server est d�j� install� sur le syst�me, d�sinstallez-le et ex�cutez � nouveau l’installation, en s�lectionnant tous les composants n�cessaires.

4748455

Une erreur de r�pertoire se produit lors de l’installation silencieuse g�n�rique.

Ce probl�me affecte l’installation silencieuse sur toutes les plates-formes. Si le programme d’installation rencontre un probl�me li� � un r�pertoire d’installation donn�, le message d’erreur g�n�rique R�pertoire d’installation non valide s’affiche. Ce message d’erreur se rapporte aux situations suivantes :

  • Le r�pertoire s�lectionn� n’est pas modifiable.
  • La cha�ne de r�pertoire s�lectionn�e est vide ou contient des espaces.

Solution

V�rifiez la valeur du r�pertoire d’installation fournie pour les deux probl�mes afin de d�terminer la cause de l’erreur.

4749033

Sous Microsoft Windows XP, impossible de d�sinstaller une installation de client d’administration autonome � l’aide du programme de d�sinstallation.

Ce probl�me affecte une installation client d’administration autonome sur la plate-forme Windows XP. Si l’utilisateur tente de d�sinstaller un client d’administration autonome via le programme de d�sinstallation fourni, la d�sinstallation tente de d�sinstaller un ensemble incorrect de composants et se bloque.

Solution

D�sinstallez manuellement un client d’administration autonome. Les fichiers plac�s dans le r�pertoire install_dir doivent �tre supprim�s. Le dossier Groupe de programmes associ� (D�marrer -> Programmes -> Sun Microsystems -> Sun ONE Application Server) doit �galement �tre supprim�. Aucune entr�e de registre Microsoft Windows ne correspond � un composant client d’administration autonome ; ces �tapes ram�nent enti�rement le syst�me � son �tat initial avant l’installation du client d’administration.

4749666

Les exemples de documentation ne sont pas publi�s vers l’instance de serveur initiale si le composant d’exemples d’applications a �t� install� progressivement.

Ce probl�me affecte le programme d’installation d’exploitation et de d�veloppement sur toutes les plates-formes. Si des exemples d’applications sont install�s lors d’une session d’installation distincte sur un logiciel Sun ONE Application Server install�, l’exemple de documentation n’est pas publi� sur l’instance de serveur initiale et n’est pas accessible via l’URL http://hostname:port/samples. Cependant, la documentation est install�e sur le syst�me de fichiers et est accessible localement � l’emplacement suivant : file:///racine_installation/samples/index.html

Solution

Acc�dez localement aux exemples de documentation.

4754256

Sous Solaris, les fichiers de configuration de Sun ONE Message Queue ne sont pas conserv�s pendant la mise � niveau de Sun ONE Message Queue effectu�e par le programme d’installation.

Si un package Sun ONE Message Queue 3.0 existant a �t� d�tect� sur le syst�me, le programme d’installation propose de le mettre � niveau vers la version 3.0.1 qui peut �tre utilis�e par le logiciel Sun ONE Application Server. Pendant cette op�ration de mise � niveau, les packages 3.0 Solaris existants sont supprim�s, ce qui entra�ne la suppression des fichiers de configuration suivants :

/etc/imq/passwd
/etc/imq/accesscontrol.properties

Si ces fichiers ont �t� modifi�s, ces modifications sont perdues et l’installation de Sun ONE Message Queue 3.0.1 g�n�r�e contient les valeurs de configuration par d�faut.

Solution

Cr�ez une copie de sauvegarde de tous les fichiers modifi�s par l’utilisateur et restaurez les copies de sauvegarde des fichiers une fois la mise � niveau termin�e. Pour plus de d�tails, consultez le manuel Sun ONE Message Queue 3.0 Installation Guide.

4754824

Sous Solaris, un message d’erreur du programme d’installation s’affiche pendant l’ex�cution de l’installation � partir d’un CD.

Lorsqu’un volume est ins�r� dans le lecteur de CD-ROM, la gestion de volume Solaris lui attribue le nom symbolique suivant. Par exemple, si deux CD-ROM correspondent � l’expression r�guli�re par d�faut, ils sont appel�s cdrom0 et cdrom. Celui qui correspond � l’expression r�guli�re ajout�e est appel� cdrom2. Cela est document� sur la page man vold.conf. À chaque installation du logiciel Sun ONE Application Server � partir du CD, le point de montage du CD-ROM ajoute un nombre apr�s le nom de l’�tiquette. La premi�re fois que le CD est mont�, tout se passe bien. Aux montages suivants, le message d’erreur suivant s’affiche lors du d�marrage du programme d’installation :

IOException:java.io.FileNotFoundException: /cdrom/appserver7 (Pas de fichier ou de r�pertoire correspondant) lors du chargement par d�faut du fichier flavormap.properties URL:file:/cdrom/appserver7#4/AppServer7/pkg/jre/lib/flavormap.properties

Solution

Le fonctionnement du programme d’installation n’est en aucun cas affect�. Cependant, le palliatif suivant existe :

1.  Devenez le super-utilisateur en entrant la commande su et le mot de passe racine � l’invite de commande ou connectez-vous comme racine. L’invite de commande devient le symbole di�se (#).

2.  Si le r�pertoire /cdrom n’existe pas d�j�, entrez la commande suivante pour le cr�er :

   # mkdir /cdrom

3.  Montez le lecteur de CD-ROM.

REMARQUE : Le processus vold g�re le lecteur de CD-ROM et effectue le montage. Le CD-ROM peut automatiquement effectuer le montage sur le r�pertoire /cdrom/cdrom0.

Si vous ex�cutez le Gestionnaire de fichiers, une fen�tre Gestionnaire de fichiers distincte affiche le contenu du CD-ROM.

4.  Si le r�pertoire /cdrom/cdrom0 est vide car le CD-ROM n’est pas mont� ou que le Gestionnaire de fichiers n’ouvre pas une fen�tre affichant le contenu du CD-ROM, v�rifiez que le d�mon vold s’ex�cute en entrant :

   # ps -e | grep vold | grep -v grep

5.  Si vold s’ex�cute, le syst�me affiche le num�ro d’identification du processus de vold. Si le syst�me n’affiche rien, arr�tez le d�mon en entrant ce qui suit :

   # ps -ef | grep vold | grep -v grep

6.  Arr�tez le processus vold en entrant :

   # kill -15 process_ID_number

7.  Montez manuellement le CD-ROM :

   # mount -F hsfs -r ro /dev/dsk/cxtyd0sz /cdrom/cdrom0

o� x est le num�ro du contr�leur du lecteur de CD-ROM, y le num�ro d’ID SCSI du lecteur de CD-ROM et z la tranche de partition sur laquelle se trouve le CD-ROM.

Vous avez maintenant mont� le lecteur de CD-ROM. Reportez-vous � la section d’installation et de configuration du CD 1 sous Solaris pour conna�tre les proc�dures d’installation.

4755165

Sous Microsoft Windows, le fonctionnement du programme d’installation est affect� si les r�f�rences de l’utilisateur administrateur sont fournies uniquement lors de l’ex�cution de setup.exe.

Ce probl�me affecte toutes les installations sur les plates-formes Microsoft Windows. Si un utilisateur est connect� sans privil�ges administrateur, il est invit� � entrer les r�f�rences de l’administrateur pendant la tentative d’ex�cution du fichier setup.exe. Si l’utilisateur saisit les r�f�rences correctes, le programme d’installation qui doit v�rifier les privil�ges de l’utilisateur est satisfait et l’installation continue. Cependant, certaines fonctions du programme d’installation seront affect�es :

  • Le programme d’installation se bloque si le bouton Parcourir est s�lectionn� sur l’�cran de s�lection du r�pertoire d’installation.
  • Les entr�es du groupe de programmes pour les �l�ments du logiciel Sun ONE Application Server risquent de ne pas �tre cr��es.

Solution

Connectez-vous comme utilisateur dot� des privil�ges d’administrateur lorsque vous effectuez l’installation.

4757687

Sous Solaris, une installation progressive du composant du logiciel Sun ONE Application Server sur le syst�me peut �tre inutilisable si un composant Client d’administration y est d�j� install�.

Ce probl�me affecte l’installation bas�e sur le package Solaris sur une plate-forme Solaris. Si un utilisateur tente d’installer le composant du logiciel Sun ONE Application Server sur le syst�me o� un composant autonome Client d’administration est d�j� install� et qu’il s�lectionne un r�pertoire d’installation diff�rent de celui utilis� � l’origine pour l’installation du client d’administration, l’installation r�sultante du logiciel Sun ONE Application Server est inutilisable m�me si un message vous indique qu’elle a abouti. Cela est d� au fait que les packages Solaris du client d’administration seront d�tect�s comme �tant d�j� install�s sur le syst�me et qu’ils ne seront pas install�s en tant que partie de l’installation du logiciel Sun ONE Application Server. Ainsi, des fichiers essentiels au fonctionnement du produit seront manquants.

Solution

D�sinstallez le client d’administration autonome avant de tenter d’installer le logiciel Sun ONE Application Server sur le m�me syst�me Solaris.

Vous pouvez �galement tenter une installation progressive mais le r�pertoire d’installation qui a �t� utilis� pour l’installation du client d’administration doit �tre s�lectionn� lors de l’installation suivante du logiciel Sun ONE Application Server.

4762118

Sous Solaris, l’installation �choue si un r�pertoire de configuration personnalis� s�lectionn� est un sous-r�pertoire du r�pertoire d’installation s�lectionn� et est appel� � etc �.

Ce probl�me affecte l’installation bas�e sur le package Solaris sur une plate-forme Solaris. Si la combinaison suivante d’emplacements de r�pertoires personnalis�s a �t� s�lectionn�e, l’installation �choue en pr�sence d’informations de propri�t� du groupe incompatibles pour le m�me r�pertoire :

  • R�pertoire d’installation : r�p_install
  • R�pertoire de configuration : r�p_install/etc

Le fichier journal pkgadd dans le r�pertoire /var/sadm/install/logs contient le message d’erreur suivant :

pkgadd : ERREUR : doublon de nom de chemin /r�p_install/etc
pkgadd : ERREUR : impossible de traiter pkgmap

Solution

S�lectionnez un r�pertoire de configuration personnalis� diff�rent de r�p_install/etc.

4724612

Sous Solaris SPARC et Linux, les scripts de l’interpr�teur de commandes PointBase �chouent si une autre personne que l’utilisateur effectuant l’installation les ex�cute.

Ce probl�me affecte uniquement l’installation d’�valuation. Tous les scripts de l’interpr�teur de commandes PointBase sont d�finis pour ex�cuter l’autorisation uniquement pour l’utilisateur effectuant l’installation.

Solution

Si des utilisateurs autres que la personne ayant install� le produit doivent ex�cuter ces scripts, modifiez les autorisations en leur attribuant la valeur 0755.

4762694

Sous Solaris, le SUNWiqsup du package Sun ONE Message Queue n’est pas supprim� pendant le processus de mise � niveau de Message Queue.

Ceci est un probl�me propre � Solaris. Le processus d’installation du logiciel Sun ONE Application Server 7 implique l’installation de Sun ONE Message Queue version 3.0.1. Sous Solaris, si Sun ONE Message Queue version 3.0 est d�tect�, il est d’abord d�sinstall� (apr�s confirmation de l’utilisateur) et la version 3.0.1 est install�e.

Un probl�me de nettoyage mineur emp�che le programme d’installation Solaris de supprimer l’un des packages Solaris (SUNWiqsup) pour Sun ONE Message Queue 3.0 en tant que partie de ce processus de mise � niveau. La pr�sence de ce package est sans danger et n’affecte pas Sun ONE Message Queue ni Sun ONE Application Server 7.

Solution

Supprimez manuellement le package SUNWiqsup � l’aide de la commande suivante (en tant que root) :

# pkgrm SUNWiqsup

4890289

Sous Windows 2000 Pro, le programme de d�sinstallation ne parvient pas � trouver le kit JDK pour ex�cuter la d�sinstallation.

Sous Windows 2000 Pro, la d�sinstallation �choue et le message suivant est affich� :

Le programme de d�sinstallation n'a pas r�ussi � trouver de kit j2sdk adapt� pour ex�cuter la d�sinstallation. R�ex�cutez la d�sinstallation en s�lectionnant pour l'option -javahome le r�pertoire dans lequel j2sdk 1.4.0_02, ou version ult�rieure, est install�. Appuyez sur Entr�e pour quitter.

Solution

Utilisez l’emplacement JDK de -javahome.

N/A

Sous Red Hat Enterprise Linux AS 3.0, vous devez installer compat-libstdc++ (biblioth�ques C++ standard pour la compatibilit� ascendante) avant d’installer Sun ONE Application Server.

Solution

Installez compat-libstdc++ avant d’installer Sun ONE Application Server. Ces biblioth�ques sont incluses dans le jeu de CD Red Hat Enterprise Linux AS 3.0.

D�marrage et arr�t du serveur

Cette section d�crit les probl�mes connus de d�marrage et d’arr�t et les solutions associ�es.

Comportement de l’attribut de la console de cr�ation du service de journal

Sous Microsoft Windows, lorsque l’attribut create-console de l’�l�ment log-service dans server.xml est d�fini sur vrai (le param�tre par d�faut), une fen�tre affichant le contenu du journal des �v�nements du serveur s’affiche sur le bureau. De par la conception du produit, la fermeture de cette fen�tre ne g�n�re pas un arr�t d�finitif du processus d’instance du serveur d’applications. La fermeture de la fen�tre de la console met fin au processus appservd.exe, mais le processus de surveillance (appservd-wdog.exe) red�marre imm�diatement le processus d’instance du serveur.

Pour les d�veloppeurs, la fermeture de la fen�tre du journal des �v�nements d’une instance peut servir � red�marrer rapidement l’instance du serveur d’applications.

Cependant, pour arr�ter compl�tement l’instance du serveur d’applications (en m�me temps que le processus de surveillance d’accompagnement), utilisez l’une des m�thodes suivantes :

À l’aide de la console Admin, vous pouvez activer/d�sactiver la fen�tre du journal des �v�nements de la console en modifiant le param�tre Cr�er console de l’onglet Journalisation de l’instance du serveur d’applications.

ID

R�sum�

4725893

Sous Solaris, les informations d’expiration de licence ne sont pas affich�es.

Affecte les licences d’�valuation Solaris SPARC. Les informations d’avertissement concernant l’expiration imminente de la licence (14 jours ou moins avant l’expiration) ne sont pas rapport�es via l’interface de ligne de commande et les interfaces bas�es sur l’explorateur. Les avertissements s’affichent cependant dans les fichiers journaux du serveur.

Solution

V�rifiez les fichiers journaux du serveur.

4738648

Le d�marrage du service JMS/Sun ONE Application Server a �chou�.

Si le fournisseur JMS (courtier de Sun ONE Message Queue) a un nombre important de messages persistants non transmis, un �chec d’initialisation du logiciel Sun ONE Application Server peut se produire en raison des probl�mes suivants :

1.  En tentant de charger tous les messages en attente, le courtier MQ peut manquer de m�moire et abandonner.

Solution

Utilisez davantage d’espace heap Java pour le processus du courtier MQ. Pour cela, d�finissez l’attribut Arguments de d�marrage du service JMS sur -vmargs -Xmx256m.

La proc�dure de param�trage de cet attribut est d�crite dans le chapitre � Using the JMS Service � du manuel Sun ONE Application Server Administrator’s Guide.

2.  Si le courtier MQ ne peut pas terminer sa s�quence d’initialisation dans un certain d�lai, le logiciel Sun ONE Application Server se d�connecte automatiquement et abandonne.

Solution

Augmentez la valeur de l’attribut du d�lai d’inactivit� au d�marrage du service JMS. La proc�dure de param�trage de cet attribut est d�crite dans le chapitre � Using the JMS Service � du manuel Sun ONE Application Server Administrator’s Guide.

4762420

Les r�gles du pare-feu peuvent provoquer des �checs de d�marrage du logiciel Sun ONE Application Server.

Si vous avez install� un pare-feu personnel, vous pouvez rencontrer ce probl�me. La pr�sence de r�gles de pare-feu strictes sur un ordinateur sur lequel est install� le logiciel Sun ONE Application Server peut provoquer des �checs de d�marrage des instances du serveur d’administration et du serveur d’applications. Les instances du serveur d’administration et du serveur d’applications tentent particuli�rement d’�tablir des connexions locales dans l’environnement du logiciel Sun ONE Application Server. �tant donn� que ces tentatives de connexion acc�dent aux ports � l’aide du nom d’h�te du syst�me plut�t qu’avec l’h�te local, les r�gles du pare-feu local peuvent bloquer de telles tentatives.

Le pare-feu local peut �galement g�n�rer involontairement des alertes indiquant que l’attaque � Portal of Doom Trojan � (par exemple, tentatives de connexion TCP sur le port 3700) ou des attaques similaires se sont produites lorsque de telles tentatives d’acc�s ont �t� effectu�es par le logiciel Sun ONE Application Server et ne menacent aucunement la s�curit� de votre ordinateur. Dans certaines conditions, le num�ro de port utilis� par le logiciel Sun ONE Application Server pour diverses communications locales peut chevaucher les num�ros de ports utilis�s dans les attaques connues. Voici certains sympt�mes de ce probl�me :

  • Une tentative de d�marrage du logiciel Sun ONE Application Server � l’aide de l’�l�ment du groupe de programmes Microsoft Windows � D�marrer Application Server � �choue et le message suivant est renvoy� :

   Impossible de d�marrer l’instance : domain1:admin-server
   le d�marrage du serveur a �chou� : arr�t du sous-processus anormal
   ...

  • Les fichiers journaux d’instance du serveur et d’administration contiennent des exceptions de connexion suivies de ce message : CORE3186 : La configuration a �chou�

Solution

Modifiez la strat�gie de pare-feu pour permettre au logiciel Sun ONE Application Server d’effectuer des tentatives de connexion vers les ports du syst�me local.

Pour �viter des alertes impr�cises concernant des attaques possibles, modifiez les r�gles pertinentes ou changez le ou les num�ros de port conflictuels utilis�s par le logiciel Sun ONE Application Server.

Pour d�terminer les num�ros de port utilis�s par les instances du serveur d’administration et du serveur d’applications, reportez-vous au fichier server.xml situ� � l’emplacement d’installation suivant du logiciel Sun ONE Application Server :

   r�p_config_domaine/domain1/admin-server/config/server.xml
   
r�p_config_domaine/domain1/server1/config/server.xml

o� r�p_config_domaine correspond � l’emplacement de la configuration initiale du serveur. Par exemple :

Microsoft Windows : r�p_install/domains/...
Installation int�gr�e Solaris versions 9 et ult�rieures : /var/appserver/domains/...
Installation s�par�e Solaris versions 8, 9 et ult�rieures : /var/opt/SUNWappserver7/domains/...

Recherchez les param�tres du port dans les �l�ments <iiop-listener> et <jms-service>. Vous pouvez remplacer ces num�ros de ports par d’autres num�ros de ports non utilis�s ou vous pouvez modifier la strat�gie de pare-feu pour permettre des tentatives de connexion � partir des clients de la machine locale vers les num�ros de ports de la m�me machine.

4780076

Sous Solaris, le logiciel Sun ONE Application Server d�marre toutes les instances en tant que root, ce qui permet aux utilisateurs non root de disposer d’un acc�s root.

Il existe plusieurs probl�mes associ�s au d�marrage du serveur de l’application lorsque le logiciel Sun ONE Application Server est install� dans le cadre d’une installation (int�gr�e) Solaris :

  • Toutes les instances du serveur d’administration et du serveur d’applications d�marrent automatiquement au d�marrage du syst�me Solaris. Dans plusieurs environnements, toutes les instances ne d�marrent pas automatiquement au d�marrage du syst�me Solaris. Le d�marrage de chaque instance d�finie peut affecter de fa�on d�favorable la m�moire disponible sur un syst�me.
  • Lorsque les instances du serveur d’applications et celles du serveur d’administration sont d�marr�es automatiquement, le script de d�marrage pour chaque instance est ex�cut� en tant que root. L’ex�cution de scripts de d�marrage d’instances poss�d�s non root peut donner aux utilisateurs non root l’acc�s � l’utilisateur root par la modification des scripts de d�marrage de l’instance.

Informations de r�f�rence

Durant l’installation du logiciel Sun ONE Application Server dans le cadre d’une installation Solaris, le script /etc/init.d/appserv et les liens symboliques pointant vers les scripts S84appserv et K05appserv dans les r�pertoires /etc/rc*.d/ sont install�s. Au d�marrage et � l’arr�t du syst�me Solaris, ces scripts d�clenchent le d�marrage et l’arr�t automatique de toutes les instances du serveur d’administration et du serveur d’applications d�finies comme faisant partie de l’installation du serveur d’applications.

Le script /etc/init.d/appserv contient la section de code suivante :

...
case "$1" in
'start')
    /usr/sbin/asadmin start-appserv
    ;;
'stop')
    /usr/sbin/asadmin stop-appserv
    ;;
...

L’ex�cution de la commande asadmin start-appserv d�clenche le d�marrage de l’instance du serveur d’administration et de toutes les instances du serveur d’applications d�finies dans tous les domaines d’administration au d�marrage du syst�me Solaris. �tant donn� que les scripts de d�marrage et d’arr�t du syst�me sont ex�cut�s en tant que root, le script de d�marrage de chaque instance du serveur d’administration et du serveur d’applications est �galement ex�cut� en tant que root. Le script de d�marrage du niveau de l’instance s’appelle startserv et se situe dans r�p-instance/bin/startserv. �tant donn� que des instances peuvent appartenir � des utilisateurs non root, les scripts startserv peuvent �tre modifi�s par l’utilisateur non root de sorte � ex�cuter des commandes comme si elles �taient �mises par l’utilisateur root.

Dans les cas o� une instance utilise un port r�seau privil�gi�, le script startserv de l’instance doit �tre ex�cut� comme root. Cependant, dans ces cas, � Ex�cuter en tant qu’utilisateur � est g�n�ralement d�fini dans la configuration de l’instance pour obliger celle-ci � s’ex�cuter comme l’utilisateur sp�cifi� apr�s le d�marrage initial de l’instance par l’utilisateur root.

4780076
(suite)

Solution

Appliquez l’une des solutions suivantes selon votre environnement :

  • Si l’environnement ne requiert pas que toutes les instances du serveur d’administration et du serveur d’applications soient d�marr�es comme root, vous devez mettre en commentaire l’ex�cution des commandes asadmin start-appserv et asadmin stop-appserv dans le script etc/init.d/appserv.
  • Si l’environnement requiert le d�marrage de domaines d’administration sp�cifiques (notamment l’instance du serveur d’administration et toutes les instances du serveur d’applications de chaque domaine) ou d’instances sp�cifiques dans un ou plusieurs domaines d’administration, vous devez modifier le script /etc/init.d/appserv pour d�marrer les domaines et/ou les instances d’int�r�t ou d�finir de nouveaux scripts /etc/rc*.d/ qui correspondent aux besoins de l’environnement.
  • D�marrage d’un domaine sp�cifique. Si vous devez d�marrer un domaine d’administration ou des instances sp�cifiques en tant qu’utilisateur non root, vous devez v�rifier que la commande su et l’option -c sont utilis�es pour d�marrer les domaines et/ou les instances d’int�r�t.

Exemples

D�marrage d’un domaine d’administration sp�cifique - Si vous voulez d�marrer l’instance du serveur d’administration et toutes les instances du serveur d’applications d’un domaine d’administration sp�cifique en tant qu’utilisateur root, vous pouvez modifier les scripts /etc/rc*.d/ de la mani�re suivante :

...
case "$1" in
'start')
   /usr/sbin/asadmin start-domain --domain production-domain
   ;;

'stop')
   /usr/sbin/asadmin stop-domain --domain production-domain
   ;;
...

4780076
(Suite)

  • Si vous voulez d�marrer des instances du serveur d’applications sp�cifiques comme utilisateur non root, modifiez les scripts /etc/rc*.d/ pour utiliser la commande su avec l’option -c :

...
case "$1" in
'start')
   su - usera -c "/usr/sbin/asadmin start-instance --domain test-domain instance-a"
   su - userb -c "/usr/sbin/asadmin start-instance --domain test-domain instance-b"
   ;;

'stop')
   su - usera -c "/usr/sbin/asadmin stop-instance --domain test-domain instance-a"
   su - userb -c "/usr/sbin/asadmin stop-instance --domain test-domain instance-b"
   ;;
...

Pour plus d’informations sur les commandes de d�marrage et d’arr�t disponibles via l’interface de ligne de commande asadmin, reportez-vous au manuel Sun ONE Application Server Administrator’s Guide.

Pilote de base de donn�es

Cette section d�crit les probl�mes connus du pilote de base de donn�es et les solutions associ�es.

ID

R�sum�

4700531

Sous Solaris, une erreur de pilote JDBC ORACLE se produit.

Ce nouveau pilote JDBC (Java Database Connectivity) est con�u pour Oracle (R) fonctionnant avec JDK1.4. Le probl�me est d� � une association de la base de donn�es Oracle 9.1 et de ojdbc14.jar. L’application du correctif r�gle le probl�me sur la machine 32 bits Solaris en ex�cutant une base de donn�es Oracle 9.0.1.3.

Solution

Procurez-vous et appliquez le correctif sur votre serveur � partir du site Web Oracle pour le bogue 2199718. Proc�dez comme suit :

1.  Acc�dez au site Web Oracle.

2.  Cliquez sur le bouton d’acc�s aux correctifs.

3.  Entrez 2199718 dans le champ du num�ro de correctif.

4.  Cliquez sur le correctif SE Solaris 32 bits. Rendez-vous � l’adresse Metalink.oracle.com.

5.  Cliquez sur les correctifs.

6.  Sous le num�ro de correctif, entrez 2199718.

7.  Cliquez sur le correctif SE Solaris 32 bits.

4707531

Sous Solaris, l’acc�s � une base de donn�es Oracle 9.1 avec un client Oracle 9.2 peut causer une alt�ration des donn�es.

Si vous utilisez un client Oracle (R) 9.2 pour acc�der � une base de donn�es Oracle 9.1, l’alt�ration des donn�es peut se produire lorsqu’une colonne de num�ros suit une colonne d’horodatage.

Le probl�me peut �tre provoqu� par l’utilisation du fichier ojdbc14.jar avec une base de donn�es Oracle 9.1. L’application du correctif peut contribuer � corriger le probl�me sur les ordinateurs 32 bits Solaris ex�cutant une base de donn�es Oracle 9.1. Ce pilote JDBC est con�u pour Oracle fonctionnant avec JDK1.4.

Solution

Obtenez le correctif disponible sur le site Web Oracle pour le bogue 2199718 et appliquez-le � votre serveur.

Conteneur Web

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

ID

R�sum�

4740477

L’exemple du cache Web dans le fichier sun-web-app_2_3-0.dtd fournit une syntaxe incorrecte pour l’�l�ment de d�lai.

L’�l�ment timeout est sp�cifi� pour �tre utilis� dans des objets cache XML en tant que :
<timeout> 60 </timeout>

Le param�tre du nom �tant un champ obligatoire, il doit �tre �crit de la fa�on suivante :
<timeout name="foo">60</timeout>

Solution

Ne l’utilisez pas avec le v�rificateur.

4817642

Le fait d’autoriser des applications Web distinctes � partager le m�me ID de session fragilise la s�curit�.

Solution

Selon la sp�cification J2EE, chaque application Web d�ploy�e g�re des objets de session (ID de session) uniques. Ceci est le comportement par d�faut du logiciel Sun ONE Application Server. Toutefois, dans certains cas, il peut �tre souhaitable d’autoriser des applications Web distinctes � partager le m�me ID de session. Dans ce cas, le logiciel Sun One Application Server vous permet d’indiquer une propri�t� de d�ploiement sp�ciale dans le descripteur de d�ploiement sun-web.xml pour indiquer au serveur d’applications que cette application particuli�re est autoris�e � r�utiliser les ID de session lorsqu’elle rencontre des modules d’application Web. (Le premier acc�s � une application Web g�n�re un nouvel ID de session unique. Les requ�tes ult�rieures � d’autres applications Web pour lesquelles cette propri�t� est d�finie utiliseront ce m�me ID de session, au lieu d’en g�n�rer un nouveau pour ce client et cette application Web.)

Pour cela, la propri�t� reuseSessionId doit �tre d�finie sur vrai pour chaque application Web d�ploy�e sur laquelle vous voulez autoriser le partage du m�me objet de session. Par exemple :

<?xml version="1.0" encoding="UTF-8"?>
<sun-web-app>
   <session-config>
     <cookie-properties>
       <property name="cookiePath" value = "/" />
       <property name="cookieDomain" value = ".sun.com" />
    </cookie-properties>
   </session-config>
   <property name="reuseSessionID" value="true"/>
</sun-web-app>

La propri�t� reuseSessionID est d�finie sur vrai de la ligne suivante � la derni�re.

ATTENTION : L’activation de l’option reuseSessionId est un facteur potentiel de fragilisation de la s�curit� (bien qu’elle ne constitue pas une vuln�rabilit� en elle-m�me). Cette propri�t� ne doit pas �tre utilis�e dans un environnement partag� (tel qu’un environnement ISV) dans lequel plusieurs clients sont autoris�s � ex�cuter leurs applications sur la m�me instance de Sun One Application Server. Dans un tel param�trage, il est beaucoup plus s�r d’utiliser le comportement de J2EE par d�faut, qui impose l’utilisation d’objets de session diff�rents pour des applications Web diff�rentes d�ploy�es sur la m�me instance de serveur.

Conteneur EJB

Cette section d�crit les probl�mes connus du conteneur Enterprise JavaBeans™ (EJB™) et les solutions associ�es.

ID

R�sum�

4735835

Impossible de g�rer correctement les cl�s primaires nulles renvoy�es � partir des m�thodes ejbFind.

Les exemples suivants de persistance g�r�e par conteneur (CMP) peuvent renvoyer un ou plusieurs caract�res nuls � partir d’une m�thode ejbFind (appel�e � partir d’un bean EmployeeEJB, car ils doivent renvoyer le m�me type d’instance que le bean EJB) :

1.  find insurance.employee o� insurance.id == 10

Cette derni�re renvoie un caract�re nul si une telle assurance n’est pas associ�e � un employ�.

2.  find all insurance.employee o� insurance.id > 10

Cette derni�re renvoie une collection pouvant contenir des caract�res nuls pour les assurances n’ayant aucun employ�.

Pour la premi�re occurrence d’un PC nul dans la s�rie de r�sultats, le client CMP obtient JDOFatalInternalException � param0 ne peut pas �tre nul �.

Le client BMP obtient EJBException � Cl� primaire nulle renvoy�e � partir de la m�thode ejbFind � pour un seul localisateur d’objet et (�ventuellement) un NullPointerException pour un localisateur multi-objets.

Solution

Aucune.

4744434

Le logiciel Sun ONE Application Server �met occasionnellement une exception de pointeur nul lors de l’utilisation de beans de session avec �tat.

Le conteneur EJB dans le logiciel Sun ONE Application Server met les beans de session avec �tat en m�moire cache pour am�liorer les performances. Lorsque le cache d�borde (c’est-�-dire que le nombre de beans dans le cache exc�de max-cache-size), le conteneur passe en mode passif les beans sur le disque. Occasionnellement, le serveur �met NullPointerException. Le probl�me se produit lorsque la diff�rence entre max-cache-size et cache-resize-quantity est inf�rieure � 8.

Solution

Assurez-vous que la diff�rence entre max-cache-size et cache-resize-quantity est sup�rieure � huit ou utilisez un cache illimit� en d�finissant max-cache-size sur z�ro.

4951476, 4967645

L’exception javax.ejb.EJBException: org/dom4j/Element est �mise lors de l’utilisation de Java WSPD 1.2 ou 1.3

REMARQUE : Si votre application n’utilise pas Java WSDP (Java Web Services Developer Pack ) 1.2 ou 1.3, vous n’�tes pas concern� par ce probl�me.

Lorsque Java WSDP 1.2 ou 1.3 est install� et configur� pour �tre utilis� avec Sun ONE Application Server 7, une exception javax.ejb.EJBException: org/dom4j/Element peut �tre �mise par le conteneur EJB.

Solution

Ajoutez le dernier fichier dom4j-full.jarserver-classpath dans le fichier server.xml. Celui-ci peut �tre t�l�charg� � l’adresse http://dom4j.org et doit pr�c�der l’entr�e appserv-jstl.jar dans server-classpath.

Persistance g�r�e par conteneur

Cette section d�crit les probl�mes connus de la persistance g�r�e par conteneur (CMP) et les solutions associ�es.

ID

R�sum�

4732684

Les optimisations du pilote JDBC Oracle ne sont pas en cours d’initialisation.

Pour b�n�ficier des optimisations de la base de donn�es Oracle (R) avec les beans de persistance g�r�e par conteneur (CMP), le fichier classes12.zip doit �tre sp�cifi� dans l’attribut classpath-suffix du fichier server.xml au lieu d’�tre plac� dans le r�pertoire /lib de l’instance, qui est le r�pertoire par d�faut pour les biblioth�ques de partie tierce.

Solution

Ajoutez le fichier classes12.zip � l’attribut classpath-suffix du fichier server.xml.

4734963

Les CMR d’auto-r�f�rence provoquent un probl�me pendant le d�ploiement.

L’analyseur du descripteur de d�ploiement EJB, ejb-jar.xml, ne g�re pas correctement les relations g�r�es par conteneur d’auto-r�f�rence (CMR), c’est-�-dire ejb-relationship-role. Le champ Un c�t� est ignor�.

Solution

Intervertissez les sections ejb-relationship-role de sorte que le champ Un c�t� (avec <multiplicity> Many) soit le premier dans ejb-relation.

4747222

Sous Oracle, l’utilitaire de sch�ma de capture ne fonctionne pas si –schemaname n’est pas sp�cifi�.

L’utilitaire capture-schema rencontre les probl�mes suivants si l’option -schemaname n’est pas sp�cifi�e lors de la capture des informations du sch�ma de la base de donn�es � partir de la base de donn�es Oracle (R) :

1.  Si vous tentez de capturer toutes les tables (c’est-�-dire que vous ne choisissez aucune table en particulier) :

bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.OracleDriver -out test.dbschema

Vous recevez :
java.sql.SQLExceptions
ORA-00942 : table ou affichage introuvable.

Le fichier de sortie g�n�r� est cass�.

2.  Si une ou plusieurs tables sont sp�cifi�es avec l’option -table :

bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.OracleDriver -table DEPT -out test.dbschema

Le fichier g�n�r� a les tables sp�cifi�es mais aucune information de colonne, ce qui signifie que le fichier ne peut pas �tre utilis� pour le mappage CMP.

Solution

Lors de la capture d’un sch�ma � partir de la base de donn�es Oracle, utilisez toujours l’option -schemaname avec le nom d’utilisateur en lettres majuscules comme valeur :

bin/capture-schema -dburl jdbc:oracle:thin:@oraserver:1521:ora -username scott -password tiger -driver oracle.jdbc.driver.OracleDriver -schemaname SCOTT -out test.dbschema)

4751235

Pour l’utilitaire du sch�ma de capture : Si les valeurs pour l’option -table ne sont pas sp�cifi�es en majuscules sous Oracle et/ou PointBase, le fichier g�n�r� est cass�.

Oracle (R) et PointBase traduisent en interne les identificateurs ne respectant pas la casse en majuscules, except� si l’identificateur est entre " "). L’utilitaire sch�ma de capture ne g�re pas correctement les noms de tables en lettres minuscules ou en lettres minuscules et majuscules comme arguments vers l’option -table lors de la capture d’un sch�ma de base de donn�es � partir d’Oracle ou de PointBase (tel que -table student ou -table Student). Le fichier du sch�ma de base de donn�es g�n�r� ne contient aucune information de colonnes pour la table correspondante.

Solution

Utilisez des lettres majuscules pour sp�cifier les noms de table (tel que -table STUDENT).

Beans Message-Driven et Message Service

Cette section d�crit le JMS (Java Message Service) connu, le logiciel Sun ONE Message Queue, les probl�mes de beans Message-Driven et les solutions associ�es.

ID

R�sum�

4683029

La balise -javahome dans tous les scripts MQ Solaris/Microsoft Windows ne fonctionne pas si la valeur comprend un espace.

Les utilitaires de ligne de commande dans Sun ONE Message Queue ont une option -javahome qui permet de sp�cifier une autre ex�cution Java. L’utilisation de cette option fait appara�tre une limitation; � savoir que le chemin de l’autre ex�cution Java sp�cifi�e ne doit pas comprendre d’espace. Vous trouverez ici des exemples de chemin contenant des espaces :

  • Microsoft Windows : C:\jdk 1.4
  • Solaris : /work/java 1.4

Ce probl�me se produit au d�marrage de l’instance du logiciel Sun ONE Application Server. Lorsqu’une instance du logiciel Sun ONE Application Server d�marre, son instance de courtier Sun ONE Message Queue correspondante par d�faut d�marre �galement. Le courtier d�marre toujours � l’aide de l’option de ligne de commande -javahome pour v�rifier qu’il utilise la m�me ex�cution Java que celle utilis�e par le logiciel Sun ONE Application Server. Si l’ex�cution Java configur�e pour �tre utilis�e par le logiciel Sun ONE Application Server (et donc transmise pour �tre utilis�e par le courtier) se trouve dans un chemin contenant des espaces, le d�marrage du courtier �choue, et il en va de m�me pour le d�marrage de l’instance du logiciel Sun ONE Application Server.

Solution

Assurez-vous que l’ex�cution Java utilis�e par le logiciel Sun ONE Application Server se trouve dans un chemin ne contenant pas d’espace.

Java Transaction Service (JTS)

Cette section d�crit les probl�mes connus du JTS (Java Transaction Service) et les solutions associ�es.

R�cup�ration

Il existe quelques probl�mes connus avec les mises en uvre de r�cup�ration de certains pilotes JDBC. Pour ces probl�mes connus, le logiciel Sun One Application Server fournit quelques palliatifs. Par d�faut, ces palliatifs ne seront pas utilis�s sauf si vous en faites explicitement la demande.

Transactions

Dans le fichier server.xml, res-type est utilis� pour d�limiter la connexion comme non-XA ou XA. Cette d�limitation est utilis�e pour identifier la configuration de la source de donn�es aux donn�es du lecteur. Par exemple, dans le pilote Datadirect, la m�me source de donn�es peut �tre utilis�e comme XA ou comme non-XA.

Le comportement par d�faut de la source de donn�es est non-XA. Pour que la source de donn�es se comporte comme XA avec l’�l�ment connpool pour les transactions, res-type est n�cessaire. Pour que l’�l�ment connpool fonctionne et participe aux transactions, ajoutez ce qui suit pour les attributs res-type dans le fichier server.xml :

res-type="javax.sql.XADataSource"

ID

R�sum�

4689337

La connexion � partir de XADatasource dans un contexte non txn ne peut pas �tre utilis�e.

Il s’agit d’un probl�me connu de pilote de base de donn�es. Lorsqu’il existe une connexion dans un contexte non txn, avec XADataSource Autocommit est d�fini sur faux par d�faut.

Solution

Utilisez la classe de source de donn�es non-XA pour appeler les programmes validation/annulation explicitement plut�t que via des transactions.

4700241

La configuration du d�lai d’attente de la transaction diff�rent de z�ro provoque des transactions locales lentes.

Actuellement, le gestionnaire de transactions local ne prend pas en charge les transactions ayant des d�lais d’attente d�finis. Si vous d�finissez l’attribut timeout-in-seconds dans l’�l�ment transaction-service sur une valeur sup�rieure � 0, toutes les transactions locales sont trait�es comme des transactions globales et leur traitement est plus long. Une transaction locale peut �galement �chouer, si le pilote de la source de donn�es ne prend pas en charge les transactions globales. Une valeur de d�lai d’attente de 0 signifie que le gestionnaire de transactions attendra ind�finiment s’il n’obtient aucune r�ponse d’une source de donn�es participante.

Solution

R�initialisez la valeur timeout-in-seconds sur sa valeur par d�faut de 0.

Compilateur JSP

Cette section d�crit les probl�mes connus relatifs au compilateur JSP et les solutions associ�es.

ID

R�sum�

4930027

La r�solution de ce probl�me de performance JSP implique une interpr�tation plus stricte de la sp�cification JSP que dans les versions pr�c�dentes de Sun ONE Application Server.

Lorsque vous utilisez la balise jsp:useBean dans une page JSP, si l’objet correspondant � l’ID sp�cifi� est introuvable dans l’�tendue indiqu�e, il est cr�� � l’aide de Beans.instantiate(), ind�pendamment des attributs indiqu�s.

Solution

Sun ONE Application Server 7.0 Update 3 introduit une nouvelle option JVM appel�e jasper.compiler.optimized qui optimise le comportement de la balise useBean et met en uvre une interpr�tation plus stricte de la sp�cification JSP. Lorsque la valeur de l’indicateur jasper.compiler.optimized est d�finie sur vrai, les beans sp�cifi�s � l’aide de l’attribut de classe useBean sont instanci�s via un appel vers le nouveau serveur. Les beans indiqu�s � l’aide de l’attribut beanName sont instanci�s par l’interm�diaire d’un appel � Bean.instantiate().

La valeur par d�faut de l’indicateur jasper.compiler.optimized �tant faux, Beans.instantiate() est appel�, que ce soit la classe ou l’attribut beanName qui est sp�cifi� dans la balise useBean.

Pour plus d’informations, reportez-vous � la section 4.1 de la sp�cification JSP 1.2.

D�ploiement de l’application

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

ID

R�sum�

4403166

Sous Microsoft Windows, les noms longs de chemin ne sont pas pris en charge.

Pour plus d’informations sur ce probl�me, reportez-vous � la section � Installation et d�sinstallation � � la page 12.

4703680

Le red�ploiement d’un module EJB (avec MDB) �met une exception de conflit de ressource.

Cela se produit sous Microsoft Windows 2000 � l’aide de Sun ONE Studio 4 lors de l’utilisation de beans Message-Driven (MDB). Si un module EJB contient un MDB qui utilise une file d’attente sp�cifique, le red�ploiement du m�me module EJB avec le m�me MDB (en utilisant la m�me file d’attente) provoque un conflit de ressources. Cela rend le module (modifi�) inutilisable.

Solution

Aucune.

4725147

Impossible de choisir un serveur virtuel particulier pour le d�ploiement.

Dans ce cas, deux serveurs virtuels sont configur�s avec exactement le m�me h�te et le m�me module d’�coute. Si une application est d�ploy�e uniquement pour le deuxi�me serveur virtuel, il ne peut pas �tre atteint car la combinaison h�te/port m�ne au premier serveur virtuel.

Solution

Le nom d’h�te du serveur virtuel ne doit pas �tre le m�me que le nom d’h�te d’origine, en particulier lorsque le m�me module d’�coute HTTP est utilis�.

4734969

Impossible de d�ployer l’application avec la classe de requ�te de l’utilisateur dans le package bean.

Le code-gen de la persistance g�r�e par conteneur (CMP) n’utilise pas le nom pleinement qualifi� pour la variable JDO Query dans concreteImpl. Si vous avez une classe de requ�te dans le m�me package que le bean abstrait, une erreur de compilation se produit.

Solution

D�placez la classe de requ�te vers un autre package ou vers un package distinct.

4750461

Sous Solaris, le logiciel Sun ONE Application Server peut se bloquer pendant le rechargement dynamique.

Pour une application volumineuse (avec de nombreux beans EJB), un blocage peut se produire au rechargement dynamique de l’application. La fonction de rechargement dynamique est utilis�e, dans l’environnement de d�veloppement, pour tester rapidement les modifications mineures d’une application. Le blocage est d� � une tentative d’utilisation d’un nombre de descripteurs de fichiers plus important que le nombre disponible.

Solution

1.  Augmentez la limite de descripteurs de fichiers en ajoutant des lignes, dans ce format, au fichier /etc/system. Selon la taille de l’application, vous pouvez d�finir des valeurs plus �lev�es ou plus faibles.

  set rlim_fd_max=8192
  set rlim_fd_cur=2048

2.  Red�marrez le syst�me.

4744128

Le compilateur EJB ne peut pas g�n�rer un code JAVA valide pour les classes internes.

Le compilateur EJB ne peut pas g�n�rer un code JAVA valide pour les mises en uvre du bean enterprise qui utilise des classes internes comme type de renvoi.

interface publique IStateServer {
   ....
   StateProperties getProperties publique (Cha�ne objectID, Cha�ne variantName, IToken securityToken) �met RemoteException ;

   classe publique StateProperties impl�mente Serializable {
      StateProperties() publique {
      }
      description de cha�ne publique = "";
      propri�taire de cha�ne publique = "";
      Date publique modifyTime = new Date();
      cha�ne publique accessPermissions = "";
   }
}
interface publique IStateServerEJB �tend EJBObject, IStateServer {
   ....
}

REMARQUE : La m�thode getProperties renvoie une classe interne.

Exemple de l’erreur :

D:\AppServer7a\appserv\domains\domain1\server1\generated\ejb\
j2ee-apps\smugglercom\spss\ssp\state\ejb\StateServerEJB_EJBObject
Impl.java:133:

L’utilisation directe des noms de classes internes synth�tiques n’est pas autoris�e :
com.spss.ssp.state.IStateServer$StateProperties

Le code g�n�r� doit �tre
com.spss.ssp.state.IstateServer.StateProperties

au lieu de
com.spss.ssp.state.IstateServer$StateProperties

Solution

D�placez StateProperties vers une classe distincte (autonome non interne).

V�rificateur

Cette section d�crit les probl�mes connus du v�rificateur et les solutions associ�es.

ID

R�sum�

4742545

Le v�rificateur autonome indique les erreurs Classe EJB introuvable.

Le v�rificateur indique que certains tests ont �chou� avec le message de description de test suivant : Classe EJB introuvable. Les �checs de test se produisent lorsqu’un fichier EJB JAR utilise un bean enterprise avec une r�f�rence � un autre bean enterprise en package dans un fichier EJB JAR distinct dans la m�me application EAR. Les messages d’erreur s’affichent �galement si vous tentez de valider les fichiers EAR d�pendant du connecteur (RAR). C’est pour cette raison que le groupe RAR ne doit pas �tre en package dans le fichier EAR qui h�berge le bean enterprise avec une d�pendance sur les fichiers int�gr�s RAR. Les �checs (except�s ceux relatifs au connecteur) s’observent uniquement avec le v�rificateur autonome. Le v�rificateur invoqu� via la commande de d�ploiement ou l’interface d’administration n’indique pas les �checs.

Solution

Assurez-vous que la mise en package de l’application EAR est correcte et que vous utilisez un fichier JAR d’utilitaire, qu’il est en package dans le fichier EAR. Pour r�soudre les erreurs de r�f�rencement, vous pouvez d�caler vers le v�rificateur invoqu� via le backend de d�ploiement en utilisant asadmin ou l’interface d’administration. Pour les �checs relatifs au connecteur, placez le fichier JAR contenant les classes requises dans le chemin de classe pour le v�rificateur. Vous pouvez ouvrir le fichier install_root/bin/verifier[.bat] et ajouter une variable LOCAL_CLASSPATH � la fin de la variable JVM_CLASSPATH. Ajoutez localement les classes � la variable LOCAL_CLASSPATH, puis ex�cutez le v�rificateur.

Configuration

Le tableau suivant d�crit les probl�mes de configuration connus du logiciel Sun ONE Application Server 7 et leur solution.

ID

R�sum�

4742559

Si votre r�seau n’utilise pas IPv6, ce probl�me ne vous concerne pas.

REMARQUE : Si votre r�seau n’utilise pas IPv6, ce probl�me ne vous concerne pas.

Par d�faut, le logiciel Sun ONE Application Server utilise IPv4. Cela est pris en charge par toutes les plates-formes sur lesquelles le logiciel Sun ONE Application Server est disponible. Certaines plates-formes prennent en charge IPv6. Dans ce cas, les modifications de configuration du logiciel Sun ONE Application Server sont requises pour �tre en conformit�.

REMARQUE : Si ces modifications de configuration sont n�cessaires, il est essentiel de s’assurer de la prise en charge d’IPv6 sur les plates-formes. Les instances du serveur risquent de ne pas d�marrer si la configuration relative � IPv6 s’applique � un syst�me qui prend uniquement en charge IPv4.

Solution

Effectuez les modifications de configuration suivantes :

1.  D�marrez le serveur d’administration.

2.  D�marrez l’Interface d’administration. (Connectez-vous � l’h�te/au port http du serveur d’administration dans un navigateur.)

3.  S�lectionnez l’instance du serveur d’applications pour configurer IPv6, tel que server1.

4.  D�veloppez le nud des modules d’�coute HTTP dans l’affichage d’arborescence.

5.  S�lectionnez le module d’�coute HTTP pour configurer IPv6, tel que http-listener1.

6.  Dans la section G�n�ral, modifiez la valeur du champ Adresse IP sur TOUT.

7.  Dans la section Avanc�, modifiez la valeur du champ Famille sur INET6.

La configuration du champ Famille sur INET6 ne d�sactive pas la fonction IPv4 sauf si une adresse IPv6 est s�lectionn�e comme adresse IP. En s�lectionnant TOUT pour une adresse IP, les deux adresses IPv4 et IPv6 correspondent.

8.  Cliquez sur Enregistrer.

9.  Dans la fen�tre de gauche, s�lectionnez votre instance de serveur.

10.  Cliquez sur Appliquer les modifications.

11.  Cliquez sur Arr�ter.

12.  Cliquez sur D�marrer. Le serveur red�marre et applique vos modifications.

Descripteurs de d�ploiement

Cette section d�crit les probl�mes connus du descripteur de d�ploiement.

Probl�mes sun-cmp-mapping.xml

Probl�mes sun-ejb-jar.xml

Surveillance

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

ID

R�sum�

4734595

Total-connections-failed-validation n’indique pas de valeurs.

Ce probl�me va de paire avec le probl�me de double pool dans la mise en uvre de r�f�rence (RI).

Solution

Aucune.

4737227

FlagAsyncEnabled ne se d�finit pas sur 1 dans http-server.

Il s’agit d’un probl�me connu du logiciel Sun ONE Web Server.

Solution

Aucune.

4752199

Les valeurs d’attribut de la m�thode du bean de surveillance ne sont pas indiqu�es pour les m�thodes getPrimaryKey(), getEJBMetaData() et getHomeHandle().

L’outil de surveillance r�pertorie les m�thodes dans un bean enterprise pouvant �tre surveill�. Pour getPrimaryKey(), getEJBMetaData() et getHomeHandle(), les attributs de surveillance du niveau de m�thode indiquent toujours z�ro.

Solution

Aucune.

Administration du serveur

Cette section traite des domaines suivants :

Interface de ligne de commande (CLI)

Cette section d�crit les probl�mes connus de l’interface de ligne de commande et les solutions associ�es.

ID

R�sum�

4676889

La commande CLI d�borde en mode simple si la commande d�passe 256 caract�res.

Sur UNIX(R), lors de l’ex�cution d’une commande CLI en mode simple contenant plus de 256 caract�res, la commande �choue et l’erreur suivante s’affiche : ...Commande introuvable...

Il s’agit d’une restriction de terminal et non d’une restriction CLI.

Exemple :

create-jdbc-connection-pool --instance server4 --datasourceuser admin --datasourcepassword adminadmin --datasourceclassname test --datasourceurl test --minpoolsize=8 --maxpoolsize=32 --maxwait=60000 --poolresize=2 --idletimeout=300 --connectionvalidate=false --validationmethod=auto-commit --failconnection=false --description test sample_connectionpoolid)

Solution

1.  Pour les commandes n�cessitant plus de 256 caract�res, utilisez la CLI en mode multiple.

2.  Si vous utilisez le mode simple, ex�cutez la commande � l’aide d’OpenWin cmdtool.

4680409

Apr�s avoir configur� une instance pour utiliser SSL, l’administrateur ne peut pas acc�der au serveur d’administration � partir de la CLI ou des clients du navigateur.

Solution

Importez le certificat du logiciel Sun ONE Application Server dans chaque client devant utiliser SSL pour acc�der au serveur d’administration, puis indiquez que les serveurs ayant ce certificat sont approuv�s. Cette op�ration sur un navigateur est sp�cifique � ce dernier ; consultez l’aide en ligne du navigateur pour importer un certificat � approuver.

Pour la CLI, si le certificat du serveur se trouve dans un fichier servercert.cer et que le r�pertoire d’installation est /INSTALL, la commande est :

keytool -import -file servercert.cer -alias server -keystore /INSTALL/jdk/jre/lib/security/cacerts

REMARQUE : Pour �viter de rencontrer ce probl�me � l’avenir, assurez-vous que le certificat du serveur d’administration est install� dans le serveur et dans le ou les clients avant de configurer le serveur d’administration pour l’utilisation de SSL.

4688386

L’utilisation d’un ast�risque (*) dans la commande CLI en mode simple cr�e des messages d’erreur et/ou un comportement inattendu.

L’ast�risque est d�velopp� par l’interpr�teur de commandes sous-jacent sous forme d’une liste de noms, qui appara�t comme telle pour la commande d’interface de ligne de commande (CLI). En mettant l’ast�risque entre guillemets, vous �vitez que l’interpr�teur de commandes �tende l’ast�risque et la commande CLI peut donc voir l’ast�risque.

Solution

Encadrez l’ast�risque par des guillemets (simples ou doubles).

4701361

Des modifications r�p�t�es appliqu�es � une instance entra�nent parfois une erreur de m�moire insuffisante.

Le serveur d’administration conserve un enregistrement de toutes les modifications effectu�es sur le syst�me, ce qui requiert de la m�moire. Cet enregistrement des modifications (mais pas les modifications elles-m�mes) est supprim� pendant une reconfiguration, lib�rant ainsi de la m�moire.

Solution

Utilisez r�guli�rement la commande de reconfiguration asadmin pour supprimer les anciens enregistrements de modifications.

4704328

Le nettoyage n’a pas lieu lorsqu’un appel de cr�ation de double domaine �choue.

Lorsqu’un domaine d�j� existant est cr��, un message d’erreur appropri� est g�n�r�. Cependant, un r�pertoire sp�cifi� par l’option -path dans la commande create-domain est cr�� s’il n’existait pas d�j�. Celui-ci sera supprim� car la commande a �chou�.

Solution

Supprimez chaque r�pertoire vide suppl�mentaire sp�cifi� qui pourrait �tre cr�� une fois l’option -path utilis�e.

4708813

Impossible de surveiller les ressources JDBC du pool de connexion (pointbase) par d�faut.

Les pools de connexion JDBC sont cr��s de fa�on dynamique � la demande, ce qui signifie qu’un pool est cr�� la premi�re fois qu’il est utilis�. Si le pool n’a pas �t� cr�� (pas utilis�), la surveillance est impossible.

Solution

Cr�ez le pool de connexion souhait� pour permettre la surveillance.

4722007

Surveillance : Il est impossible de mesurer des temps d’ex�cution inf�rieurs � 1 milli�me de seconde.

Lorsqu’une m�thode de bean d’entit� est surveill�e, l’attribut execution-time-millis indique -1. Par exemple, lors de l’ex�cution de la commande :

iasadmin>get -m server1.application.usecase1app.ejb-module.UseCase1Ejb_jar.entity-bean.BeanOne.bean-method.method_create0.*

Les attributs suivants sont renvoy�s :

Attribute name = total-num-errors Value = 0
Attribute name = method-name Value = public abstract
com.iplanet.ias.perf.jts.UseCase1.ejb.BeanOneRemote
com.iplanet.ias.perf.jts.UseCase1.ejb.BeanOneHome.create() �met
javax.ejb.CreateException,java.rmi.RemoteException
Attribute name = total-num-calls Value = 0
Attribute name = total-num-success Value = 0
Attribute name = execution-time-millis Value = -1

Avant de d�marrer la surveillance, la valeur par d�faut pour execution-time-millis est d�finie sur-1 pour indiquer que la valeur pour cet attribut est incorrecte � ce moment. Une valeur par d�faut de 0 donnerait la fausse impression que le temps d’ex�cution a �t� mesur� et qu’il atteint une tr�s petite valeur.

Solution

Aucune.

4733109

Erreur de v�rificateur rapport�e dans l’interface d’administration lors de l’affichage de la ressource d’usine du Gestionnaire de persistance � partir de l’interface de ligne de commande.

Lorsqu’une ressource d’usine du Gestionnaire de persistance s’affiche dans l’interface d’administration, l’erreur suivante est rapport�e pour la ressource lorsqu’elle est cr��e � partir de l’interface de ligne de commande :

ArgChecker Failure: La validation a �chou� pour jndiName : l’objet ne doit pas �tre nul

Solution

Aucune.

4742993

Sous Solaris, la commande flexanlg provoque un �chec d’ouverture lorsqu’elle est utilis�e sur le logiciel Sun ONE Application Server int�gr� dans Solaris.

Si vous ex�cutez une version int�gr�e dans l’environnement d’exploitation Solaris et que vous utilisez la commande flexanlg � partir de /usr/appserver/bin, une erreur d’�chec d’ouverture s’affiche.

ld.so.1: /usr/appserver/bin/flexanlg: fatal : libplc4.so: open failed: Ce fichier ou r�pertoire n’existe pas
Arr�t� pr�matur�ment

Solution

Proc�dez comme suit :

1.  Ajoutez l’entr�e suivante dans le fichier LD_LIBRARY_PATH :

usr/lib/mps

2.  Ex�cutez ensuite la commande flexanlg.

% /usr/appserver/bin/flexanlg

4750518

Certaines commandes CLI ne fonctionnent pas sur le serveur d’administration cible.

Les commandes create, delete ou list ne fonctionnent pas dans la CLI sur le serveur d’administration cible pour cr�er/supprimer/r�pertorier de nouveaux �l�ments (tels que SSL, mime, profileur, ressources, etc.) dans le fichier server.xml du serveur d’administration.

Solution

Utilisez l’Interface d’administration pour cr�er, supprimer et r�pertorier des �l�ments dans le serveur d’administration.

Infrastructure d’administration

Cette section d�crit les probl�mes connus de l’infrastructure d’administration et les solutions associ�es.

ID

R�sum�

4676888

Sous Microsoft Windows 2000, impossible de cr�er JVM lorsque la taille du heap JVM est d�finie sur une valeur �lev�e.

Si vous tentez de d�finir une taille heap JVM plus grande sous Windows 2000, vous risquez d’obtenir le message d’erreur suivant :

Une erreur s’est produite lors de l’initialisation de VM,
Impossible de conserver suffisamment d’espace pour le heap d’objets
Erreur interne : impossible de cr�er JVM

Solution

Pour configurer le logiciel Sun ONE Application Server avec une taille de heap JAVA sup�rieure sous Windows 2000, il est n�cessaire de rebaser les DLL du logiciel Sun ONE Application Server.

L’utilitaire Rebase, livr� avec Microsoft Framework SDK et Microsoft Visual Studio, permet de d�finir des adresses de base optimales pour un nombre de DLL d�marrant � partir d’une adresse, puis augmentant la disponibilit� du heap JVM. La rubrique SDK Help Rebase recommande l’utilisation de l’adresse 0x60000000. Pour plus de d�tails sur l’utilitaire Rebase, acc�dez � l’adresse suivante :

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/tools/tools /performance_tools.asp

Conditions requises :

  • Syst�me Windows 2000 avec m�moire de 2 � 4 Go
  • Utilitaire Rebase SDK de Visual Studio/Microsoft Framework

Pour appliquer l’utilitaire Rebase aux biblioth�ques dynamiques S1AS, proc�dez comme suit :

1.  cd into r�p_install\bin

2.  rebase -b 0x6000000 *.dll

3.  cd ..\lib

4.  rebase -b 0x6600000 *.dll

4686003

Les limites de la qualit� de service HTTP ne sont pas appliqu�es.

La qualit� de service (QOS) comprend un moyen de sp�cifier le nombre maximum de connexions HTTP et la limite de la bande passante. Lorsque vous exc�dez ces attributs, une erreur 503 doit �tre renvoy�e au client. Cependant, apr�s avoir activ� la QOS via l’interface d’administration, le serveur n’applique pas les limites de la QOS.

Solution

Pour activer enti�rement les fonctions de la QOS, vous devez ajouter manuellement une ligne AuthTrans fn=qos-handler en haut de l’objet par d�faut dans le fichier obj.conf du serveur virtuel. La fonction d’application du serveur qos-handler (SAF) et le fichier de configuration obj.conf sont d�crits dans le manuel Developer’s Guide to NSAPI.

4692673

Le red�marrage d’une instance en mode de d�bogage semble �chouer si l’instance n’est pas ex�cut�e � l’origine en mode de d�bogage.

Si une instance est d�marr�e sans cocher/s�lectionner la case � D�marrer/Red�marrer en mode de d�bogage �, les param�tres suivants de cette case ne fonctionnent pas. Dans l’interface d’administration, la case D�bogage activ� semble d�coch�e m�me si elle a �t� coch�e. Le fichier server.xml indique �galement debug-enabled=false.

Solution

Aucune.

4699450

Sous Microsoft Windows 2000, le d�ploiement �choue pour les fichiers EAR si la longueur totale du chemin menant � un fichier g�n�r� pendant le d�ploiement d�passe 260 caract�res.

Sur la plate-forme Windows 2000, la machine virtuelle Java (JVM) est limit�e � 260 caract�res pour les noms de chemin menant � des fichiers g�n�r�s. Il s’agit d’un probl�me li� � la prise en charge de Microsoft Windows dans la JVM qui sera probablement r�solu dans la version J2SE 1.5.

Solution

Lors du d�ploiement d’une application, utilisez un nom de fichier et un nom de chemin inf�rieurs � 260 caract�res au total.

4723776

Sous Solaris, le serveur ne peut pas red�marrer lors de la conversion vers un environnement compatible SSL.

Si vous tentez de red�marrer le logiciel Sun ONE Application Server apr�s avoir install� un certificat et avoir activ� la s�curit�, le red�marrage �choue. Un message s’affiche indiquant que le serveur n’a pas pu recevoir le mot de passe. Cliquez une deuxi�me fois sur le bouton D�marrer pour d�marrer le serveur. Lorsque SSL n’est pas activ�, les mots de passe ne sont pas en m�moire cache, emp�chant ainsi le red�marrage. La commande de red�marrage ne prend pas en charge la transition d’un mode non compatible SSL vers un mode compatible SSL.

REMARQUE : Ce probl�me se produit uniquement lors du premier red�marrage du serveur. Les red�marrages suivants fonctionnent normalement.

Solution

Si vous rencontrez ce probl�me :

   Cliquez sur D�marrer.

Afin d’�viter ce probl�me, proc�dez comme suit au lieu de cliquer sur le bouton Red�marrer.

   Cliquez sur Arr�ter.
   Cliquez sur D�marrer.

4724780

Impossible de d�marrer le serveur d’administration si le domaine est cr�� dans un autre syst�me.

  • Si le domaine est cr�� sur un lecteur mont� PCNFS, le serveur d’administration et toutes les instances de ces domaines ne peuvent pas �tre d�marr�s en raison d’un probl�me connu de Microsoft impliquant les lecteurs PCNFS.
  • Si le domaine est cr�� dans le m�me lecteur local que l’installation du produit mais dans un chemin de r�pertoire diff�rent, les instances et le serveur d’administration fonctionnent correctement et sont enti�rement op�rationnels.

Solution

Aucune.

4734184

Sous Microsoft Windows 2000, la console est parfois d�sactiv�e.

Parfois (rarement) l’instance du serveur d’administration ou du serveur d’applications s’arr�te pendant le d�ploiement ou lors de l’ex�cution de commandes. Cela peut se produire lorsqu’une partie du texte du journal de la console est s�lectionn�e. Si vous d�s�lectionnez le texte sur le journal de la console, le processus continue.

Solution

D�sactivez la cr�ation automatique de la console pour l’instance server1 en configurant l’attribut log-service create-console sur faux. Vous pouvez �galement r�soudre ce probl�me en cliquant avec la souris ou en appuyant sur Entr�e dans le journal de la console.

4736554

Une fois qu’un module d’�coute http s�curis� est supprim� d’un serveur, l’administrateur doit encore donner le mot de passe (qui n’est plus n�cessaire).

Solution

Supprimez la totalit� du serveur, puis ajoutez-le � nouveau.

REMARQUE : Pour �viter que ce probl�me ne se reproduise � l’avenir - Avant de supprimer le module d’�coute http, d�sactivez la s�curit� � l’aide de la commande suivante :

/export2/build/bin/> asadmin set --user admin --password adminadmin
server1.http-listener.http-listener-1.securityEnabled=false
L’attribut securityEnabled est d�fini sur faux.
/export2/build/bin/> asadmin delete-http-listener --user admin --password adminadmin ls2
Module d’�coute Http supprim� avec id = ls2

4737756

Sous Microsoft Windows 2000, des messages corrompus s’affichent sur la console.

Sous Windows 2000, pour une langue autre que l’anglais (telle que le japonais), des messages corrompus peuvent s’afficher sur la console.

Solution

Utilisez l’interface d’administration pour afficher les messages du journal.

4739831

Une instance partiellement supprim�e peut provoquer des r�ponses incorrectes � partir de certaines commandes CLI.

Si une instance de serveur est partiellement supprim�e, les probl�mes suivants se produisent avec certaines commandes CLI (des solutions sont fournies avec chaque description de probl�me) :

1.  La commande create-instance en mode local rapporte que l’instance existe m�me s’il n’existe aucun sous-r�pertoire sous le dossier de l’instance.

Solution

Supprimez manuellement le r�pertoire d’instance restant, puis ex�cutez la commande create-instance.

2.  La commande list-instances en mode local comprend le nom et l’�tat de l’instance partiellement supprim�e.

Solution

Supprimez manuellement le r�pertoire d’instance restant, puis ex�cutez la commande list-instances.

3.  Sous Microsoft Windows 2000, la commande start-instance en mode distant affiche une cha�ne nulle.

Solution

Supprimez manuellement le r�pertoire d’instance restant, cr�ez une nouvelle instance, puis ex�cutez la commande start-instance.

4.  Sous Microsoft Windows 2000, la commande stop-instance en modes local et distant rapporte des exceptions incorrectes. En mode local, la commande affiche un message incorrect indiquant que l’instance n’est pas ex�cut�e. En mode distant, la commande affiche une cha�ne nulle.

Sous Solaris, la commande stop-instance en mode local rapporte de fa�on incorrecte que l’utilisateur n’a pas l’autorisation d’acc�der au r�pertoire config de l’instance m�me si le r�pertoire config n’existe pas.

Solution

Supprimez manuellement le r�pertoire d’instance restant.

4739891

La suppression d’un serveur virtuel �choue si le module Web par d�faut auquel le serveur virtuel fait r�f�rence n’existe pas ou si son d�ploiement a �t� annul�.

Solution

D�finissez le champ Module Web par d�faut du serveur virtuel sur Aucune s�lection, cliquez sur OK pour enregistrer les modifications, puis supprimez le serveur virtuel.

4740022

SNMP : END OF MIB est renvoy� lors de l’ajout et du d�marrage d’un nouveau serveur d’instance.

Si vous ajoutez et d�marrez une nouvelle instance sans fermer le serveur d’instance et le sous-agent, un message END OF MIB est renvoy�.

Solution

1.  Pour afficher une nouvelle instance, assurez-vous que le sous-agent et tous les processus du serveur d’instance sont ferm�s. Sous chaque serveur -> Surveillance -> � Activer la collecte de statistiques SNMP : activ� �, appliquez la modification, puis red�marrez chaque serveur d’instance et red�marrez uniquement un processus de sous-agent.

2.  Si le sous-agent est d�j� ex�cut�, ne d�marrez aucun processus de sous-agent suppl�mentaire dans aucune instance. Il ne peut y avoir qu’un seul agent principal et un sous-agent pour une installation du logiciel Sun ONE Application Server (commun pour tous les domaines ou toutes les instances).

4737138

Le message d’expiration de la licence ne s’affiche ni sur les services Microsoft Windows, ni sous l’invite DOS.

Lors du d�marrage des serveurs � partir des services Windows ou de la commande d’invite DOS (startserv.bat) apr�s l’expiration de la licence, les messages d’expiration de la licence appropri�s ne s’affichent pas.

Solution

D�marrez les serveurs � partir d’une CLI (asadmin) ou d’une ic�ne de programme Sun.

4780488

L’existence de plusieurs fichiers obj.conf provoque une confusion.

À la cr�ation d’une instance du logiciel Sun ONE Application Server, le r�pertoire instance-dir/config/ contient deux fichiers de type obj.conf, un appel� obj.conf et l’autre nom-serveur-virtuel-obj.conf, o� nom-serveur-virtuel est la m�me valeur que le nom de l’instance pour le serveur virtuel cr�� automatiquement lors de la cr�ation de l’instance. La documentation fait r�f�rence � la � modification du fichier obj.conf � alors qu’elle devrait faire r�f�rence � la � modification du fichier obj.conf associ� au serveur virtuel en question �.

Lorsque le logiciel Sun ONE Application Server est install�, les fichiers obj.conf et server1-obj.conf se trouvent sous le r�pertoire /domains/domain1/server1/config/. Le contenu du fichier appel� obj.conf est �cras� par le contenu du fichier server1-obj.conf sp�cifi� au niveau du serveur virtuel. En effet, le fichier appel� obj.conf n’est pas utilis� par l’instance du logiciel Sun ONE Application Server.

Par exemple, si vous avez modifi� le fichier appel� obj.conf lors de la configuration du plug-in du serveur Web Sun ONE Application Server, les param�tres de transition ne sont pas appliqu�s car le mauvais fichier obj.conf a �t� modifi�.

Solution

Lorsque vous devez modifier le fichier obj.conf pour une instance, modifiez le fichier pr�d�termin� avec le nom du serveur virtuel en question.

4938319

Erreurs lors de l’utilisation de SSL et du plug-in de serveur Web (proxy inverse).

Des erreurs 502 se produisent lors de l’utilisation de SSL et du plug-in de serveur Web

Solution

D�finissez le param�tre keepAliveTimout sur la m�me valeur dans le fichier magnus.conf de Sun ONE Web Server et dans le fichier init.conf de Sun ONE Application Server. Si ces valeurs sont diff�rentes, la connexion peut �tre ferm�e lorsque Application Server se connecte � Web Server ou lorsque Web Server se connecte � Application Server. Si la connexion est d�j� ferm�e, une erreur 502 appara�t.

Interface d’administration

Lorsque vous utilisez l’interface d’administration, assurez-vous que le navigateur est configur� pour v�rifier les versions de pages les plus r�centes � partir du serveur, au lieu de pr�lever celles-ci dans la m�moire cache. G�n�ralement, les param�tres du navigateur par d�faut ne posent pas de probl�mes.

Cette section d�crit les probl�mes connus de l’interface utilisateur d’administration du logiciel Sun ONE Application Server 7 et les solutions associ�es.

ID

R�sum�

4722607

Sous Microsoft Windows 2000, impossible de modifier ou de supprimer des entr�es dans un fichier mime r�cemment cr�� qui ignore l’extension .types.

Sous Windows 2000, le fichier MIME doit poss�der l’extension .types apr�s le nom de fichier pour permettre l’entr�e de modifications dans le fichier. Par exemple, mime2.types et non mime2

Solution

Utilisez l’extension .types pour tous les noms de fichiers mime.

4725473

Le surnom du certificat externe n’est pas affich� dans la liste Surnom de l’Interface d’administration.

Lorsque vous installez un certificat externe via l’interface d’administration du logiciel Sun ONE Application Server, vous rencontrez un probl�me lorsque vous tentez d’activer SSL pour le module d’�coute http en utilisant le certificat install� sur le module cryptographique externe. Bien que l’installation du certificat ait r�ussi, le surnom du certificat ne s’affiche pas dans l’interface d’administration.

Solution

1.  Connectez-vous comme utilisateur administrateur au syst�me o� le logiciel Sun ONE Application Server est install�.

2.  Liez le module d’�coute http au certificat install� sur le module cryptographique externe. Ex�cutez la commande asadmin. Pour plus d’informations sur la commande asadmin reportez-vous � la man page asadmin(1M).

/sun/appserver7/bin/asadmin create-ssl
   --user admin --password
mot_de_passe
   --host
nom_h�te
   --port 8888
   --type http-listener
   --certname nobody@apprealm:Server-Cert
   --instance server1
   --ssl3enabled=true
   --ssl3tlsciphers +rsa_rc4_128_md5
   http-listener-1

Cette commande �tablit le lien entre le certificat et l’instance de serveur ; elle ne permet pas d’installer le certificat (ce qui a �t� fait � l’aide de l’Interface d’administration). M�me si le certificat est li� au module d’�coute http, vous �couterez ce dernier dans un autre mode que SSL.

3.  Activez le module d’�coute http pour �couter en mode SSL � l’aide de la commande CLI suivante.

/sun/appserver7/bin/asadmin set
   --user admin
   --password
mot_de_passe
   --host
nom_h�te
   --port 8888
   server1.http-listener.http-listener-1.securityEnabled=true

Cette commande bascule l’�tat d’�coute de l’instance de serveur de non SSL vers SSL.

Une fois les �tapes pr�c�dentes termin�es, le certificat s’affiche dans l’Interface d’administration.

4.  Vous pouvez maintenant utiliser l’Interface d’administration pour modifier le module d’�coute http en fonction de vos besoins.

4728718

Lors de la cr�ation d’un serveur virtuel et lorsqu’une valeur est donn�e pour l’emplacement du fichier journal, une erreur � Fichier introuvable � est rapport�e.

Dans l’interface d’administration, le champ du fichier journal ne peut pas �tre utilis� pour ajouter des valeurs.

Solution

Supprimez le serveur virtuel que vous venez de cr�er, cr�ez le fichier n�cessaire, puis recr�ez le serveur virtuel.

REMARQUE : Pour �viter de rencontrer � nouveau ce probl�me - Cr�ez toujours le fichier journal en premier avant de cr�er le serveur virtuel.

4741123

Sous Solaris 9 update 2, le navigateur par d�faut est incompatible avec le logiciel Sun ONE Application Server 7.

Lorsque vous essayez d’utiliser l’interface d’administration du logiciel Sun ONE Application Server avec le navigateur par d�faut de l’environnement d’exploitation Solaris 9 4/03, le message d’erreur suivant s’affiche :

Ce navigateur n’est pas pris en charge : Netscape 4.78.

Nous vous recommandons de mettre votre navigateur au niveau de la version Netscape 4.79 ou Netscape 6.2 pour ex�cuter l’interface utilisateur du logiciel Sun ONE Application Server. Si vous d�cidez de ne pas poursuivre et de ne pas r�aliser la mise � niveau, vous remarquerez peut-�tre une d�gradation des performances et/ou un comportement inattendu.

REMARQUE : Si vous ex�cutez la version de l’interface d’administration du logiciel Sun ONE Application Server, qui est incluse dans l’environnement d’exploitation Solaris 9 4/03, vous devrez utiliser Netscape 4.79 ou Netscape 7.0.

Solution

  • Pour le logiciel Sun ONE Application Server 7 autonome, mettez � niveau avec Netscape 4.79 ou Netscape 6.2. Utilisez /usr/dt/bin/netscape6 au lieu de /usr/dt/bin/netscape.
  • Pour le logiciel Sun ONE Application Server 7 int�gr� avec Solaris, effectuez une mise � niveau vers Netscape 4.79 ou Netscape 7. Utilisez /usr/dt/appconfig/SUNWns/netscape au lieu de /usr/dt/bin/netscape.

4750616

La modification de la liste de contr�le d’acc�s (ACL) n’est pas prise en charge sur certaines versions de Netscape Navigator.

Si vous tentez de modifier des entr�es ACL tout en utilisant Netscape Navigator, version 6.x ou 7.x, vous pouvez rencontrer des probl�mes par intermittence, tels que la disparition du navigateur ou encore l’�cran de modification d’ACL qui ne s’affiche jamais.

Solution

Choisissez l’un des palliatifs suivants.

  • Utilisez la version 4.79 de Netscape Navigator prise en charge.
  • Modifiez manuellement le fichier ACL. Pour obtenir des d�tails sur le formatage du fichier ACL, reportez-vous au manuel Administrator’s Guide du logiciel Sun ONE Application Server.

4752055

Netscape 4.8 cr�e un message d’avertissement sur l’interface d’administration.

Lorsque vous utilisez Netscape 4.8 pour acc�der � l’interface d’administration, un avertissement s’affiche indiquant que Netscape 4.8 n’est pas un navigateur pris en charge. Bien qu’aucun probl�me n’ait �t� identifi� lors de l’utilisation de Netscape 4.8 pour ex�cuter l’interface d’administration, une v�rification plus approfondie doit �tre men�e sous cette version du navigateur Netscape.

Solution

S�lectionnez le lien hypertexte Continuer du message d’avertissement pour continuer � utiliser l’interface d’administration.

Utilisez Netscape 4.79 ou effectuez une mise � niveau vers Netscape 6.2.

4760714

Un bouton d’aide non valide s’affiche sur l’�cran Installation du certificat.

Sur l’�cran Installation du certificat affichant toutes les informations de certificat saisies, un bouton d’aide non valide est pr�sent dans l’Interface d’administration. Si vous cliquez sur ce bouton, un message d’erreur s’affiche indiquant que la page d’aide est introuvable. L’aide contextuelle est visible uniquement si vous cliquez sur le lien Aide dans le cadre sup�rieur de chaque page.

Solution

Cliquez sur le lien Aide dans la fen�tre sup�rieure pour afficher l’aide contextuelle.

4760939

SSL : Un certificat auto-sign� g�n�r� par certutil ne s’affiche pas dans la liste Surnom du certificat.

Un certificat auto-sign� est g�n�r� par certutil et le Surnom du certificat ne s’affiche pas sur l’Interface d’administration.

Solution

Pour utiliser un certificat � signature automatique, vous devez modifier manuellement le fichier server.xml.

4848146

Une erreur se produit lors de l’acc�s � l’Interface d’administration si le navigateur utilise un serveur proxy.

Si le navigateur est configur� pour utiliser un serveur proxy et que le serveur proxy n’est pas configur� pour ignorer l’h�te local, une erreur se produit lorsque vous s�lectionnez D�marrer la console d’admin dans le menu D�marrer.

Solution

D�sactivez le serveur proxy.

OU

Incluez l’h�te local dans la liste des domaines � ignorer par le serveur proxy.

4957860

Sous Red Hat Enterprise Linux AS 3.0 Impossible d’ajouter le type MIME.

Lorsque vous tentez d’ajouter un type MIME � un fichier de types MIME par le biais de l’interface d’administration, une erreur s’affiche pour emp�cher l’acc�s � la page g�n�rale des types MIME.

Solution

Ce probl�me se produit car le param�tre local par d�faut a la valeur en_US.UTF-8 au lieu de en_US. La solution consiste � d�finir export LANG=en_US, puis � red�marrer le serveur d’administration.

Plug-in de Sun ONE Studio 4

Cette section d�crit les probl�mes connus de Sun ONE Studio 4, Enterprise Edition (anciennement Forte pour Java) et les solutions associ�es.

ID

R�sum�

4689097

Une erreur se produit lorsque des espaces sont sp�cifi�s dans les r�pertoires � utiliser par Sun ONE Studio 4.

Sun ONE Studio 4 ne s’installe pas correctement si un espace est utilis� dans la structure de r�pertoires. Le programme d’installation v�rifie s’il existe des espaces dans le chemin d’installation et, s’il en trouve, affiche un message d’erreur.

Solution

N’utilisez pas d’espace lorsque vous sp�cifiez le r�pertoire d’installation pour le composant Sun ONE Studio 4 du logiciel Sun ONE Application Server.

4720145

ConnectionException a �t� �mise pendant l’�tablissement d’une connexion au d�bogueur.

Sun ONE Studio 4 vous invite � plusieurs reprises � cr�er une session de d�bogage, puis �met l’exception.

Solution

Red�marrez l’IDE.

4727932

L’utilisation d’un environnement MAD dans FFJ provoque des effets secondaires.

Les effets secondaires intermittents se produisent lors de l’utilisation de configurations MAD avec Sun ONE Studio 4.

Solution

N’utilisez pas Sun ONE Studio 4 avec des configurations MAD.

4733794

Les modifications ejb-name appliqu�es au nud d’application ne sont pas d�ployables.

Il est possible de modifier l’�l�ment ejb-name d’un bean, dans le contexte d’une application, en utilisant la bo�te de dialogue pr�sent�e lorsque vous s�lectionnez l’�l�ment Afficher les noms EJB du menu contextuel (menu affich� en cliquant avec le bouton droit de la souris) d’un nud d’application. Ces modifications s’appliquent au alt-dd cr�� en tant que partie du package. La modification du nom ne se r�percute pas sur alt-dd du logiciel Sun ONE Application Server.

Solution

Aucune.

4725779

Les valeurs de propri�t� pr�configur�es sp�cifiques � Sun ONE ne s’affichent pas dans l’�diteur.

Si vous disposez d’un fichier RAR qui a �t� configur� pour le d�ploiement vers le logiciel Sun ONE Application Server et que vous essayiez de regarder les valeurs de propri�t� dans la feuille de propri�t�s, vous verrez les valeurs par d�faut et non celles sp�cifi�es dans le fichier sun-ra.xml.

Solution

Extrayez le fichier XML du descripteur sp�cifique Sun � partir du RAR et placez-le dans le m�me r�pertoire que le RAR. Cela vous permet de modifier les descripteurs s1as.

REMARQUE : Le contenu d’origine du fichier RAR ne sera pas modifi� comme un r�sultat des modifications de l’utilisateur de cette fa�on mais le fichier RAR envoy� au serveur comprendra le fichier XML mis � jour.

4733794

Les modifications du nom EJB appliqu�es au nud d’application ne sont pas d�ployables.

Il est possible de modifier l’�l�ment ejb-name d’un bean, dans le contexte d’une application, en utilisant la bo�te de dialogue pr�sent�e lorsque vous s�lectionnez l’�l�ment Afficher les noms EJB du menu contextuel (menu affich� en cliquant sur le bouton droit de la souris) d’un nud d’application. Ces modifications s’appliquent au alt-dd cr�� comme une partie du package. La modification du nom ne se r�percute pas sur alt-dd du logiciel Sun ONE Application Server.

Solution

Aucune.

4745283

Si seul le client d’administration est install�, le client d’application ne peut pas �tre ex�cut�.

Si seul le client d’administration ou le plug-in Sun ONE Studio est install�, vous ne pouvez pas ex�cuter une application du client d’application. Le client d’application est un package distinct du client d’administration.

Solution

Installez le package du client d’application. Procurez-vous une installation compl�te (le script appclient se trouve sous SUNONE_INSTALL_ROOT/bin) ou le package appclient � partir d’une machine distante sur laquelle le logiciel Sun ONE Application Server est install�.

Pour obtenir le package appclient :

1.  Ex�cutez SUNONE_INSTALL_ROOT/bin/package-appclient[.bat]

Cela g�n�re le fichier appclient.jar dans SUNONE_INSTALL_ROOT/lib/appclient/appclient.jar

2.  Distribuez appclient.jar vers la machine distante sur laquelle le logiciel Sun ONE Application Server n’est pas install�, puis appliquez la commande unjar sur appclient.jar. Vous devez obtenir un r�pertoire appclient contenant toutes les biblioth�ques du client d’application et les fichiers JAR.

3.  Modifiez le script bin/appclient int�gr� dans le fichier appclient.jar avant la premi�re utilisation. Remplacez la cha�ne %CONFIG_HOME% par le chemin r�el menant � asenv.conf (ou asenv.bat pour Windows 2000).

4.  Configurez asenv.conf (asenv.bat pour Microsoft Windows) de la mani�re suivante :

%AS_INSTALL%=APPCLIENT_INSTALLED_ROOT
%AS_JAVA%=Your_Installed_Java_Home
%AS_IMQ_LIB%=APPCLIENT_INSTALLED_ROOT/imq/lib
%AS_ACC_CONFIG%=
APPCLIENT_INSTALLED_ROOT/config/sun-acc.xml
%AS_WEBSERVICES_LIB%=
APPCLIENT_INSTALLED_ROOT/lib

REMARQUE : Le fichier appclient.jar est uniquement pr�vu pour �tre ex�cut� � partir d’une machine distante ayant le m�me syst�me d’exploitation que celle o� il a �t� cr��. Par exemple, appclient.jar cr�� sur une plate-forme Solaris ne fonctionne pas sous Windows 2000.

Pour obtenir des d�tails, reportez-vous � la page man package-appclient.

Exemples d’application

Cette section d�crit les probl�mes connus des exemples d’applications du logiciel Sun ONE Application Server 7 et les solutions associ�es.

ID

R�sum�

4714439

Dans PetStore, impossible d’ajouter un utilisateur qui existe d�j�.

Dans l’exemple d’application PetStore, si vous tentez d’ajouter un utilisateur qui existe d�j�, une trace de pile s’affiche sur l’�cran.

Solution

Aucune.

4726161

Les exemples modifi�s ne sont pas mis � jour avant le red�ploiement.

Si vous tentez de d�ployer un exemple plusieurs fois, apr�s avoir apport� de petites modifications et remis l’application en package, le message d’erreur suivant s’affiche.

       � D�j� d�ploy� �

Ce probl�me affecte la plupart des exemples car ils emploient l’utilitaire Ant et le fichier common.xml, qui ont la cible � d�ployer �, combinant ainsi le d�ploiement d’applications et l’enregistrement des ressources.

Solution

Choisissez l’un des palliatifs suivants :

Pour la majorit� des exemples d’applications utilisant les fichiers build.xml de l’utilitaire Ant, dont le fichier common.xml, tapez la commande suivante.

  % asant deploy_common

Pour tous les autres exemples d’application, tapez les commandes suivantes.

  % asant undeploy
  % asant deploy

4733412

Le convertisseur d’exemple d’application contient le fichier JAR redondant dans le module Web.

L’application du convertisseur contient un fichier EJB JAR redondant sans �tat de convertisseur sous le r�pertoire WEB-INF/lib. Le fichier EAR se trouve sous le r�pertoire de l’exemple d’application. À partir de la construction Solaris int�gr�e, il se trouve � l’emplacement suivant :

/usr/appserver/samples/ejb/stateless/converter/stateless-converter.ear

Extrayez ce fichier et acc�dez au r�pertoire WEB-INF/lib du module Web appel� convertisseur sans �tat et vous verrez le fichier. Ce fichier JAR redondant s’applique � tous les modules Web qui appellent le module EJB. L’origine du probl�me est le fichier common.xml utilis� pour cr�er l’application.

Solution

Aucune. N’affecte pas le fonctionnement lors de l’ex�cution d’un exemple d’application.

4739854

Instructions requises pour le d�ploiement des ressources � l’aide d’asadmin.

Dans la documentation de certains exemples, vous avez appris � d�ployer l’application � l’aide de la commande asadmin, mais aucune explication n’est fournie sur la cr�ation des ressources requises.

Solution

Vous pouvez d�ployer l’application/la ressource � l’aide de la commande asadmin et vous pouvez obtenir des informations suppl�mentaires en vous reportant au fichier build.xml de l’exemple. Vous trouverez �galement des informations suppl�mentaires dans le rapport de l’ex�cution asant deploy.

Pour l’exemple JDBC/BLOB, les �tapes suivantes permettent de cr�er les ressources � l’aide de asadmin (en supposant que le nom d’h�te est jackiel2 et le nom d’utilisateur/mot de passe/port pour le serveur d’administration est admin/adminadmin/4848) :

asadmin create-jdbc-connection-pool --port 4848 --host jackiel2 --password adminadmin --user admin jdbc-simple-pool

--datasourceclassname com.pointbase.jdbc.jdbcDataSource --instance server1

asadmin set --port 4848 --host jackiel2 --password adminadmin --user admin

server1.jdbc-connection-pool.jdbc-simple-pool.property.DatabaseName=jdbc:pointbase:server://localhost/sun-appserv-samples

4747534

L’exemple d’application au cycle de vie multithread demande le mot de passe utilisateur administrateur 8 fois.

Lors du d�ploiement du fichier lifecycle-multithreaded.jar de l’exemple d’application � l’aide de la commande asant deploy, vous �tes invit� � entrer le mot de passe utilisateur administrateur huit fois.

Solution

Aucune.

4748535

Divers probl�mes avec les fichiers exemples.

1.  La journalisation d’exemples g�n�re plusieurs fichiers journaux, pour la quatri�me option de journalisation.

2.  La journalisation d’exemples a un fichier log.properties redondant.

3.  Les instructions pour l’octroi de s�curit� dans l’exemple de documentation ne sont pas enti�rement correctes.

Solution

1.  Fermez le gestionnaire avant de le supprimer. Reportez-vous � la m�thode initLog() dans GreeterServlet.java.

private void initLog(String log_type) {
   //Supprimez tous les gestionnaires
   Handler[] h = logger.getHandlers();
   pour (int i = 0; i < h.length; i++) {
      h[i].close(); //doit faire cela
      logger.removeHandler(h[i]);
   }
   ...
}

Ouvrez �galement le Gestionnaire de fichiers avec une option ajout�e. Reportez-vous � addHandler() dans GreeterServlet.java. �crivez :

Handler fh = new FileHandler(log_file, true);

au lieu de

Handler fh = new FileHandler(log_file);

2.  Modifiez le fichier build.xml de la mani�re suivante :

< <fileset dir="${src.docroot}" excludes="cvs,annontation"/>

> <fileset dir="${src.docroot}" excludes="cvs,annontation,log.properties"/>

3.  Dans la section � Ex�cution d’un exemple d’application �, supprimez domains/domain1/ des instructions pour ajouter les entr�es de subvention de s�curit� au fichier server.policy.

4752731

PointBase 4.4 remplace PointBase 4.3.

Lors du chargement et de l’installation de PointBase avec les exemples, (http://hostname:port/samples/docs/pointbase.html) les instructions font r�f�rence � PointBase 4.3. Cependant, PointBase 4.4 a remplac� PointBase 4.3.

Solution

Dans la section � Mettre � jour les exemples de fichiers Ant �, utilisez les fichiers pbtools44.jar et pbclient44.jar au lieu des fichiers pbtools43.jar et pbclient43.jar.

Dans la section � D�marrage de PointBase �, pour charger PointBase et l’installer s�par�ment sur des plates-formes UNIX, utilisez pointbase_install_dir/tools/server/start_server pour d�marrer PointBase.

4965815

La documentation de l’application Journalisation/Simple est incorrecte.

Dans la documentation relative � l’application de journalisation/simple, dans la section � Ex�cution d’un exemple d’application �, la remarque signalant que les deux premi�res options de l’application ne n�cessitent pas de modifications dans le fichier server.policy est incorrecte. Toutes les options n�cessitent des modifications du fichier server.policy pour pouvoir fonctionner.

Solution

Pour toutes les options d�crites dans l’exemple, notamment :

  • Imprimer les messages du journal avec System.err.println (sans utiliser de Logger)
  • Imprimer le journal INFO � l’aide de java.util.logging.Logger

Vous devez modifier votre fichier server.policy pour pouvoir ex�cuter l’exemple. Reportez-vous � la documentation de l’exemple � l’emplacement r�p_install/samples/logging/simple/docs/index.html pour obtenir des instructions compl�tes.

Module d’�coute ORB/IIOP

Cette section d�crit les probl�mes connus du module d’�coute ORB/IIOP et les solutions associ�es.

ID

R�sum�

4743366

L’attribut d’adresse dans l’�l�ment iiop-listener du fichier server.xml ne prend pas TOUT en charge.

Dans la configuration par d�faut, le logiciel Sun ONE Application Server est configur� avec la valeur d’adresse 0.0.0.0 dans l’�l�ment iiop-listener. Cette configuration par d�faut n’�coute pas sur les interfaces IPv6. Elle �coute uniquement sur toutes les interfaces IPv4 d’un syst�me. La valeur TOUT dans l’�l�ment d’adresse du iiop-listener, qui permettrait au serveur d’�couter sur toutes les interfaces (IPv4 ou IPv6) d’un syst�me, n’est pas prise en charge.

La valeur TOUT de l’attribut d’adresse de l’�l�ment iiop-listener dans le fichier server.xml permet d’�couter sur toutes les interfaces disponibles d’un syst�me. Cette prise en charge comprend les interfaces IPv4 et IPv6.

Solution

Pour les interfaces IPv4 et IPv6, utilisez � :: � dans la valeur d’adresse de l’�l�ment iiop-listener. Cette solution est uniquement applicable � Solaris 8.0 et aux versions ult�rieures.

4743419

Les clients RMI-IIOP ne fonctionnent pas pour les adresses IPv6 ou les recherches d’adresse DNS �chouent pour l’adresse IPv6.

Si une recherche DNS pour une adresse IPv6 �choue, les clients du protocole Remote Method Invocation-Internet Inter-ORB Protocol (RMI-IIOP) ne fonctionnent pas pour les adresses IPv6.

Solution

Le service de nom de domaine (DNS) doit �tre configur� sur le site de d�ploiement afin de rechercher une adresse IPv6.

4810199

Le d�l�gu� CORBA Util optimis�, int�gr� avec le logiciel Sun ONE Application Server 7.0 Standard Edition, n’est pas activ� par d�faut.

Une installation par d�faut du logiciel Sun ONE Application Server 7 n’active pas l’utilisation du d�l�gu� CORBA Util haute performance. Finalement, vous pouvez constater une d�gradation importante des performances lors de l’utilisation du JDK int�gr� ou d’ORB int�gr� au logiciel Sun ONE Application Server.

Reportez-vous � la section � High performance CORBA Util Delegate Class � dans le module � ORB Tuning � du manuel Performance Tuning Guide de Sun ONE Application Server.

Solution

Vous pouvez am�liorer les performances de fa�on significative en activant l’utilisation d’une mise en uvre de d�l�gu� CORBA Util haute performance. Pour activer l’autre d�l�gu� CORBA Util, ajoutez ce qui suit au fichier de configuration server.xml du logiciel Sun ONE Application Server :

<jvm-options>-Djavax.rmi.CORBA.UtilClass=com.iplanet.ias.util.orbutil.IasUtilDelegate</jvm-options>

4847269

Le client J2SE 1.3.1_X ne peut pas communiquer avec Sun ONE Application Server 7.

Lorsque le client J2SE 1.3.1_X communique avec Sun ONE Application Server 7, le client vide la m�moire.

Solution

Utilisez J2SE 1.3.1_04 pour le client.

Internationalisation (i18n)

Cette section d�crit les probl�mes connus d’internationalisation et les solutions associ�es.

ID

R�sum�

4761017

Sur la version int�gr�e Solaris : Interface d’administration s’affiche en anglais.

�tant donn� qu’il n’existe pas d’entr�e de langue pour l’instance de serveur d’administration sur la version int�gr�e Solaris, l’Interface d’administration du logiciel Sun ONE Application Server s’affiche en anglais pour la version localis�e.

Solution

D�finissez manuellement l’entr�e de la langue dans le fichier server.xml

4830338

Les donn�es multi-octets des cookies n�cessitent peut-�tre des modifications dans sun-web.xml.

Certaines modifications peuvent �tre n�cessaires dans sun.web.xml pour que les donn�es multi-octets des cookies fonctionnent correctement.

Solution

Il y a deux cas de figure, selon que vous souhaitez conserver des donn�es multi-octets dans les cookies ou que vous ne souhaitez pas coder les cookies.

Si vous souhaitez conserver des donn�es multi-octets dans les cookies, il y a deux sc�narios possibles :

  • Vous voulez envoyer des cookies multi-octets en utilisant uniquement les API du servlet (aucun cookie multi-octets n’est d�fini c�t� client � l’aide de JavaScript™), aucune information suppl�mentaire n’est requise dans sun-web.xml.
  • Vous voulez envoyer des cookies multi-octets en utilisant les API du servlet et JavaScript. D�finissez les lignes suivantes dans sun-web.xml :
  • <property name="UseResponseCTForHeaders" value="true"/>
    <property name="encodeCookies" value="false"/>
    <locale-charset-info default-locale="ko">
    <locale-charset-map locale="ko" charset="euc-kr"/>
    </locale-charset-info>

La variable locale ko est utilis�e en exemple. Vous pourriez utiliser n’importe quel mappage locale-charset en fonction de votre application.

Si vous ne souhaitez pas coder les cookies, vous pouvez apporter la modification suivante. Cette modification fonctionne quelle que soit la langue :

Par d�faut, l’URL de Sun ONE Application Server code les cookies avant de les envoyer au client. Pour d�sactiver cette fonction, ajoutez la ligne suivante au fichier sun-web.xml :

<property name="encodeCookies" value="false"/>

Pour les exemples ci-dessus, placez ces lignes directement sous la balise <sun-web-app> ; ne les imbriquez pas dans une autre balise.

4957904

L’utilisateur ne parvient pas � lancer la version chinoise de l’interface d’administration apr�s l’installation.

Apr�s l’installation de la version chinoise de Sun ONE Application Server, l’interface d’administration s’affiche en anglais.

Solution

D�finissez manuellement l’entr�e de la langue dans le fichier server.xml et red�marrez le serveur.

N/A

Sous Solaris, il existe des limitations associ�es au navigateur Netscape 4.79.

  • Lorsque vous utilisez Netscape 4.79 sous Solaris, les messages JavaScript localis�s affichent des caract�res tronqu�s. JavaScript ne prend pas en charge le codage UTF-8.
  • Lorsque vous utilisez Netscape 4.79 sous Solaris dans la langue chinoise GB18030, les caract�res GB18030 ne sont pas accept�s.

Solution

Sur le site Web Sun, t�l�chargez Netscape 6.23 ou 7.0 pour Solaris. Cela r�sout ces deux probl�mes.

Documentation

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

ID

R�sum�

4839719

Developer’s Guide to Web Applications : Description erron�e de la propri�t� cookieName.

Dans le manuel Developer's Guide to Web Applications, la documentation du fichier sun-web.xml cite la propri�t� cookieName du sous-�l�ment cookie-properties et implique que la valeur de la propri�t� cookieName peut �tre modifi�e � la place de la valeur par d�faut. Toutefois, cette valeur ne peut pas �tre modifi�e ; elle doit toujours �tre �gale � JSESSIONID.

Solution

Aucune.

4720171

Il n’existe aucune documentation expliquant l’utilisation des r�pertoires de d�ploiement index�s.

La partie de la trame de num�rotage du nom de r�pertoire d’une application d�ploy�e a �t� mise en uvre comme m�canisme d’indexation pour permettre � un d�veloppeur de modifier un fichier JAR et/ou de classe associ� � l’application d�ploy�e. Ceci est important pour la plate-forme Windows en raison d’une erreur de violation de partage qui se produit pendant une tentative d’�crasement d’un fichier charg� ; Windows place un verrou de fichier sur le fichier charg�. Le fichier est charg� dans l’instance du serveur ou dans l’IDE pendant le d�marrage de la session. Avec l’erreur de violation de partage, deux options sont possibles :

  • Compilez le fichier de classe mis � jour (faisant partie � l’origine de ce fichier JAR) et placez-le d’abord dans le chemin de classe pour le charger avant les anciennes classes, puis laissez le logiciel Sun ONE Application Server charger � nouveau cette application (aussi longtemps que le chargement est actif), OU
  • Mettez � jour le fichier JAR, cr�ez un fichier EAR et red�ployez l’application.

REMARQUE : Le red�ploiement de l’application sur la plate-forme Solaris n’est pas n�cessaire �tant donn� qu’il n’y a aucune contrainte de verrouillage de fichier.

Solution

Lorsque vous apportez des modifications � une application d�j� d�ploy�e sur la plate-forme Windows pour la configuration de l’IDE, la copie de fichier ANT, la compilation ou pour d’autres op�rations, veuillez noter qu’un nouveau r�pertoire est cr�� avec un num�ro d’index incr�ment� comme palliatif pour la contrainte de verrouillage de fichier. Par exemple : sur la plate-forme Solaris, l’application J2EE, helloworld, est d�ploy�e vers le logiciel Sun ONE Application Server avec la structure de r�pertoire suivante :

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_1

Une modification doit �tre apport�e au servlet faisant partie de cette application d�ploy�e (par exemple, HelloServlet.java). L’IDE Sun Java Studio est d�marr�, le fichier source pour ce servlet est modifi� et compil� avec l’ensemble cible javac menant au r�pertoire ci-dessus. Avec le fichier source compil� dans l’emplacement appropri�, un fichier recharg� existe pour cette application, la balise recharg�e dans le fichier server.xml est d�finie sur vrai et, avec l’instance de serveur en cours d’ex�cution, les modifications sont appliqu�es sans que l’application ne soit regroup�e et red�ploy�e.

Pour la plate-forme Windows, le fichier JAR ou de classe ne peut pas �tre modifi� et mis � jour en raison du probl�me de verrouillage de fichier. Il existe donc deux m�thodes pour traiter ce probl�me sous Windows :

  • Compilez le fichier source modifi� et ajoutez au d�but le fichier de classe ou JAR dans le chemin de classe pour appliquer les modifications du fichier source, OU
  • Proc�dez aux modifications sur la source helloworld, groupez-la et red�ployez-la sans annuler le d�ploiement pr�c�dent de helloworld.

La seconde option est la m�thode la plus utilis�e car cette option utilise le nombre d’index incr�ment� ajout� au nom du r�pertoire de l’application d�ploy�e. Par cons�quent, apr�s un second d�ploiement de helloworld, la structure de r�pertoires sera la suivante :

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_1
appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_2

Le deuxi�me d�ploiement de helloworld doit �tre effectu� sous helloworld_2.

4851218

Vous ne pouvez pas utiliser keytool pour g�n�rer des certificats avec Sun ONE Application Server.

Les certificats g�n�r�s avec keytool ne sont pas compatibles avec Sun ONE Application Server.

Solution

Vous pouvez utiliser certutil pour g�n�rer des certificats � signature automatique. Cet utilitaire est disponible sous forme de add-on de Sun ONE Application Server � l’adresse :

http://wwws.sun.com/software/download/app_servers.html

Pour plus d’informations sur l’utilisation de certutil, consultez :

http://www.mozilla.org/projects/security/pki/nss/tools/certutil.html

4870888

Le manuel Getting Started Guide int�gr� au produit est incorrect.

Le manuel Getting Started Guide int�gr� au produit contient des informations incorrectes concernant les plates-formes et le redimensionnement. Il n’est pas totalement compatible avec la version 508.

Solution

Pour des informations correctes sur les plates-formes et le redimensionnement, reportez-vous au manuel Installation Guide ou au document Platform Summary. La version totalement compatible avec la version 508 du Getting Started Guide est celle figurant � cette adresse :

http://docs.sun.com

4875280

L’aide en ligne contient quelques descriptions incorrectes.

  • Dans le fichier asprfhls.html :

D�finit si SSL3 est activ�. À des fins d’administration, il est recommand� de d�s�lectionner SSL2 et d’utiliser uniquement TLS. (nom de fichier asprfhls.html)

Si votre navigateur ne prend pas en charge TLS, s�lectionnez SSL3.

La description devrait indiquer :

D�finit si SSL3 est activ�. À des fins d’administration, il est recommand� de d�s�lectionner SSL3 et d’utiliser uniquement TLS.

Si votre navigateur ne prend pas en charge TLS, s�lectionnez SSL3.

  • Dans le fichier asprflo.html :

Cr�er console

(fen�tre uniquement) Lorsqu’il est coch�, une fen�tre de console est cr��e pour le r�sultat stderr.

La description devrait indiquer :

Cr�er console

(Windows uniquement) Lorsqu’il est coch�, une fen�tre de console est cr��e pour le r�sultat stderr.

4879044

Admin Guide : Le chemin d’acc�s du compilateur n’est pas valable.

Page 196 de la mise � jour 1 Sun ONE Application Server Administrator’s Guide, les informations suivantes sont incorrectes.

CC=/usr/dist/share/devpro/5.x-sparc/bin/cc

Le chemin d’acc�s ci-dessus est un chemin d’acc�s interne Sun. Le r�pertoire d’installation par d�faut du compilateur devrait �tre :

/opt/SUNWspro

4884043

R�f�rence dans le fichier de configuration : la valeur par d�faut du param�tre TransmitFile est incorrecte.

La description du document pour le param�tre TransmitFile dans le fichier nsfc.conf indique la valeur par d�faut suivante :

(pour Unix), par exemple

TransmitFile=off

Ceci est incorrect. La case � cocher Transmettre le fichier est activ�e par d�faut. Comme d�crit dans le document, elle devrait �tre d�sactiv�e.

4890285

Certains documents n’ont pas �t� mis � jour pour la plate-forme Solaris x86.

Il est possible que la plate-forme Solaris x86 ne soit pas mentionn�e dans les documents r�pertoriant les plates-formes prises en charge par Sun ONE Application Server. Pour consulter les derni�res informations relatives aux plates-formes, reportez-vous au document Platform Summary.

Developer’s Guide to NSAPI : Lorsque le manuel fait r�f�rence � SPARC, les r�f�rences devraient en fait concerner Solaris (Solaris comprend SPARC et x86). Pages 158 et 159, SPARC n’est pas mentionn�.

Solution

Reportez-vous � la section � Limitations de Solaris x86 � � la page 4 pour conna�tre la liste des limitations associ�es � Solaris x86 dans cette version. La documentation ne pr�cise pas toujours ces limitations.

4893954

Le manuel Administrator’s Guide n’indique pas que la rotation de journal effectu�e avec le script cron de Solaris red�marre Sun ONE Application Server.

Deux types de rotation de journal sont disponibles :

La rotation du journal d�mon interne se produit au sein du d�mon HTTP et ne peut �tre configur�e qu’au moment du d�marrage. La rotation du journal d�mon interne permet au serveur de faire tourner les journaux en interne, sans exiger le red�marrage du serveur.

La rotation de journal bas�e sur le planificateur (cron) est initialis�e au d�marrage du serveur. Si la rotation est activ�e, le serveur cr�e un fichier journal d’acc�s horodat� et la rotation commence au d�marrage du serveur. Ce type de rotation de journal appelle en interne le script rotatelog, qui red�marre le processus du serveur d’applications.

4896094

Admin Guide : Instructions n�cessaires pour la d�finition de la variable ACC_CONFIG au moment de l’installation.

La documentation ne contient pas d’instructions pour la d�finition de la variable ACC_CONFIG apr�s la cr�ation des instances de serveur et de domaine. Le texte suivant doit �tre ajout� � la suite de la section � Deploying Applications � dans le manuel Sun ONE Application Server Administrator’s Guide :

In addition to the above steps, you need to modify the asenv.conf file. (En plus des �tapes ci-dessus, vous devez modifier le fichier asenv.conf.) After creating the domains, set the value of the AS_ACC_CONFIG variable to the sun-acc.xml file located in the server_instance_config directory. (Apr�s avoir cr�� les domaines, d�finissez la valeur de la variable AS_ACC_CONFIG sur le fichier sun-acc.xml situ� dans le r�pertoire server_instance_config.) If this value is not set properly, you might get errors while running the applications related to the Application Client Container (ACC). (Si cette valeur n’est pas correctement d�finie, vous risquez d’obtenir des erreurs lors de l’ex�cution des applications li�es � ACC (Application Client Container).) For example: (Par exemple :)

AS_ACC_CONFIG=/var/appserver/domains/domain1/server1/config/sun-acc.xml

where server1 is the application server instance you have created. (o� server1 est l’instance du serveur d’applications que vous avez cr��e.)

4913290

L’authentification bas�e sur le formulaire n’assure pas la m�me fonctionnalit� que dans la version 6.5

Les applications d�velopp�es sur iPlanet Application Server 6.5 et utilisant l’authentification bas�e sur le formulaire peuvent transmettre les param�tres de la requ�te au formulaire d’authentification ou � la page de connexion. La page de connexion peut �tre personnalis�e pour afficher les param�tres d’authentification en fonction des param�tres entr�s.

Solution

Sun ONE Application Server 7 ne prend pas en charge le transfert des param�tres de la requ�te lors de l’affichage de la page de connexion. Les applications utilisant l’authentification bas�e sur la forme, qui transmet les param�tres de la requ�te, ne peuvent pas migrer vers Sun ONE Application Server 7. La migration de ce type d’applications vers Application Server 7 n�cessite des modifications significatives du code. En revanche, vous pouvez stocker les param�tres entr�s dans la session, qui peuvent ensuite �tre r�cup�r�s lors de l’affichage de la page de connexion.

L’exemple de code suivant illustre cette solution :

Avant modification du code dans la version 6.5 :

---------index-65.jsp -----------

<%@page contentType="text/html"%>
<html>
<head><title>JSP Page</title></head>
<body>
Acc�dez � la zone s�curis�e <a href="secured/page.jsp?arg1=test&arg2=me"> </a>
</body>
</html>

----------login-65.jsp--------------

<%@page contentType="text/html"%>
<html>
<head> </head>
<body>
<!-- Impression du formulaire de connexion -->
<h3>Param�tres</h3><br>
out.println("arg1 is " + request.getParameter("arg1"));
out.println("arg2 is " + request.getParameter("arg2"));
</body>
</html>

4913290 (Suite)

Apr�s modification du code dans la version 7.0 :

---------index-7.jsp -----------

<%@page contentType="text/html"%>
<html>
<head><title>JSP Page</title></head>
<body>
<%session.setAttribute("arg1","test"); %>
<%session.setAttribute("arg2","me"); %>
Acc�dez � la zone s�curis�e <a href="secured/page.jsp"> </a>
</body>
</html>

La page index-7.jsp indique o� vous pouvez enregistrer les param�tres de la requ�te d’une session.

----------login-7.jsp--------------

<%@page contentType="text/html"%>
<html>
<head> </head>
<body>
<!-- Impression du formulaire de connexion -->
<h3>Param�tres</h3><br>
<!--r�cup�ration des param�tres de la session -->
out.println("arg1 is " + (String)session.getAttribute("arg1"));
out.println("arg2 is " + (String)session.getAttribute("arg2"));
</body>
</html>

  4913611

Les incompatibilit�s de sp�cifications J2EE ne sont pas document�es.

Developer’s Guide to Web Applications : La remarque suivante s’applique � la description de l’attribut du d�l�gu� :

� If the delegate flag is set to its default value of false, the classloader delegation behavior complies with the Servlet 2.3 specification, section 9.7.2. If set to true, classes and resources residing in container-wide library JAR files are loaded in preference to classes and resources packaged within the WAR file, contrary to what this specification recommends. (Si la balise du d�l�gu� a sa valeur par d�faut (faux), le comportement de la d�l�gation du chargeur de classe est conforme � la sp�cification Servlet 2.3, section 9.7.2. Si elle a la valeur vrai, les classes et ressources r�sidant dans les fichiers JAR de biblioth�que au niveau du conteneur sont charg�s de pr�f�rence � ceux figurant dans le fichier WAR, contrairement � ce qui est recommand� par cette sp�cification.)

Portable programs that use this flag should not be packaged with any classes or interfaces that are a part of the J2EE specification. (Les programmes portables utilisant cette balise ne doivent pas �tre regroup�s avec les classes ou interfaces faisant partie de la sp�cification J2EE.) The behavior of a program that includes such classes or interfaces in its WAR file is undefined. (Le comportement d’un programme contenant ce type de classes ou d’interfaces dans son fichier WAR est impr�visible.) �

Developer’s Guide et Developer’s Guide to Enterprise JavaBeans Technology : La remarque suivante s’applique aux descriptions de l’�l�ment pass-by-reference:

� If the pass-by-reference flag is set to its default value of false, the passing semantics for calls to remote interfaces comply with the EJB 2.0 specification, section 5.4. (Si la balise pass-by-reference a sa valeur par d�faut (faux), la s�mantique de transfert pour les appels adress�s � des interfaces distantes est conforme � la sp�cification EJB 2.0, section 5.4.) If set to true, remote calls involve pass-by-reference semantics instead of pass-by-value semantics, contrary to this specification. (Si elle a la valeur vrai, les appels distants impliquent la s�mantique pass-by-reference au lieu de la s�mantique pass-by-value, contrairement � ce que recommande cette sp�cification.)

Portable programs should not assume that a copy of the object is made during such a call, and thus that it’s safe to modify the original. (Les programmes portables ne doivent pas tenir pour acquis qu’une copie de l’objet est effectu�e lors de ce type d’appel, et que la modification de l’original peut �tre effectu�e en toute s�curit�.) Nor should they assume that a copy is not made, and thus that changes to the object are visible to both caller and callee. (Ils ne doivent pas non plus consid�rer qu’aucune copie n’est effectu�e et que les modifications apport�es � l’objet sont donc visibles de l’appelant et de l’appel�.) When this flag is set, parameters and return values should be considered read-only. (Lorsque cette balise est d�finie, les param�tres et leurs valeurs de retour doivent �tre consid�r�s en lecture seulement.) The behavior of a program that modifies such parameters or return values is undefined. (Le comportement d’un programme modifiant ces param�tres ou valeurs de retour est impr�visible.) �

4915451

La d�finition de idle-timeout-in-seconds dans le manuel Administrator’s Guide est incorrecte.

Dans le Sun ONE Application Server Administrator’s Guide chapitre 6, Monitoring the Sun ONE Application Server, la d�finition de idle-timeout-in-seconds comprend la phrase suivante :

If the current size is less than steady-pool-size, it is increased by pool-resize-quantity, with a ceiling of min (current-pool-size+pool + resize-quantity, max-pool-size). (Si la taille actuelle est inf�rieure � steady-pool-size, elle est augment�e de la valeur de pool-resize-quantity, avec un plafond minimum de (current-pool-size+pool + resize-quantity, max-pool-size).)

Elle doit �tre remplac�e par :

If the current size is less than steady-pool-size, it is increased by pool-resize-quantity, with a ceiling of min (current-pool-size + pool-resize-quantity, max-pool-size). (Si la taille actuelle est inf�rieure � steady-pool-size, elle est augment�e de la valeur de pool-resize-quantity, avec un plafond minimum de (current-pool-size + pool-resize-quantity, max-pool-size).)

4950035

Les informations permettant d’activer les statistiques avec stats-xml dans le Performance Tuning Guide sont incorrectes.

Solution

Dans le manuel Sun ONE Application Server Performance Tuning Guide, chapitre � Tuning Sun ONE Application Server �, la description permettant d’activer les statistiques avec stats-xml contient deux erreurs :

  • Vous devez effectuer la modification dans le fichier nom_instance-obj.conf, et non obj.conf comme indiqu�.
  • L’exemple est incorrect. Les entr�es pour :
  • NameTrans fn="assign-name" from="/stats-xml/*" name="stats-xml" et

    NameTrans fn=assign-name from="/.perf" name="perf"

doivent appara�tre avant la ligne :

NameTrans fn=document-root root="$docroot"

sinon elles seront ignor�es. L’exemple actuel ne pr�sente pas les lignes dans l’ordre ad�quat.

4983280

Les instructions d’installation du plug-in de serveur Web sont incorrectes

Dans la mise � jour 2 du manuel Sun ONE Application Server Administrator’s Guide, les instructions d’installation du plug-in de serveur Web sont incorrectes. La proc�dure ne doit pas inclure l’ajout de directives NSServlet.

Solution

Sous le titre � Using the Web Server Plug-in �, la proc�dure pour � Changes to Sun ONE Web Server � doit indiquer ceci :

Changes to Sun ONE Web Server (Modifications de Sun ONE Web Server)

Take backups of critical configuration files, such as magnus.conf and obj.conf, before making changes to these files. (Effectuez des copies de sauvegarde des fichiers de configuration essentiels, comme magnus.conf et obj.conf, avant de modifier ces fichiers.)

1.  Create a directory in the web server installation area that will contain the web server (passthrough) plug-in. For example: (Cr�ez un r�pertoire dans l’emplacement d’installation du serveur Web qui contiendra le plug-in (transition) du serveur Web. Par exemple :)

cd /webserver_install_dir/plugins

mkdir -p passthrough/bin

2.  Copy the passthrough plug-in from Sun ONE Application Server installation to this new, web server directory. (Copiez le plug-in de transition de l’installation de Sun ONE Application Server vers ce nouveau r�pertoire de serveur Web.) For example: (Par exemple :)

cd appserver_install_dir/lib

cp libpassthrough.so webserver_install_dir/plugins/passthrough/bin

For Windows, copy the passthrough.dll file. (Pour Windows, copiez le fichier passthrough.dll.)

3.  Edit the magnus.conf file, found under webserver_install_dir/https-host.domain/config, and append the following lines: (Modifiez le fichier magnus.conf, sous webserver_install_dir/https-host.domain/config, en lui ajoutant les lignes suivantes :)

Init fn="load-modules"
shlib="webserver_install_dir/plugins/passthrough/bin/libpassthrough.so"
funcs="init-passthrough,auth-passthrough,check-passthrough,service-
passthrough"
NativeThread="no"
Init fn="init-passthrough"

4983280
(Suite)

4.  Edit the obj.conf file, found under webserver_install_dir/https-host.domain/config, and add the NameTrans directive as shown: (Modifiez le fichier obj.conf, sous webserver_install_dir/https-host.domain/config, en lui ajoutant la directive NameTrans comme indiqu� :)

<Object name="default">
NameTrans fn="assign-name" from="/*" name="passthrough"
...
</Object>

The from="/*" URI is the context root of a web application deployed on the remote servers, and passthrough corresponds to the name of the <Object> in obj.conf. (L’URI from="/*" est la racine contexte d’une application Web d�ploy�e sur les serveurs distants, et la transition correspond au nom de l’<objet> dans obj.conf.)

For example: (Par exemple :)

<Object name="default">
NameTrans fn="assign-name" from="(/webapp1|/webapp1/*)" name="passthrough"
...
</Object>

5.  Add the following lines in the obj.conf file: (Ajoutez les lignes suivantes dans le fichier obj.conf :)

<Object name="passthrough">

6.  Restart the Sun ONE Web Server instance. (Red�marrez l’instance de Sun ONE Web Server.)

4986222

Clarification de la documentation relative � JMS.

La documentation fait r�f�rence � une version incorrecte de la documentation Sun ONE Message Queue.

La description de la propri�t� server.xml jms-service instance-name est incorrecte dans le manuel Administrator’s Configuration File Reference de m�me que dans le Developer’s Guide to J2EE Features and Services.

Solution

La version correcte de la documentation Sun ONE Message Queue se trouve sur http://docs.sun.com/db/prod/s1.s1msgqu.

La documentation de la propri�t� jms-service instance-name indique que le nom d’instance du courtier Sun ONE Message Queue est toujours la concat�nation du nom du domaine et de l’instance du serveur. Ceci n’est pas vrai. Vous pouvez utiliser le nom de votre choix.

N/A

Le manuel J2EE CA SPI Administrator’s Guide fait r�f�rence � un titre de manuel incorrect.

Le manuel Sun ONE Application Server J2EE CA SPI Administrator’s Guide fait r�f�rence au manuel Sun ONE Application Server J2EE CA SPI Developer’s Guide. Ce titre est incorrect.

Solution

Les r�f�rences doivent mentionner Sun ONE Application Server Developer’s Guide.


Fichiers redistribuables

Sun ONE Application Server 7 ne contient aucun fichier pouvant �tre redistribu�.


Comment signaler des probl�mes et transmettre des commentaires

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

Pour que nous puissions vous aider � r�soudre un probl�me, pensez � r�unir les informations suivantes lorsque vous contactez l’assistance technique :

Sun attend vos commentaires

Afin d’am�liorer sa documentation, Sun vous encourage communiquer vos commentaires et suggestions. Envoyez vos commentaires � Sun � l’adresse e-mail suivante :

Indiquez le num�ro du document et le titre complet dans la ligne d’objet de votre e-mail. Le num�ro du document se trouve sur la page de titre du manuel ou en haut du document. Il s’agit g�n�ralement d’un nombre � 7 ou 9 chiffres. Par exemple, le num�ro de ce document Notes de mise � jour est 817-6313-10.


Ressources Sun suppl�mentaires

Vous pouvez obtenir des informations utiles concernant Sun ONE sur les sites Internet suivants :


Copyright � 2004 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.

Droits soumis � la loi am�ricaine - Logiciel de commerce. Les utilisateurs de l’�tat sont soumis au contrat de licence standard de Sun Microsystems, Inc. ainsi qu’aux clauses applicables du FAR et de ses suppl�ments.

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 sous contrat de licence par l’Universit� de Californie.

Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques 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.