Chapitre 5 Directory Proxy Server

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

Mise à niveau de Directory Proxy Server à partir de Java ES version 3

Mise à niveau de Directory Proxy Server à partir de Java ESversion 2



Remarque	Les emplacements de fichiers auxquels il est fait référence dans ce chapitre sont spécifiés en fonction du chemin d’accès du répertoire appelé serverRoot. Une partie au moins de ce chemin a été probablement spécifiée comme répertoire d’installation lors de l’installation et de la configuration initiales de Directory Proxy Server. Dans le cas contraire, une valeur par défaut a été attribuée. La valeur par défaut de serverRoot dépend de la plate-forme du système d’exploitation : Solaris : /var/opt/mps/serverroot Linux : /var/opt/sun/directory-server

Présentation des mises à niveau de Directory Proxy Server

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

À propos de Java ES version 4

Directory Proxy Server pour Java ES version 4 ne présente que peu de corrections de bogues et d’améliorations. Aucune nouvelle fonctionnalité n’a été ajoutée.

Présentation de la mise à niveau de Java ES version 4

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

Tableau 5-1 Méthodes de mise à niveau vers Java ES version 4 : Sun Java System Directory Proxy Server 5.2 2005Q4
Version de Java ES	Directory Proxy Server Version	Approche globale	Reconfiguration requise
Version 3	Sun Java System Directory Proxy Server 5.2 2005Q1	Mise à niveau directe : appliquez les patchs et reconfigurez l’annuaire de configuration.	Reconfiguration automatique des données de l’annuaire de configuration
Version 2	Sun Java System Directory Proxy Server 5.2 2004Q2	Mise à niveau directe : appliquez les patchs et reconfigurez l’annuaire de configuration.	Reconfiguration automatique des données de l’annuaire de configuration
Version 1	Sun One Directory Proxy Server 5.2	Mise à niveau directe non certifiée : mais vous pouvez utiliser la méthode adoptée pour la mise à niveau à partir de la version 2.	Reconfiguration automatique des données de l’annuaire de configuration
Versions antérieures à Java ES	Sun One Directory Proxy Server 5.2	Mise à niveau directe non certifiée : mais vous pouvez utiliser la méthode adoptée pour la mise à niveau à partir de la version 2.	Reconfiguration automatique des données de l’annuaire de configuration
Versions antérieures à Java ES	Sun One Directory Access Router 5.0 or 5.0 SP1	Pas de mise à niveau directe : effectuez tout d’abord la mise à niveau vers la version 3. Reportez-vous au manuel Guide de migration et de mise à niveau de Java Enterprise System 2005Q1 (http://docs.sun.com/doc/819-0062). Mettez ensuite la version 3 à niveau vers la version 4.	Reportez-vous au manuel Guide de migration et de mise à niveau de Java Enterprise System 2005Q1. (http://docs.sun.com/doc/819-0062)

Données de Directory Proxy Server

Directory Proxy Server utilise Directory Server pour le stockage des données de configuration. Les données sont stockées dans une structure d’arborescence particulière dans le répertoire. L’instance de Directory Server qui héberge la configuration est appelée annuaire de configuration.

Dans la plupart des architectures de déploiement, l’annuaire de configuration est distant des autres composants qui l’utilisent pour stocker les informations de configuration.

Le tableau suivant affiche le type de données susceptible d’être affecté par la mise à niveau du logiciel Directory Proxy Server.

Problèmes de compatibilité

Directory Proxy Server pour Java ES version 4 n’introduit aucune modification d’interface, et est compatible avec les versions antérieures.

Dépendances

Tableau 5-2 Utilisation des données de Directory Proxy Server
Type de données	Emplacement	Utilisation
Données de configuration de Directory Proxy Server	Annuaire de configuration	Configuration de Directory Proxy Server

Les dépendances par rapport autres composants Java ES ont une influence sur la procédure de mise à niveau et de reconfiguration du logiciel Directory Proxy Server. Directory Proxy Server présente des dépendances par rapport à des composants partagés Java ES particuliers (voir le Tableau 1-6). Directory Proxy Server fournit un accès frontal à Directory Server et utilise Administration Server à des fins de configuration. Directory Proxy Server présente donc des dépendances à la fois par rapport à Directory Server et à Administration Server.

Mise à niveau de Directory Proxy Server à partir de Java ES version 3

Cette section fournit des informations sur la mise à niveau de Directory Proxy 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 de Directory Proxy Server pour Java ES version 3 vers la version 4, tenez compte des aspects suivants du processus de mise à niveau :

Approche globale de la mise à niveau. Pour effectuer la mise à niveau, il vous faut appliquer des patchs aux versions correspondant à Java ES version 3. La reconfiguration de Directory Proxy Server est réalisée automatiquement par la synchronisation de l’annuaire de configuration avec le logiciel mis à niveau.

Dépendances pour la mise à niveau. Bien que Directory Proxy Server présente des dépendances par rapport à plusieurs composants partagés Java ES (voir le Tableau 1-6), Directory Proxy Server pour Java ES version 4 est compatible avec les versions 3 de ces composants. La mise à niveau de ces composants partagés est donc facultative dans le cadre de la mise à niveau de Directory Proxy Server vers la version 4.

Compatibilité ascendante. Directory Proxy Server pour la version 4 est compatible avec la version 3.

Annulation de la mise à niveau. Sur les plates-formes Solaris, pour annuler la mise à niveau vers la version 4, vous devez supprimer les patchs appliqués au cours de la mise à niveau. Sur la plate-forme Linux, toutefois, il n’existe aucune procédure d’annulation de la mise à niveau vers la version 4.

Problèmes relatifs à la plate-forme. L’approche générale de la mise à niveau de Directory Proxy Server est identique pour les systèmes d’exploitation Solaris et Linux. En revanche, les modes d’application de patchs sont différents. La mise à niveau inclut par conséquent des procédures spécifiques à la plate-forme.

Mise à niveau de Directory Proxy Server pour la version 3

Cette section explique comment effectuer la mise à niveau de Directory Proxy 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 Directory Proxy 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 de Directory Proxy Server à l’aide des commandes suivantes :

Tableau 5-3 Résultat de la vérification de la version de Directory Proxy Server
Version de Java ES	Numéro de version de Directory Proxy Server
Version 2	Sun ONE Directory Proxy Server Version 5.2_Patch_2
Version 3	Sun ONE Directory Proxy Server Version 5.2_Patch_3
Version 4	Sun ONE Directory Proxy Server Version 5.2_Patch_4

Mettre à niveau les composants présentant des dépendances par rapport à Directory Proxy 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.

Directory Proxy Server présente des dépendances strictes de mise à niveau par rapport à Directory Server et Administration Server, même lorsqu’ils sont exécutés sur des ordinateurs distants. Ces composants doivent donc être mis à niveau avant Directory Proxy Server.

La mise à niveau des composants partagés Java ES version 3 dont dépend Directory Proxy Server est donc facultative, bien que recommandée.

Vous pouvez mettre à niveau les composants dépendant de Directory Proxy Server dans l’ordre suivant et avant toute mise à niveau de Directory Proxy Server. Vous pouvez ignorer tout composant déjà mis à niveau.

Sauvegarder les données de Directory Server

La mise à niveau de Directory Proxy Server modifie les données de l’annuaire de configuration. Par conséquent, avant d’effectuer la mise à niveau, vous devez sauvegarder vos données d’annuaire de configuration à l’aide de la console Directory Server ou d’un utilitaire de ligne de commande tel que db2bak.

Pour plus d’informations sur la sauvegarde de Directory Server, reportez-vous au manuel Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).

