Sun Java logo     Précédent      Sommaire      Index      Suivant     

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

Chapitre  17
Portal Server

Ce chapitre décrit la procédure de mise à niveau de Portal Server vers Java ES 2005Q4 (version 4) : Sun Java System Portal Server 6.3.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 de Portal Server

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

À propos de Portal Server pour Java ES version 4

Portal Server pour Java ES version 4 a les mêmes fonctionnalités que la version 3, mais certaines corrections de bogue ont été apportées depuis la version 3.

Présentation de la mise à niveau de Portal Server

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

Tableau 17-1  Méthodes de mise à niveau vers Java ES version 4 : Sun Java System Portal Server 6.3.1 2005Q4 

Version de Java ES

Portal Server Version

Approche globale

Reconfiguration requise

Version 3

Sun Java System Portal Server 6.3.1 2005Q1

Mise à niveau directe :
exécutée par l’application de patchs. Certaines restrictions s’appliquent (voir les procédures).

Aucun

Version 2

Sun Java System Portal Server 6.3 2004Q2

Mise à niveau directe :
exécutée par l’application de patchs de mise à niveau vers la version 4, reconfiguration du logiciel et redéploiement dans le conteneur Web.

Données de configuration

Version 1

Sun ONE Portal Server 6.1 (2003Q4)

Pas de mise à niveau directe :
peut être effectuée en passant par la mise à niveau vers la version 3 puis application de patchs de mise à niveau vers la version 4. Certaines restrictions s’appliquent (voir les procédures).

Données de configuration

Versions antérieures à Java ES

 

Pas de mise à niveau directe.

 

Données de Portal Server

Le tableau suivant indique le type de données qui peut être affecté par une mise à niveau du logiciel Portal Server.

Tableau 17-2  Portal Server Utilisation des données 

Type de données

Emplacement

Utilisation

Données de configuration

PortalServerConfig-base/

Configuration de Portal Server

Configuration du conteneur Web

Web Server:
Fichiers server.policy et server.xml dans
WebServer-base/https-nom_hôte/config

Application Server (Java ES version 3 et 4) :
Fichiers server.policy et domain.xml dans
AppServer8Config-base/domains/nomDomaine/config

Application Server (Java ES version 2) :
Fichiers server.policy et server.xml dans
AppServer7Config-base/domains/nomDomaine/config

Configuration de l’instance de conteneur Web du Portal Server.

Données de personnalisation

PortalServerConfig-base/desktop

Fichiers JAR pour les modules personnalisés

Exemple de bureau Portal Server personnalisé

Schéma d’annuaire

Configuration des services

Données utilisateur

Directory Server

Portal Server dépend de configurations de services, telles que le bureau Portal, et de données de profil utilisateur stockées dans un répertoire.

Données d’application dynamiques

Aucun

Portal Server ne stocke pas en permanence les données d’application, telles que l’état de la session.

Problèmes de compatibilité

Portal Server version 4 n’introduit aucune modification d’interface. Les composants de Portal Server, notamment le composant pour l’accès mobile, présentent une compatibilité ascendante avec les versions antérieures.

Dépendances de Portal Server

Les dépendances de Portal Server par rapport à d’autres composants Java ES peuvent avoir une influence sur la procédure de mise à niveau et de reconfiguration du logiciel Portal Server. Les modifications apportées aux interfaces ou fonctions de Portal Server, par exemple, peuvent demander une version mise à niveau des composants dont dépend Portal Server. Le besoin de mettre à jour ces composants dépend de la méthode de mise à niveau spécifique.

Portal Server présente des dépendances par rapport aux composants Java ES suivants :

Mise à niveau de Portal Server à partir de Java ES version 3

Cette section présente des informations sur la mise à niveau de Portal Server à partir de Java ES 2005Q1 (version 3) vers Java ES 2005Q4 (version 4).

Remarque

Cette section ne s’applique pas au cas particulier où Portal Server est déployé dans un conteneur Web Application Server et a été mis à niveau de la version 2 vers la version 3 avant la mise à niveau vers la version 4. Cette méthode de mise à niveau n’est pas prise en charge.

Elle aborde les thèmes suivants :

Introduction

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

Mise à niveau de Portal Server pour la version 3

Cette section explique comment effectuer la mise à niveau de Portal Server 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 Portal 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 du Portal Server à l’aide de la commande suivante :

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

Il est généralement conseillé de mettre tous les composants de Java ES d’un ordinateur (et de son environnement informatique) au niveau de Java ES version 4. Toutefois, Portal Server présente une dépendance pour la mise à niveau stricte uniquement pour le composant partagé Mobile Access Core (MA Core). La mise à niveau des autres composants de Java ES version 3 dont dépend Portal Server est donc facultative.

