Chapitre 1 Sun GlassFish Enterprise Server v3 Notes de version

Sun GlassFish^TM Enterprise Server est un serveur compatible avec la plate-forme Java^TM Enterprise Edition (Java EE) 6 permettant de développer et de déployer des applications Java EE et des services Web Java. L'utilisation de ce serveur à des fins de production est gratuite. Son utilisation est également gratuite pour le développement, le déploiement et la redistribution d'applications. Si vous vous intéressez à la redistribution, contactez le service des ventes sur de l'OEM Sun pour obtenir une licence de redistribution.

Les Notes de version de Sun GlassFish Enterprise Server v3 contiennent des informations importantes concernant cette version de Enterprise Server v3, notamment des informations sur les nouvelles fonctions, les configurations matérielle et logicielle requises, ainsi que les problèmes connus et, le cas échéant, leur solution.

Lisez ce document avant d'installer et de configurer le logiciel et avant de commencer à utiliser Sun GlassFish Enterprise Server v3. Consultez ce document régulièrement pour bénéficier de la documentation actualisée.

• Historique des révisions

• Nouveautés de la version Sun GlassFish Enterprise Server v3

• Configurations matérielle et logicielle requises

• Problèmes connus

• Limitations

• Jeu de documentation de Enterprise Server

• Fonctions disponibles uniquement dans le profil de la plate-forme complète

• Normes Java EE 6

• Java EE 6 SDK

• Comment signaler des problèmes et apporter des commentaires

• Ressources complémentaires

• Références à des sites Web tiers

• Fonctions d'accessibilité

Historique des révisions

Cette section répertorie les changements apportés aux Notes de version de Sun GlassFish Enterprise Server v3.

Nouveautés de la version Sun GlassFish Enterprise Server v3

Sun GlassFish Enterprise Server v3 fournit un serveur permettant de développer et de déployer des applications et des technologies Web pour la plate-forme Java Enterprise Edition (plate-forme Java EE) s'appuyant sur la technologie Java.

Les nouvelles fonctionnalités suivantes de Enterprise Server sont décrites dans ce document :

• Prise en charge des profils Java EE

• Conception modulaire

• Prise en charge de l'extension de Enterprise Server

• Intégration de Outil de mise à jour

• Prise en charge des langages de script

• Prise en charge de WSIT (Web Services Interoperability Technologies)

• Améliorations apportées à l'utilitaire appclient

• Intégration d'EclipseLink

• Transfert des paramètres du service HTTP au service réseau

• Modifications liées à l'authentification de l'administrateur

• Modifications liées à l'utilitaire asadmin

• Modifications liées à la structure des fichiers

• Modifications liées aux tâches Ant et à l'utilitaire asant

• Modifications liées à la validation du fichier domain.xml

• Modifications liées aux applications

Prise en charge des profils Java EE

Java EE 6 introduit le concept des profils. Un profil est un ensemble de technologies Java EE et d'API s'adressant à des communautés de développeurs et des types d'application spécifiques.

Les profils suivants sont implémentés via la distribution de Sun GlassFish Enterprise Server v3 :

• Profil Plate-forme complète. Ce profil s'adresse aux développeurs ayant besoin de l'ensemble des API Java EE pour développer des applications d'entreprise. Le profil Plate-forme complète est installé lors de l'installation de Sun GlassFish Enterprise Server v3. Ce profil est également installé lors de l'installation de Java EE 6 SDK.

• Profil Web. Ce profil contient des technologies Web de la plate-forme complète et s'adresse aux développeurs n'ayant pas besoin de l'ensemble des API Java EE. Le profil Web est installé lors de l'installation du profil Web de Sun GlassFish Enterprise Server v3. Ce profil est également installé avec le profil Web de Java EE 6 SDK.

Les distributions de Java EE 6 SDK sont disponibles à partir de Java EE 6 SDK downloads page.

Pour obtenir la liste des API de chaque profil, reportez-vous à la rubrique Normes Java EE 6.

Conception modulaire

Dans Sun GlassFish Enterprise Server v3, le code GlassFish a été divisé en modules afin d'assurer une souplesse et d'offrir de meilleures performances d'exécution. L'architecture modulaire, implémentée dans le respect des normes d'OSGi Alliance, permet de réutiliser les modules de Enterprise Server v3, ainsi que d'autres modules.

Cette modification de conception permet d'utiliser uniquement les modules requis par l'application déployée. Le programme n'est utilisé que pour les applications en ayant besoin et les mises à niveau peuvent être implémentées sans avoir à réinstaller le système dans son intégralité. Ce changement réduit le temps de démarrage, la consommation de mémoire et les exigences en termes d'espace disque.

Cette conception modulaire permet d'effectuer les opérations suivantes :

• Déploiement des bundles OSGi

• Déploiement des fichiers JAR de bibliothèque

• Remplacement d'une fonctionnalité existante par une autre implémentation

Prise en charge de l'extension de Enterprise Server

Une nouvelle interface de fournisseur de système (SPI) du conteneur Sun GlassFish Enterprise Server v3 définit les interfaces que le développeur du conteneur doit implémenter pour que Enterprise Server puisse l'appeler le moment venu. Ce changement permet aux utilisateurs de Enterprise Server de créer des applications de serveurs personnalisées en ajoutant des commandes administratives et des composants graphiques add-on.

Enterprise Server permet également une prise en charge transparente de nouveaux types de modules tels que Ruby on Rails.

Intégration de Outil de mise à jour

Outil de mise à jour est maintenant intégré à la Sun GlassFish Enterprise Server v3 Console d'administration . Il facilite la gestion des composants add-on et des applications annexes qui permettent d'étendre les fonctions de Enterprise Server v3.

La Console d'administration permet d'accéder à la page Outil de mise à jour via l'arborescence de navigation. La page Outil de mise à jour contient des onglets permettant d'afficher les éléments suivants :

• les composants installés ;

• les mises à jour disponibles pour les composants installés ;

• les composants add-on disponibles et pouvant être installés.

L'intégration de Outil de mise à jour à la Console d'administration permet aux administrateurs d'étendre Enterprise Server facilement et d'afficher les mises à jour disponibles. Une version autonome de l'outil de mise à jour est également disponible à l'aide de la commande updatetool. Pour plus d'informations sur l'outil de mise à jour, reportez-vous à la rubrique Update Tool du Sun GlassFish Enterprise Server v3 Administration Guide .

Vous ne pouvez pas mettre à jour les composants existants via l'interface de l'outil de mise à jour de la Console d'administration . Pour mettre à jour ou supprimer des composants installés, vous devez utiliser la version autonome de la ligne de commande ou la commande pkg.

L'outil de mise à jour est disponible dans le projet Update Center. La Console d'administration fait appel à l'API d'Update Center 2.3 pour afficher la liste des composants, versions et dates disponibles. Pour plus d'informations sur Update Center 2.3, reportez-vous aux Release Notes for Update Center 2.3.

L'outil de mise à jour diffère de l'outil de mise à niveau qui est utilisé pour migrer la configuration et les applications déployées d'une version antérieure de Enterprise Server vers la version actuelle. Pour plus d'informations sur l'outil de mise à niveau, reportez-vous au Sun GlassFish Enterprise Server v3 Upgrade Guide.

Prise en charge des langages de script

Afin d'accélérer le développement et le déploiement d'applications, Sun GlassFish Enterprise Server v3 prend en charge divers langages de script. L'utilisation de langages de script permet l'application de Enterprise Server au-delà des développements centrés sur la technologie Java. Les langages de script pris en charge sont les suivants :

• JRuby et Rails: langage de script et structure de développement d'applications Web.

• Grails : structure d'application Web s'appuyant sur le langage de programmation Groovy et complétant le développement Web Java.

• Jython et Django : implémentation Java du langage Python et structure Web pour Python et implémentations de Python (notamment Jython)

• jMaki : structure de création d'applications Web Ajax.

