Guide de mise à niveau de Sun Java Enterprise System 5 pour UNIX |
Chapitre 5
Directory ServerCe chapitre décrit la procédure de mise à niveau de Directory Server vers Java ES 5 (version 5) : Sun Java System Directory Server 6.0.
Ce chapitre présente les considérations relatives à la mise à niveau pour les différentes méthodes de mise à niveau prises en charge par la version 5. Il traite des mises à niveau sur les systèmes d'exploitation Solaris et Linux :
Présentation des mises à niveau de Directory ServerCette section présente les aspects généraux de Directory Server qui ont un impact sur la mise à niveau vers Java ES 5 (version 5) :
À propos de Java ES version 5
Directory Server pour Java ES version 5 constitue une mise à jour majeure, comprenant un grand nombre de nouvelles fonctionnalités et d'améliorations. Pour plus d'informations, voir les Notes de version de Directory Server Enterprise Edition 6 (http://docs.sun.com/doc/820-0286).
Présentation de la mise à niveau vers Java ES version 5
Le Tableau 5-2 répertorie les méthodes de mise à niveau de Directory Server vers Java ES version 5 prises en charge. Il s'applique à la fois à Solaris et Linux.
Tableau 5-2 Méthodes de mise à niveau vers Java ES 5 (version 5) : Directory Server 6.0
Version de Java ES
Directory Server Version
Approche globale
Reconfiguration requise
Version 4
Sun Java System Directory Server 5.2 2005Q4
Sun Java System Administration Server 5.2 2005Q4
Mise à niveau directe :
Installation complète et migration de toutes les données.Les fonctionnalités d'Administration Server sont remplacées par Directory Service Control Center et les utilitaires de ligne de commande de Directory Server EE.
Données de configuration migrées à partir de la version précédente vers la nouvelle installation de Directory Server.
Version 3
Sun Java System Directory Server 5 2005Q1
Sun Java System Administration Server 5 2005Q1
Mise à niveau directe :
Installation complète et migration de toutes les données.Les fonctionnalités d'Administration Server sont remplacées par Directory Service Control Center et les utilitaires de ligne de commande de Directory Server EE.
Données de configuration migrées à partir de la version précédente vers la nouvelle installation de Directory Server.
Version 2
Sun Java System Directory Server 5.2 2004Q2
Sun Java System Administration Server 5.2 2004Q2
Mise à niveau directe :
Installation complète et migration de toutes les données.Les fonctionnalités d'Administration Server sont remplacées par Directory Service Control Center et les utilitaires de ligne de commande de Directory Server EE.
Données de configuration migrées à partir de la version précédente vers la nouvelle installation de Directory Server.
Version 1
Sun ONE Directory Server 5.2
Sun ONE Administration 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.Données de configuration migrées à partir de la version précédente vers la nouvelle installation de Directory Server.
Versions antérieures à Java ES
Sun ONE Directory Server 5.2
Sun ONE Administration 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.Données de configuration migrées à partir de la version précédente vers la nouvelle installation de Directory Server.
Sun ONE Directory Server 5.1
Sun ONE Administration Server 5.1
Pas de mise à niveau directe :
Effectuez d'abord une mise à niveau vers la version 3 à l'aide des procédures décrites dans le Guide de migration et de mise à niveau de Java Enterprise System 2005Q1 (http://docs.sun.com/doc/819-0062).Ensuite, effectuez la mise à niveau de la version 3 vers la version 5.
Reportez-vous au Guide de migration et de mise à niveau de Java Enterprise System 2005Q1 (http://docs.sun.com/doc/819-0062).
Données de Directory Server
Les versions 5.x de Directory Server utilisaient Directory Server lui-même pour le stockage des données de configuration. Les données étaient stockées dans une structure d'arborescence particulière dans l'annuaire. L'instance de Directory Server qui héberge la configuration est appelée annuaire de configuration. Celui-ci pouvait être hébergé sur le même ordinateur que les autres instances de Directory Server. Toutefois, dans la plupart des architectures de déploiement, cela n'était pas le cas et il se trouvait sur un ordinateur autre que celui des autres composants qui l'utilisaient pour stocker des informations de configuration.
Directory Server 6.0 ne stocke plus les données de configuration dans un annuaire de configuration. La configuration s'effectue en utilisant Directory Service Control Center (ou les utilitaires de ligne de commande de Directory Server EE) et est accessible par l'intermédiaire de cette interface. Directory Service Control Center stocke les données de configuration dans sa propre instance locale de Directory Server.
Le tableau suivant affiche le type de données affecté par une mise à niveau du logiciel Directory Server vers la version 5.
Stratégie de mise à niveau de Directory Server
De manière générale, la stratégie à utiliser pour effectuer la mise à niveau de Directory Server dépend de nombreuses considérations, décrites dans le Chapter 1, "Planification des mises à niveau" : méthode de mise à niveau, dépendances entre les composants Java ES, mise à niveau sélective ou globale, déploiements portant sur plusieurs instances et ainsi de suite.
Cette section aborde spécifiquement les questions susceptibles d'influencer la planification de mise à niveau de Directory Server.
Problèmes de compatibilité
Directory Server pour Java ES version 5 n'inclut pas de nouvelles interfaces publiques et est donc compatible avec les versions antérieures ; il prend en charge tous les composants pris en charge par Directory Server pour la version 4 et les versions antérieures.
En revanche, la version 5 apporte des modifications aux interfaces administratives privées. Les interfaces de la version 5 ne sont pas compatibles avec les versions antérieures de Directory Server. En particulier, Administration Server, utilisé pour configurer les instances antérieures de Directory Server, a été remplacé par Directory Service Control Center et les utilitaires de ligne de commande de Directory Server ; de plus, le suffixe d'annuaire o=NetscapeRoot pour le stockage des informations de configuration de Directory Server a été éliminé. Pour plus d'informations, reportez-vous au Guide de migration de Directory Server Enterprise Edition 6 (http://docs.sun.com/doc/819-0994).
Dépendances
De manière générale, les dépendances par rapport à d'autres composants Java ES peuvent avoir un impact sur la procédure de mise à niveau du logiciel Directory Server.
Directory Server présente des dépendances par rapport aux composants Java ES suivants :
- Composants partagés.Directory Server présente des dépendances par rapport à des composants partagés Java ES particuliers (voir le Tableau 1-9). Les mises à niveau de Directory Server peuvent dépendre des versions mises à niveau de ces composants.
- Directory Proxy Server ;. Directory Server présente une co-dépendance par rapport à Directory Proxy Server ; pour renforcer la sécurité et améliorer les performances des requêtes LDAP.
Double mise à niveau
La double mise à niveau, qui permet à la fois la mise à niveau de Directory Server et du système d'exploitation (comme le décrit la section Mises à niveau doubles : Java ES et système d'exploitation) peut être effectuée des deux façons suivantes :
Installation d'un nouveau système d'exploitation
- Sauvegardez les données de Directory Server.
Pour plus d'informations concernant Directory Server 5.x, reportez-vous à la section Création d'une image de Directory Server (facultatif).
- Installez le nouveau système d'exploitation.
Le système d'exploitation peut être installé sur un nouveau système (ou une zone Solaris 10) ou écraser un système de fichier existant.
- Restaurez les données Directory Server que vous avez sauvegardées dans l'Step 1.
- Installez Directory Server pour la version 5.
- Créez une instance de Directory Server pour la version 5 et migrez les données d'annuaire vers la nouvelle instance.
Reportez-vous aux étapes correspondantes concernant la procédure de Mise à niveau de la version 4 de Directory Server.
Mise à niveau d'un système d'exploitation existant
- Sauvegardez les données de Directory Server.
Pour plus d'informations concernant Directory Server 5.x, reportez-vous à la section Création d'une image de Directory Server (facultatif).
- Mettez à niveau le système d'exploitation.
La mise à niveau ne modifie pas le système de fichier existant.
- Procédez à la mise à niveau de Directory Server vers la version 5.
Reportez-vous à la section correspondante du présent chapitre, en fonction de la méthode de mise à niveau.
Mise à niveau de Directory Server à partir de Java ES version 4Cette section fournit des informations sur la mise à niveau de Directory Server à partir de Java ES 2005Q4 (version 4) vers Java ES 5 (version 5). La section aborde les thèmes suivants :
Introduction
Lors de la mise à niveau de Directory Server pour Java ES version 4 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :
- Approche générale de mise à niveau. Pour effectuer la mise à niveau, vous devez effectuer une installation complète de Directory Server pour la version 5, puis utiliser les outils de migration pour recréer les anciennes instances de Directory Server dans de nouvelles instances de Directory Server pour la version 5.
- Dépendances pour la mise à niveau. Bien que Directory Server présente des dépendances par rapport à plusieurs composants partagés Java ES (voir le Tableau 1-9), ils sont tous automatiquement mis à niveau vers la version 5 par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau de Directory Server.
- Compatibilité ascendante. Directory Server pour la version 5 n'est pas compatible avec la version 4, comme cela est indiqué dans la section Problèmes de compatibilité. Néanmoins, les outils de migration permettent de faire migrer le suffixe o=NescapeRoot si vous conservez un jeu d'instances de Directory Server reposant sur la structure d'administration de Directory Server 5.x.
- Annulation de la mise à niveau. L'annulation de la mise à niveau vers la version 5 s'effectue en revenant à la version précédente, qui n'est pas modifiée par la mise à niveau vers la version 5.
- Problèmes relatifs à la plate-forme. L'approche générale de mise à niveau de Directory Server est identique pour les systèmes d'exploitation Solaris et Linux.
Mise à niveau de Directory Server pour la version 4
Cette section explique comment effectuer la mise à niveau de Directory Server à partir de Java ES version 4 vers Java ES version 5 sur les plates-formes Solaris et Linux. Lorsqu'une rubrique traite de procédures spécifiques à une plate-forme, le système d'exploitation auquel elle fait référence est indiqué. La section aborde les thèmes suivants :
Tâches à exécuter avant la mise à niveau
Avant de mettre à niveau Directory Server, vous devez effectuer les tâches décrites ci-dessous :
Vérification des informations sur la version actuelle
Pour vérifier la version actuelle de Directory Server, redémarrez le démon Directory Server en utilisant l'option -v :
cd serverRoot/bin/slapd/server
./ns-slapd -v
Si la commande ns-slapd échoue sur la plate-forme Solaris 10, définissez le chemin de la bibliothèque sur null lorsque vous exécutez la commande :
LD_LIBRARY_PATH= ./ns-slapd -v
Mise à niveau des dépendances de Directory Server
Il est généralement conseillé de mettre à niveau tous les composants Java ES d'un ordinateur (et de son environnement informatique) vers Java ES version 5. Toutefois, tous les composants partagés requis par Directory Server sont mis à niveau automatiquement lorsque vous effectuez la mise à niveau de Directory Server vers la version 5.
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 de Directory Server. Les autres informations de configuration sont conservées pendant le processus de mise à niveau.
Création d'une image de Directory Server (facultatif)
Dans le cas où Directory Server pour la version 5 est installé sur un ordinateur autre que celui sur lequel se trouve Directory Server pour la version 4, vous devez créer une image de Directory Server pour la version 4 sur l'ordinateur sur lequel Directory Server pour la version 5 est installée. Cette image est nécessaire pour permettre l'automatisation de la migration des données (en utilisant la commande dsmig) vers les instances de Directory Server pour la version 5.
L'image de l'installation pour la version 4 contient tous les fichiers de schéma, de configuration, de sécurité et de base de données, présentés exactement comme dans la structure de fichiers serverRoot d'origine de Directory Server 5.x. Cette image est nécessaire pour effectuer la migration des données vers les instances de Directory Server pour la version 5.
Mise à niveau de la version 4 de Directory Server
Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Directory Server, suivies de la description de la procédure elle-même.
Considérations relatives à la mise à niveau
La mise à niveau de Directory Server vers Java ES version 5 tient compte des considérations suivantes :
- Tout composant Java ES utilisant une instance de Directory Server (comme Access Manager ou Portal Server, ou les composants Sun Java Communications Suite) doit être arrêté et reconfiguré (si nécessaire) pour accéder à la nouvelle instance de Directory Server pour la version 5.
- Dans une architecture de déploiement contenant plusieurs instances de Directory Server exécutées sur un même ordinateur (toutes correspondant à la même image Directory Server installée), vous n'avez besoin de mettre à niveau l'image Directory Server qu'une seule fois ; toutefois, vous devez migrer les données séparément pour chacune des instances.
- Dans la plupart des architectures de déploiement de Directory Server pour la version 4, l'annuaire de configuration est une instance distincte de Directory Server. Il est inutile d'effectuer la mise à niveau de ces instances car l'utilisation de l'annuaire de configuration a été abandonnée dans la version 5. D'un autre côté, la mise à niveau peut entraîner le déploiement de la console d'administration de Directory Server pour la version 5 (Directory Service Control Center) sur un ordinateur différent de celui depuis lequel vous gérez à distance les instances de Directory Server.
- Un outil de ligne de commande est fourni avec Directory Server pour automatiser la migration des données de schéma, de configuration, de sécurité et d'utilisateur. Cet outil de migration permet d'effectuer la migration étape par étape de ces données. Dans la plupart des scénarios de mise à niveau, au moins une partie des données peut être migrée automatiquement.
Procédure de mise à niveau
La procédure présentée ci-dessous s'applique à toutes les instances de Directory Server installées sur l'ordinateur sur lequel la mise à niveau est effectuée, ou, dans le cas où des instances sont déplacées vers un autre ordinateur, toutes les instances qui seront exécutées sur l'ordinateur cible.
- Connectez-vous en tant qu'utilisateur root ou superutilisateur.
su -
- Arrêtez les instances de Directory Server pour la version 4 (5.2).
serverRoot/slapd-nomInstance/stop-slapd
Vérifiez dans le journal des erreurs (serverRoot/slapd-nomHôte/logs/errors) que l'arrêt s'est passé correctement :
[23/Jan/2006:15:56:47 +0100] - All database threads now stopped
[23/Jan/2006:15:56:50 +0100] - slapd stopped.
- Vérifiez qu'il y a suffisamment d'espace libre sur l'ordinateur qui héberge Directory Server pour la version 5.
Utilisez la formule suivante pour le calcul de l'espace libre nécessaire :
2 * (espace pour le serveur existant) + (espace pour les fichiers LDIF)Il n'existe malheureusement aucun outil permettant de prévoir la taille d'un fichier LDIF créé en exportant une base de données. La taille dépend du nombre d'entrées, de leur représentation interne, du nombre d'index, etc.
- Pour installer la version 5 à distance, créez une image de la version 4 et transférez-la sur l'ordinateur distant.
Voir la section Création d'une image de Directory Server (facultatif).
- Veillez à bien avoir mis à niveau tous les composants Java ES par rapport auxquels Directory Server présente des dépendances strictes pour la mise à niveau (voir la section Mise à niveau des dépendances de Directory Server).
- Effectuez une installation complète de Directory Server pour la version 5.
Procédez comme suit :
- Lancez le programme d’installation de Java ES.
où arch_se correspond à votre plate-forme, telle que Solaris_sparc. (Utilisez l’option installer -nodisplay pour l’interface de ligne de commande.)
Une fois que les pages de bienvenue et du contrat de licence se sont affichées, vous accédez à la page de sélection de composant. (Lorsque des composants installés pouvant être directement mis à niveau par le programme d’installation de Java ES sont détectés, ils sont présentés avec l’état “pouvant être mis à niveau”.)
- Sélectionnez le sous-composant Directory Server de Directory Server Enterprise Edition.
Vous devrez aussi installer les sous-composants d'administration (Directory Service Control Panel ou les utilitaires de ligne de commande) que vous souhaitez utiliser.
- Spécifiez un répertoire d'installation différent de celui dans lequel Directory Server pour la version 4 est installé.
- Sélectionnez Configurer maintenant ou Configurer ultérieurement.
L'option choisie n'a pas d'importance car il n'y a quasiment aucune configuration requise pour Directory Server. Toutefois, si vous choisissez l'option Configurer maintenant, ne sélectionnez pas l'option de création d'une nouvelle instance.
- Confirmez vos préférences d’installation.
Les packages de Directory Server sont mis à niveau et un récapitulatif de la mise à niveau s'affiche.
- Quittez le programme d'installation de Java ES.
- Créez une instance de Directory Server.
DirServer-base/ds6/bin/dsadm create cheminInstance
où cheminInstance est le chemin d'accès complet de l'instance de Directory Server.
Pour plus d'informations sur la création d'une instance de Directory Server, reportez-vous au Guide d’administration de Directory Server Enterprise Edition 6 (http://docs.sun.com/doc/819-0995).
Si vous ne parvenez pas à créer une instance, une nouvelle instance sera créée automatiquement lorsque vous migrerez les données à l'aide de la commande dsmig (Step 8).
Si la commande dsadm échoue sur la plate-forme Solaris 10, définissez le chemin de la bibliothèque sur null lorsque vous exécutez la commande :
LD_LIBRARY_PATH= ./dsadm create cheminInstance
- Migrez les données de la version 4 vers l'instance de Directory Server pour la version 5.
Utilisez les commandes DirServer-base/ds6/bin/dsmig.
Les commandes dsmig adaptent les données de la version 4 au format de la version 5 et les inscrivent dans les emplacements appropriés. Exemple de migration standard sur un seul ordinateur avec une instance de Directory Server :
Remarques
- Si l'instance de Directory Server que vous migrez stocke des données de configuration pour d'autres composants Java ES, par exemple pour le composant Messaging Server de Sun Java Communications Suite, il peut être nécessaire de migrer une partie spécifique de l'arborescence d'informations d'annuaire, nommée o=netscaperoot. Ce suffixe racine n'est pas migré par défaut. Pour migrer o=netscaperoot, utilisez l'option -N des commandes dsmig migrate-config et dsmig migrate-data . Par exemple :
- Si vous effectuez la migration d'une instance sur architecture 32 bits vers une instance sur architecture 64 bits, vous ne pouvez pas utiliser la commande dsmig migrate-data (outil de migration automatique). Vous devez migrer les données manuellement, comme cela est décrit dans le Guide de migration référencé plus bas. Toutefois, vous pouvez migrer automatiquement les données de schéma, de configuration et de sécurité.
- Dans certains cas, lorsque vous démarrez Directory Server après avoir migré les données d'annuaire, la nouvelle fonction de vérification des erreurs de la version 5 détecte des définitions circulaires dans les entrées de groupe de Directory Server. Ces définitions circulaires sont bénignes d'un point de vue des fonctionnalités, mais peuvent provoquer la consignation d'un grand nombre d'erreurs.
Pour plus d'informations sur le processus de migration, les commandes dsmig et la migration manuelle, reportez-vous au Guide de migration de Directory Server Enterprise Edition 6 (http://docs.sun.com/doc/819-0994).
Vérification de la mise à niveau
Vous pouvez vérifier que la mise à niveau de Directory Server a été correctement effectuée en procédant comme suit.
- Démarrez la nouvelle instance de Directory Server :
DirServer-base/ds6/bin/dsadm -V
Voir le Tableau 5-4 pour les valeurs de résultat.
- Vérifiez les messages de démarrage dans le journal des erreurs de Directory Server :
cheminInstance/logs/errors
Remarque
Au démarrage, Directory Server pour la version 5 détecte les définitions circulaires. Ces définitions circulaires sont bénignes d'un point de vue des fonctionnalités, mais peuvent provoquer la consignation d'un grand nombre d'erreurs lorsque vous effectuez la mise à niveau à partir d'une version précédente contenant des définitions circulaires.
Tâches à exécuter après la mise à niveau
Il n'y a aucune tâche à exécuter après les étapes de mise à niveau décrites dans la section Procédure de mise à niveau, à part que tous les composants Java ES présentant des dépendances par rapport à Directory Server doivent être reconfigurés pour pointer sur les nouvelles instances de Directory Server.
Annulation de la mise à niveau
L'annulation de la mise à niveau vers la version 5 est obtenue par le retour à la version précédente, qui n'a pas été modifiée par la mise à niveau.
Mise à niveau de plusieurs instances
Les procédures décrites dans la section Mise à niveau de Directory Server pour la version 4 ne traitent pas de manière explicite des architectures dans lesquelles Directory Server est répliqué pour l'évolutivité ou une haute disponibilité. Ces architectures peuvent inclure une réplication de Directory Server ou le déploiement de Directory Server en tant que service de données dans un environnement Sun Cluster.
Mise à niveau progressive des réplications de Directory Server
Lorsque des instances de Directory Server sont placées sur différents systèmes, comme dans les architectures de déploiement de réplication multimaître, elles peuvent être mises à niveau une par une. Après avoir synchronisé tous les maîtres Directory Server, la mise à niveau de chaque instance sur l'ordinateur qui l'héberge se fait pendant que les autres instances continuent de s'exécuter. La mise à niveau progressive permet au service d'annuaire de rester en ligne pendant que des instances Directory Server qui fournissent le service sont mises à niveau.
Mise à niveau de Directory Server en tant que service de données
Les instructions relatives à la mise à niveau et à l'annulation de Directory Server en tant que service de données dans un environnement Sun Cluster sont en cours de développement.
Mise à niveau de Directory Server à partir de Java ES version 3La procédure de mise à niveau de Directory Server pour Java ES 2003Q1 (version 3) vers la version 5 est la même que pour la mise à niveau de Directory Server pour la version 4 vers la version 5.
Pour mettre à niveau Directory Server pour la version 3 vers la version 5, suivez les instructions décrites dans la section Mise à niveau de Directory Server à partir de Java ES version 4, en remplaçant chaque occurrence de version 4 par version 3.
Mise à niveau de Directory Server à partir de Java ES version 2La procédure de mise à niveau de Directory Server pour Java ES 2004Q2 (version 2) vers la version 5 est identique à celle de la mise à niveau de Directory Server pour la version 4 vers la version 5, à l'exception près que les tâches à exécuter avant la mise à niveau doivent inclure la mise à niveau vers la version 5 de tous les composants partagés (voir le Tableau 1-9).
Les instructions de mise à niveau des composants partagés Java ES vers la version 5 sont présentées dans le Chapter 2, "Mise à niveau des composants partagés Java ES".
Pour mettre à niveau Directory Server pour la version 2 vers la version 5, suivez les instructions décrites dans la section Mise à niveau de Directory Server à partir de Java ES version 4 en remplaçant chaque occurrence de version 4 par version 2.
Remarque
Si vous procédez à une mise à niveau de Directory Server pour la version 2 sur la plate-forme Linux, il vous faudra procéder à une double mise à niveau (pour Directory Server et le système d'exploitation). Directory Server pour la version 5 n'est pas pris en charge sur RHEL 2.1. Pour plus d’informations, reportez-vous à la section Double mise à niveau.