En revanche, si vous choisissez de mettre à niveau toutes les dépendances de Portal Server, vous devez le faire dans l’ordre suivant, et ce avant de mettre à niveau Portal Server. Vous pouvez ignorer tout composant déjà mis à niveau.

  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. Directory Server.  Les instructions de mise à niveau de Directory Server vers la version 4 sont présentées dans le Chapitre 4, « Directory Server et Administration Server ».
  3. Logiciels de conteneur Web :  les instructions de mise à niveau de Web Server ou d’Application Server sont présentées respectivement dans les sections Chapitre 6, « Web Server » et Chapitre 9, « Application Server ».

    4. Remarque

    La mise à niveau de conteneurs Web tiers, tels que ceux de WebLogic et WebSphere, peut provoquer l’arrêt de Portal Server car les personnalisations apportées à ces conteneurs pour la prise en charge de Portal Server sont écrasées par la mise à niveau du conteneur.

    Dans ce cas, vous devez réinstaller et reconfigurer Portal Server pour les environnements de conteneur Web mis à niveau.

  4. Access Manager (SDK Access Manager).  Les instructions de mise à niveau d’Access Manager vers la version 4 sont présentées dans le Chapitre 11, « Access Manager ».
Sauvegarder les informations de configuration de Portal Server pour la version 3

La mise à niveau de Portal Server vers la version 4 ne nécessite pas de nouvelle configuration du logiciel Portal Server. Toutefois, par mesure de précaution, vous pouvez sauvegarder les répertoires suivants qui contiennent les informations de configuration :

Obtenir les mots de passe et informations de configuration requis

Vous devez vous connecter en tant que superutilisateur pour procéder à la mise à niveau. Si vous utilisez Web Server comme conteneur Web, aucune information de configuration n’est requise. En revanche, si vous utilisez Application Server comme conteneur Web, vous devrez indiquer l’ID utilisateur et le mot de passe de l’administrateur d’Application Server.

Mise à niveau de la version 3 de Portal Server (Solaris)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau pour Portal Server et décrit ensuite les différentes étapes de cette procédure.

Considérations relatives à la mise à niveau (Solaris)

La mise à niveau de Portal 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 au logiciel Portal Server installé sur l’ordinateur sur lequel est effectuée la mise à niveau.

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

    2. Utilisez toujours la dernière révision de patch disponible, sauf spécification contraire.

    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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Arrêtez Portal Server en fermant son conteneur Web.

    4. Web Server:
    WebServer-base    /https-nomInstance/stop

    Application Server:
    AppServer8-base    /bin/asadmin stop-domain nomDomaine

  4. Si vous ne l’avez pas encore fait, procédez à la mise à niveau du composant partagé MA Core et de tout autre composant souhaité.

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. Appliquez le patch de Portal Server répertorié dans le Tableau 17-4.

    6. Appliquez le patch principal de Portal Server (119707) avant d’appliquer les deux patchs de localisation de Portal Server.

    patchadd ID_patch.

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

  7. Redémarrez Portal Server en redémarrant son conteneur Web.

    8. Web Server:
    WebServer-base    /https-nomInstance/start

    Application Server:
    AppServer8-base    /bin/asadmin start-domain --user ID_admin
         --password mot_de_passe nomDomaine

  8. Redéployez l’application Web Portal Server dans votre conteneur Web.

    9. PortalServer-base/bin/deploy redeploy

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  9. Arrêtez puis redémarrez le conteneur Web.

    10. Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

Mise à niveau de la version 3 de Portal Server (Linux)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau pour Portal Server et décrit ensuite les différentes étapes de cette procédure.

Considérations relatives à la mise à niveau (Linux)

Les mêmes considérations s’appliquent à la mise à niveau de Portal 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.

Les patchs de mise à niveau de Portal Server pour la version 4 sont répertoriés dans le tableau suivant pour le système d’exploitation Linux :

Tableau 17-5  Patchs1 pour la mise à niveau de Portal Server sur Linux 

Description

ID de patch et nom de RPM

Portal Server Core

118952-12

  • sun-portal-core-6.3-25.12.i386.rpm

et un certain nombre de RPM supplémentaires pour le bureau Portal et l’accès mobile Portal Server.

Localisation de Portal Server

119426-07

  • sun-portal-core-Langue-6.3-24.i386.rpm

et un certain nombre de RPM supplémentaires pour l’accès mobile, la configuration, l’identité et d’autres composants Portal Server.

Portal Server Configurateur de localisation

