Chapitre 2 À propos de Sun GlassFish Enterprise Server

Enterprise Server est un serveur compatible avec la plate-forme Java EE 5, utilisé pour le développement et le déploiement des applications Java EE et des services Web dans des environnements de production à grande échelle.

Cette section aborde les sujets suivants :

• Nouveautés de Sun GlassFish Enterprise Server 2.1

• Fonctions de Sun GlassFish Enterprise Server

• Configurations matérielle et logicielle requises

• Utilisation du centre de mise à jour

Nouveautés de Sun GlassFish Enterprise Server 2.1

Corrections de bogues et améliorations – le tableau suivant répertorie les bogues corrigés dans cette version.

Fonctions de Sun GlassFish Enterprise Server

Ces fonctions ont été introduites dans Sun Java System Application Server 9.1. Sun GlassFish Enterprise Server présente les fonctions suivantes :

• Enregistrement sur Sun Connection — vous pouvez utiliser le programme d'installation, l'IG de la console d'administration ou le centre de mise à jour pour enregistrer le produit sur Sun Connection. En enregistrant Enterprise Server sur Sun Connection, vous pouvez bénéficier des éléments suivants :

  • informations de patch et mises à jour de bogue ;

  • Screencasts et didacticiels

  • actualités et événements ;

  • support et offres de formation.

• Prise en charge du système d'exploitation AIX — Enterprise Server est pris en charge sur le système d'exploitation AIX pour les domaines créés sous le profil développeur ou cluster.

  ---

  Remarque –

  Le profil entreprise n'est pas pris en charge sur le système d'exploitation AIX car ce dernier ne prend en charge ni HADB, ni NSS.

  ---

• Prise en charge du système d'exploitation Ubuntu — Enterprise Server est intégrée au système d'exploitation Linux Ubuntu.

  ---

  Remarque –

  Les informations sur l'installation dans la documentation Enterprise Server ne sont pas pertinentes pour ce système d'exploitation. Le profil entreprise n'est pas pris en charge sur le système d'exploitation Linux Ubuntu car ce dernier ne prend en charge ni HADB, ni NSS.

  ---

• Prise en charge de SuSe Linux 64 bits

• Prise en charge du préchargement de relations multiniveaux : le préchargement de relations multiniveaux pour les beans entité de CMP 2.1 (persistance gérée par conteneur) est désormais pris en charge. Pour plus d'informations, reportez-vous à la section Activation du préchargement de relations multiniveaux.

• Prise en charge de JBI (Java Business Integration) : vous pouvez mettre à jour un composant JBI à l'aide de l'interface graphique de la console d'administration ou à partir de la ligne de commande sans avoir à redéployer les ensembles de services déjà déployés.

• Prise en charge de la plate-forme Java EE 5 : Sun GlassFish Enterprise Server implémente la spécification Java EE 5 pour offrir l'une des meilleures exécutions d'application possibles pour les applications et services Web de nouvelle génération d'une entreprise. Enterprise Server implémente les composants standard Java EE suivants :

  • Enterprise Java Beans 3.0

  • JAXB 2.0

  • Java Persistence

  • Java Server Faces 1.2

  • Java Server Pages 2.1 (JSP 2.1)

  • Java Server Pages Standard Tag Library (JSTL) 1.2

  • Streaming API for XML (StAX)

  • Web Services Metadata

  • Java API for XML based Web Services 2.0 (JAX-WS 2.0)

  • Common Annotations for the Java Platform 1.0 (CAJ 1.0)

  • Java Servlet 2.5

  Vous trouverez par la suite la liste complète des technologies de la plate-forme Java EE 5.

• Prise en charge de WSIT (Web Services Interoperability Technologies) : Sun travaille étroitement 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é. La version initiale de WSIT est le fruit de cette collaboration. 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é.

  Reportez-vous à la section Informations supplémentaires sur l'intégration de WSIT de ce chapitre pour obtenir plus de détails sur ce processus sous Enterprise Server.