La prise en charge de ces langages de script est permise par des composants qui ne sont pas disponibles par le biais de l'outil de mise à jour.

Prise en charge de WSIT (Web Services Interoperability Technologies)

Sun travaille en étroite collaboration avec Microsoft en vue d'assurer l'interopérabilité des technologies d'entreprise de services Web telles que l'optimisation des messages, la fiabilité des services de messagerie et la sécurité. WSIT est le fruit de cette collaboration. WSIT fait partie de Metro 2.0, une pile extensible de services Web haute performance permettant l'interopérabilité avec Microsoft .NET 3.5. Metro 2.0 est inclus dans la distribution complète de Enterprise Server v3.

WSIT est une implémentation de nombreuses spécifications de services Web ouverts visant à prendre en charge des fonctions d'entreprise. Outre l'optimisation des messages, la messagerie fiable et la sécurité, WSIT inclut une technologie d'initialisation et de configuration. Reprenant les composants XML de base actuellement intégrés à la plate-forme Java, WSIT utilise ou étend les fonctions existantes, et ajoute un nouveau support pour les services Web interopérables, notamment :

• l'initialisation et la configuration ;

• la technologie d'optimisation des messages ;

• la technologie de messagerie fiable ;

• la technologie de sécurité.

Améliorations apportées à l'utilitaire appclient

Dans cette version, l'utilitaire appclient présente les améliorations suivantes :

• L'utilitaire appclient accepte une syntaxe de ligne de commande alternative similaire à la syntaxe du lanceur de l'application Java (java).

• L'option -targetserver est ajoutée pour permettre au serveur et au numéro de port de la cible d'être spécifiés.

• Les écrans d'accueil sont pris en charge dans les clients de l'application.

Pour plus d'informations, reportez-vous à la page man appclient(1M).

Intégration d'EclipseLink

Sun GlassFish Enterprise Server v3 utilise EclipseLink comme fournisseur JPA (Java Persistence API) 2.0. EclipseLink est également l'implémentation de référence de JSR 317. Pour les toutes dernières informations concernant la fonctionnalité EclipseLink, reportez-vous aux EclipseLink 2.0 Release Notes.

Transfert des paramètres du service HTTP au service réseau

Dans Sun GlassFish Enterprise Server v3, la plupart des paramètres du service HTTP ont été transférés dans la configuration du nouveau service réseau. Pour plus d'informations, reportez-vous au Sun GlassFish Enterprise Server v3 Upgrade Guide .

Modifications liées à l'authentification de l'administrateur

Dans Sun GlassFish Enterprise Server v3, vous n'êtes, par défaut, pas invité à saisir les données d'authentification d'administration. Il s'agit d'une modification par rapport aux versions précédentes.

Lorsque vous installez Enterprise Server à partir du fichier ZIP, vous n'êtes pas invité à entrer les données d'authentification d'administration au lancement de la console d'administration ni lors de l'utilisation de l'utilitaire asadmin et des sous-commandes distantes pour exécuter des tâches administratives.

Lorsque vous installez Enterprise Server v3 à partir du fichier auto-extracteur et du programme d'installation graphique, vous n'êtes pas invité à entrer les données d'authentification d'administration à moins d'avoir spécifié un nom d'utilisateur et un mot de passe à la page Paramètres d'administration au cours de l'installation. Si vous avez accepté les paramètres par défaut de cette page, l'utilisateur administratif par défaut est admin et le champ du mot de passe reste vide.

S'il n'y a qu'un seul utilisateur administratif sans mot de passe, les connexions non authentifiées sont autorisées. Pour plus d'informations sur l'authentification de l'administrateur, reportez-vous à la rubrique To Log In to a Domain du Sun GlassFish Enterprise Server v3 Administration Guide .

Les règles d'authentification des administrateurs peuvent être modifiées après l'installation de Enterprise Server. Pour de plus amples informations sur l'utilisation de la console d'administration afin d'effectuer cette opération et des tâches associées, reportez-vous à l'aide en ligne de la console d'administration. Pour plus d'informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à la rubrique Administering Passwords du Sun GlassFish Enterprise Server v3 Administration Guide .

Modifications liées à l'utilitaire asadmin

Le comportement de l'utilitaire asadmin a été modifié afin d'accentuer la différence entre les options de l'utilitaire asadmin et celles de ses sous-commandes. Les options de l'utilitaire asadmin sont dorénavant autorisées avant la sous-commande. Cependant, pour des raisons de compatibilité avec d'autres versions, les options de l'utilitaire asadmin sont encore autorisées après la sous-commande mais cette syntaxe est obsolète.

Pour plus d'informations, reportez-vous à la rubrique Using the asadmin Utility du Sun GlassFish Enterprise Server v3 Administration Guide .

Modifications liées à la structure des fichiers

Sun GlassFish Enterprise Server v3 inclut les modifications de structure de fichiers suivantes par rapport aux versions précédentes :

• Le répertoire d'installation par défaut est le suivant :

  Systèmes Solaris, Linux et Mac OS X : répertoire-personnel-de-l'utilisateur/glassfishv3

  Systèmes Windows : unité-système:\glassfishv3

• Un sous-répertoire glassfish accompagné de sous-répertoires a été ajouté.

• Les bibliothèques du produit ont été déplacées de glassfish/lib à glassfish/modules.

• Un répertoire osgi a été ajouté.

• Un répertoire dédié aux fichiers juridiques a été ajouté. Les fichiers de licence et de copyright se trouvent désormais dans glassfish/legal.

• Sun GlassFish Message Queue est installé dans un répertoire de niveau supérieur et non pas un sous-répertoire.

• Java DB est installé dans un répertoire de niveau supérieur et non pas un sous-répertoire.

Modifications liées aux tâches Ant et à l'utilitaire asant

Sun GlassFish Enterprise Server v3 propose des tâches Ant spécifiques au serveur pour lesquelles Ant doit être installé. L'utilitaire asant n'est pas inclus dans cette version.

Enterprise Server est compatible avec Apache Ant, versions 1.6.5 et plus récentes. Si le script Ant n'est pas installé, vous pouvez l'installer à l'aide de l'outil de mise à jour.

Pour plus d'informations sur l'outil de mise à jour, reportez-vous à la rubrique Update Tool du Sun GlassFish Enterprise Server v3 Administration Guide . Pour plus d'informations sur les tâches Ant, reportez-vous au Chapitre 3, Using Ant with Enterprise Server du Sun GlassFish Enterprise Server v3 Application Development Guide.

Modifications liées à la validation du fichier domain.xml

Sun GlassFish Enterprise Server v3 étant un fichier modulaire extensible, le fichier domain.xml ne peut pas être validé par rapport à un fichier DTD statique. Le fichier domain.xml est à la place validé par rapport aux annotations @Configured du code source. Pour plus d'informations sur la structure du fichier domain.xml,reportez-vous à la Sun GlassFish Enterprise Server v3 Domain File Format Reference .

Modifications liées aux applications

Des différences d'application existent entre Enterprise Server v3 et Enterprise Server v2. Cette rubrique décrit certaines de ces différences.

Option force

La valeur par défaut de l'option force pour le déploiement est false dans Enterprise Server v3. Cette valeur par défaut était true dans Enterprise Server v2. Dans Enterprise Server v3 vous devez explicitement donner à cette option la valeur true pour le redéploiement. Cette option n'est pas définie automatiquement lors du processus de mise à niveau. L'objet de cette modification est d'éviter le remplacement accidentel du contenu d'une application existante. Ceci s'applique à la fois à la console d'administration et à l'utilitaire de ligne de commande.

La commande asadmin redeploy est également une nouveauté de Enterprise Server v3 et est l'équivalent de --force=true. L'option force ne s'applique qu'à la commande deploy (interface de ligne de commande) et à l'écran deploy (console), et non pas à la commande redeploy ni à l'écran redeploy.

Applications et structure de répertoires générée