118116-08

  • sun-portal-l10n-configurator-6.3-24.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 au logiciel Portal Server installé 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 17-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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Arrêtez Portal Server en fermant son conteneur Web.

    4. Web Server:
    WebServer-base    /https-nomInstance/stop

    Application Server:
    AppServer8-base    /bin/asadmin stop-domain nomDomaine

  4. Si vous ne l’avez pas encore fait, procédez à la mise à niveau du composant partagé MA Core et de tout autre composant souhaité.

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. Appliquez les RPM pour le patch principal de Portal Server dans le Tableau 17-5.

    6. cd /tmp

    où /tmp est le répertoire dans lequel vous avez téléchargé le patch à l’étape 1.

    ./update

    Le script de mise à jour installe les RPM et garantit que les modifications de configuration appropriées sont effectuée suite à l’application du patch.

  6. Confirmez la réalisation de la mise à niveau du patch :

    7. rpm -qa | grep sun-portal-core-6.3-25

    Le système doit vous renvoyer les numéros de révision mis à niveau des RPM.

  7. Appliquez les RPM pour les deux patchs de localisation Portal Server dans le Tableau 17-5.

    8. rpm -Fvh --replacefiles sun-portal-*-Langue-6.3-24.i386.rpm
    rpm -Fvh --replacefiles
         sun-portal-l10n-configurator-6.3-24.i386.rpm

  8. Confirmez la réalisation de la mise à niveau du patch :

    9. rpm -qa | grep sun-portal-l10n-configurator-6.3-24

    Le système doit vous renvoyer les numéros de révision mis à niveau des RPM.

  9. Redémarrez Portal Server en redémarrant son conteneur Web.

    10. Web Server:
    WebServer-base    /https-nomInstance/start

    Application Server:
    AppServer8-base    /bin/asadmin start-domain --user ID_admin
         --password mot_de_passe nomDomaine

  10. Redéployez l’application Web Portal Server dans votre conteneur Web.

    11. PortalServer-base/bin/deploy redeploy

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  11. Arrêtez puis redémarrez le conteneur Web.

    12. Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

Vérification de la mise à niveau

Vous pouvez vérifier que la mise à niveau de Portal Serververs la version 4 est réussie en vérifiant que les patchs de mise à niveau ont été correctement appliqués. Les étapes de cette vérification figurent dans Procédure de mise à niveau (Solaris) et Procédure de mise à niveau (Linux).

Par ailleurs, vous pouvez utiliser la commande suivante :

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

En plus des tests de mise à niveau du patch, vous pouvez vous assurer que les fonctions qui marchaient fonctionnent toujours et que les corrections de bogue importantes ont effectivement été mises en uvre.

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 décrit les points qui ont une influence sur la procédure d’annulation de la mise à niveau de Portal Server, suivis par 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 vers la version 4 de Portal Server est quasiment l’inverse de la procédure de mise à niveau. Les nouvelles configurations sont annulées et les patchs sont supprimés.

Procédure d’annulation de la mise à niveau (Solaris)
  1. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    2. su -

  2. Arrêtez Portal Server en fermant son conteneur Web.

    3. Web Server:
    WebServer-base    /https-nomInstance/stop

    Application Server:
    AppServer8-base    /bin/asadmin start-domain --user ID_admin
         --password mot_de_passe nomDomaine

  3. Supprimez les patchs répertoriés dans le Tableau 17-4.

    4. patchrm ID_patch

  4. Redémarrez Portal Server en redémarrant son conteneur Web.

    5. Web Server:
    WebServer-base    /https-nomInstance/start

    Application Server:
    AppServer8-base    /bin/asadmin start-domain nomDomaine
         --user ID_admin --password mot_de_passe

  5. Redéployez l’application Web Portal Server dans votre conteneur Web.

    6. PortalServer-base/bin/deploy redeploy

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  6. Arrêtez puis redémarrez le conteneur Web.

    7. Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

Mise à niveau de plusieurs instances

Dans certaines architectures, Portal Server est déployé sur plusieurs systèmes afin de permettre une meilleure évolutivité et une disponibilité accrue. Par exemple, certains composants Portal Server peuvent être exécutés sur plusieurs ordinateurs avec un programme d’équilibrage de charge pour répartir la charge.

Dans le cas d’instances de Portal Server avec équilibrage de charge, vous pouvez exécuter une mise à niveau progressive, au cours de laquelle les différentes instances de Portal Server seront successivement mises à niveau sans interruption du service. Vous mettez individuellement chaque instance de Portal Server à niveau pendant que les autres instances continuent de fonctionner. Vous exécutez la mise à niveau de chaque instance en suivant la description de la section Mise à niveau de Portal Server pour la version 3.