• Prise en charge de JBI : JBI étend Java EE avec des interfaces de fournisseurs de services d'intégration d'entreprise (SPI). Ces SPI permettent aux développeurs de créer ou d'implémenter un environnement Java d'intégration à l'échelle de l'entreprise pour des spécifications telles que WSCI, BPEL4WS et W3C Choreography Working Group. Une implémentation JBI est directement installée par le programme d'installation d'Enterprise Server, généralement dans le répertoire as-install/jbi. Ce répertoire contient tous les fichiers JAR et composants système communs pour JBI, notamment un module lifecycle permettant de démarrer la structure JBI dans la JVM d'Enterprise Server.

• Prise en charge de la réplication en mémoire : la réplication en mémoire sur d'autres serveurs fournit un stockage léger des données d'état de session sans qu'une base de données, telle que HADB, ne soit nécessaire. Ce type de réplication utilise la mémoire d'autres serveurs pour le stockage haute disponibilité des données de bean de session avec état et de session HTTP. Les instances de serveur clusterisées répliquent l'état de session dans une topologie en anneau. Chaque instance de sauvegarde stocke les données répliquées en mémoire. La réplication en mémoire des données de l'état de session sur d'autres serveurs permet de distribuer les sessions. L'utilisation de la réplication en mémoire nécessite que GMS (Group Management Service) soit activé (true par défaut).

• Profils d'utilisation : chaque domaine administratif est associé à un profil d'utilisation, permettant d'identifier les capacités de ce domaine. Enterprise Server inclut les profils suivants :

  • Developer (Développeur) : utilisez ce profil si vous exécutez votre domaine dans un environnement de développement et si vos applications ne nécessitent aucune fonctionnalité de clustering, telles que l'équilibrage de charge, la haute disponibilité et la réplication de session. Notez que le nom réel de ce profil est « developer » (sensible à la casse).

  • Cluster : utilisez ce profil si vous souhaitez créer des clusters d'instances de serveur d'application destinées à transmettre l'évolutivité et la haute disponibilité aux applications Java EE déployées. L'état de ces applications est en mémoire persistante. Notez que le nom réel de ce profil est « cluster » (sensible à la casse).

  • Enterprise (Entreprise) : utilisez ce profil si vous souhaitez utiliser HADB et NSS. Ce profil est inutilisable sauf si vous installez HADB et NSS séparément ou que vous installez Enterprise Server comme partie de Java Enterprise System (Java ES).

• Améliorations de l'équilibrage de charge : plusieurs améliorations ont été apportées au plug-in d'équilibrage de charge. En bref, celles-ci incluent :

  • Tour de rôle pondéré : un attribut facultatif, nommé weight, a été ajouté au fichier d'instance Loadbalancer.xml. Cette option permet au plug-in d'équilibreur de charge d'acheminer les demandes en fonction de la pondération. Par exemple, toutes les 500 requêtes, 100 seront transmises à l'instance1 et 400 à l'instance2 . La pondération par défaut est de 100. La pondération est assignée à chaque instance à partir de la console d'administration ou de la ligne de commande, et le fichier serveur domain.xml comporte un attribut pour chaque instance indiquant la pondération.

  • Décision de l'équilibreur de charge définie par l'utilisateur : permet aux utilisateurs de définir une logique personnalisée pour l'équilibrage de charge ; par exemple, des redirections basées sur l'identité utilisateur et un équilibrage de charge basé sur MIME. Cette fonctionnalité est implémentée au moyen d'une bibliothèque partagée définie par l'utilisateur, chargée par l'équilibreur de charge. Cette bibliothèque partagée personnalisée implémente l'interface telle que définie dans le fichier loadbalancer.h , stocké dans as-install/lib/install/templates/.

  • Améliorations de l'administration : les versions précédentes d'Enterprise Server nécessitaient que le fichier loadbalancer.xml soit copié manuellement vers le répertoire config particulier du serveur. Enterprise Server inclut des automatisations d'envoi pour effectuer de telles copies entre le serveur Web et Enterprise Server. L'équilibreur de charge lui-même est configuré dans le fichier domain.xml du serveur.