Obtenir les mots de passe et informations de configuration requis

Directory Proxy Server doit être exécuté en tant que même utilisateur et groupe que Directory Server et Administration Server, c’est-à-dire avec le même ID utilisateur et ID de groupe.

Mise à niveau de Directory Proxy Server pour la version 3 (Solaris)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Directory Proxy Server, suivies de la description de la procédure elle-même.

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

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

Tout composant Java ES utilisant une instance de Directory Proxy Server (comme Access Manager, Communications Express, Messaging Server, Portal Server, etc.) doit être arrêté avant la mise à niveau de l’instance. Toutefois, les architectures de déploiement utilisent souvent plusieurs instances de Directory Proxy Server afin de fournir évolutivité et haute disponibilité. Dans ce cas, vous pouvez effectuer une mise à niveau progressive de Directory Proxy Server et les clients Directory Proxy Server n’ont pas besoin d’être arrêtés.

La mise à niveau de Directory Proxy Server doit être effectuée après celle d’Administration Server et de Directory Server car la reconfiguration doit avoir lieu dans un ordre précis.

Directory Proxy Server doit être arrêté lors de l’application de patchs. En revanche, l’annuaire de configuration associé doit être en cours d’exécution pour effectuer la reconfiguration.

Dans une architecture de déploiement contenant plusieurs instances de Directory Proxy Server exécutées sur un même ordinateur (toutes correspondant à la même image Directory Proxy Server installée), la mise à niveau de l’image de Directory Proxy Server se répercute sur toutes les instances. Dans ces architectures, il n’existe qu’une instance d’Administration Server par image de Directory Proxy Server installée.

