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 v2.1.1

• Fonctionnalités de Sun GlassFish Enterprise Server

• Configurations matérielle et logicielle requises

• Sun GlassFish Enterprise Manager

• Prise en charge de Web Stack

• Utilisation du centre de mise à jour

Nouveautés de Sun GlassFish Enterprise Server v2.1.1

Grizzly 1.0.30 - Outre l'intégration de Grizzly 1.0.30, des améliorations ont été apportées à ce dernier pour assurer un basculement plus rapide et plus fiable des instances dans Enterprise Server.

Prise en charge d'Apache Web Server via le plug-in mod_jk – Pour en savoir plus sur la prise en charge d'Apache Web Server par Enterprise Server v2.1.1, reportez-vous à Prise en charge de Web Stack.

Prise en charge de JSF 1.2_13 – Enterprise Server v2.1.1 prend en charge JSF 1.2_13.

Prise en charge de Jersey 1.0.3 – Enterprise Server v2.1.1 prend en charge Jersey 1.0.3.

Prise en charge de Sun GlassFish Message Queue 4.4 – Enterprise Server v2.1.1 prend en charge Sun GlassFish Message Queue 4.4. Pour plus de détails, reportez-vous à Versions de Message Queue.

Corrections et améliorations – Pour consulter la liste complète des bogues résolus dans la version, reportez-vous à Outil de suivi des problèmes liés à GlassFish et à bugs.sun.com .

Sun GlassFish Enterprise Server v2.1.1 est l'équivalent du patch 06 de Sun GlassFish Enterprise Server v2.1, disponible sur la page SunSolve.

Fonctionnalités de Sun GlassFish Enterprise Server

Ces fonctionalités, introduites dans Sun GlassFish Enterprise Server, sont les 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.

  Sun GlassFish Enterprise Server v2.1.1 prend en charge AIX 6.1 avec JDK 1.6 Update 17. Vous devez appliquer le patch IBM PMR : 56151,756,000.

  ---

  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 pour le plug-in d'équilibrage de charge

• 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 v2.1.1. Tous les systèmes d'exploitation pris en charge sont des systèmes d'exploitation 32 bits, sauf indication contraire. JDK 64 bits est uniquement pris en charge sur les systèmes d'exploitation 64 bits pris en charge.

Le tableau suivant répertorie la version minimale requise pour chaque système d'exploitation pris en charge. Les mises à jour des service packs vers la version minimale requise sont également prises en charge.

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 Mac OS ne soit pas pris en charge pour les déploiements en 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 5 de Java EE 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.

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

Le 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.

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

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

Cette section explique comment utiliser l'implémentation de la base de données Java DB intégrée à Enterprise Server v2.1.1. Java DB repose 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.1 comprend 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.4 est intégré à Enterprise Server.

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 pour le plug-in d'équilibrage de charge

Cette section répertorie les serveurs Web pris en charge par le plug-in d'équilibrage de charge de Sun GlassFish Enterprise Server.

Navigateurs

Cette section répertorie les navigateurs pris en charge par Sun GlassFish Enterprise Server v2.1.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 v2.1.1 Enterprise. Notez également que les composants Java du système ont été créés et testés sur JDK 5 et JDK 6.

Plates-formes prises en charge

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

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