• Open Source et communauté GlassFish — en juin 2005, Sun a lancé la communauté GlassFish en vue de développer un serveur d'application gratuit, open source, de qualité commerciale permettant d'implémenter les dernières fonctionnalités de la plate-forme Java EE 5 ainsi que les technologies d'entreprise associées. Enterprise Server est basé sur le code source développé par les ingénieurs de Sun et la communauté GlassFish.

• Prise en charge du centre de mise à jour : le centre de mise à jour d'Enterprise Server fournit des mises à jour automatiques du produit et un accès rapide aux nouveaux composants. Pour plus d'informations, reportez-vous à la section Utilisation du centre de mise à jour.

Configurations matérielle et logicielle requises

Cette section présente la configuration requise pour pouvoir installer Sun GlassFish Enterprise Server.

• Plates-formes prises en charge

• Informations importantes concernant les patchs

• Version de JDK

• Pour passer à la version Java SE prise en charge

• Version Apache Ant

• Pilotes JDBC et bases de données

• Utilisation de la base de données Java DB intégrée

• Versions de Message Queue

• Serveurs Web

• Navigateurs

• Configuration requise pour HADB et plates-formes prises en charge

• Mise à niveau de Enterprise Server

• Autres exigences

Plates-formes prises en charge

Le tableau suivant répertorie les systèmes d'exploitation compatibles avec Sun GlassFish Enterprise Server 2.1.

Nous vous recommandons d'utiliser le système de fichiers NTFS plutôt que FAT ou FAT32 pour exécuter Enterprise Server sur n'importe quelle plate-forme Microsoft Windows.

Sous UNIX^TM, 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.

Bien que MacOS ne soit pas pris en charge pour les déploiements de production, il est pris en charge à des fins de développement. Vous pouvez obtenir des informations sur le téléchargement du système d'exploitation Macintosh sur la page de téléchargements GlassFish, ou sur la page SDK où Mac est répertorié. Par exemple, sur la page de téléchargement de la mise à jour de JavaEE 5 SDK https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=java_ee_sdk-5_05-nojdk-oth-JPR@CDS-CDS_Developer.

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.

Informations importantes concernant les patchs

Patchs requis pour Solaris

Sun conseille aux utilisateurs de Solaris 10 (x86, SPARC) d'installer le groupe de patchs recommandés. Ce cluster de patches est disponible sous “Patches recommandés et de sécurité” sur le site Web SunSolve .

Version de JDK

La version minimale (et certifiée) du JDK pour Enterprise Server est 1.5.0_14.

Pour passer à la version Java SE prise en charge

Vous pouvez passer à une version Java SE prise en charge en modifiant le fichier asenv tel qu'indiqué ici.

1. Si vous ne l'avez pas encore fait, installez la nouvelle version Java SE sur votre système.

   Le kit Java SE SDK peut être téléchargé à l'adresse http://java.sun.com/javase

2. Arrêtez Enterprise Server.

   • À partir de la ligne de commande :

     install_dir/bin/asadmin stop-domain

   • À partir de la console d'administration :

     1. Cliquez sur le nœud Application Server.

     2. Cliquez sur Arrêter l'instance.

3. Modifiez le fichier install_dir/config/asenv.conf (asenv.bat sous Windows), en remplaçant la valeur AS_JAVA de sorte qu'elle pointe sur le nouveau répertoire de base de Java :

4. Éditez le fichier as-install/samples/common.properties, en modifiant la ligne commençant par com.sun.aas.javaRoot.. pour faire référence au nouveau répertoire de base Java.

5. Redémarrez Application Server.

   • À partir de la ligne de commande :

     as-install/bin/asadmin start-domain

   • À partir de la console d'administration :

     1. Cliquez sur le nœud Application Server.

     2. Cliquez sur Arrêter l'instance.

Version Apache Ant