Mise à niveau de Portal Server à partir de Java ESversion 2

Cette section présente des informations sur la mise à niveau du Portal Server à partir de Java ES 2004Q2 (version 2) vers Java ES 2005Q4 (version 4).

En raison de la complexité de la mise à niveau d’un système Portal Server version 2, et du temps d’arrêt important à prévoir, vous pouvez envisager de procéder à une mise à niveau en parallèle sur un autre ordinateur au lieu d’effectuer une mise à niveau en place d’un système de production. Cette approche est conseillée dans les cas où les solutions Portal Server sont essentielles pour les activités et où le temps d’arrêt doit être réduit au minimum. La durée de la procédure de mise à niveau dépendra également du temps dont vous aurez besoin pour mettre en uvre et tester les personnalisations requises pour Portal Server.

Il est possible également que vous deviez modifier ou adapter les instructions de cette section en fonction de votre scénario spécifique de mise à niveau. Dans ces situations, nous vous invitons à contacter les services de support de Sun Microsystems afin de bénéficier d’une assistance pour la mise à niveau.

Cette section contient les rubriques suivantes relatives à la mise à niveau de la version 2 à la version 4 :

Introduction

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

Mise à niveau de Portal Server pour la version 2

Cette section explique comment effectuer la mise à niveau de Portal Server de Java ES version 2 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 Portal 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 du Portal Server à l’aide de la commande suivante :

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

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

Java ES version 4 n’accepte pas le mélange de composants partagés des versions 2 et 4 sur un seul ordinateur.

Vous devez donc mettre à niveau tous les composants locaux de Java ES version 2 dont dépend Portal Server vers la version 4. Lorsque vous procédez à la mise à niveau des dépendances de Portal Server sur un ordinateur, vous devez exécuter la procédure dans l’ordre suivant, avant même de passer à la mise à niveau de Portal Server. Notez qu’il n’existe pas de contraintes spécifiques liées à un scénario de mise à niveau particulier.

  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. Directory Server.  Portal Server dépend rarement d’un Directory Server local. Toutefois, les instructions de mise à niveau de Directory Server vers la version 4 sont présentées dans le Chapitre 4, « Directory Server et Administration Server ».
  3. Logiciel de conteneur Web.  Portal Server peut être exécuté dans un conteneur Web fourni soit par Web Server soit par Application Server.
    • Web Server: Procédez à la mise à niveau vers Web Server version 4 en utilisant la procédure décrite dans Mise à niveau de Web Server à partir de Java ESversion 2.
    • Application Server: Procédez à la mise à niveau vers Application Server version 4 en réalisant une nouvelle installation d’Application Server à l’aide du programme d’installation de Java ES au lieu d’utiliser la procédure décrite dans Mise à niveau d’Application Server à partir de Java ES version 2. Veillez à obtenir le port d’administration et le port de l’instance du serveur d’Application Server 7 pour la version 2 avant d’installer Application Server 8 pour la version 4.

      • Remarque

      La mise à niveau de conteneurs Web tiers, tels que ceux de WebLogic et WebSphere, peut provoquer l’arrêt de Portal Server car les personnalisations apportées à ces conteneurs pour la prise en charge de Portal Server sont écrasées par la mise à niveau du conteneur.

      Dans ce cas, vous devez réinstaller et reconfigurer Portal Server pour les environnements de conteneur Web mis à niveau.

  4. Access Manager (SDK Access Manager).  Portal Server peut être exécuté dans le même conteneur Web qu’Access Manager ou dans un conteneur Web différent.
Sauvegarder les informations de configuration de Portal Server pour la version 2

La mise à niveau de Portal Server vers la version 4 nécessite une nouvelle configuration du logiciel Portal Server. Par mesure de précaution, vous pouvez sauvegarder les répertoires suivants qui contiennent les informations de configuration :

Obtenir les mots de passe et informations de configuration requis

Vous devez vous connecter en tant que superutilisateur pour procéder à la mise à niveau. Si vous utilisez Web Server comme conteneur Web, aucun mot de passe d’administration n’est requis. En revanche, si vous utilisez Application Server comme conteneur Web, vous devrez indiquer l’ID utilisateur et le mot de passe de l’administrateur d’Application Server.

Mise à niveau de Portal Server version 2 (Solaris)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau pour Portal Server et décrit ensuite les différentes étapes de cette procédure.

Considérations relatives à la mise à niveau (Solaris)

La mise à niveau de Portal Server vers Java ES version 4 tient compte des considérations suivantes :

Procédure de mise à niveau (Solaris : Web Server)

