Sun Java logo     Précédent      Sommaire      Index      Suivant     

Sun logo
Sun Java Enterprise System 2005Q4 Guide de mise à niveau 

Chapitre  9
Application Server

Ce chapitre décrit la procédure de mise à niveau d’Application Server vers Java ES 2005Q4 (version 4) : Sun Java System Application Server Enterprise Edition 8.1 2005Q4

Ce chapitre présente globalement les problèmes et procédures des différentes méthodes de mise à niveau prises en charge par Java ES version 4. Il traite des mises à niveau sur les systèmes d’exploitation Solaris et Linux :

Présentation des mises à niveau d’Application Server

Cette section présente les aspects généraux d’Application Server qui ont un impact sur la mise à niveau vers Java ES 2005Q4 (version 4) :

À propos d’Application Server pour Java ES version 4

Application Server pour Java ES version 4 représente les corrections de bogues sélectionnées apportées aux versions relatives à la version 3. Le fonctionnement d’Application Server est identique pour la version 4 et pour la version 3.

Présentation de la mise à niveau d’Application Server

Le Tableau 9-1 répertorie les méthodes de mise à niveau d’Application Server vers Java ES version 4 prises en charge. Il s’applique à la fois à Solaris et Linux.

Tableau 9-1  Méthodes de mise à niveau vers Java ES version 4 : Sun Java System Application Server Enterprise Edition 8.1 2005Q4  

Version de Java ES

Application Server Version

Approche globale

Reconfiguration requise

Version 3

Sun Java System Application Server Enterprise Edition 8.1 2005Q1

Mise à niveau directe :
exécutée par l’application de patchs.

Aucun

Version 2

Sun Java System Application Server 7.0 Upgrade 3 (2004Q2)
Enterprise Edition et Platform Edition

Mise à niveau directe :
servez-vous du programme d’installation de Java ES, puis de l’utilitaire de reconfiguration.

Variables d’environnement 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 Upgrade 1 (2003Q4)
Enterprise Edition et Platform Edition

Mise à niveau directe non certifiée :
mais vous pouvez vous servir du programme d’installation de Java ES, puis de l’utilitaire de reconfiguration.