La version 1.6.5 d'Apache Ant est intégrée à Enterprise Server sur tous les systèmes d'exploitation sauf Linux Ubuntu. La version 1.7.0 d'Apache Ant est intégrée à Linux Ubuntu et utilisée avec Enterprise Server .

Pilotes JDBC et bases de données

Tableau 2–2 répertorie les bases de données et les pilotes compatibles avec Java EE. Toutes les configurations prises en charge de Sun GlassFish Enterprise Server doivent au minimum comprendre une combinaison base de données/pilote de ce tableau, telle que la base de données Java DB intégrée et son pilote. En outre, Enterprise Server est conçu pour prendre en charge la connectivité JDBC à tout DBMS supplémentaire avec un pilote JDBC correspondant.

Tableau 2–3 répertorie toutes les bases de données et tous les pilotes supplémentaires qui doivent être pris en charge dans la version FCS de Enterprise Server.

En règle générale, Enterprise Server 2.1 prend en charge tous les pilotes JDBC répondant à la spécification Java EE.

Utilisation de la base de données Java DB intégrée

Cette section donne des instructions sur l'utilisation de l'implémentation de la base de données Java DB intégrée à Enterprise Server 2.1. Java DB est basée sur la base de données Apache Derby.

• Ouverture et fermeture de la base de données Java DB

• Scripts d'utilitaire Java DB

Ouverture et fermeture de la base de données Java DB

Sun GlassFish Enterprise Server comporte les commandes asadmin suivantes pour démarrer et arrêter le serveur réseau Java DB.

• Utilisez la commande asadmin start-database pour démarrer une instance du serveur réseau Java DB :

  asadmin start-database [--dbhost 0.0.0.0] [--dbport 1527] [--dbhome path]

  La valeur par défaut pour l'hôte est 0.0.0.0, ce qui permet à Java DB d'écouter sur localhost ainsi que sur les interfaces de noms d'hôte/d'adresses IP. La valeur de la propriété dbhome correspond à l'emplacement où les bases de données Java DB résident. Le chemin par défaut est as-install/javadb.

• Utilisez la commande asadmin stop-database pour fermer une instance en cours d'exécution sur le serveur réseau Java DB :

  asadmin stop-database [--dbhost 0.0.0.0] [--dbport 1527]

Scripts d'utilitaire Java DB

La configuration de Java DB proposée avec Enterprise Server 2.1 comprend également des scripts pouvant vous aider à utiliser Java DB. Les scripts suivants sont disponibles dans le répertoire as-install/javadb/bin :

• startNetworkServer, startNetworkServer.bat  : script de démarrage du serveur réseau

• stopNetworkServer, stopNetworkServer.bat  : script de démarrage du serveur réseau

• ij, ij.bat : outil de script JDBC interactif.

• dblook, dblook.bat : script permettant d'afficher tout ou partie du LDD d'une base de données.

• sysinfo, sysinfo.bat : script permettant d'afficher des informations de versionnage relatives à l'environnement Java DB.

• NetworkServerControl, NetworkServerControl.bat  : script permettant d'exécuter des commandes sur l'APINetworkServerControl

Pour configurer l'environnement d'exécution de scripts de l'utilitaire Java DB

1. Assurez-vous que la variable d'environnement JAVA_HOME spécifie le répertoire dans lequel JDK est installé.

2. Définissez la variable d'environnement DERBY_HOME pour que celle-ci pointe vers le répertoire as-install/javadb.

Voir aussi

Pour plus d'informations sur ces utilitaires, consultez les manuels Derby suivants :

• Guide des outils et utilitaires Derby

• Guide d'administration du serveur Derby

Versions de Message Queue

Pour les installations basées sur des fichiers, Message Queue 4.3 est intégré à Enterprise Server. Pour les installations basées sur les offres UNIX, Message Queue 4.1.1, l'équivalent fonctionnel de la version 4.3, est fourni. Malgré la numérotation des versions, Message Queue 4.1.1 est en fait rétrocompatible avec Message Queue 4.2.