La procédure présentée ci-dessous s’applique au logiciel Portal Server installé sur l’ordinateur sur lequel est effectuée la mise à niveau.

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

    2. Veillez à télécharger les révisions de patch exactes indiquées dans le Tableau 17-6, sauf pour les corrections de Portal Server, pour lesquelles il peut exister un patch plus récent.

    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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Arrêtez Portal Server en fermant son conteneur Web.

    4. WebServer-base/https-nomInstance/stop

  4. Si vous ne l’avez pas encore fait, mettez à niveau tous les composants partagés, le conteneur Web, ainsi qu’Access Manager (ou le SDK Access Manager).

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. S’ils ne sont pas déjà exécutés, lancez Directory Server et Access Manager.
  6. Appliquez les patchs de Portal Server répertoriés dans le Tableau 17-6.

    7. Appliquez ces patchs strictement dans l’ordre où ils sont indiqués dans le Tableau 17-6, du haut vers le bas.

    patchadd ID_patch

  7. Confirmez la réalisation de la mise à niveau du patch :

    8. showrev -p | grep ID_patch

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

  8. Reconfigurez le logiciel Portal Server :

    9. ksh

    $ cd PortalServer-base/lib
    $ ./upgradePS04Q205Q1

  9. Redémarrez Portal Server en redémarrant son conteneur Web.

    10. WebServer-base/https-nomInstance/start

  10. Redéployez l’application Web Portal Server dans votre conteneur Web.

    11. PortalServer-base/bin/deploy redeploy

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  11. Arrêtez puis redémarrez le conteneur Web.

    12. Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

Procédure de mise à niveau (Solaris : Application Server)