Enterprise Server v2 dispose de deux sous-répertoires pour le référentiel des applications : applications/j2ee-apps et applications/j2ee-modules. Ces sous-répertoires n'existent pas dans Enterprise Server v3 (il n'existe pas de niveau j2ee-apps ni de niveau j2ee-modules). Le déploiement d'un module autonome tel que foo.war, résidant auparavant dans applications/j2ee-modules/foo dans Enterprise Server v2, s'effectue désormais dans Enterprise Server v3 dans applications/foo. Les applications d'entreprise et les modules autonomes partagent essentiellement le même espace de noms ; la couche de répertoires intermédiaires n'est donc pas nécessaire.

Élément domain.xml application

Les anciens éléments tels que web-module, ejb-module , etc., ont été abandonnés dans Enterprise Server v3 pour être remplacés par le nouvel élément application. Pour plus d'informations sur l'élément application, reportez-vous à application du Sun GlassFish Enterprise Server v3 Domain File Format Reference.

Au cours d'une mise à niveau, les applications Enterprise Server v2 sont redéployées au nouvel emplacement applications/ avec le nouvel élément application du fichier domain.xml. Les nouvelles applications déployées sur Enterprise Server v3 sont déployées avec la nouvelle structure de répertoires et le nouvel élément.

Règles de visibilité plus strictes des fichiers JAR

Java EE 6 impose des règles de visibilité plus strictes des fichiers JAR que Java EE 5. Par conséquent, certaines applications plus anciennes risque de ne pas fonctionner correctement.

Java EE 6 specification impose des règles strictes de visibilité des fichiers JAR à partir d'un fichier EAR (ficher archive d'entreprise). Consultez tout particulièrement la section EE.8.3.3. Les modules client d'application notamment ne doivent avoir accès à aucun fichier JAR EJB à moins que le manifest du fichier JAR de client d'application class-path ne fasse explicitement référence au(x) fichier(s) JAR EJB.

Ceci diffère de Enterprise Server v2 dans lequel les clients d'application avaient automatiquement accès à tous les fichiers JAR EJB dans le fichier EAR, ainsi qu'à tous les fichiers JAR au niveau le plus élevé du fichier EAR. Pour se conformer au langage de spécification plus stricte, Enterprise Server v3 ne peut pas fournir automatiquement aux clients d'application l'accès à ces fichiers JAR.

Ce nouveau comportement plus stricte imposé par Java EE 6 peut être utilisé comme suit :

• Si l'application est déployée sur un domaine Enterprise Server v2, l'outil de mise à niveau préserve le comportement de Enterprise Server v2 de cette application dans ce domaine. Pour plus d'informations sur les mises à niveau, reportez-vous au Sun GlassFish Enterprise Server v3 Upgrade Guide.

• Modifiez le fichier manifeste Class-Path du client afin qu'il réfère explicitement aux fichiers JAR desquels il dépend. Class-Path ne doit pas répertorier les fichiers JAR dans le répertoire de bibliothèque du fichier EAR. De par la spécification , tous les fichiers JAR de ce répertoire sont mis à la disposition de tous les modules du fichier EAR. Ce répertoire est par défaut /lib ; toutefois, vous pouvez définir un autre répertoire à l'aide de library-directory dans le descripteur application.xml.

• Déployez le fichier EAR à l'aide du paramètre facultatif --property compatibility=v2. Ce paramètre permet de préserver le comportement de Enterprise Server v2 pour l'application en question lors de son déploiement sur Enterprise Server v3.

Ce changement de comportement est également abordé dans Chapitre 1, Application Server Compatibility Issues du Sun GlassFish Enterprise Server v3 Upgrade Guide.

Commandes deploy --retrieve et get-client-stubs des clients d'application

Dans Sun GlassFish Enterprise Server v3, l'exécution des commandes deploy --retrieve et get-client-stubs ne télécharge pas un seul fichier JAR dans votre répertoire local comme cela était le cas dans Enterprise Server v2. Bien que la création du répertoire localdir/myAppClient.jar a toujours lieu dans Enterprise Server v3 et qu'il puisse être utilisé comme cible dans la commande appclient, un autre répertoire, localdir/myAppClient , qui peut aussi contenir d'autres fichiers, est également créé.

Si vous avez l'habitude de copier le seul fichier JAR téléchargé de Enterprise Server v2 afin de déplacer les composants des clients d'application d'un emplacement à un autre, cette opération ne fonctionne pas dans Enterprise Server v3. La méthode prise en charge pour cette opération consiste à utiliser la commande asadmin get-client-stubs. Pour plus d'informations sur cette commande, reportez-vous à get-client-stubs(1).

Si vous optez cependant pour la copie, vous devez non seulement copier le fichier localdir/myAppClient.jar (tout comme dans Enterprise Server v2), mais aussi tout le contenu du répertoire localdir/myAppClient.

Configurations matérielle et logicielle requises

Cette section présente la configuration requise pour l'installation de Sun GlassFish Enterprise Server v3.

• Plates-formes prises en charge

• Prise en charge de la virtualisation du système

• Espace disque requis

• Nombre requis de port disponibles

• Informations importantes concernant les patchs

• Version du JDK requise

• Paramètres du chemin d'accès du logiciel JDK

• Pilotes et bases de données JDBC pris en charge

• Navigateurs pris en charge

• Prise en charge de mod_jk

Plates-formes prises en charge

Sun GlassFish Enterprise Server v3 nécessite un minimum de 200 Mo d'espace disque disponible pour son installation et de 100 MOctets de mémoire libre pour son exécution.

Le tableau suivant présente les systèmes d'exploitation pris en charge et fournit des indications concernant les quantités minimales et recommandées de mémoire et d'espace disque, ainsi que la machine virtuelle Java adaptée à chaque cas.

Comme cela est indiqué ci-après, Enterprise Server nécessite JDK^TM release 6. La version minimale (et certifiée) du logiciel JDK 6 nécessaire dépend de votre système d'exploitation. Pour connaître la configuration requise spécifique à une plate-forme, reportez-vous à Version du JDK requise.

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

Utilisez le système de fichiers NTFS plutôt que FAT ou FAT32 pour exécuter Enterprise Server sur une plate-forme Microsoft Windows.

Prise en charge de la virtualisation du système

La virtualisation du système est une technologie permettant l'exécution indépendante de plusieurs instances du système d'exploitation sur un matériel partagé. Le logiciel déployé sur un système d'exploitation hébergé dans un environnement virtualisé ne détecte généralement pas que la plate-forme a été virtualisée. Sun teste ses produits Sun Java System sur des combinaisons de virtualisation de système et de systèmes d'exploitation afin de s'assurer qu'ils fonctionnent aussi bien dans des environnements virtualisés correctement dimensionnés et configurés que dans des environnements non virtualisés. Pour plus d'informations sur le support de Sun pour les produits Sun Java System dans les environnements virtualisés, reportez-vous à l'article System Virtualization Support in Sun Java System Products.

Espace disque requis

Le répertoire temporaire doit disposer de suffisamment d'espace libre pour l'installation des logiciels suivants :

• Sun GlassFish Enterprise Server: 35 Mo minimum

• SDK: 250 Mo minimum

Nombre requis de port disponibles

vous devez disposer de sept ports non utilisés.

Le programme d'installation détecte automatiquement les ports utilisés et propose des ports non utilisés comme paramètres par défaut.

Les attributions de ports initiales par défaut sont présentées dans le tableau suivant. Si ces numéros de ports par défaut sont utilisés, le programme d'installation attribue de manière aléatoire un numéro de port à partir de la plage de ports dynamiques. Il se peut que le numéro de port sélectionné ne soit pas le numéro disponible suivant.

Informations importantes concernant les patchs

Patchs requis pour Solaris

Sous Solaris 10 vous devez appliquer le patch correspondant à votre plate-forme, comme présenté dans le tableau suivant.

Vous devez également vous assurer que le bloc de patchs recommandé Sun est appliqué.

Ces patchs et le bloc de patchs sont disponibles à partir du programme SunSolve^SM web site.