Les patchs de mise à niveau de Directory Proxy Server pour la version 4 sous Solaris sont indiqués dans le tableau suivant :

Tableau 5-4 Patchs1 de mise à niveau de Directory Proxy Server sous Solaris
Description	SPARC Solaris 8, 9 et 10	X86 Solaris 9 et 10
Directory Proxy Server	116373-18	116374-18
Localisation de Directory Proxy Server	117017-20	117017-20

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

La procédure présentée ci-dessous s’applique aux instances de Directory Proxy Server installées sur l’ordinateur sur lequel est effectuée la mise à niveau.

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

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

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

su -

Arrêtez la console d’administration si elle est exécutée localement.

Arrêtez tous les composants Java ES qui dépendent des instances Directory Proxy Server que vous allez mettre à niveau. Cette étape dépend de la façon dont Directory Proxy Server est répliqué dans votre architecture de déploiement.

Pour plus d’informations sur l’arrêt d’un composant Java ES, reportez-vous au guide d’administration correspondant.

Veillez à bien avoir mis à niveau tous les composants Java ES par rapport auxquels Directory Proxy Server présente des dépendances de mise à niveau strictes (voir la section Mettre à niveau les composants présentant des dépendances par rapport à Directory Proxy Server).

Mettez à niveau Directory Proxy Server.

Assurez-vous que l’annuaire de configuration est en cours d’exécution.

S’il est installé localement, vous devez le démarrer. S’il est distant, vérifiez qu’il est en cours d’exécution.

Appliquez les patchs de Directory Proxy Server répertoriés dans le Tableau 5-4.

Appliquez le patch de localisation de Directory Proxy Server (117017) avant d’appliquer le patch de base de Directory Proxy Server.

patchadd ID_patch.

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

showrev -p | grep ID_patch

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

Redémarrez Directory Proxy Server et tous les composants Java ES qui dépendent de Directory Proxy Server.

Pour redémarrer Directory Proxy Server :

serverRoot/dps-nom_hôte/restart-dps