La procédure présentée ci-dessous s’applique au logiciel Portal Server installé sur l’ordinateur sur lequel est effectuée la mise à niveau.

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

    2. Veillez à télécharger les révisions de patch exactes indiquées dans le Tableau 17-6, sauf pour les corrections de Portal Server, pour lesquelles il peut exister un patch plus récent.

    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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Assurez-vous que Portal Server n’est plus exécuté à l’aide de l’instance d’Application Server version 2.

    4. AppServerConfig7-base/domains/nomDomaine/nomInstance/bin/stopserv

    Dans les commandes ci-dessus et dans les étapes suivantes, les conventions suivantes sont utilisées :

    • La valeur par défaut de nomDomaine est domain1
    • La valeur par défaut de nomInstance est server1
  4. Si vous ne l’avez pas encore fait, mettez à niveau tous les composants partagés, le conteneur Web, ainsi qu’Access Manager (ou le SDK Access Manager).

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. Assurez-vous que la version mise à niveau d’Access Manager n’est plus exécutée à l’aide d’Application Server version 4.

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

  6. Vérifiez que le fichier de configuration d’Access Manager,

    7. AccessManagerConfig-base/config/AMConfig.properties

    contient les valeurs de propriété suivantes :

    com.iplanet.am.notification.url=
        http://    nom_hôte:port/amserver/notificationservice
    com.sun.identity.webcontainer=IAS8.1
    com.iplanet.am.cookie.encode=true

    où nom_hôte:port correspond à l’ordinateur et au port hébergeant l’instance d’Access Manager.

  7. Appliquez les patchs de Portal Server répertoriés dans le Tableau 17-6.

    8. Appliquez ces patchs strictement dans l’ordre où ils sont indiqués dans le Tableau 17-6, du haut vers le bas.

    patchadd ID_patch

  8. Confirmez la réalisation de la mise à niveau du patch :

    9. showrev -p | grep ID_patch

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

  9. Vérifiez que le fichier de configuration de Portal Server,

    10. PortalServerConfig-base/PSConfig.properties

    contient les valeurs de propriété suivantes, qui font référence à l’instance DAS (Domain Administration Server ) d’Application Server :

    DEPLOY_TYPE=SUNONE8  DEPLOY_INSTANCE_DIR=AppServer8Config-base/domains/nomDomaine
    DEPLOY_DOMAIN=AppServer8Config-base/domains/nomDomaine
    DEPLOY_PRODUCT_DIR=AppServer8Config-base/domains/nomDomaine
    DEPLOY_ADMIN_PROTOCOL=https
      DEPLOY_ADMIN_PORT=    DAS_adminPort (par exemple, default=4848)
      DEPLOY_ADMIN_HOST=nom_hôteDAS
      LOAD_BALANCER_URL=http://nom_hôteDASe:port_hôteDAS/portal
    DEPLOY_DOCROOT=    AppServer8Config-base/domains/nomDomaine/docroot
      PS_PORT=    port_hôteDAS (par exemple, default=80)
      DEPLOY_DIR=AppServer8-base
      PS_PROTOCOL=http

    En supposant que les valeurs de port attribuées à la nouvelle installation d’Application Server 8 pour la version 4 sont identiques à celles de l’installation d’Application Server 7 pour la version 2, et qu’il s’agissait des valeurs de port par défaut, alors les valeurs par défaut mentionnées ci-dessus s’appliquent.

  10. Modifiez le fichier PSconfig.properties comme suit :

    11. DEPLOY_INSTANCE=nomInstance_temporaire

    où nomInstance_temporaire est une valeur temporaire non utilisée.

  11. Assurez-vous que DAS est en cours d’exécution.

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

  12. Exécutez les commandes suivantes :

    13. cd PortalServer-base/bin
    ./multiserverinstance

    Un certain nombre de questions utilisées par le script multiserverinstance utilisent les valeurs définies dans le fichier PSConfig.properties illustré à l’étape 9 comme valeurs par défaut, et les instructions suivantes supposent que les valeurs par défaut son correctes.

    Répondez aux questions posées par le script multiserverinstance comme suit :

    1. Sélectionnez l’option 1 pour Create a new portalserver instance (Créer une nouvelle instance de Portal Server).
    2. Sélectionnez l’option 3 pour Sun Java System Application Server 8.1.
    3. Indiquez l’emplacement d’installation du conteneur Web. Appuyez sur Retour.
    4. Indiquez le nom du domaine. Appuyez sur Retour.
    5. Indiquez le chemin d’accès du domaine. Entrez la même valeur que celle indiquée par défaut pour la question 4.
    6. Indiquez le chemin d’accès de l’instance du conteneur Web. Entrez la même valeur que pour la question 5.
    7. Indiquez l’administrateur du conteneur Web. Appuyez sur Retour.
    8. Indiquez le port d’administration du conteneur Web. Appuyez sur Retour.
    9. Indiquez si le port d’administration du conteneur Web est sécurisé. Appuyez sur Retour.
    10. Indiquez le nom de l’instance. Indiquez une valeur pour server.
    11. Indiquez le port de l’instance. Entrez la même valeur que pour PS_PORT dans le fichier PSConfig.properties.
    12. Indiquez si le port de l’instance est sécurisé. Appuyez sur Retour.
    13. Indiquez le répertoire racine du document du conteneur Web. Appuyez sur Retour.
    14. Indiquez le mot de passe de l’administrateur d’Application Server. Entrer le mot de passe.
    15. Indiquez le mot de passe de l’administrateur d’Identity Server. Entrer le mot de passe.

  13. Modifiez le fichier PSconfig.properties comme suit :

    14. DEPLOY_INSTANCE=server

    où la valeur de server correspond au nom d’instance par défaut de l’instance DAS.

  14. Redémarrez le serveur d’administration de domaine :

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

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

  15. Déployez l’application Web Portal Server.

    16. cd PortalServer-base/bin
    ./deploy redeploy

    Ignorez les messages indiquant la présence d’erreurs éventuelles dans le fichier deploy.log.

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  16. Reconfigurez le logiciel Portal Server :

    17. ksh

    $ cd PortalServer-base/lib
    $ ./postinstall_PortletSamples
    $ ./upgradePS04Q205Q1

    Ignorez les erreurs liées à CLI137 ou à (un)deploy générées par le script upgradePS04Q205Q1.

  17. Redémarrez le serveur d’administration de domaine :

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

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

    Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

  18. Mettez à jour le profil d’affichage de Portal Server.
    1. Exécutez la commande suivante :

      2. PortalServer-base/bin/dpadmin list -g -u amadminDN
           -w amadminPassword /tmp/GlobalDP.xml

      Où la valeur de amadminDN se trouve dans la propriété com.sun.identity.authentication.super.user dans le fichier AccessManagerConfig-base/config/AMConfig.properties .

    2. Ouvrez le fichier /tmp/GlobalDP.xml pour le modifier.
    3. Remplacez la valeur de :

      4. org.apache.xalan.xsltc.trax.TransformerFactoryImpl
       par :
      com.sun.org.apache.xalan.internal.xsltc.trax.
           TransformerFactoryImpl

    4. Remplacez toutes les occurrences de la valeur :

      5. Sun JavaTM System Portal Server 6 2004Q2
       par :
      Sun JavaTM System Portal Server 6 2005Q4

    5. Exécutez la commande suivante :

      6. PortalServer-base/bin/dpadmin list -g -u amadminDN
           -w amadminPassword /tmp/GlobalDP.xml

      Où la valeur de amadminDN est identique à celle de l’étape a.