Le code imbriqué Sun GlassFish Message Queue fourni avec Enterprise Server est uniquement testé et certifié (en général) par rapport à la version équivalente du courtier Message Queue. Ceci signifie que l'utilisation du code Message Queue imbriqué fourni pour se connecter à un courtier Message Queue distant (non géré par Enterprise Server) exécutant une version différente du code Message Queue n'est pas prise en charge.

Serveurs Web

Cette section répertorie les serveurs Web pris en charge par Sun GlassFish Enterprise Server .

Seules les plates-formes 32 bits sont prises en charge.

Navigateurs

Cette section répertorie les navigateurs pris en charge par Sun GlassFish Enterprise Server 2.1.

Configuration requise pour HADB et plates-formes prises en charge

Outre la configuration indiquée dans la section Configurations matérielle et logicielle requises, vous devez vérifier que le système est conforme aux exigences ci-dessous pour pouvoir exécuter HADB.

• Plates-formes prises en charge

• Configuration requise au niveau de l'hôte pour le serveur HADB

• Configuration requise au niveau de l'hôte pour la gestion HADB

• Configuration requise au niveau de l'hôte pour le client HADB

HADB est uniquement fourni avec le profil Enterprise Server 2.1 Enterprise. Veuillez également noter que les composants Java du système ont été générés à l'aide de JDK 5 et testés sur JDK 1.5.

Plates-formes prises en charge

• Solaris (SPARC) – Solaris 8 MU7, Solaris 9 MU7, Solaris 10 RR.

• Solaris (x86) – Solaris 9 MU7, Solaris 10 RR.