Mise à niveau de Directory Proxy Server pour la version 3 (Linux)

Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Directory Proxy 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 de Directory Proxy Server vers Java ES version 4 sous Linux et Solaris (voir la section 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 de Directory Proxy Server pour la version 4 sous Linux est indiqué dans le tableau suivant :

Tableau 5-5 Patchs1 de mise à niveau de Directory Proxy Server sous Linux
Description	ID de patch et nom de RPM
Directory Proxy Server	118096-08: sun-directory-proxy-server-5.2-13.i386.rpm
Localisation de Directory Proxy Server	118288-11: sun-directory-proxy-server-Langue-5.2-16.i386.rpm

Procédure de mise à niveau (Linux)

La procédure présentée ci-dessous s’applique aux instances de Directory Proxy 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.

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

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

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

su -

Arrêtez la console d’administration si elle est exécutée localement.

Pour plus d’informations sur l’arrêt d’un composant Java ES, reportez-vous au guide d’administration correspondant.

Appliquez les RPM à Directory Proxy Server.

Assurez-vous que l’annuaire de configuration est en cours d’exécution.

S’il est installé localement, vous devez le démarrer. S’il est distant, vérifiez qu’il est en cours d’exécution.

Appliquez les RPM.

Appliquez le RPM de localisation de Directory Proxy Server avant d’appliquer le RPM de base de Directory Proxy Server.

rpm -Fvh sun-directory-proxy-server-Langue-5.2-16.i386.rpm
rpm -Fvh sun-directory-proxy-server-5.2-13.i386.rpm

Les paramètres mis à niveau sont automatiquement synchronisés avec l’annuaire de configuration.

Redémarrez Directory Proxy Server et tous les composants Java ES qui dépendent de Directory Proxy Server.

Pour redémarrer Directory Proxy Server :

serverRoot/dps-nom_hôte/restart-dps

Vérification de la mise à niveau

Vous pouvez vérifier que la mise à niveau de Directory Proxy Server est réussie, à l’aide des commandes suivantes :

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

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 de Directory Proxy 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 de Directory Proxy 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 et l’annuaire de configuration est resynchronisé.

Notez toutefois que lorsque vous appliquez les patchs, vous mettez à niveau la base de données de certificats SSL vers un format cert8. Le patch sauvegarde les données cert7, puis les convertit au format cert8. Si vous décidez ensuite d’annuler la mise à niveau et que vous avez ajouté de nouveaux certificats à la base de données, vous devez les extraire manuellement, restaurer les patchs, puis ajouter de nouveau les certificats à la base de données au format cert7.

Lorsque vous annulez une mise à niveau après avoir modifié la base de données de certificats SSL, vous ne pouvez pas démarrer en mode SSL. Pour éviter ce problème, désactivez le mode SSL, redémarrez Directory Proxy Server et Administration Server, réinstallez le certificat, puis activez à nouveau le mode SSL.

Procédure d’annulation de la mise à niveau (Solaris)

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

su -

Arrêtez la console d’administration si elle est exécutée localement.

Pour plus d’informations sur l’arrêt d’un composant Java ES, reportez-vous au guide d’administration correspondant.

Annulez la mise à niveau de Directory Proxy Server.

Assurez-vous que l’annuaire de configuration est en cours d’exécution.

S’il est installé localement, vous devez le démarrer. S’il est distant, vérifiez qu’il est en cours d’exécution.

Supprimez les patchs de Directory Proxy Server répertoriés dans le Tableau 5-5.

patchrm ID_patch

Annulez toutes les mises à niveau des composants de Java ES pour lesquels Directory Proxy Server présente des dépendances de mise à niveau strictes, en particulier par rapport à Directory Server et Administration Server.

Redémarrez Directory Proxy Server et tous les composants Java ES qui dépendent de Directory Proxy Server.

Mise à niveau de plusieurs instances

Dans certaines architectures, Directory Proxy Server est déployé sur plusieurs systèmes afin de permettre l’évolutivité et d’améliorer la disponibilité. Par exemple, des composants Directory Proxy Server peuvent être exécutés sur plusieurs ordinateurs avec un équilibreur de charge pour répartir cette dernière.

Dans le cas d’instances de Directory Proxy Server dont la charge est équilibrée, vous pouvez effectuer une mise à niveau progressive dans laquelle vous mettez à niveau les instances de Directory Proxy Server une par une sans interrompre le service. Vous mettez à niveau chaque instance de Directory Proxy Server pendant que les autres restent actives. La mise à niveau de chaque instance est décrite dans la section Mise à niveau de Directory Proxy Server pour la version 3.

Mise à niveau de Directory Proxy Server à partir de Java ESversion 2

La procédure de mise à niveau de Directory Proxy Server pour Java ES 2004Q2 (version 2) vers la version 4 est identique à celle de la mise à niveau de la version 3 vers la version 4, à l’exception près que les tâches antérieures à la mise à niveau doivent inclure la mise à niveau vers la version 4 de tous les composants partagés (voir le Tableau 1-6) et de tous les composants locaux par rapport auxquels Directory Proxy Server présente des dépendances.

Précédent Sommaire Index Suivant
Sun Java Enterprise System 2005Q4 Guide de mise à niveau