Mise à niveau de Portal Server pour la version 2 (Linux)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau pour Portal Server et décrit ensuite les différentes étapes de cette procédure.

Considérations relatives à la mise à niveau (Linux)

Les mêmes considérations s’appliquent à la mise à niveau de Portal 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.

Les patchs de mise à niveau de Portal Server pour la version 4 sont répertoriés dans le tableau suivant pour le système d’exploitation Linux :

Tableau 17-7  Patchs de mise à niveau de Portal Server vers la version 4 sur Linux 

Description

ID de patch et nom de RPM

Portal Server Core

118020-16

sun-portal-module-6.3-25.i386.rpm

où module peut être n’importe lequel des 70 modules logiciels

Mobile Access Core

119529-02

  • sun-mobileaccess-1.0-25.2.i386.rpm
  • sun-mobileaccess-config-1.0-25.2.i386.rpm

Corrections de Portal Server :

118952-15 (ou supérieure)

  • sun-portal-core-6.3-xx.y.i386.rpm
  • sun-portal-configurator-6.3-xx.y.i386.rpm
  • sun-portal-mobileaccess-6.3-xx.y.i386.rpm
  • sun-portal-desktop-6.3-xx.y.i386.rpm
  • sun-portal-sample-6.3-xx.y.i386.rpm
  • sun-portal-mobileaccess-config-6.3-xx.y.i386.rpm

Procédure de mise à niveau (Linux : Web Server)

La procédure présentée ci-dessous s’applique au logiciel Portal Server installé sur l’ordinateur sur lequel est effectuée la mise à niveau.

  1. Procurez-vous les patchs requis à l’aide de leurs numéros et des noms de RPM indiqués dans le Tableau 17-7. 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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Arrêtez Portal Server en fermant son conteneur Web.

    4. WebServer-base/https-nomInstance/stop

  4. Si vous ne l’avez pas encore fait, mettez à niveau tous les composants partagés, le conteneur Web, ainsi qu’Access Manager (ou le SDK Access Manager).

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. S’ils ne sont pas déjà exécutés, lancez Directory Server et Access Manager.
  6. Appliquez les RPM pour Portal Server dans le Tableau 17-7.
    1. cd /tmp

      2. où /tmp est le répertoire dans lequel vous avez téléchargé le patch à l’étape 1.

    2. Décompressez le fichier de patch 118020, lisez le fichier README et exécutez le script suivant :

      3. ./upgradeportalrpms

      Le script de mise à jour upgradeportalrpms installe les RPM et garantit que les modifications de configuration appropriées sont effectuée suite à l’application du patch.

    3. Décompressez le fichier de patch 119529 et exécutez le script ./update à partir du répertoire ayant été créé lors de la décompression du patch.
    4. Décompressez le fichier de patch 118952 et exécutez le script ./update à partir du répertoire ayant été créé lors de la décompression du patch.
  7. Confirmez la réalisation de la mise à niveau du patch :

    8. rpm -qa | grep sun-portal
    rpm -qa | grep sun-mobileaccess

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

  8. Reconfigurez le logiciel Portal Server :

    9. ksh

    $ cd PortalServer-base/lib
    $ ./upgradePS04Q205Q1

  9. Modifiez le fichier PortalServer-base/export/deploy.import comme suit :

    10. Si l’entrée suivante est présente :

    %JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    %JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    Remplacez-la par :

    /usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    /usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    En d’autres termes, remplacez %JATO_LIB_DIR% par /usr/share/lib/jato

  10. Redémarrez Portal Server en redémarrant son conteneur Web.

    11. WebServer-base/https-nomInstance/start

  11. Redéployez l’application Web Portal Server dans votre conteneur Web.

    12. PortalServer-base/bin/deploy redeploy

    La commande redeploy redéploie le contenu de PortalServer-base/web-src vers /var/PortalServer-base/https-nom_hôte/deploy-dir/web-apps. Toutes les personnalisations de l’application Web Portal Server doivent d’abord être effectuées sur /web-src puis déployées vers /web-apps. Toute modification apportée sous /web-apps doit être répliquée dans /web-src avant l’exécution de la commande deploy, sinon ces modifications seront perdues.

  12. Arrêtez puis redémarrez le conteneur Web.

    13. Bien que ce ne soit pas obligatoire pour toutes les situations, le fait de redémarrer le conteneur Web permet de garantir que Portal Server démarre à partir d’un état propre.

Procédure de mise à niveau (Linux : Application Server)