• Pour obtenir un patch, cliquez sur le lien Patchfinder, puis utilisez le champ Patch ID pour trouver le patch.

• Pour obtenir un bloc de patchs, cliquez sur le lien Patch Cluster & Patch Bundle Downloads dans la section Downloads, puis sur le lien Recommended Patch Clusters.

Version du JDK requise

L'installation de Sun GlassFish Enterprise Server v3 nécessite JDK release 6.

La version minimale (et certifiée) du logiciel JDK requise par Enterprise Server dépend de votre système d'exploitation :

• Pour les systèmes d'exploitation pris en charge, excepté Mac OS X, la version minimale requise est 1.6.0_17.

• Pour le système d'exploitation Mac OS X, la version minimale requise est 1.6.0_15.

Paramètres du chemin d'accès du logiciel JDK

Les fichiers binaires suivants utilisés avec Enterprise Server doivent provenir du logiciel JDK et non pas du logiciel Java Runtime Environment (JRE^TM):

• java

• keytool

Pour se conformer à cette exigence, assurez-vous que le répertoire bin contenant le logiciel JDK précède le répertoire bin du logiciel JRE dans votre chemin d'accès.

Pilotes et bases de données JDBC pris en charge

Le tableau suivant répertorie les bases de données et pilotes pris en charge dans cette version. Toutes les configurations de Sun GlassFish Enterprise Server v3 prises en charge doivent être constituées d'une base de données et d'un pilote figurant dans ce tableau, par ex. la base de données Java et le pilote associé. En outre, Enterprise Server est conçu de manière à prendre en charge la connectivité, grâce à la technologie Java DataBase Connectivity (JDBC^TM), avec tout système de gestion de bases de données (SGBD) supplémentaire avec un pilote correspondant qui prend en charge l'API JDBC (pilote JDBC).

Navigateurs pris en charge

Le tableau suivant répertorie les navigateurs et les versions pris en charge.

Prise en charge de mod_jk

Sun GlassFish Enterprise Server v3 prend en charge mod_jk 1.2.x, avec 1.2.26 minimum.

Problèmes connus

Cette section décrit les problèmes connus de Sun GlassFish Enterprise Server v3 et leurs solutions éventuelles.

• [JDK_Issue] Dégradation des performances dû à l'appel de setSoLinger ou de setReuseAddress (problème 7109)

• [JDK_Issue] Exception de pointeur nul lors du redémarrage du serveur (problème 8299)

• [JDK_Issue] Exception d'E/S : argument incorrect au cours du test de longévité (problème 7529)

• [JDK_Issue] Exception de pointeur nul EPoll au démarrage (problème 9472)

• [JDK_ISSUE] Richaccess : java.io.IOException: Argument incorrect de doSelect (problème 8573)

• Les droits d'accès au répertoire /applications d'un domaine peuvent générer l'erreur NullProcessException (problème 6545)

• Le fichier journal d'installation de Windows n'est pas lisible (problème 4881)

• L'accès aux statistiques de nouveaux serveurs virtuels nécessite le redémarrage du serveur (problèmes 6238 et 6422)

• [Open Installer] L'option -l permettant de repositionner les fichiers journaux est ignorée sous Windows (problème 10693)

• Problèmes de distribution ZIP lorsque l'UAC est activé sous Windows Vista (problème 10755)

• Exception de pointeur nul générée par com.sun.xml.wss.NonceManager.getInstance (problème 11138)

• [Open Installer] Menu Démarrer non affiché, puis vide sous Windows Vista et Windows 2008 (problème 5087)

• Lorsque l'application specj est déployée, asadmin get --monitor=true "server.*" génère une erreur d'E/S (problème 11163)

• Échec de l'outil de mise à jour autonome avec erreur de segmentation sous Solaris (problème 11222)

• Les applications Ruby déployées à la racine du contexte ne fonctionnent pas avec la console d'administration (problème 10854)

• La prise en charge des beans gérés Java EE 6 n'est pas disponible dans les clients d'application lancés à l'aide de Java Web Start (problème 11257)

• Affichage de messages d'avertissement lors de l'appel du script appclient sur Mac OS X avec Java d'Apple installée (8644)

• Le lancement d'un client d'application génère parfois l'erreur ClassNotFound pour la classe principale du client (problème 11181)

• Pour être pris en compte, le changement de l'emplacement du fichier journal requiert le redémarrage du serveur (problème 11142)

• Impossible d'ouvrir les fichiers journaux d'installation à partir des liens de l'écran de résumé sous Linux et Mac OS (problème 6621)

• La commande updatetool ne fonctionne pas si vous effectuez sous Windows une réinstallation dans le même répertoire d'installation (problème 8233)

• [Update Center] Échec de l'accès aux répertoires non utilisateur (problème du centre de mise à jour 1583)

• L'aide intégrée et la page man de l'interface de ligne de commande (CLI) répertorient une version de servlet incorrecte (2.4) dans X-Powered-By (problème 11011)

• [Embedded] Le déploiement de l'application contenant activation-1.1.jar échoue lorsque vous utilisez uber-jar (problème 11149)

• La commande create-service ne parvient pas à créer de service sans AS_ADMIN_USER dans passwordfile sous Solaris (problème 11119)

• [Monitoring] Vue de contrôle supplémentaire de connector-connection-pools non disponible (problème 11256)

• [EclipseLink] Problèmes liés à ElementCollections concernant les éléments intégrables (problème EclipseLink 296606)

• Serveur virtuel démarré deux fois (problème 11195)

• Problèmes de débogage de JPA (problème 11274)

• Échec de l'interopérabilité d'EJB distants lorsque l'EJB cible se trouve sur le même hôte (problème 11152)

• Le programme d'installation se bloque à 41 % par intermittence sous Windows Vista et Windows 7 (problème 11185)

• Impossible d'envoyer des messages JMS d'un système à un autre (problème 11254)

• Le menu système de Windows est vide (problème 11239)

• Base de données mysql non répertoriée dans la liste des bases de données prises en charge par --dbvendorname sur la page de manuel relative à la commande de déploiement (problème 11328)

• ACC intégré trop strict sur le chargeur de classe de contexte du thread actif (problème 11427)

• Problème de configuration du service d'horloge EJB pour MySQL (problème 11428)

• Échec de la sous-commande de déploiement sur le serveur sécurisé (problème 11439)

• Certificat expiré dans le truststore Enterprise Server (6852796)

[JDK_Issue] Dégradation des performances dû à l'appel de setSoLinger ou de setReuseAddress (problème 7109)

Description

Lorsque la méthode setSoLinger ou la méthode setReuseAddess est appelée, les performances sont dégradées et l'exception suivante est générée :

