Guide de mise à niveau de Sun Java Enterprise System 5 pour UNIX |
Chapitre 11
Application ServerCe chapitre décrit la procédure de mise à niveau d'Application Server vers Java ES 5 (version 5) : Sun Java System Application Server Enterprise Edition 8.2.
Ce chapitre présente les considérations relatives à la mise à niveau pour les différentes méthodes de mise à niveau prises en charge par la version 5. Il traite des mises à niveau sur les systèmes d'exploitation Solaris et Linux :
Remarque
Le nom de domaine Application Server par défaut d'Application Server pour la version 5 (8.x) est domain1. Cela signifie que domain1 est la valeur par défaut de la variable nomDomaine utilisée dans ce chapitre.
De plus le nom d'instance par défaut pour le serveur d'administration du domaine (DAS) est server. Normalement, les applications J2EE ne sont pas déployées dans l'instance DAS mais dans d'autres instances autonomes.
Pour plus d'informations sur les commandes asadmin utilisées dans ce chapitre, reportez-vous au Manuel de référence de Sun Java System Application Server Enterprise Edition 8.2, http://docs.sun.com/doc/819-4736.
Présentation des mises à niveau d'Application ServerCette section présente les aspects généraux d'Application Server qui ont un impact sur la mise à niveau vers Java ES 5 (version 5) :
À propos d'Application Server pour Java ES version 5
Application Server pour Java ES version 5 constitue une mise à jour mineure par rapport à la version 4, ne contenant qu'un certain nombre de corrections de bogues. Le fonctionnement d'Application Server est identique pour la version 5 et pour la version 4.
Présentation de la mise à niveau de Application Server
Il existe deux méthodes de mise à niveau d'Application Server vers Java ES version 5 :
- Le Tableau 11-2 répertorie les méthodes de mise à niveau d'Application Server vers Java ES version 5 prises en charge. Il s'applique à la fois à Solaris et Linux.
- Le Tableau 11-3 répertorie les méthodes de mise à niveau de la version d'Application Server fournie avec Solaris vers Java ES version 5 prises en charge. Application Server Platform Edition est fourni avec le système d'exploitation Solaris. La mise à niveau des versions fournies d'Application Server vers Enterprise Edition pour la version 5 peut être effectuée par le programme d'installation de Java ES, comme cela est indiqué dans le Tableau 11-3.
Tableau 11-2 Méthodes de mise à niveau vers Java ES 5 (version 5) : Application Server Enterprise Edition 8.2
Version de Java ES
Application Server Version
Approche globale
Reconfiguration requise
Version 4
Sun Java System Application Server Enterprise Edition 8.1 2005Q4
Mise à niveau directe :
Effectuée en utilisant le programme d'installation de Java ES.1Aucune
Version 3
Sun Java System Application Server Enterprise Edition 8.1 2005Q1
Mise à niveau directe :
Effectuée en utilisant le programme d'installation de Java ES.Aucune
Version 2
Sun Java System Application Server 7.0 Update 3 (2004Q2)
Enterprise Edition et Platform EditionMise à niveau directe :
Utilisez le programme d'installation de Java ES pour effectuer la mise à niveau des packages, le script postInstall pour effectuer la reconfiguration et l'utilitaire asupgrade pour migrer les informations de domaine.2Variables d'environnement, domaines et autres données de configuration.
Les composants et applications J2EE doivent être migrés vers le nouvel environnement Application Server et redéployés.
Version 1
Sun ONE Application Server 7.0 Update 1 (2003Q4)
Enterprise Edition et Platform EditionMise à niveau directe non certifiée :
Utilisez la même méthode que pour la mise à niveau à partir d'Application Server pour la version 2.Variables d'environnement, domaines et autres données de configuration.
Les composants et applications J2EE doivent être migrés vers le nouvel environnement Application Server et redéployés.
Versions antérieures à Java ES
Pas de mise à niveau directe :
Effectuez d'abord une mise à niveau vers la version 3 à l'aide des procédures décrites dans le Guide de migration et de mise à niveau de Java Enterprise System 2005Q1 (http://docs.sun.com/doc/819-0062).Ensuite, effectuez la mise à niveau de la version 3 vers la version 5.
1Pour effectuer la mise à niveau d'Application Server de la version 4 vers la version 5 sans conserver les informations de configuration ou domaine, vous pouvez utiliser le programme de désinstallation de Java ES version 4 pour désinstaller Application Server pour la version 4, puis utiliser le programme d'installation de Java ES version 5 pour effectuer une installation complète d'Application Server pour la version 5. Cependant, si Application Server pour la version 4 a été installé en utilisant l'option Configurer ultérieurement, avant de désinstaller Application Server pour la version 4, vous devez commencer par créer un fichier $HOME/.asadminprefs (où $HOME est le répertoire personnel de l'utilisateur qui installe et exécute Application Server). Ce fichier contient les deux lignes suivantes :
AS_ADMIN_PASSWORD=mot_de_passe
AS_ADMIN_USER=admin2Faites particulièrement attention si vous effectuez la mise à niveau à partir d'Application Server pour la version 2 sur une plate-forme Solaris car la version d'Application Server fournie avec Solaris et la version d'Application Server pour Java ES version 2 coexistent sur votre ordinateur. Examinez le Tableau 11-3 et la note qui y fait suite.
Remarque
Faites particulièrement attention si vous effectuez la mise à niveau à partir d'Application Server pour la version 2 sur une plate-forme Solaris car la version fournie avec Solaris et la version d'Application Server pour Java ES coexistent sur votre ordinateur. C'est pourquoi vous devez commencer par désinstaller la version fournie avec Solaris (et les éventuels domaines correspondants) avant d'effectuer la mise à niveau à partir de la version pour Java ES version 2. Voir la section SE Solaris uniquement : supprimez manuellement les packages d' Application Server fournis avec le système d'exploitation..
Données d'Application Server
Le tableau suivant affiche le type de données susceptible d'être affecté par la mise à niveau du logiciel Application Server.
Stratégie de mise à niveau d'Application Server
De manière générale, la stratégie à utiliser pour effectuer la mise à niveau d'Application Server dépend de nombreuses considérations, décrites dans le Chapter 1, "Planification des mises à niveau" : méthode de mise à niveau, dépendances entre les composants Java ES, mise à niveau sélective ou globale, déploiements portant sur plusieurs instances et ainsi de suite.
Cette section aborde spécifiquement les questions susceptibles d'influencer la planification de mise à niveau d'Application Server.
Problèmes de compatibilité
Application Server pour la version 5 ne présente aucune modification d'interface par rapport aux versions 3 et 4. Il existe toutefois des modifications d'interface entre la version 5 et la version 2, qui rendent ces deux versions incompatibles.
Cependant, Application Server pour la version 5 ne prend pas en charge Service Registry pour la version 4. Si Application Server est mis à niveau vers la version 5, Service Registry doit également être mis à niveau vers la version 5.
Dépendances d'Application Server
Les dépendances d'Application Server par rapport aux autres composants Java ES peuvent avoir une influence sur la procédure de mise à niveau et de reconfiguration du logiciel Application Server. Les modifications apportées aux interfaces ou fonctions d'Application Server, par exemple, peuvent demander une version mise à niveau des composants dont dépend Application Server. Le besoin de mettre à jour ces composants dépend de la méthode de mise à niveau spécifique.
Application Server présente des dépendances par rapport aux composants Java ES suivants :
- Composants partagés. Application Server présente des dépendances par rapport à certains composants partagés Java ES (voir le Tableau 1-9).
- Message Queue. Application Server dépend de Message Queue pour prendre en charge les fonctions de messagerie compatibles avec J2EE Java Message Service.
- High Availability Session Store. Application Server dépend de High Availability Session Store pour conserver les informations d'état de session requises pour la prise en charge du basculement entre instances.
- Base de données Java. Application Server dépend de Base de données Java comme base de données de développeur par défaut et pour stocker des échantillons des données d'application et les données requises pour les horloges Enterprise Java Beans.
- Conteneur Web (dépendance facultative). Application Server dépend des services de conteneur Web pour son plug-in d'équilibrage de charge. Cette prise en charge est fournie soit par Java ES Web Server, soit par des conteneurs Web tiers (tels qu'Apache Web Server et Microsoft IIS).
Double mise à niveau
La double mise à niveau, qui permet à la fois la mise à niveau d'Application Server et du système d'exploitation (comme le décrit la section Mises à niveau doubles : Java ES et système d'exploitation) peut être effectuée des deux façons suivantes :
Installation d'un nouveau système d'exploitation
- Sauvegardez les données d'Application Server.
Reportez-vous à la section Données d'Application Server concernant l'emplacement des données fondamentales.
- Installez le nouveau système d'exploitation.
L'installation du système d'exploitation ne peut s'effectuer que sur le même ordinateur. Cette procédure aura pour effet de supprimer le système de fichiers existant.
- Restaurez les données Application Server que vous avez sauvegardées dans l'Step 1.
- Installez Application Server pour la version 5.
Utilisez la procédure décrite dans la section de mise à niveau correspondante du présent chapitre, en fonction de la version des données Application Server sauvegardées dans la section Step 1.
Mise à niveau d'un système d'exploitation existant
- Sauvegardez les données d'Application Server.
Reportez-vous à la section Données d'Application Server concernant l'emplacement des données fondamentales.
- Mettez à niveau le système d'exploitation.
La mise à niveau ne modifie pas le système de fichier existant.
- Procédez à la mise à niveau d'Application Server vers la version 5.
Reportez-vous à la section correspondante du présent chapitre, en fonction de la méthode de mise à niveau.
Mise à niveau d'Application Server à partir de Java ES version 4Cette section fournit des informations sur la mise à niveau d'Application Server à partir de Java ES 2005Q4 (version 4) vers Java ES 5 (version 5). La section aborde les thèmes suivants :
Introduction
Lors de la mise à niveau d'Application Server pour Java ES version 4 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :
- Approche générale de mise à niveau. La mise à niveau s'effectue en utilisant le programme d'installation de Java ES. Aucune reconfiguration d'Application Server ni reconfiguration ou migration des composants J2EE n'est requise pour la mise à niveau d'Application Server pour la version 4 vers la version 5.
- Dépendances pour la mise à niveau. Application Server présente des dépendances par rapport à plusieurs composants partagés Java ES (voir le Tableau 1-9), qui sont tous automatiquement mis à niveau vers la version 5 par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau d'Application Server. Application Server présente une dépendance stricte pour la mise à niveau uniquement par rapport au composant partagé NSS.
En outre, comme cela est décrit dans la section Dépendances d'Application Server, Application Server pour la version 5 présente des dépendances par rapport à Message Queue, HADB et Base de données Java. Il s'agit de dépendances strictes pour la mise à niveau : tous ces composants doivent être mis à niveau vers la version 5.
En outre, Application Server peut dépendre de Java ES Web Server ou de conteneurs Web tiers. Toutefois, il s'agit de dépendances souples pour la mise à niveau. La mise à niveau du conteneur Web est facultative dans le cadre de la mise à niveau d'Application Server vers la version 5.
- Compatibilité ascendante. Application Server pour la version 5 présente une compatibilité ascendante avec la version 4.
- Annulation de la mise à niveau. Il n'est pas possible d'annuler la mise à niveau vers la version 5 pour revenir à la version 4.
- Problèmes relatifs à la plate-forme. L'approche générale de mise à niveau d'Application Server est identique pour les systèmes d'exploitation Solaris et Linux.
Mise à niveau d'Application Server pour la version 4
Cette section explique comment effectuer la mise à niveau d'Application Server à partir de Java ES version 4 vers Java ES version 5 sur les plates-formes Solaris et Linux. Lorsqu'une rubrique traite de procédures spécifiques à une plate-forme, le système d'exploitation auquel elle fait référence est indiqué. La section aborde les thèmes suivants :
Tâches à exécuter avant la mise à niveau
Avant de mettre à niveau Application Server, vous devez effectuer les tâches décrites ci-dessous :
Vérifier les informations sur la version actuelle
Vous pouvez vérifier la version actuelle d'Application Server à l'aide de la commande suivante :
AppServer8-base/bin/asadmin version --verbose
Mise à niveau des dépendances d'Application Server
Il est généralement recommandé de mettre à niveau tous les composants Java ES sur un même ordinateur (et dans son environnement) vers Java ES version 5. Application Server présente des dépendances strictes pour la mise à niveau par rapport au composant partagé NSS et par rapport aux composants Message Queue, HADB et Base de données Java.
Vous devez effectuer la mise à niveau des dépendances d'Application Server dans l'ordre décrit ci-dessous (en sautant les dépendances déjà mises à niveau), avant d'effectuer la mise à niveau d'Application Server. Cependant, la mise à niveau des composants partagés, ainsi que de Message Queue, HADB et Base de données Java est normalement effectuée automatiquement par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau d'Application Server.
- Composants partagés. Les instructions de synchronisation des composants partagés Java ES vers la version 5 sont présentées dans la section Mise à niveau des composants partagés Java ES. Néanmoins, tous les composants partagés requis par Application Serversont automatiquement mis à niveau par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau d'Application Server vers la version 5.
- Message Queue. Les instructions de mise à niveau de Message Queue vers la version 5 sont présentées dans le Chapter 10, "Message Queue".
- High Availability Session Store (HADB). Les instructions de mise à niveau de HADB sont fournies dans le Chapter 9, "High Availability Session Store".
- Base de données Java. Les instructions de mise à niveau de Base de données Java sont fournies dans le Chapter 8, "Base de données Java".
- Logiciels de conteneur Web (dépendance souple pour la mise à niveau). Les instructions de mise à niveau de Web Server sont présentées dans le Chapter 7, "Web Server".
Sauvegarde des données d'Application Server
La mise à niveau d'Application Server à partir de la version 4 vers la version 5 ne modifie pas les données de configuration. Il est donc inutile de sauvegarder les données actuelles.
Obtenir les mots de passe et informations de configuration requis
Vous devez connaître le mot de passe et l'ID administrateur de la version actuellement installée d'Application Server.
Mise à niveau de la version 4 de Application Server
Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau d'Application Server, suivies de la description de la procédure elle-même.
Considérations relatives à la mise à niveau
La mise à niveau d'Application Server vers Java ES version 5 tient compte des considérations suivantes :
- Tout composant J2EE exécuté sur une instance d'Application Server doit être arrêté avant la mise à niveau de l'instance en question. Toutefois, si l'équilibrage des charges offre de l'évolutivité ou une haute disponibilité, cet arrêt n'est pas obligatoire.
- Toutes les instances d'Application Server exécutées sur un même ordinateur (toutes correspondant à la même image d'Application Server) doivent être arrêtées pendant la mise à niveau de l'image installée.
- Dans les déploiements sur plusieurs nuds, effectuez la procédure de mise à niveau sur chaque nud ou ordinateur hébergeant les instances d'Application Server.
Procédure de mise à niveau
La procédure présentée ci-dessous s'applique aux instances d'Application Server installées sur l'ordinateur sur lequel est effectuée la mise à niveau.
- Connectez-vous en tant qu'utilisateur root ou superutilisateur.
su -
- Arrêtez tous les composants J2EE exécutés sur les instances d'Application Server que vous allez mettre à niveau.
- Arrêtez toutes les instances d'Application Server installées sur l'ordinateur que vous allez mettre à niveau.
- Arrêtez tous les agents de nud en cours d'exécution.
AppServer8-base/bin/asadmin stop-node-agent --user ID_admin
nomAgentNudoù nomAgentNud est au format nomHôte_nomDomaine, mais est simplement nomHôte par défaut.
- Arrêtez le serveur d'administration du domaine (DAS).
AppServer8-base/bin/asadmin stop-domain --user ID_admin
nomDomaine- Arrêtez le serveur de base de données PointBase (s'il est en cours d'utilisation).
AppServer8Config-base/appserver/pointbase/tools/stopserver.sh
- Lancez le programme d'installation de Java ES.
cd distribution Java ES version 5/arch_se
./installeroù arch_se correspond à votre plate-forme, telle que Solaris_sparc. (Utilisez l’option installer -nodisplay pour l’interface de ligne de commande.)
Une fois que les pages de bienvenue et du contrat de licence se sont affichées, vous accédez à la page de sélection de composant. (Lorsque des composants installés pouvant être directement mis à niveau par le programme d’installation de Java ES sont détectés, ils sont présentés avec l’état “pouvant être mis à niveau”.)
- Sélectionnez Application Server dans la page de sélection des composants.
Comme il s'agit de dépendances strictes pour la mise à niveau, Message Queue, HADB et Base de données Java sont également sélectionnés automatiquement pour la mise à niveau.
- Sélectionnez l'option Configurer maintenant.
- Indiquez les valeurs de configuration requises.
Un certain nombre d'écrans de configuration s'affichent.
- Confirmez la configuration de mise à niveau que vous avez spécifiée.
Les packages d'Application Server (et, si nécessaire, ceux de Message Queue, HADB et Base de données Java) sont mis à niveau et un récapitulatif de la mise à niveau s'affiche.
- Quittez le programme d'installation de Java ES.
- Redémarrez le serveur d'administration du domaine (DAS) mis à niveau.
AppServer8-base/bin/asadmin start-domain --user ID_admin
nomDomaine- Redémarrez les instances mises à niveau d'Application Server.
AppServer8-base/bin/asadmin start-node-agent --user ID_Admin
nomAgentNudoù nomAgentNudpossède la forme nomHôte_nomDomaine, mais est simplement nomHôte par défaut.
Vérification de la mise à niveau
Pour vérifier que la mise à niveau a réussi, utilisez la commande suivante :
AppServer8-base/bin/asadmin version --verbose
Voir le Tableau 11-5 pour les valeurs de résultat.
Tâches à exécuter après la mise à niveau
Si vous souhaitez continuer à utiliser la base de données PointBase intégrée de la version 4 au lieu de Base de données Java, un nouveau composant de la version 5 de Java ES, vous devez modifier manuellement le fichier AppServer8-base/config/asenv.conf mis à niveau.
Après la mise à niveau d'Application Server à partir de la version 4, les paramètres de PointBase dans asenv.conf sont les suivants :
Modifiez ces paramètres de la manière suivante :
AS_POINTBASE="AppServer8-base/pointbase"
AS_POINTBASE_SAMPLESDB="AppServerConfig8-base/var/appserver/pointbase"Annulation de la mise à niveau
L'annulation de la mise à niveau vers la version 5 n'est pas prise en charge.
Mise à niveau d'Application Server à partir de Java ES version 3La procédure de mise à niveau d'Application Server pour Java ES 2005Q1 (version 3) vers la version 5 est la même que pour la mise à niveau d'Application Server pour la version 4 vers la version 5.
Pour mettre à niveau Application Server pour la version 3 vers la version 5, suivez les instructions décrites dans la section Mise à niveau d'Application Server à partir de Java ES version 4, en remplaçant chaque occurrence de version 4 par version 3.
Mise à niveau d'Application Server à partir de Java ES version 2Cette section fournit des informations sur la mise à niveau d'Application Server à partir de Java ES version 2 vers Java ES 5 (version 5). La section aborde les thèmes suivants :
Remarque
Si vous procédez à une mise à niveau d'Application Server pour la version 2 sur la plate-forme Linux, il vous faudra procéder à une double mise à niveau (pour Application Server et le système d'exploitation). Application Server pour la version 5 n'est pas pris en charge sur RHEL 2.1. Pour plus d’informations, reportez-vous à la section Double mise à niveau.
Introduction
Lors de la mise à niveau d'Application Server pour Java ES version 2 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :
- Approche générale de mise à niveau. Pour effectuer la mise à niveau, vous devez installer Application Server pour la version 5 à l'aide du programme d'installation de Java ES et choisir l'option Configurer ultérieurement. Vous effectuez ensuite la reconfiguration à l'aide de l'utilitaire asupgrade. Une fois la mise à niveau d'Application Server effectuée, vous devez migrer les composants J2EE pour la version 2 vers la version 5.
- Dépendances pour la mise à niveau. La mise à niveau de tout composant Java ES d'un ordinateur à partir de la version 2 nécessite la mise à niveau de tous les autres composants de Java ES hébergés sur cet ordinateur ; la mise à niveau sélective des composants Java ES de la version 2 vers la version 5 n'est pas prise en charge.
En particulier, tous les composants partagés Java ES requis par Application Server doivent être mis à niveau. S'il est hébergé sur le même ordinateur, Message Queue doit également être mis à niveau. High Availability Session Store (HADB) et Base de données Java doivent être installés et, si Web Server est utilisé pour l'équilibrage de charge, il doit également être mis à niveau.
- Compatibilité ascendante. Application Server pour la version 5 n'est pas compatible avec la version 2. Les composants et applications J2EE doivent être migrés et exécutés dans un environnement Application Server pour la version 5.
- Annulation de la mise à niveau. L'annulation de la mise à niveau vers la version 5 avec retour à la version 2 s'effectue simplement par la restauration de l'installation de la version 2 (les données de configuration de la version 2 ne sont pas supprimées par le processus de mise à niveau).
- Problèmes relatifs à la plate-forme. L'approche générale de mise à niveau d'Application Server est identique pour les systèmes d'exploitation Solaris et Linux : Java ES version 2 n'est pris en charge que sous Linux2.1, alors que Java ES version 5 n'est pas pris en charge sous Linux2.1. Une double mise à niveau est donc nécessaire : le système d'exploitation et Application Server doivent être mis à niveau (voir la section Mises à niveau doubles : Java ES et système d'exploitation).
- Emplacements des données. La version 5 utilise de nouveaux emplacements pour le stockage des données de configuration et de déploiement et les fichiers journaux d'accès, comme indiqué dans le Tableau 11-4.
Mise à niveau d'Application Server pour la version 2
Cette section explique comment effectuer la mise à niveau d'Application Server à partir de Java ES version 2 vers Java ES version 5 sur les plates-formes Solaris et Linux. Lorsqu'une rubrique traite de procédures spécifiques à une plate-forme, le système d'exploitation auquel elle fait référence est indiqué. La section aborde les thèmes suivants :
Tâches à exécuter avant la mise à niveau
Avant de mettre à niveau Application Server, vous devez effectuer les tâches décrites ci-dessous :
SE Solaris uniquement : supprimez manuellement les packages d' Application Server fournis avec le système d'exploitation.
L'installation d'Application Server pour la version 2 n'a pas supprimé la version d'Application Server fournie avec le système d'exploitation Solaris. Pour effectuer correctement la mise à niveau d'Application Server pour la version 2 vers la version 5, procédez comme suit :
- Désinstallez la version fournie avec le système d'exploitation en supprimant manuellement les packages d'Application Server correspondants, qui se trouvent dans le répertoire /usr/appserver :
pkgrm SUNWascmnse SUNWaslb SUNWasut ...
Utilisez la commande suivante pour obtenir la liste complète des packages à supprimer :
pkginfo -i|grep -i “application server”
Les packages renvoyés par cette commande devraient notamment être les suivants :
SUNWasacee, SUNWascmnse, SUNWasu, SUNWasuee, SUNWasac, SUNWascmn, SUNWasdb, SUNWasdem, SUNWasdemdb, SUNWasr, SUNWasut, SUNWasman, SUNWasjdoc
Cette commande peut également renvoyer des packages de localisation :
SUNWlangueasacee, SUNWlangueascmnse, SUNWlangueasu, SUNWlangueasuee
- Si la version fournie avec le système d'exploitation a été utilisée, supprimez les informations de domaine :
rm /usr/appserver/domains
Vérification des informations sur la version actuelle
Vous pouvez vérifier la version actuelle d'Application Server à l'aide de la commande suivante :
AppServer7-base/bin/asadmin version --verbose
Voir le Tableau 11-5 des résultats de version.
Mise à niveau des dépendances d'Application Server
La mise à niveau des dépendances d'Application Server nécessite la mise à niveau vers la version 5 de tous les composants locaux par rapport auxquels Application Server présente une dépendance, spécifiquement Application Server et les composants partagés. En revanche, les composants partagés sont mis à niveau automatiquement par le programme d'installation de Java ES dans le cadre de la mise à niveau (voir la section Procédure de mise à niveau).
En outre, la mise à niveau d'Application Server nécessite l'installation de HADB et de Base de données Java car Application Server pour la version 5 dépend de ces composants. Toutefois, ces composants sont automatiquement sélectionnés et installés par le programme d'installation de Java ES dans le cadre de la mise à niveau (voir la section Procédure de mise à niveau).
De manière générale, vous devez effectuer la mise à niveau des dépendances d'Application Server dans l'ordre décrit ci-dessous (en sautant les dépendances déjà mises à niveau), avant d'effectuer la mise à niveau d'Application Server. Cependant, la mise à niveau des composants partagés, ainsi que l'installation de HADB et Base de données Java sont effectuées automatiquement par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau d'Application Server.
- Composants partagés. Les instructions de synchronisation des composants partagés Java ES vers la version 5 sont présentées dans la section Mise à niveau des composants partagés Java ES. Néanmoins, tous les composants partagés requis par Application Serversont automatiquement mis à niveau par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau d'Application Server vers la version 5.
- Message Queue. Voir la section Mise à niveau de Message Queue à partir de Java ES version 2. Message Queue ne peut pas être mis à niveau à partir de la version 2 en utilisant le programme d'installation de Java ES.
- High Availability Session Store (HADB). Une installation complète de HADB est effectuée par le programme d'installation de Java ES lors de la mise à niveau d'Application Server.
- Base de données Java. Une installation complète de Base de données Java est effectuée par le programme d'installation de Java ES lors de la mise à niveau d'Application Server.
- Logiciels de conteneur Web (dépendance souple pour la mise à niveau). Voir la section Mise à niveau de Web Server à partir de Java ES version 2.
Sauvegarde des données d'Application Server
La mise à niveau d'Application Server à partir de la version 2 vers la version 5 n'écrase pas les données de configuration de la version 2. Toutefois, par mesure de précaution, il est conseillé de sauvegarder le répertoire domains avant d'effectuer la mise à niveau vers la version 5.
Obtention des mots de passe et informations de configuration requis
Vous devez connaître les informations suivantes concernant la version actuellement installée :
Mise à niveau de la version 2 Application Server
Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau d'Application Server, suivies de la description de la procédure elle-même.
Considérations relatives à la mise à niveau
La mise à niveau d'Application Server vers Java ES version 5 tient compte des considérations suivantes :
- Tout composant J2EE exécuté sur une instance d'Application Server doit être arrêté avant la mise à niveau de l'instance en question. Toutefois, si vous utilisez l'équilibrage de charge pour fournir de l'évolutivité ou une haute disponibilité, cet arrêt n'est pas obligatoire.
- Toutes les instances d'Application Server exécutées sur un même ordinateur (toutes correspondant à la même image d'Application Server) doivent être arrêtées pendant la mise à niveau de l'image installée.
Procédure de mise à niveau
La procédure présentée ci-dessous s'applique à toutes les instances d'Application Server installées sur l'ordinateur sur lequel est effectuée la mise à niveau.
- Connectez-vous en tant qu'utilisateur root ou superutilisateur.
su -
- Si les composants partagés Java ES ont été mis à niveau vers la version 5 (en particulier si J2SE a été mis à niveau vers le JDK 1.5), alors qu'Application Server pour la version 2 était en cours d'exécution, vous devez modifier le fichier asenv.conf pour qu'il pointe directement sur le JDK 1.4.
AS_JAVA=/usr/java
Application Server ne peut pas être arrêté (voir l'Step 3 ci-dessous) si le fichier asenv.conf référence le JDK 1.5.
- Arrêtez tous les processus d'Application Server et les processus liés.
AppServer7-base/bin/asadmin stop-appserv nomDomaine
- Installez Application Server pour la version 5.
Procédez comme suit :
- Lancez le programme d'installation de Java ES sur l'ordinateur qui héberge Application Server pour la version 2.
cd distribution Java ES version 5/arch_se
./installeroù arch_se correspond à votre plate-forme, telle que Solaris_sparc. (Utilisez l’option installer -nodisplay pour l’interface de ligne de commande.)
Une fois que les pages de bienvenue et du contrat de licence se sont affichées, vous accédez à la page de sélection de composant. (Lorsque des composants installés pouvant être directement mis à niveau par le programme d'installation de Java ES sont détectés, ils sont présentés avec l'état “pouvant être mis à niveau”.) Application Server n'est pas affiché comme pouvant être mis à niveau à partir de la version 2.
- Sélectionnez Application Server dans la page de sélection des composants.
Choisissez d'installer au moins les trois premiers sous-composants, y compris le composant d'agent du nud.
- Cliquez sur Suivant.
Si Message Queue n'a pas encore été mis à niveau vers la version 5, un message d'erreur vous demande d'effectuer la mise à niveau de Message Queue. Dans ce cas, cliquez sur OK et effectuez la mise à niveau de Message Queue. La procédure est décrite dans la section Mise à niveau de Message Queue pour la version 2.
- Spécifiez un répertoire d'installation différent de celui dans lequel Application Server pour la version 2 était installé.
- Sélectionnez l'option Configurer ultérieurement.
Remarque
Si vous avez la version d'Application Server fournie avec le système d'exploitation Solaris 9 et que vous n'avez jamais utilisé cette version (aucune information de domaine n'a été créée), vous pouvez sélectionner l'option Configurer maintenant et sauter l'Step 5 et les étapes suivantes.
- Si besoin, sélectionnez l’option d’installation des packages localisés.
- Lorsque l'installation est terminée, quittez le programme d'installation de Java ES.
- Exécutez la procédure de finalisation suivante :
- Localisez le fichier ReadMe du script postInstall dans le répertoire des outils d'Application Server de la distribution Java ES version 5.
distribution Java ES version 5/arch_se/Product/application_svr/Tools
où arch_se correspond à votre plate-forme, telle que Solaris_sparc.
- Reportez-vous au fichier ReadMe et exécutez le script postInstall .
cd distribution Java ES version 5/arch_se/Product/application_svr/Tools
./postInstall AppServer8Install-base AppServer8Config-baseCes scripts configurent et créent les scripts de shell AppServer8-base/bin/* et un fichier config/asenv.conf à partir des modèles installés au cours de l'installation. En principe, le programme d'installation crée les scripts de shell Java ESbin/*, mais si vous sélectionnez l'option Configurer ultérieurement, ils doivent être créés comme indiqué.
Remarque
Lorsque vous effectuez la mise à niveau d'Application Server vers la version 5, les ports non admin 8080 (par défaut) et 8181 (sécurisé) sont affectés au serveur d'administration du domaine (DAS). Ces affectations de ports peuvent entrer en conflit avec les ports affectés aux instances d'Application Server pour la version 2. Dans ce cas, vous devez modifier les ports affectés au serveur DAS pour éviter tout conflit. Pour plus d'informations sur la modification des attributs du listener http, reportez-vous au Guide d'administration de Sun Java System Application Server Enterprise Edition 8.2, http://docs.sun.com/doc/819-4733.
- Si nécessaire, modifiez les paramètres d'environnement dans le fichier AppServer8-base/config/asenv.conf.
Vous devez modifier le fichier manuellement.
Remarque
Pour configurer Application Server pour l'équilibrage de charge, reportez-vous à la section “Configuration des serveurs Web pour l'équilibrage de charge HTTP” du chapitre “Fonctionnalités haute disponibilité d’Application Server” du Guide d'administration haute disponibilité de Sun Java System Application Server Enterprise Edition 8.2 (http://docs.sun.com/doc/819-4740).
- Exécutez l'utilitaire asupgrade.
L'utilitaire asupgrade crée un agent de nud de version 5 sous lequel il migre les instances d'Application Server pour la version 2.
Cet utilitaire se trouve dans le répertoire d'Application Server, par exemple :
- Mode d'assistant de mise à niveau : AppServer8-base/bin/asupgrade
- Mode de console de mise à niveau : AppServer8-base/bin/asupgrade -c
L'assistant ou la console de mise à niveau vous guide à travers les différentes étapes de mise à niveau.
- Identifiez les répertoires source et cible pour la migration des informations de domaine :
- Indiquez l'utilisateur admin, le mot de passe admin et le mot de passe principal d'Application Server pour la version 2.
Si le système vous demande un mot de passe principal, spécifiez changeit ; si le keystore que vous utilisez a un mot de passe principal autre que changeit, modifiez ce mot de passe pour lui donner la valeur changeit.
jdk-home/bin/keytool -storepasswd -new changeit -keystore keystore -storepass ancienMdP
Pour plus d'informations sur l'utilitaire Application Server asupgrade, reportez-vous à la section décrivant les commandes utilisateur du Manuel de référence Sun Java System Application Server Enterprise Edition 8.2 (http://docs.sun.com/doc/819-4736) et au Guide de migration et de mise à niveau de Sun Java System Application Server Enterprise Edition 8.2 (http://docs.sun.com/doc/819-4737/6n6sao3ju?a=view).
- Si vous aviez redirigé le fichier asenv.conf dans l'Step 2, restaurez-le pour qu'il pointe de nouveau vers JDK 1.5.
AS_JAVA=/usr/jdk/entsys-j2se
Application Server ne peut pas être démarré (Step 8 et Step 9 ci-dessous) si le fichier asenv.conf référence le JDK 1.4.
- Démarrez le serveur d'administration du domaine (DAS).
AppServer8-base/bin/asadmin start-domain --user ID_admin
nomDomaine- Redémarrez les instances mises à niveau d'Application Server.
Pour ce faire, démarrez l'agent du nud sous lequel les instances mises à niveau d'Application Server ont été migrées :
AppServer8-base/bin/asadmin start-node-agent --user ID_Admin
nomAgentNudoù nomAgentNudpossède la forme nomHôte_nomDomaine, mais est simplement nomHôte par défaut.
Vérification de la mise à niveau
Démarrez la console d'administration et vérifiez que ces serveurs sont lancés. Si l'un des serveurs n'est pas en cours d'exécution, vérifiez le fichier journal suivant afin de déceler tout échec éventuel provoqué par des conflits de ports :
En cas d'échec dû à un conflit de ports, utilisez la console d'administration et modifiez les numéros de ports de sorte qu'il n'y ait plus de conflit, puis arrêtez et redémarrez l'agent de nud.
Vous pouvez vérifier que la mise à niveau d'Application Server vers la version 5 est réussie, à l'aide de la commande suivante :
AppServer8-base/bin/asadmin version --verbose
Voir le Tableau 11-5 pour les valeurs de résultat.
Tâches à exécuter après la mise à niveau
Il reste deux tâches à exécuter une fois effectuées les étapes décrites dans la section Procédure de mise à niveau :
Correction de la référence à JSS
Pour qu'Application Server référence la bonne version du composant partagé JSS, vous devez remplacer jss3.jar par jss4.jar dans le fichier domain.xml d'Application Server, qui se trouve dans le répertoire suivant :
AppServer8Config-base/domains/nomDomaine/config/domain.xml
Migration des composants J2EE pour la version 2
Vous devez migrer les composants et applications J2EE pour la version 2 pour qu'ils s'exécutent dans un environnement Application Server pour la version 5 et les redéployer sur les instances d'Application Server appropriées. Pour plus d'informations sur la migration des composants et applications J2EE, reportez-vous au chapitre 4 du Guide de migration et de mise à niveau d'Application Server Enterprise Edition 8.2 (http://docs.sun.com/doc/819-4737).
Annulation de la mise à niveau
La procédure d'annulation de la mise à niveau d'Application Server vers la version 5 consiste simplement à revenir à Application Server pour la version 2 qui n'a pas été supprimée au cours de la mise à niveau vers la version 5.
Mise à niveau de la version d'Application Server fournie avec Solaris dans un environnement Solaris 10 multizoneApplication Server (ainsi que Message Queue, dont dépend Application Server) est fourni avec le système d'exploitation Solaris 10. Sauf s'il est retiré de la zone globale, la version d'Application Server fournie avec Solaris est répercutée aux zones non globales lorsque des zones de ce type sont créées. L'existence de la version d'Application Server fournie avec Solaris dans toutes les zones a des conséquences sur la mise à niveau d'Application Server vers la version 5 :
- La mise à niveau d'Application Server dans la zone globale supprime la version fournie avec Solaris dans la zone globale et supprime automatiquement la version fournie avec Solaris de toutes les zones non globales.
- La mise à niveau d'Application Server vers la version 5 dans la zone globale ne met pas à niveau Application Server dans les zones non globales car les packages d'Application Server pour la version 5 ne sont pas répercutés.
L'exemple suivant illustre certaines subtilités relatives à la mise à niveau d'Application Server dans un environnement Solaris 10 multizone. Pour plus d'informations concernant Java ES et la gestion des zones dans Solaris 10, voir la section Mise à niveau de Java ES 5 et zones Solaris 10.
Cet exemple illustre la mise à niveau vers la version 5 de la version d'Application Server (version 8.0.0_01) fournie avec Solaris dans une zone Solaris 10 « sparse root ».
Vous ne pouvez pas simplement mettre à niveau Application Server dans une zone « sparse root » car la version d'Application Server fournie avec Solaris est installée dans un répertoire en lecture seule monté à partir de la zone globale. C'est pourquoi, pour effectuer la mise à niveau d'Application Server vers la version 5 dans la zone « sparse root », vous devez commencer par supprimer la version d'Application Server fournie avec Solaris dans la zone globale.
De plus, Message Queue est installé dans la zone globale ce qui contrevient à la pratique selon laquelle seuls les composants partagés (et non les composants du produit) doivent être installés dans la zone globale. Cela est dû au fait que Message Queue ne peut pas être installé ou mis à niveau dans une zone « sparse root » à cause du fait que les répertoires sont en lecture seule.
La procédure de mise à niveau vers la version 5 de la version d'Application Server (version 8.0.0_01) fournie avec Solaris dans une zone Solaris 10 « sparse root » est la suivante :
- Vérifier l'état initial du système.
Dans cet exemple, l'environnement considéré est une version de Solaris 10 comportant une zone « sparse root » qui a été installée, configurée et amorcée par l'administrateur global.
La zone « sparse root » inclut tous les composants Java ES qui sont déjà installés dans la zone globale, c'est-à-dire les versions de Message Queue et d'Application Server fournies avec Solaris 10.
De plus, on considère dans cet exemple que l'utilisateur a déjà utilisé la version d'Application Server fournie avec Solaris dans la zone « sparse root » et qu'il a créé des informations d'administration de domaine qui doivent être préservées.
- Effectuez la mise à niveau de la version d'Application Server fournie avec Solaris dans la zone globale.
Cette opération supprime les packages de la version d'Application Server fournie avec Solaris et les remplace par les packages de la version 5. La suppression des packages de la version fournie avec Solaris est répercutée à la zone « sparse root », ce qui a pour effet de désinstaller les packages d'Application Server dans la zone « sparse root », mais les packages de la version 5 ne sont pas répercutés aux zones non globales.
- Exécutez le programme d'installation de Java ES dans la zone globale.
- Sélectionnez Application Server dans la page de sélection des composants.
Message Queue, HADB et Base de données Java sont sélectionnés automatiquement et Application Server et Message Queue sont signalés comme pouvant être mis à niveau.
- Terminez la mise à niveau.
Message Queue pour la version 5 est répercuté dans la zone « sparse root », mais Application Server, HADB et Base de données Java ne sont pas répercutés. De plus, tous les composants partagés sont synchronisés vers la version 5 et répercutés dans la zone « sparse root ».
- Installez Application Server dans la zone « sparse root ».
- Exécutez le programme d'installation de Java ES dans la zone « sparse root ».
- Sélectionnez Application Server dans la page de sélection des composants.
Désélectionnez Message Queue s'il est sélectionné automatiquement et sélectionnez HADB et Base de données Java s'ils ne sont pas sélectionnés automatiquement.
- Terminez l'installation d'Application Server.
Sélectionnez l'option Configurer ultérieurement afin que les informations de domaine ne soient pas écrasées par la procédure d'installation.
Si aucun domaine n'a été créé, vous pouvez sélectionner l'option Configurer maintenant.