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