[#|2009-01-26T00:33:56.325-0800|WARNING|sun-appserver9.1|
javax.enterprise.system.container.web|_ThreadID=17;
_ThreadName=SelectorReaderThread-8084;
_RequestID=11ae0030-c392-4217-8408-cfa7efe0a879;|setSoLinger
exception
java.net.SocketException: Invalid argument

Ce problème est lié à un problème du logiciel JDK. Ce problème est résolu dans JDK version 7.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

[JDK_Issue] Exception de pointeur nul lors du redémarrage du serveur (problème 8299)

Description

Le redémarrage de Enterprise Server génère parfois une exception de pointeur nul.

SEVERE: doSelect exception
java.lang.NullPointerException

Ce problème est lié à un problème du logiciel JDK. Ce problème est résolu dans JDK version 7.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

[JDK_Issue] Exception d'E/S : argument incorrect au cours du test de longévité (problème 7529)

Description

Au cours d'un test de longévité HTTP, l'exception suivante est générée au bout de 42 heures :

[#|2009-04-05T17:41:26.537-0700|SEVERE|glassfish|javax.enterprise.system.core|
_ThreadID=15;_ThreadName=Thread-1;|doSelect
exception
java.io.IOException: Invalid argument

L'instance et l'application sont toujours accessibles pendant l'exécution.

Ce problème est lié à un problème du logiciel JDK. Ce problème est résolu dans JDK version 7.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

[JDK_Issue] Exception de pointeur nul EPoll au démarrage (problème 9472)

Description

Au démarrage, Enterprise Server génère une exception de pointeur nul :

java.lang.NullPointerException
        at sun.nio.ch.Util.atBugLevel(Util.java:326)
        at sun.nio.ch.SelectorImpl.<init>(SelectorImpl.java:40)
        at sun.nio.ch.EPollSelectorImpl.<init>(EPollSelectorImpl.java:47)

Ceci concerne Grizzly et est lié à un problème du logiciel JDK 6. Ce problème est résolu dans JDK 7.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune. Grizzly tente de résoudre ce problème mais n'y parvient pas toujours.

[JDK_ISSUE] Richaccess : java.io.IOException: Argument incorrect de doSelect (problème 8573)

Description

L'exception suivante s'affiche :

[#|2009-06-20T06:05:57.942-0700|SEVERE|glassfish|
com.sun.grizzly.config.GrizzlyServiceListener|
_ThreadID=21;_ThreadName=Thread-2;|doSelect
IOException
java.io.IOException: Invalid argument

Il s'agit d'un problème lié à JDK qui devrait être corrigé dans JDK 1.6.0_18.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Augmentez le nombre maximum de descripteurs de fichier à 10 000 ou plus (la valeur par défaut sous Solaris est 64000). Installez JDK 1.6.0_18 dès qu'il est disponible.

Les droits d'accès au répertoire /applications d'un domaine peuvent générer l'erreur NullProcessException (problème 6545)

Description

Si le répertoire /applications d'un domaine en limite l'accès, ou si vous déployez un répertoire depuis un répertoire limité, le serveur ne parvient pas à lire les fichiers contenus dans le répertoire développé. Une erreur NullProcessException survient lors du déploiement.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Modifiez les paramètres d'accès à ces répertoires de sorte à accorder des droits de serveur autorisant la lecture de leur contenu.

Le fichier journal d'installation de Windows n'est pas lisible (problème 4881)

Description

Le fichier horodatage-install.log ne peut pas être lu, car toutes les lignes écrites dans le fichier sont concaténées en une seule chaîne longue.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Faites appel à un éditeur différent et ouvrez manuellement le fichier journal d'installation créé dans le répertoire %TEMP%.

L'accès aux statistiques de nouveaux serveurs virtuels nécessite le redémarrage du serveur (problèmes 6238 et 6422)

Description

Les statistiques de contrôle concernant les serveurs virtuels récemment ajoutés sont disponibles uniquement après le redémarrage du serveur.

Pour plus d'informations, reportez-vous aux rapports de Issue 6238 et de Issue 6422.

Solution

Après l'ajout d'un serveur virtuel, redémarrez le serveur pour afficher les données de contrôle du serveur virtuel.

[Open Installer] L'option -l permettant de repositionner les fichiers journaux est ignorée sous Windows (problème 10693)

Description

L'option -l permettant de repositionner les fichiers journaux est ignorée lorsqu'elle est utilisée avec les options -a et -s, et les fichiers journaux sont créés à l'emplacement par défaut.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

Problèmes de distribution ZIP lorsque l'UAC est activé sous Windows Vista (problème 10755)

Description

Certaines fonctions ne fonctionnent pas correctement sous Windows Vista lorsque l'UAC (contrôle des comptes utilisateur) est activé. La Console d'administration , par exemple, ne peut pas être lancée.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Désactivez l'UAC, puis réinitialisez.

Exception de pointeur nul générée par com.sun.xml.wss.NonceManager.getInstance (problème 11138)

Description

Lorsque vous testez un service Web JAX-RPC alors que le fournisseur de sécurité des messages GlassFish est activé, l'exception suivante est générée dans les fichiers journaux du serveur :

[#|2009-11-23T11:16:58.375+0005|SEVERE|glassfishv3.0|
javax.enterprise.resource.webservices.rpc.server.http|_ThreadID=25;_
ThreadName=http-thread-pool-8080-(2);|caught
throwable
java.lang.RuntimeException: com.sun.enterprise.security.jauth.AuthException

La valeur par défaut de la propriété nonce ne fonctionne pas.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Pour utiliser la sécurité des messages avec les services Web JAX-RPC, désactivez la propriété nonce dans la configuration. Reportez-vous au rapport du problème qui contient une solution.

[Open Installer] Menu Démarrer non affiché, puis vide sous Windows Vista et Windows 2008 (problème 5087)

Description

Le groupe de menus Démarrer de Enterprise Server ne s'affiche pas à l'issue de l'installation. Lorsque vous vous déconnectez, puis vous reconnectez, le groupe de menus s'affiche mais est vide.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

Lorsque l'application specj est déployée, asadmin get --monitor=true "server.*" génère une erreur d'E/S (problème 11163)

Description

La commande asadmin get -m "server.*" renvoie toutes les données de contrôle relatives à ce serveur. Lorsque plusieurs applications sont déployées, la quantité de données est relativement volumineuse et leur renvoi peut de ce fait prendre un certain temps. Le délai de temporisation du client est parfois dépassé, générant l'erreur suivante sur celui-ci :

./asadmin get --monitor=true "server.*"
I/O Error: Read timed out
Command get failed.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Réduisez la quantité de données que le client doit renvoyer.

1. Exécutez la commande asadmin list -m "server.*" qui renvoie les éléments au niveau supérieur.

2. Sélectionnez l'élément de niveau supérieur pour lequel des renseignements sont requis, puis utilisez-les comme filtre. Exemple :

   > ./asadmin list -m "server.*" ... server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-cache server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods. create-int-int-[Lorg\.spec\.jappserver\.supplier\.helper\.ComponentOrder server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods. findByPrimaryKey-java\.lang\.Integer server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.generateXml server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.getEJBLocalHome ... >./asadmin get -m "server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.*" ... server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.remove. methodstatistic-name = MethodStatistic server.applications.SPECjAppServer.supplier\.jar.POEnt.bean-methods.remove. methodstatistic-starttime = 1259604209775 ...

Échec de l'outil de mise à jour autonome avec erreur de segmentation sous Solaris (problème 11222)

Description

Lors de l'installation des composants add-on, l'outil de mise à jour autonome lancé à l'aide de la commande updatetool échoue et génère une erreur de segmentation sous Solaris.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Assurez-vous que votre système est conforme aux exigences requises des patchs de l'outil de mise à jour autonome définies dans lesUpdate Center Release Notes.

La fonction Outil de mise à jour de la console d'administration utilise une autre API de centre de mise à jour Java et n'est pas affectée par ce problème.

Les applications Ruby déployées à la racine du contexte ne fonctionnent pas avec la console d'administration (problème 10854)

Description

Si une application Ruby est déployée à la racine du contexte '/' et que vous accédez ensuite à la console d'administration, l'application Ruby génère une erreur 404 lorsque vous y accédez.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

La prise en charge des beans gérés Java EE 6 n'est pas disponible dans les clients d'application lancés à l'aide de Java Web Start (problème 11257)

Description

Lorsque Java Web Start est utilisé pour lancer un client d'application, les beans gérés du client d'application ne sont pas reconnus.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Lancez le client d'application à l'aide du script appclient. Les beans gérés du client d'application sont alors pris en charge normalement.

Affichage de messages d'avertissement lors de l'appel du script appclient sur Mac OS X avec Java d'Apple installée (8644)

Description

Lorsque vous appelez le script appclient sur des systèmes Mac OS X sur lesquels la technologie Java d'Apple est installée, le suivi de pile suivant s'affiche deux fois (seules les premières lignes sont illustrées ici) :

Intentionally suppressing recursive invocation exception!
java.lang.IllegalStateException: recursive invocation
    at java.lang.ClassLoader.initSystemClassLoader(ClassLoader.java:1394)
    at java.lang.ClassLoader.getSystemClassLoader(ClassLoader.java:1377)
    at sun.security.jca.ProviderConfig$1.run(ProviderConfig.java:64)
...

Pour plus d'informations, reportez-vous à Issue report.

Solution

Aucune action n'est requise.

Malgré les messages d'avertissement, le client est lancé avec succès et s'exécute normalement. Ces erreurs sont dues à un problème lié à l'implémentation de Java d'Apple.

Le lancement d'un client d'application génère parfois l'erreur ClassNotFound pour la classe principale du client (problème 11181)

Description

Un problème se produit lorsque toutes les conditions suivantes sont vérifiées :

• L'application est un fichier EAR contenant un client d'application.

• Le fichier EAR est un répertoire déployé.

• Le fichier EAR contient un module client d'application myAppClient.jar qui, de part sa nature (déploiement de répertoire), est déjà étendu dans myAppClient_jar. (Dans cet exemple, l'EAR s'appelle myApp. Il peut porter n'importe quel nom.)

Les tentatives de lancement du client d'application échouent et génèrent l'erreur ci-après car un fichier généré sur le serveur est placé dans le mauvais répertoire de serveur et écrase l'autre fichier généré :

java.lang.ClassNotFoundException:(main-class-for-the-client)

Pour plus d'informations, reportez-vous à Issue report.

Solution

Donnez au client d'application un nom autre que myAppClient.jar . Notamment :

1. Modifiez myApp/META-INF/application.xml de sorte que la déclaration du client soit <java>myClient.jar</java>. Notez que vous pouvez utiliser tout nom autre que myAppClient.jar.

2. Remplacez le nom de répertoire myApp/myAppClient_jar par myApp/myClient_jar. Notez que le nom du sous-répertoire du client doit correspondre à celui de l'URI du client d'application dans le fichier application.xml, .jar étant remplacé par _jar.

3. Déployez l'application :

   asadmin deploy --retrieve localdir myApp

4. Exécutez le client d'application :

   appclient -client localdir/myAppClient.jar

Pour être pris en compte, le changement de l'emplacement du fichier journal requiert le redémarrage du serveur (problème 11142)

Description

Les modifications apportées aux valeurs du journal du serveur sous l'onglet Général de la page Paramètres de l'enregistreur de la console d'administration ne prennent pas effet immédiatement.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Redémarrez le serveur. Toutes les modifications apportées aux valeurs de cette page requièrent un redémarrage du serveur pour être prise en compte.

Impossible d'ouvrir les fichiers journaux d'installation à partir des liens de l'écran de résumé sous Linux et Mac OS (problème 6621)

Description

Les fichiers journaux d'installation ne peuvent pas être ouverts en cliquant sur les liens de la page de résumé qui s'affiche à la fin du processus d'installation dans le programme d'installation graphique.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Accédez aux fichiers manuellement. Les noms du fichier journal d'installation et du fichier de résumé sont horodatage-install.log et horodatage-install-summary.html. Dans les systèmes Linux et Mac, ces fichiers sont créés dans le répertoire $TMP.

La commande updatetool ne fonctionne pas si vous effectuez sous Windows une réinstallation dans le même répertoire d'installation (problème 8233)

Description

Si vous réinstallez Enterprise Server (avec l'outil de mise à jour) dans le même répertoire de l'installation et avec les mêmes valeurs par défaut, puis appelez l'outil de mise à jour à l'aide de la commande updatetool , un message indiquant que l'outil de mise à jour n'est pas installé et vous demandant si vous souhaitez l'installer s'affiche. Ceci ne se produit que sous Windows.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Une fois la désinstallation terminée, supprimez manuellement le répertoire .org* restant avant de procéder à la réinstallation.

[Update Center] Échec de l'accès aux répertoires non utilisateur (problème du centre de mise à jour 1583)

Description

Ce problème se produit de manière intermittente sous Windows et Mac OS. pkg(5) ne fonctionne pas toujours sur certains systèmes.

Pour plus d'informations, reportez-vous à Update Center Issue report.

Solution.

aucune.

L'aide intégrée et la page man de l'interface de ligne de commande (CLI) répertorient une version de servlet incorrecte (2.4) dans X-Powered-By (problème 11011)

Description

L'aide intégrée et la page man de l'interface de ligne de commande (CLI) répertorient la servlet 2.4 dans le champ X-Powered-By. La version correcte de servlet est 3.0.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

[Embedded] Le déploiement de l'application contenant activation-1.1.jar échoue lorsque vous utilisez uber-jar (problème 11149)

Description

Lors de l'utilisation de embedded avec glassfish-embedded-all-3.0-b73.jar, le déploiement échoue avec l'erreur suivante :

SEVERE: WEB9051: Error trying to scan the classes at
/private/var/folders/CV/CVhj8DvqEwGK5bdJKK9TaE   TI/-Tmp-
/gfembed6991712842235699248tmp/applications/xwiki-enterprise-web-2.0/
WEB-INF/lib/activation-1.1.jar for annotations in which a 
ServletContainerInitializer has expressed interest
java.util.zip.ZipException: error in opening zip file

Ce problème se produit parce que embedded utilise un dossier doté de signes plus (+) et que les signes plus d'un chemin sont convertis en espaces " " lorsque le chemin est décodé.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Une propriété système a été ajoutée pour vous permettre de placer des répertoires temporaires. La propriété est glassfish.embedded.tmpdir et peut être définie de manière à ce que le répertoire temporaire de domaine ne soit pas placé dans le répertoire de l'utilisateur.

La commande create-service ne parvient pas à créer de service sans AS_ADMIN_USER dans passwordfile sous Solaris (problème 11119)

Description

La commande create-service ne parvient pas à créer de service sans AS_ADMIN_USER dans passwordfile sous Solaris.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

[Monitoring] Vue de contrôle supplémentaire de connector-connection-pools non disponible (problème 11256)

Description

Enterprise Server utilise une structure arborescente pour suivre les objets contrôlables. Dans cette arborescence, la vue suivante n'est pas disponible pour obtenir les statistiques de pool de connexions :

server.connector-service.nom-de-l'adaptateur-de-ressources.nom--du-pool-de-connexions .* ou server.jms-service.connection-factories. nom-d'usine-des-connexions.* (pour pools jms-ra).

Pour plus d'informations, reportez-vous à Issue report.

Solution

Utilisez la vue server.resources.* pour obtenir les statistiques.

Pour plus d'informations sur le contrôle, reportez-vous à Chapitre 8, Administering the Monitoring Service du Sun GlassFish Enterprise Server v3 Administration Guide.

[EclipseLink] Problèmes liés à ElementCollections concernant les éléments intégrables (problème EclipseLink 296606)

Description

Lorsque le tramage est activé, les mises à jour d'une collection d'éléments intégrables risquent de générer une exception de pointeur nul.

Pour plus d'informations, reportez-vous à EclipseLink Issue report.

Solution

Deux solutions sont disponibles :

1. Ajoutez l'annotation @ChangeTracking(DEFFERED) sur l'élément intégrable et donnez à la propriété eclipselink.weaving.internal la valeur false ; ou

2. Donnez aux propriétés suivantes la valeur false dans le XML de persistance : eclipselink.weaving.changetracking et eclipselink.weaving.internal.

Serveur virtuel démarré deux fois (problème 11195)

Description

Après avoir démarré le domaine et accédé à localhost:4848, les messages suivants sont constatés dans le journal du serveur :

[#|2009-11-27T16:21:57.091+1100|INFO|glassfishv3.0|
javax.enterprise.system.container.web.com.sun.enterprise.web|
_ThreadID=20;_ThreadName=Thread-1;|Created
virtual server server|#]

[#|2009-11-27T16:21:57.091+1100|INFO|glassfishv3.0|
javax.enterprise.system.container.web.com.sun.enterprise.web|
_ThreadID=20;_ThreadName=Thread-20;|Created
virtual server server|#]

Ces messages donnent l'impression que le serveur virtuel, server , a été démarré deux fois. Ce n'est pas le cas. Les serveurs virtuels ne sont démarrés qu'une fois mais les messages sont enregistrés plusieurs fois.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

Problèmes de débogage de JPA (problème 11274)

Description

Le débogage de JPA est difficile car le nombre de messages envoyés par le serveur est limité.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Ajoutez la propriété org.eclipse.persistence.session.level=INFO au fichier logging.properties. Vous pouvez ensuite utiliser la Console d'administration pour contrôler les enregistreurs EclipseLink.

Échec de l'interopérabilité d'EJB distants lorsque l'EJB cible se trouve sur le même hôte (problème 11152)

Description

L'interopérabilité d'EJB distants ne fonctionne pas lorsque l'EJB cible se trouve sur le même hôte (autre domaine de Enterprise Server ou autre instance de Enterprise Server v3).

Pour plus d'informations, reportez-vous à Issue report.

Solution

Définissez la propriété suivante dans jvm-options:

-Dorg.glassfish.orb.iiop.orbserverid=:

Le programme d'installation se bloque à 41 % par intermittence sous Windows Vista et Windows 7 (problème 11185)

Description

Le programme d'installation de l'interface graphique de Enterprise Server s'interrompt à 41 % de l'installation sous Windows Vista et Windows 7. Cela ne se produit pas à chaque tentative d'installation.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Ce problème est lié à la fonctionnalité de réglage automatique de Windows Vista et Windows 7 qui est activée par défaut.

Si votre première installation de Enterprise Server s'interrompt ou que l'ajout de packages ou l'application de mises à jour s'interrompt, restreignez ou désactivez la fonctionnalité de réglage automatique.

Impossible d'envoyer des messages JMS d'un système à un autre (problème 11254)

Description

Par défaut, le nom d'hôte par défaut du service JMS sur Enterprise Server est localhost. Pour accéder au service JMS à partir d'un autre système, vous devez par contre modifier le nom d'hôte. Vous pouvez le remplacer par le nom d'hôte réel ou par 0.0.0.0.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Pour le modifier, effectuez l'une des opérations suivantes :

1. À partir de la Console d'administration  : Développez les nœuds Configuration, Service de message JMS et Hôtes JMS, sélectionnez default_JMS_host, puis modifiez le champ Hôte ; ou,

2. Utilisez une sous-commande asadmin telle que :

   asadmin set server-config.jms-service.jms-host.default_JMS_host.host="0.0.0.0" ; ou

   asadmin set server-config.jms-service.jms-host.default_JMS_host.host="hostname"

Le menu système de Windows est vide (problème 11239)

Description

Quand Enterprise Server est installé à l'aide du programme d'installation graphique, l'installation se déroule correctement mais seule l'entrée de niveau supérieur GlassFish v3 est ajoutée au menu système de Windows et elle est vide. Ce problème se produit tout aussi bien avec les versions localisées qu'avec la version anglaise du programme d'installation.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

Base de données mysql non répertoriée dans la liste des bases de données prises en charge par --dbvendorname sur la page de manuel relative à la commande de déploiement (problème 11328)

Description

Base de données mysql non répertoriée dans la liste des bases de données prises en charge par --dbvendorname sur la page de manuel relative à la commande de déploiement. Il s'agit d'une erreur. MySQL est une base de données prise en charge et devrait donc figurer dans la liste.

Pour plus d'informations, reportez-vous à Issue report.

Solution

aucune.

ACC intégré trop strict sur le chargeur de classe de contexte du thread actif (problème 11427)

Description

L'ACC s'attend à ce que le chargeur de classe de contexte du thread actif soit ACCClassLoader. Ce paramètre est trop restrictif. Bien que cette condition soit remplie pour les exécutions de script appclient et Java Web Start, elle n'est pas nécessairement remplie pour l'ACC intégré. D'autres fonctions à l'intérieur de l'ACC nécessitent un chargeur de classe de type URLClassLoader (ou une instance d'une sous-classe de URLClassLoader), mais le chargeur ne doit pas nécessairement être un chargeur de type ACCClassLoader.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Deux solutions sont disponibles :

1. Définissez -Djava.System.class.loader=org.glassfish.appclient.client.acc.ACCClassLoader , ou

2. Dans votre programme Java, créez une instance ACCClassLoader et définissez-la en tant que chargeur de classe de contexte du thread actif à l'aide de la commande Thread.currentThread().setContextClassLoader avant d'utiliser les classes et interfaces ACC intégrées.

Problème de configuration du service d'horloge EJB pour MySQL (problème 11428)

Description

La création et le stockage du service d'horloge EJB dans MySQL sont possibles en tant qu'utilisateur, mais une exception est renvoyée lors de la tentative de configuration du service d'horloge EJB pour MySQL(déclaration d'exécution SQLException ) :

"CREATE TABLE EJB__TIMER__TBL (TIMERID
VARCHAR(255) NOT NULL, BLOB BLOB(64000), INITIALEXPIRATIONRAW BIGINT, SCHEDULE
VARCHAR(255), INTERVALDURATION BIGINT, OWNERID VARCHAR(255), STATE INTEGER,
LASTEXPIRATIONRAW BIGINT, PKHASHCODE INTEGER, CREATIONTIMERAW BIGINT,
CONTAINERID BIGINT, PRIMARY KEY (TIMERID))":
com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: You have an error in
your SQL syntax; check the manual that corresponds to your MySQL server version
for the right syntax to use near 'BLOB BLOB(64000), INITIALEXPIRATIONRAW BIGINT,
SCHEDULE VARCHAR(255), INTERVALDU' at line 1|#] 

Pour plus d'informations, reportez-vous à Issue report.

Solution

Assurez-vous que le nom de classe de source de données spécifié pour le pool d'horloge représente une source de données XA.

Étapes MySQL spécifiques :

1. Décompressez le fichier glassfishv3/glassfish/lib/install/applications/ejb-timer-service-app.war .

2. Ajoutez la chaîne suivante à WEB-INF/classes/__ejb_timer_mappings.xml après <persistence-unit-metadata>:

   <persistence-unit-defaults>
   <delimited-identifiers/>
   </persistence-unit-defaults>

3. Compressez de nouveau le fichier WEB-INF/classes/__ejb_timer_mappings.xml.

4. Cette étape est requise uniquement si l'installation actuelle a déjà utilisé le service d'horloge EJB. Créez manuellement EJB__TIMER__TBL dans la base de données en utilisant cette déclaration de création :

   CREATE TABLE `EJB__TIMER__TBL` (`TIMERID` VARCHAR(255) NOT NULL,
   `BLOB` BLOB(64000), `INITIALEXPIRATIONRAW` BIGINT, `SCHEDULE` VARCHAR(255),
   `INTERVALDURATION` BIGINT, `OWNERID` VARCHAR(255), `STATE` INTEGER,
   `LASTEXPIRATIONRAW` BIGINT, `PKHASHCODE` INTEGER, `CREATIONTIMERAW` BIGINT,
   `CONTAINERID` BIGINT, PRIMARY KEY (`TIMERID`))

Échec de la sous-commande de déploiement sur le serveur sécurisé (problème 11439)

Description

La sous-commande de déploiement échoue sur un serveur sécurisé à moins que l'option --secure soit utilisée.

Pour plus d'informations, reportez-vous à Issue report.

Solution

Activez l'option --secure lorsque vous exécutez la sous-commande de déploiement sur un serveur sécurisé.

Certificat expiré dans le truststore Enterprise Server (6852796)

Description

L'un des certificats d'autorité du truststore Enterprise Server a expiré le 7 janvier 2010. Il s'agit du certificat cacerts.jks. Un message d'erreur indiquant que le certificat a expiré est généré au démarrage :

Version: V1
  Subject: OU=Secure Server Certification Authority, O="RSA Data Security, Inc.", C=US
  Signature Algorithm: MD2withRSA, OID = 1.2.840.113549.1.1.2

  Key:  SunPKCS11-Solaris RSA public key, 1000 bits (id 17891456, session object)
  modulus: 
  public exponent: 
  Validity: [From: Tue Nov 08 19:00:00 GMT-05:00 1994,
               To: Thu Jan 07 18:59:59 GMT-05:00 2010]
  Issuer: OU=Secure Server Certification Authority, O="RSA Data Security, Inc.", C=US
  SerialNumber: [    02ad667e 4e45fe5e 576f3c98 195eddc0]

Pour plus d'informations, reportez-vous à Issue report.

Solution

Le certificat d'autorité expiré a été supprimé dans la mise à jour 18 de Java SE 6. Il sera également supprimé du truststore Enterprise Server lors d'une prochaine mise à jour.

Vous pouvez ignorer les messages d'erreur et utiliser la mise à jour ou vous pouvez supprimer les messages d'erreur. Pour cesser de recevoir des messages d'erreur, utilisez keytool afin de supprimer le certificat du truststore Enterprise Server :

=> cd domains/domainX/config
=> cp cacerts.jks cacerts.jks.save
=> keytool -delete -keystore cacerts.jks -alias verisignserverca
Enter keystore password:

Pour empêcher le certificat expiré de réapparaître dans les domaines créés à l'avenir, vous devez également le supprimer du modèle de truststore :

=> cd glassfish/lib/templates
=> cp cacerts.jks cacerts.jks.save
=> keytool -delete -keystore cacerts.jks -alias verisignserverca
Enter keystore password:

Pour plus d'informations sur le mot de passe keystore, consultez les informations sur les mots de passe et les keystores dans la section Authentication du Sun GlassFish Enterprise Server v3 Administration Guide.

Limitations

Cette section décrit les limitations suivantes de Sun GlassFish Enterprise Server v3 :

• Options non prises en charge dans les commandes asadmin

• Pas de prise en charge de la VM cliente sous Windows AMD64

Options non prises en charge dans les commandes asadmin

L'aide concernant les commandes asadmin décrit certaines options qui ne sont pas prises en charge par Sun GlassFish Enterprise Server v3. Exemple :

• les options liées aux clusters et aux instances de serveur multiples, par exemple, l'option --target ;

• les options liées aux profils, par exemple, l'option --profile.

Si vous spécifiez une option non prise en charge, aucune erreur de syntaxe ne se produit, mais la commande s'exécute et l'option non prise en charge est ignorée en silence.

Pas de prise en charge de la VM cliente sous Windows AMD64

Par défaut, Enterprise Server utilise la VM cliente pour optimiser ses performances de démarrage et de déploiement. Si vous utilisez Windows AMD64, modifiez le fichier domain.xml en supprimant la ligne <jvm-options>–client<jvm-options> . L'ergonomie de la JVM sélectionne le type de VM approprié à la plate-forme en question.

Pour plus d'informations sur la prise en charge des plates-formes, reportez-vous à Ergonomics in the 5.0 Java Virtual Machine.

Jeu de documentation de Enterprise Server

Le tableau suivant fournit des titres et des descriptions abrégées des ouvrages composant le jeu de documentation de Enterprise Server.

Fonctions disponibles uniquement dans le profil de la plate-forme complète

Les fonctions suivantes de Sun GlassFish Enterprise Server v3 ne sont disponibles que dans profil de la plate-forme complète :

• Fonctions EJB faisant partie de l'API complète d'EJB 3.1, notamment les composants EJB distants, les beans gérés par message, les points d'extrémité EJB des services Web et le service d'horloge EJB

  La spécification EJB 3.1 Lite est prise en charge dans le profil Web. Cette spécification autorise les beans d'entreprise dans les applications Web et inclut la prise en charge des beans de session sans état, des beans de session avec état et des beans de session individuels.

• Conteneur de client d'application

• Ressources JMS

• Services Web

  Dans le profil Web, un composant de servlet ou EJB ne peut pas être un point d'extrémité de service Web. Les éléments sun-web.xml et sun-ejb jar.xml liés aux services Web sont ignorés.

• Sécurité des messages

• Ressources JavaMail

Les modules connecteurs n'utilisant que des fonctions de communication sortante et une gestion de travail n'impliquant pas de fonctions de communication entrante sont pris en charge dans le profil Web. D'autres fonctions de connecteur ne sont prises en charge que dans le profil de la plate-forme complète.

Normes Java EE 6

Sun GlassFish Enterprise Server v3 applique les normes Java EE répertoriées dans le tableau suivant. Il indique également les distributions pour lesquelles l'application d'une norme est disponible.

X indique que l'implémentation est disponible dans la distribution.

- Indique que l'implémentation n'est pas disponible dans la distribution.

Sur la base de ces standards, Enterprise Server v3 propose un certain nombre d'extensions, dont les suivantes :

• Ajax (asynchronous JavaScript and XML) : extrait et affiche les nouvelles données relatives à une partie d'une page Web, sans incidence sur le reste de la page.

• Metro : pile de services Web implémentant l'architecture JAXB (Java Architecture for XML Binding) et les API JAX-WS 2.1 (Java APIs for XML Web Services 2.1).

• Grizzly : structure de création de serveurs évolutifs et fiables à l'aide d'API New I/O (NIO), qui permettent l'évolution vers des milliers d'utilisateurs. Il est possible d'intégrer des composants prenant en charge les standards HTTP, Bayeux Protocol, Java Servlet API et Comet.

Java EE 6 SDK

Enterprise Server v3 est disponible sous Java EE 6 SDK. Les versions suivantes de Java EE 6 SDK sont disponibles :

• Java EE 6 SDK. Cette version inclut Sun GlassFish Enterprise Server v3. Cette version s'adresse aux développeurs nécessitant l'ensemble des API Java EE pour développer des applications d'entreprise.

• Java EE 6 Web Profile SDK. Cette version inclut le profil Web de Sun GlassFish Enterprise Server v3. Cette version contient des technologies Web incluses dans le profil de la plate-forme complète et s'adresse aux développeurs ne nécessitant pas l'ensemble des API Java EE.

Les distributions de Java EE 6 SDK sont disponibles à partir de Java EE 6 SDK downloads page.

Comment signaler des problèmes et apporter des commentaires

Si vous avez des problèmes avec Sun GlassFish Enterprise Server v3, vous pouvez nous en faire part par l'un des moyens suivants :

• GlassFish mailing lists – A variety of GlassFish community mailing lists for various interests and feedback

• GlassFish forum – Forum de discussion sur le projet GlassFish

Ressources complémentaires

Vous pouvez obtenir des informations utiles sur les sites suivants:

• GlassFish Community

• Glassfish Wiki: GlassFish v3

• Sun Developer Information

• Services de support à l'attention des développeurs Sun

• Documentation produit Sun Microsystems

Références à des sites Web tiers

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

Sun ne saurait être tenu responsable de la disponibilité des sites Web tiers mentionnés dans ce manuel. Sun décline toute responsabilité quant au contenu, à la publicité, aux produits ou tout autre matériel disponibles dans ou par l’intermédiaire de ces sites ou ressources. Sun ne pourra en aucun cas être tenu responsable, directement ou indirectement, de tous dommages ou pertes, réels ou invoqués, causés par ou liés à l’utilisation des contenus, biens ou services disponibles dans ou par l’intermédiaire de ces sites ou ressources.

Fonctions d'accessibilité

Pour obtenir la liste des fonctions d'accessibilité mises à disposition depuis la publication de ces médias, consultez les évaluations de produit de la Section 508, disponibles sur demande auprès de Sun, afin de déterminer les versions les mieux adaptées au déploiement des solutions accessibles. Vous trouverez les versions mises à jour des applications sur : http://sun.com/software/javaenterprisesystem/get.html.

Pour obtenir des informations sur l'engagement de Sun en matière d'accessibilité, consultez la page Web http://sun.com/access.