Variables d’environnement 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 :
vous pouvez d’abord effectuer une mise à niveau vers la version 3 à l’aide des procédures fournies dans le Guide de migration et de mise à niveau de Sun Java Enterprise System 2005Q1
(http://docs.sun.com/doc/819-2234).

Mettez ensuite la version 3 à niveau vers la version 4.

 

Outre les versions Java ES d’Application Server indiquées dans le Tableau 9-1, Application Server Platform Edition est également fourni avec le système d’exploitation Solaris. La mise à niveau des versions fournies d’Application Server Enterprise Edition vers la version 4 peut être effectuée par le programme d’installation de Java ES. Il vous suffit d’installer Application Server à l’aide du programme d’installation, comme pour une nouvelle installation, et le logiciel mettra automatiquement à niveau la version fournie, en reconfigurant Application Server si nécessaire.

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.

Tableau 9-2  Utilisation des données d’Application Server

Type de données

Emplacement

Utilisation

Variables d’environnement

AppServer8-base/config/asenv

Variables générales

Données de configuration

Version 3 et version 4 :
Fichiers domain.xml et server.policy dans
AppServer8Config-base/domains/nomDomaine/config

Version 2 :
Fichiers server.xml et server.policy dans
AppServer7Config-base/domains/nomDomaine/
nomInstance/config

Configuration des instances d’Application Server

Données de déploiement

Version 3 et version 4 :
AppServer8Config-base/domains/nomDomaine/
applications

Version 2 :
AppServer7Config-base/domains/nomDomaine/
nomInstance/applications

Configuration du conteneur J2EE pour des composants et applications J2EE particuliers.

Problèmes de compatibilité

Application Server pour la version 4 ne présente aucune modification d’interface par rapport à la version 3. Il existe toutefois des modifications d’interface entre la version 4 et la version 2, qui rendent ces deux versions incompatibles.

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 :

Mise à niveau d’Application Server à partir de Java ESversion 3

Cette section fournit des informations sur la mise à niveau d’Application Server à partir de Java ES 2005Q1 (version 3) vers Java ES 2005Q4 (version 4). Elle aborde les thèmes suivants :

Introduction

Lors de la mise à niveau d’Application Server pour Java ES version 3 vers la version 4, tenez compte des aspects suivants du processus de mise à niveau :

Mise à niveau d’Application Server pour la version 3

Cette section explique comment effectuer la mise à niveau d’Application Server à partir de Java ES version 3 vers Java ES version 4 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é. Elle 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 :

Mettre à niveau les composants présentant des dépendances par rapport à Application Server

Il est généralement recommandé de mettre à niveau tous les composants Java ES installés sur un même ordinateur (et dans un environnement informatique) vers Java ES version 4. Toutefois, puisque la mise à niveau d’Application Server vers la version 4 ne requiert pas la mise à niveau des composants Java ES version 3, cette tâche est facultative. Si vous décidez de mettre à niveau les composants par rapport auxquels Application Server présente des dépendances, vous devez le faire dans l’ordre suivant :

  1. Composants partagés.  Les instructions de mise à niveau des composants partagés Java ES vers la version 4 sont présentées dans la section Mise à niveau des composants partagés Java ES.
  2. Message Queue.  Les instructions de mise à niveau de Message Queue vers la version 4 sont présentées dans le Chapitre 7, « Message Queue ».
  3. Logiciels de conteneur Web (facultatif).  Les instructions de mise à niveau de Web Server ou d’Application Server sont présentées respectivement dans le Chapitre 6, « Web Server » et le Chapitre 9, « Application Server ».
  4. High Availability Session Store (facultatif).  Les instructions de mise à niveau de High Availability Session Store sont présentées dans le Chapitre 8, « High Availability Session Store ».
Sauvegarder les données d’Application Server

La mise à niveau d’Application Server à partir de la version 3 vers la version 4 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 d’Application Server pour la version 3 (Solaris)

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 (Solaris)

La mise à niveau d’Application Server vers Java ES version 4 tient compte des considérations suivantes :

Procédure de mise à niveau (Solaris)

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.

  1. Notez les numéros des patchs requis indiqués dans le Tableau 9-4.

    2. Vous pouvez télécharger les patchs dans /tmp à partir de l’adresse : http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. Arrêtez tous les composants J2EE exécutés sur les instances d’Application Server que vous allez mettre à niveau.
  3. Arrêtez toutes les instances d’Application Server installées sur l’ordinateur que vous allez mettre à niveau.

    4. AppServer8-base/bin/asadmin stop-domain nomDomaine

  4. Appliquez le patch approprié d’Application Server, répertorié dans le Tableau 9-4.

    5. patchadd ID_patch

  5. Modifiez le script asant.
    1. Renommez le script asant existant en asant.bak.

      2. Ce script se trouve à l’emplacement suivant :

      AppServer8-base/bin/asant

    2. Copiez le fichier asant.template de

      3. AppServer8-base/lib/install/templates/ee

      dans

      AppServer8-base/bin/asant

    3. Modifiez le script.

      4. Remplacez le jeton %CONFIG_HOME% par AppServer8-base/config.

    4. Si vous avez apporté des modifications manuelles au fichier script original (asant.bak), fusionnez-les dans le nouveau script asant.
  6. Confirmez la réalisation de la mise à niveau du patch :

    7. showrev -p | grep ID_patch

    Le résultat doit renvoyer les versions des ID de patchs appliqués à l’étape 4.

  7. Redémarrez les instances d’Application Server.

    8. AppServer8-base/bin/asadmin start-domain nomDomaine

Mise à niveau d’Application Server pour la version 3 (Linux)

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 (Linux)

Les mêmes considérations s’appliquent à la mise à niveau d’Application Server vers Java ES version 4 sous Linux et Solaris (voir Considérations relatives à la mise à niveau (Solaris)), sauf que les patchs de mise à niveau pour la version 4 sous Linux sont différents de ceux destinés à Solaris.

Le patch de mise à niveau d’Application Server pour la version 4 sous Linux est indiqué dans le tableau suivant :

Tableau 9-5  Patchs1 de mise à niveau de Application Server sous Linux 

Description

ID de patch et nom de RPM

Application Server

119168-10

sun-asac-8.1.2-10.i386.rpm, sun-asacee-8.1.2-10.i386.rpm
sun-ascml-8.1.2-10.i386.rpm, sun-ascmn-8.1.2-10.i386.rpm
sun-ascmnse-8.1.2-10.i386.rpm, sun-asdb-8.1.2-10.i386.rpm
sun-asdem-8.1.2-10.i386.rpm, sun-asdemdb-8.1.2-10.i386.rpm
sun-ashdm-8.1.2-10.i386.rpm
sun-asJdbcDrivers-8.1.2-10.i386.rpm
sun-asjdoc-8.1.2-10.i386.rpm, sun-aslb-8.1.2-10.i386.rpm
sun-asman-8.1.2-10.i386.rpm, sun-asmanee-8.1.2-10.i386.rpm
sun-asu-8.1.2-10.i386.rpm, sun-asuee-8.1.2-10.i386.rpm
sun-asut-8.1.2-10.i386.rpm, sun-aswbcr-8.1.2-10.i386.rpm

Localisation d’Application Server

119026-10

sun-asacee-Langue-8.1.1-51.i386.rpm
sun-ascmnse-Langue-8.1.1-51.i386.rpm
sun-asu-Langue-8.1.1-51.i386.rpm
sun-asuee-Langue-8.1.1-51.i386.rpm

1Les numéros de révision des patchs sont les numéros minimum requis pour la mise à niveau vers Java ES version 4. S’il existe des versions plus récentes, utilisez-les à la place de celles indiquées dans ce tableau.

Procédure de mise à niveau (Linux)

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.

Attention

Il est impossible d’annuler une mise à niveau de Java ES version 3 vers Java ES version 4 sous Linux.

  1. Procurez-vous les patchs requis à l’aide de leurs numéros et des noms de RPM indiqués dans le Tableau 9-5. Utilisez ces informations pour obtenir les numéros de version des RPM.

    2. Vous pouvez télécharger les patchs dans /tmp à partir de l’adresse : http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  2. Arrêtez tous les composants J2EE exécutés sur les instances d’Application Server que vous allez mettre à niveau.
  3. Arrêtez toutes les instances d’Application Server installées sur l’ordinateur que vous allez mettre à niveau.

    4. AppServer8-base/bin/asadmin stop-domain nomDomaine

  4. Sauvegardez les fichiers suivants :
    • tous les fichiers contenus dans AppServer8-base/pointbase/tools/serveroption
    • AppServer8-base/samples/common.properties
  5. Appliquez les RPM indiqués dans le Tableau 9-5 à Application Server.

    6. rpm -Fvh sun-im-module-7.0-13.4.i386.rpm
    rpm -Fvh sun-as    module-Langue-8.1.1-51.i386.rpm

  6. Restaurez les fichiers sauvegardés à l’étape 4 à leur emplacement d’origine :
    • tous les fichiers contenus dans AppServer8-base/pointbase/tools/serveroption
    • AppServer8-base/samples/common.properties
  7. Modifiez le script asant.
    1. Renommez le script asant existant en asant.bak.

      2. Ce script se trouve à l’emplacement suivant :

      AppServer8-base/bin/asant

    2. Copiez le fichier asant.template de

      3. AppServer8-base/lib/install/templates/ee

      dans

      AppServer8-base/bin/asant

    3. Modifiez le script.

      4. Remplacez le jeton %CONFIG_HOME% par AppServer8-base/config.

    4. Si vous avez apporté des modifications manuelles au fichier script original (asant.bak), fusionnez-les dans le nouveau script asant.
  8. Confirmez la réalisation de la mise à niveau du patch :

    9. rpm -qa | grep sun-as

    Le système doit vous renvoyer les numéros de la nouvelle version des RPM.

  9. Redémarrez les instances d’Application Server.

    10. AppServer8-base/bin/asadmin start-domain nomDomaine

Vérification de la mise à niveau

Vous pouvez vérifier à l’aide de la commande suivante que le patch est correctement appliqué :

AppServer8-base/bin/asadmin version --verbose

Voir le Tableau 9-3 des valeurs de résultat.

Tâches à exécuter après la mise à niveau

Aucune tâche n’est à exécuter après les étapes de mise à niveau décrites dans les sections Procédure de mise à niveau (Solaris) et Procédure de mise à niveau (Linux).

Annulation de la mise à niveau (Solaris)

Cette section traite des considérations qui ont une incidence sur la procédure d’annulation de la mise à niveau d’Application Server, suivies de la description de la procédure elle-même.

Considérations relatives à l’annulation de la mise à niveau (Solaris)

La procédure d’annulation de la mise à niveau d’Application Server vers la version 4 est quasiment l’inverse de la procédure de mise à niveau vers la version 4. Les patchs sont supprimés.

Procédure d’annulation de la mise à niveau (Solaris)
  1. Arrêtez tous les composants J2EE exécutés sur l’instance d’Application Server que vous allez mettre à niveau.
  2. Arrêtez l’instance d’Application Server que vous allez mettre à niveau.
  3. Supprimez les patchs répertoriés dans le Tableau 9-4.

    4. patchrm ID_patch

  4. Redémarrez l’instance d’Application Server.

Mise à niveau d’Application Server à partir de Java ES version 2

Cette section fournit des informations sur la mise à niveau d’Application Server à partir de Java ES version 2 vers Java ES 2005Q4 (version 4). Elle aborde les thèmes suivants :

Introduction

Lors de la mise à niveau d’Application Server pour Java ES version 2 vers la version 4, tenez compte des aspects suivants du processus de mise à niveau :

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 3 vers Java ES version 4 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é. Elle 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 :

AppServer7-base/bin/asadmin version --verbose

Voir le Tableau 9-3 des résultats de version.

Mettre à niveau les composants présentant des dépendances par rapport à Application Server

La mise à niveau des composants présentant des dépendances par rapport à Application Server doit inclure la mise à niveau vers la version 4 de tous les composants locaux par rapport auxquels Application Server présente des dépendances. Les composants partagés sont mis à niveau automatiquement par le programme d’installation de Java lors de la procédure de mise à niveau (voir l’étape 3).

La mise à niveau des composants dépendant d’Application Server doit être effectuée dans l’ordre suivant, avant la mise à niveau d’Application Server. Vous pouvez ignorer tout composant déjà mis à niveau.

Sauvegarder les données d’Application Server

La mise à niveau d’Application Server à partir de la version 2 vers la version 4 n’écrase pas les données de configuration de la version 2. Toutefois, pour des mesures de sécurité, le répertoire de configuration de toutes les instances d’Application Server doit être sauvegardé avant la mise à niveau vers la version 4.

Les répertoires de configuration se trouvent à l’emplacement suivant :

Obtenir les mots de passe et informations de configuration requis

Vous devez connaître les informations suivantes concernant la version actuellement installée :

Mise à niveau d’Application Server pour la version 2

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 4 tient compte des considérations suivantes :

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.

  1. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    2. su -

  2. Arrêtez tous les processus d’Application Server et les processus liés.
  3. Installez Application Server pour la version 4 à l’aide du programme d’installation de Java ES et sélectionnez l’option Configurer ultérieurement.

    4. Choisissez d’installer au moins les trois premiers sous-composants, y compris le composant d’agent du nud.

    Une fois le logiciel Application Server installé, veillez à effectuer les procédures postérieures à l’installation qui sont indiquées dans la section Configuration d’Application Server après une installation sans configuration immédiate.

  4. Identifiez les répertoires d’installation source et cible, par exemple :
    • Source version 2 par défaut sous Solaris : /opt/SUNWappserver7
    • Cible version 4 par défaut sous Solaris : /opt/SUNWappserver/appserver
  5. Exécutez l’utilitaire asupgrade.

    6. L’utilitaire asupgrade crée un agent de nud de version 4 sous lequel il migre les instances d’Application Server pour la version 2.

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

      Pour plus d’informations sur l’utilitaire asupgrade de mise à niveau d’Application Server, reportez-vous au chapitre 3 du manuel Application Server Enterprise Edition 8.1 Upgrade and Migration Guide 2005Q1 (http://docs.sun.com/doc/819-0222).

  6. Démarrez le serveur d’administration du domaine.

    7. AppServer8-base/bin/asadmin start-domain --user ID_admin
         --password mot_de_passe nomDomaine

  7. Redémarrez les instances d’Application Server mises à niveau.

    8. 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
         --password mot_de_passe NomAgentNud

    où nomAgentNud est sous la forme nom_hôte_nomDomaine.
    La valeur par défaut de nomDomaine est domain1.

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 4 est réussie, à l’aide de la commande suivante :

AppServer8-base/bin/asadmin version --verbose

Voir le Tableau 9-3 des valeurs de résultat.

Tâches à exécuter après la mise à niveau

Il reste des tâches à exécuter après les étapes décrites dans la section Procédure de mise à niveau. Elles impliquent la migration des composants et applications J2EE pour la version 2 à exécuter dans un environnement Application Server pour la version 4 et leur redéploiement 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 manuel Application ServerEnterprise Edition 8.1 Upgrade and Migration Guide 2005Q1 (http://docs.sun.com/doc/819-0222).

Annulation de la mise à niveau

La procédure d’annulation de la mise à niveau d’Application Server vers la version 4 consiste simplement à revenir à Application Server pour la version 2 qui n’a pas été supprimé au cours de la mise à niveau.

Mise à niveau de plusieurs instances (cluster)

L’utilitaire asupgrade d’Application Server permet de mettre à niveau plusieurs instances. Vous trouverez les instructions dans le chapitre 3 du manuel Application Server Enterprise Edition 8.1 2005Q2 Upgrade and Migration Guide (http://docs.sun.com/doc/819-2559).

Configuration d’Application Server après une installation sans configuration immédiate

Après une installation sans configuration immédiate, vous devez exécuter un script pour configurer l’environnement d’Application Server. Procédez comme suit :

  1. Recherchez la distribution d’accessoires d’Application Server.

    2. CD 1 Accessory de Sun Java Enterprise System 2005Q4,
    Add Ons d’Application Server pour Solaris SPARC et x86,
    Image du CD 1 sur 1

    Vous pouvez télécharger le contenu des accessoires depuis le centre de téléchargement de Sun à l’adresse http://www.sun.com/software/javaenterprisesystem/get.xml.

  2. Reportez-vous au fichier ReadMe qui se trouve dans le dossier Addon de la distribution des accessoires et suivez les procédures indiquées.
    1. Exécutez le script postInstall.

      2. Le script principal du dossier Addon, postInstall, doit être exécuté à partir de la distribution des accessoires, sinon il ne trouve pas certains fichiers.

      Ces scripts configurent et créent les scripts de shell AppServer8-base/bin/* et un fichier config/asenv à partir des modèles installés au cours de l’installation. (En principe, le programme d’installation crée les scripts de shell bin/*, mais si vous sélectionnez l’option Configurer ultérieurement, ils doivent être créés comme indiqué.)

    2. Créez un autre domaine.

      3. Lorsque vous utilisez la commande asadmin create-domain pour créer un domaine,vous devez indiquer les valeurs de deux paramètres : adminPort et instancePort. La valeur de adminPort peut être identique à celle utilisée par l’instance du serveur pour la version 2, toutefois, la valeur de instancePort doit être différente de celles utilisées par les instances de serveur pour la version 2. En choisissant une valeur pour instancePort non utilisée, vous évitez tout conflit entre l’instance du serveur d’administration du domaine pour la version 4 et les instances de serveur pour la version 2 qui sont migrées vers la version 4 (voir l’étape 5).

  3. Si nécessaire, modifiez les paramètres d’environnement dans le fichier AppServer8-base/config/asenv.

    4. Vous devez modifier le fichier manuellement.

    Remarque

    Pour configurer Application Server pour l’équilibrage de charge, reportez-vous à la section « Configuring Web Servers for HTTP Load Balancing » dans le chapitre « Application Server High Availability Features » du manuel Sun Java System Application Server Enterprise Edition High Availability Administration Guide (http://docs.sun.com/doc/819-0216).



Précédent      Sommaire      Index      Suivant     

Numéro de référence : 819-3460.   Copyright 2006 Sun Microsystems, Inc. Tous droits réservés.