• Red Hat Enterprise Linux. 2.1 U5 (seul le système de fichiers ext2, et non ext3, est pris en charge). 3.0 U4 (ext2 et ext3, 4 et 5 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 Red Hat Enterprise Linux 3.0 exécuté en mode 64 bits en raison d'un bogue au niveau du système d'exploitation (voir le bogue connu 6249685 dans la section Haute disponibilité pour obtenir plus de détails sur l'incidence de ce bogue sur HADB). Les versions 4 et 5 sont également prises en charge.

• Microsoft Windows. – Microsoft Windows 2000 Advanced Server Service Pack 4 et Microsoft Windows 2003 Enterprise Edition, Windows 2008 et Windows XP Professionnel sont pris en charge. 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 v2.1.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 de lancer la procédure d'installation de Sun GlassFish Enterprise Server v2.1.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 v2.1.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 v2.1.1 Upgrade Guide .

API de la plate-forme Java EE 5

Sun GlassFish Enterprise Server v2.1.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 v2.1.1 est disponible dans le cadre de 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 avec le JDK. Pour obtenir plus d'informations, consultez la page de téléchargement sur http://java.sun.com/javaee/downloads/index.jsp.

Passage à une autre version Java prise en charge

Sun GlassFish Enterprise Server v2.1.1 requiert Java SE 5.0 ou une version supérieure comme JVM sous-jacent. Pour passer d'une version Java à une 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 v2.1.1 et Java ES 5 (JES5).

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

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

   Pour une installation Java ES 5 comportant Portal Server sur Enterprise Server 8.2, la mise à niveau de Enterprise Server 8.2 vers v2.1.1 rend Portal Server inutilisable. Enterprise Server v2.1.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 à niveau Enterprise Server vers v2.1.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.

Prise en charge de Web Stack

Vous pouvez utiliser Enterprise Server avec Sun GlassFish Web Stack, qui intègre des composants tels que HTTP Apache Server, PHP, Ruby, etc. Pour plus d'informations sur Sun GlassFish Web Stack, reportez-vous à http://www.sun.com/software/webstack/index.xml

Enterprise Server prend en charge l'équilibrage de charge à l'aide de l'interface frontale du plug-in d'équilibreur de charge pris en charge en frontal par Sun Java System Web Server, Apache Web Server et Microsoft IIS. . Une autre technique de prise en charge en frontal de Enterprise Server consiste à utiliser Apache httpd avec le connecteur mod_jk..

Enterprise Server en frontal avec Apache httpd et mod_jk

1. Créez un cluster Enterprise Server.

2. Définissez les options JVM suivantes comme indiqué ci-après :

   • asadmin create-jvm-options --target nom-cluster "-DjvmRoute=\${AJP_INSTANCE_NAME

   • asadmin create-jvm-options --target nom-cluster "-Dcom.sun.enterprise.web.connector.enableJK=\${AJP_PORT}

3. Configurez les options JVM AJP_PORT et AJP_INSTANCE_NAME pour chaque instance du cluster avec la commande suivante :

   asadmin create-system-properties --target nom-instance AJP_INSTANCE_NAME=nom-instance

   asadmin create-system-properties --target nom-instance AJP_PORT=numéro-port

4. Redémarrez le cluster.

5. Installez Apache httpd.

   Apache httpd est disponible à l'adresse http://httpd.apache.org/download.cgi

6. Installez mod_jk.

   Le connecteur mod_jk est disponible à l'adresse http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/

7. Ajoutez les lignes suivantes au fichier mof_jk.so :

   LoadModule jk_module path_to_mod_jk.so JkWorkersFile /etc/apache2/worker.properties # Where to put jk logs JkLogFile /var/log/httpd/mod_jk.log # Set the jk log level [debug/error/info] JkLogLevel debug # Select the log format JkLogStampFormat "[%a %b %d %H:%M:%S %Y] " # JkRequestLogFormat set the request format JkRequestLogFormat "%w %V %T" # Send all jsp requests to GlassFish JkMount /*.jsp loadbalancer.

8. Créez un nouveau fichier, /etc/apache2/worker.properties, puis ajoutez les lignes suivantes :

   # Define 1 real worker using ajp13 worker.list=loadbalancer # Set properties for instance1 worker.instance1.type=ajp13 worker.instance1.host=localhost worker.instance1.port=9090 worker.instance1.lbfactor=50 worker.instance1.cachesize=10 worker.instance1.cache_timeout=600 worker.instance1.socket_keepalive=1 worker.instance1.socket_timeout=300 # Set properties for instance2 worker.instance2.type=ajp13 worker.instance2.host=localhost worker.instance2.port=9091 worker.instance2.lbfactor=50 worker.instance2.cachesize=10 worker.instance2.cache_timeout=600 worker.instance2.socket_keepalive=1 worker.instance2.socket_timeout=300 # Set properties for instance3 worker.instance3.type=ajp13 worker.instance3.host=localhost worker.instance3.port=9092 worker.instance3.lbfactor=50 worker.instance3.cachesize=10 worker.instance3.cache_timeout=600 worker.instance3.socket_keepalive=1 worker.instance3.socket_timeout=300 worker.loadbalancer.type=lb worker.loadbalancer.balance_workers=instance1,instance2,instance3

9. Copiez le fichier tomcat-ajp.jar depuis l'installation d'Apache 5.5.x vers le répertoire lib de Enterprise Server.

10. Copiez les fichiers commons-logging.jar (version 1.1.1) et commons-modeler.jar (version 2.0.1) depuis le site Web Jakarta Commons à l'adresse http://commons.apache.org.

11. Redémarrez le cluster et démarrez httpd.

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 v2.1.1 est pris en charge sur le système d'exploitation AIX uniquement pour les domaines créés sous le profil développeur ou le profil 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'exploitation 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 :

  ---

  Remarque –

  Pour obtenir une description des profils pris en charge, reportez-vous à la section Usage Profiles du Sun GlassFish Enterprise Server v2.1.1 Administration Guide.

  ---

  • Système d'exploitation Red Hat Enterprise Linux 64 bits et JVM 64 bits

  • Système d'exploitation 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 v2.1.1 est intégré au système d'exploitation Linux Ubuntu, les informations d'installation figurant dans la documentation de Enterprise Server v2.1.1 ne concernent pas 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.

Sun GlassFish Enterprise Manager

Sun GlassFish Enterprise Manager améliore la gestion et la visibilité des performances des déploiements en production de Sun GlassFish Enterprise Server v2.1.1. Il permet également au service informatique de réduire le temps de déploiement, d'optimiser les performances et de résoudre les problèmes éventuels avant qu'ils ne surviennent. Pour plus de détails, consultez la page http://www.sun.com/software/products/appsrvr/ent_manager.jsp

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 automatiquement les mises à jour des composants de 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 v2.1.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.