• RedHat Enterprise Linux - 2.1 U5 (seul le système de fichiers ext2 est pris en charge, non ext3), 3.0 U4 (ext2 et ext3 sont pris en charge. Les mises à jour antérieures à U4 ne sont pas recommandées en raison d'un swapping excessif). Notez que HADB est testé sur ces versions de système d'exploitation en mode 32 bits uniquement. Par ailleurs, HADB ne prend pas en charge la version RedHat Enterprise Linux 3.0 exécutée en mode 64 bits, en raison d'un bogue au niveau du système d'exploitation (voir le problème connu 6249685 dans la section Haute disponibilité pour obtenir plus de détails sur l'incidence de ce bogue sur HADB).

• Microsoft Windows – Microsoft Windows 2000 Advanced Server Service Pack 4 et Microsoft Windows 2003 Enterprise Edition. Notez que HADB ne prend en charge aucune des versions ultérieures de Microsoft Windows en mode 64 bits.

Configuration requise au niveau de l'hôte pour le serveur HADB

• Mémoire minimum : 320 Mo par nœud.

• Espace minimum disponible sur le disque : 70 Mo par hôte pour les binaires HADB. En outre, un espace disque doit être dédié aux périphériques de données, à savoir 512 Mo par nœud pour une installation test.

• Mémoire recommandée : 512 Mo par nœud.

• Espace disque recommandé : 70 Mo par hôte pour les binaires HADB. En outre, un espace disque doit être dédié aux périphériques de données, à savoir 1200 Mo par nœud pour une installation test.

Vérifiez que l'écriture en cache est désactivée sur les périphériques sur lesquels des données HADB et des fichiers journaux sont stockés. L'écriture en cache est activée par défaut sur certaines plates-formes Solaris, Solaris x86 par exemple.

Configuration requise au niveau de l'hôte pour la gestion HADB

• Mémoire minimum : 128 Mo

• Espace disque minimum : 70 Mo par nœud pour les binaires HADB.

Configuration requise au niveau de l'hôte pour le client HADB

• Mémoire minimum : 120 Mo

• Espace disque minimum : 20 Mo

Mise à niveau de Enterprise Server

Reportez-vous au manuel Sun GlassFish Enterprise Server 2.1 Upgrade guide pour obtenir les instructions complètes de mise à niveau d'une version précédente de Enterprise Server vers la version actuelle.

Autres exigences

Avant d'installer le logiciel Sun GlassFish Enterprise Server, vous devez également veiller à ce que les autres exigences ci-dessous soient satisfaites.

• Espace disponible : vous devez disposer d'au moins 35 Mo dans votre répertoire temporaire pour l'installation de Sun GlassFish Enterprise Server, et de 250 Mo d'espace disponible pour l'installation de SDK.

• Utilisation du programme de désinstallation : si vous souhaitez supprimer Enterprise Server de votre système, veillez à utiliser le programme de désinstallation fourni avec le logiciel. Si vous utilisez une autre méthode, des problèmes peuvent de se produire lors de la réinstallation de cette version ou de l'installation d'une nouvelle version.

• Ports libres : vous devez disposer de sept ports non utilisés. Le programme d'installation détecte automatiquement les ports utilisés et suggère des ports disponibles pour le domaine par défaut. Les ports par défaut initiaux sont :

  • 8080 pour HTTP, 8181 pour HTTPS ;

  • 3700 pour IIOP, 3820 pour IIOP/SSL et 3920 pour IIOP/SSL avec authentification mutuelle ;

  • 4848 (HTTP) pour le serveur d'administration ;

  • 8686 (RMI) pour les clients JMX.

  Démarrage de serveurs déjà installés (UNIX) — à moins que vous ne remplaciez le serveur précédemment installé, vous devez le démarrer avant d'entamer la procédure d'installation de Sun GlassFish Enterprise Server 2.1. Le programme d'installation sera ainsi en mesure de détecter les ports utilisés et évitera de les affecter à d'autres utilisations.

• Remplacement de serveurs déjà installés (UNIX) — Reportez-vous au manuel Sun GlassFish Enterprise Server 2.1 Upgrade guide pour obtenir les instructions complètes de mise à niveau d'une version précédente de Enterprise Server.

• Arrêt du pare-feu (Microsoft Windows) : vous devez arrêter votre pare-feu avant d'installer le logiciel Sun GlassFish Enterprise Server. À défaut, tous les ports par défaut risquent d'être désactivés. Le programme d'installation doit être capable de déterminer, avec précision, les ports qui sont disponibles.

  Pour en savoir plus sur la compatibilité, reportez-vous au manuel Sun GlassFish Enterprise Server 2.1 Upgrade guide .

API de la plate-forme Java EE 5

Sun GlassFish Enterprise Server 2.1 prend en charge la plate-forme Java EE 5. Le tableau suivant répertorie les API améliorées disponibles sur la plate-forme Java EE 5.

Java EE 5 SDK

Sun GlassFish Enterprise Server 2.1 est disponible sous Java EE 5 SDK.

Il existe deux versions de Java EE 5 SDK :

• Java Application Platform SDK

• Java EE 5 SDK

En outre, vous pouvez télécharger ces distributions SDK à l'aide des outils de JDK ou de NetBeans 5.5.1. Pour obtenir plus d'informations, consultez la page de téléchargement sur http://java.sun.com/javaee/downloads/index.jsp.

GlassFish v2.1 et Enterprise Server 2.1 ne fonctionnent pas avec NetBeans 5.5 pour le développement d'applications Java EE. Vous devez utiliser NetBeans 5.5.1.

Passage à une autre version Java prise en charge

Sun GlassFish Enterprise Server 2.1 requiert SE 5.0 ou une version supérieure comme JVM sous-jacent. Pour passer d'une version Java à l'autre, suivez les étapes générales suivantes. (Windows et Unix)

Il est préférable de ne pas rétrograder la version Java après qu'un domaine ait été créé avec une machine virtuelle Java récente. Si vous devez rétrograder votre JVM, nous vous recommandons de le faire par domaine. Pour cela, reportez-vous à la procédure suivante.

Pour passer à une autre version Java prise en charge

1. Téléchargez le SDK Java choisi (non pas le JRE) et installez-le sur votre système, si ce n'est pas déjà fait.

   Le Java SDK peut être téléchargé sur http://java.sun.com/j2se.

2. Démarrez le domaine pour lequel vous souhaitez modifier le JDK :

   as-install/bin/asadmin start-domain domain-name

3. Connectez-vous à la console d'administration et modifiez les attributs JVM du domaine.

   En particulier, vous pouvez vouloir modifier la variable JAVA_HOME sur la page Paramètres JVM pour ce domaine.

   Sinon, vous pouvez utiliser la commande asadmin :

   as-install/bin/asadmin set "server.java-config.java-home=Path-To-Java-Home"

Problèmes de compatibilité avec Java ES 5 connus

Il existe deux problèmes de compatibilité connus entre Enterprise Server 2.1 et Java ES 5 (JES5).

1. Le JES5 Service Registry n'est pas compatible avec Enterprise Server 2.1 à cause de la version JSF 1.2 fournie par Enterprise Server 2.1. Le Service Registry doit être mis à niveau vers JES5u1 avant la mise à niveau de Enterprise Server vers la version 2.1. Cette limitation est également expliquée dans la documentation relative à Service Registry.

2. Le JES5 Portal Server n'est pas compatible avec Enterprise Server 2.1 à cause de la version JSF 1.2 fournie par Enterprise Server 2.1. Portal Server doit être mis à niveau vers JES5u1 avant la mise à niveau vers la version 2.1.

   Pour une installation Java ES 5 comportant Portal Server sur Enterprise Server 8.2, la mise à niveau de Enterprise Server 8.2 vers 2.1 rend Portal Server inutilisable. Enterprise Server 2.1 utilise JSF 1.2, mais le pont JSF-Portlet de la version 5 de Portal Server ne prend pas en charge JSF 1.2. Sous Solaris/Linux, Portal Server doit être mis à niveau vers la mise à jour 1 de JavaES5. Sous Windows, ne mettez pas Enterprise Server à niveau vers la version 2.1 si vous souhaitez continuer à utiliser la version 5 de Portal Server, car Portal Server n'est pas pris en charge par la mise à jour 1 de Java ES 5 sous Windows.

Fonctions non prises en charge sur certains systèmes d'exploitation

Certaines fonctionnalités d'Enterprise Server ne sont pas prises en charge sur tous les systèmes d'exploitation. Ces fonctionnalités sont développées dans les sous-sections suivantes.

Fonctions non prises en charge sur le système d'exploitation AIX

Si vous utilisez le système d'exploitation AIX, les limitation suivantes s'appliquent :

• Enterprise Server 2.1 est pris en charge sur le système d'exploitation AIX uniquement pour les domaines créés sous le profil développeur ou cluster. Le profil entreprise n'est pas pris en charge sur ce système d'exploitation car ce dernier ne prend en charge ni HADB, ni NSS.

• Le lanceur natif n'est pas disponible sur ce système d'exploitation.

Fonctions non prises en charge sur le système d'exploitation Linux

Si vous utilisez le système d'exploitation Linux, les limitation suivantes s'appliquent :

• Pour le système d'exploitation SuSe Linux 64 bits et le système d'exploitation RHEL 64 bits sous JVM 64 bits, le programme de lancement du serveur d'applications natives n'est pas disponible. Utilisez plutôt JVM 32 bits.

• Pour le système d'exploitaiton SuSe Linux 64 bits et le système d'exploitation RHEL 64 bits sous JVM 64 bits, le programme d'installation n'est pas disponible. Utilisez plutôt JVM 32 bits.

• Le profil entreprise n'est pas pris en charge sur les plates-formes suivantes :

  • RedHat Enterprise Linux 64 bits et JMV 64 bits

  • SuSe Linux 64 bits et JVM 64 bits

Composants non pris en charge sur le système d'exploitation Ubuntu

Si vous utilisez le système d'exploitation Linux Ubuntu, les limitations suivantes s'appliquent :

• Étant donné que Enterprise Server 2.1 est intégré au système d'exploitation Linux Ubuntu, les informations sur l'installation dans la documentation Enterprise Server 2.1 ne sont pas pertinentes pour ce système d'exploitation.

• Le profil entreprise n'est pas pris en charge sur ce système d'exploitation car ce dernier ne prend en charge ni HADB, ni NSS.

Utilisation du centre de mise à jour

Le centre de mise à jour fournit des mises à jour automatiques de Enterprise Server et un accès rapide aux nouveaux composants.

Lorsque celui-ci est activé, il effectue une mise à jour automatique du logiciel. Lors de ce processus, le centre de mise à jour collecte et transmet les données suivantes à Sun Microsystems (ou à son fournisseur de services) :

• ID d'installation unique (GUID) ;

• Adresse IP

• informations sur le système d'exploitation (nom, version, architecture, langue) ;

• version du JDK ;

• informations sur le téléchargement du module (nom du module, date, heure, état, temps de téléchargement, nombre d'octets téléchargés).

Aucune information personnelle identifiable ne fait l'objet d'un suivi. Aucune information personnelle identifiable n'est associée à d'autres données ou utilisée dans des rapports.

Utilisation du centre de mise à jour

Pour garantir un accord explicite sur les mises à jour automatiques, le centre de mise à jour est, par défaut, désactivé. Pour permettre au centre de mise à jour d'effectuer des vérifications périodiques et des mises à jour automatiques :

1. Démarrez le centre de mise à jour.

   • Sous Unix : <installdir>/updatecenter/bin/updatetool

   • Sous Windows : <installdir>\updatecenter\bin\updatetool.bat

2. Sélectionnez l'onglet Préférences.

3. Dans la fenêtre de planification des mises à jour, modifiez la valeur Rechercher les mises à jour de Jamais (manuelle) sur la valeur désirée. Par exemple, choisissez une planification quotidienne ou hebdomadaire.

4. Spécifiez le jour et l'heure choisis pour la mise à jour.

5. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications.

   Le centre de mise à jour recherchera ainsi automatiquement les mises à jour des composants SailFin ou Enterprise Server suivant la planification spécifiée. Lorsqu'une mise à jour est disponible, le centre de mise à jour vous indiquera le composant prêt à être mis à jour.

Mise à niveau de Enterprise Server sur le système d'exploitation Ubuntu

Si vous installez GlassFish v2 sur le système d'exploitation Linux Ubuntu, cette version ne remplace pas la version GlassFish v1 existante. Le script asadmin dans /usr/bin administre GlassFish v2. Pour administrer GlassFish v1, servez-vous de son utilitaire local asadmin dans/usr/share/sunappserver/bin. Pour mettre à niveau le domaine v1 vers v2, utilisez l'outil asupgrade situé dans /usr/share/glassfishv2/bin.

Si vous utilisez le script global asadmin permettant de lancer un domaine v1, l'outil de mise à niveau sera appelé automatiquement. Toutefois, cela entraîne une erreur en raison d'un bogue qui utilise l'emplacement de domaine par défaut du serveur pour les autres plates-formes (non Ubuntu). Pour éviter cette erreur, utilisez plutôt l'outil asupgrade .

Activation du préchargement de relations multiniveaux

Le préchargement de relations multiniveaux est pris en charge pour les beans entité CMP 2.1.

Pour activer cette option, définissez la propriété suivante :

-Dcom.sun.jdo.spi.persistence.support.sqlstore.MULTILEVEL_PREFETCH=true

Pour plus d'informations sur le préchargement de relations, reportez-vous à la section Relationship Prefetching du Sun GlassFish Enterprise Server 2.1 Developer’s Guide.

Informations supplémentaires sur l'intégration de WSIT

Pour obtenir des informations détaillées sur le statut WSIT, reportez-vous à la page Notes de statut WSIT. Reportez-vous également au manuel The WSIT Tutorial pour obtenir des informations sur l'utilisation de WSIT avec Enterprise Server.