La procédure présentée ci-dessous s’applique au logiciel Portal Server installé sur l’ordinateur sur lequel est effectuée la mise à niveau.

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

    2. Veillez à télécharger les révisions de patch exactes indiquées dans le Tableau 17-7, sauf pour les corrections de Portal Server, pour lesquelles il peut exister un patch plus récent.

    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. Connectez-vous en tant qu’utilisateur root ou superutilisateur.

    3. su -

  3. Assurez-vous que Portal Server n’est plus exécuté à l’aide de l’instance d’Application Server version 2.

    4. AppServerConfig7-base/domains/nomDomaine/nomInstance/bin/stopserv

    Dans les commandes ci-dessus et dans les étapes suivantes, les conventions suivantes sont utilisées :

    • La valeur par défaut de nomDomaine est domain1
    • La valeur par défaut de nomInstance est server1
  4. Si vous ne l’avez pas encore fait, mettez à niveau tous les composants partagés, le conteneur Web, ainsi qu’Access Manager (ou le SDK Access Manager).

    5. Voir Mettre à niveau les composants présentant des dépendances par rapport à Portal Server.

  5. Assurez-vous que la version mise à niveau d’Access Manager n’est plus exécutée à l’aide d’Application Server version 4.

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

  6. Vérifiez que le fichier de configuration d’Access Manager,

    7. AccessManagerConfig-base/config/AMConfig.properties

    contient les valeurs de propriété suivantes :

    com.iplanet.am.notification.url=
        http://    nom_hôte:port/amserver/notificationservice
    com.sun.identity.webcontainer=IAS8.1
    com.iplanet.am.cookie.encode=true

    où nom_hôte:port correspond à l’ordinateur et au port hébergeant l’instance d’Access Manager.

  7. Appliquez les RPM pour Portal Server dans le Tableau 17-7.
    1. cd /tmp

      2. où /tmp est le répertoire dans lequel vous avez téléchargé le patch à l’étape 1.

    2. Décompressez le fichier de patch 118020, lisez le fichier README et exécutez le script suivant :

      3. ./upgradeportalrpms

      Le script de mise à jour upgradeportalrpms installe les RPM et garantit que les modifications de configuration appropriées sont effectuée suite à l’application du patch.

    3. Décompressez le fichier de patch 119529 et exécutez le script ./update à partir du répertoire ayant été créé lors de la décompression du patch.
    4. Décompressez le fichier de patch 118952 et exécutez le script ./update à partir du répertoire ayant été créé lors de la décompression du patch.
  8. Confirmez la réalisation de la mise à niveau du patch :

    9. rpm -qa | grep sun-portal
    rpm -qa | grep sun-mobileaccess

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

  9. Modifiez le fichier PortalServer-base/export/deploy.import comme suit :

    10. Si l’entrée suivante est présente :

    %JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    %JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    Remplacez-la par :

    /usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
    /usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar

    En d’autres termes, remplacez %JATO_LIB_DIR% par /usr/share/lib/jato

  10. Suivez l’étape 9 à l’étape 18 sous Procédure de mise à niveau (Solaris : Application Server).

Vérification de la mise à niveau

Vous pouvez vérifier que la mise à niveau de Portal Serververs la version 4 est réussie en vérifiant que les patchs de mise à niveau ont été correctement appliqués. Les étapes de cette vérification figurent dans Procédure de mise à niveau (Solaris) et Procédure de mise à niveau (Linux).

Par ailleurs, vous pouvez utiliser la commande suivante :

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

En plus des tests de mise à niveau du patch, vous pouvez vous assurer que les fonctions qui marchaient fonctionnent toujours et que les corrections de bogue importantes ont effectivement été mises en uvre.

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 : Application Server) et Procédure de mise à niveau (Linux : Web Server).

Annulation de la mise à niveau

La mise à niveau de Portal Server de la version 2 vers la version 4 ne peut être annulée.

Mise à niveau de plusieurs instances

Dans certaines architectures, Portal Server est déployé sur plusieurs systèmes afin de permettre une meilleure évolutivité et une disponibilité accrue. Par exemple, certains composants Portal Server peuvent être exécutés sur plusieurs ordinateurs avec un programme d’équilibrage de charge pour répartir la charge.

Dans le cas d’instances de Portal Server avec équilibrage de charge, vous pouvez exécuter une mise à niveau progressive, au cours de laquelle les différentes instances de Portal Server seront successivement mises à niveau sans interruption du service. Vous mettez individuellement chaque instance de Portal Server à niveau pendant que les autres instances continuent de fonctionner. La mise à niveau de chaque instance est décrite dans la section Mise à niveau de Portal Server pour la version 2.



Précédent      Sommaire      Index      Suivant     

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