| |
| Sun Java Enterprise System 2005Q4 Guide de mise à niveau | |
Chapitre 19
Delegated AdministratorCe chapitre décrit la procédure de mise à niveau de Delegated Administrator vers Java ES 2005Q4 (version 4) : Sun Java System Communication Services Delegated Administrator 6.3 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 Delegated AdministratorCette section présente les aspects généraux de Delegated Administrator qui ont un impact sur la mise à niveau vers Java ES 2005Q4 (version 4) :
À propos de Delegated Administrator pour Java ES version 4
Les nouvelles fonctions de Delegated Administrator pour Java ES version 4 par rapport à la version 3 sont les suivantes : provisioning de service de calendrier, provisioning des groupes de messagerie, navigation améliorée sur l’interface basée sur le retour d’utilisation et diverses corrections de bogues.
Présentation de la mise à niveau de Delegated Administrator
Le Tableau 19-1 répertorie les méthodes de mise à niveau de Delegated Administrator vers Java ES version 4 prises en charge. Il s’applique à la fois à Solaris et Linux.
Données de Delegated Administrator
Le tableau suivant affiche le type de données susceptible d’être affecté par la mise à niveau du logiciel Delegated Administrator.
Problèmes de compatibilité
Delegated Administrator pour la version 4 introduit des modifications d’interface, mais est compatible avec les versions antérieures.
Dépendances de Delegated Administrator
Les dépendances de Delegated Administrator par rapport aux autres composants Java ES peuvent avoir une influence sur la procédure de mise à niveau et de reconfiguration du logiciel Delegated Administrator. Les modifications apportées aux interfaces ou fonctions de Delegated Administrator, par exemple, peuvent demander une version mise à niveau des composants dont dépend Delegated Administrator. Le besoin de mettre à jour ces composants dépend de la méthode de mise à niveau spécifique.
Delegated Administrator présente des dépendances par rapport aux composants Java ES suivants :
- Composants partagés. Delegated Administrator présente des dépendances par rapport à certains composants partagés Java ES (voir le Tableau 1-6).
- Conteneur Web. Delegated Administrator dépend des services de conteneur Web qui peuvent être fournis par Java ES Web Server ou par Java ES Application Server.
- Directory Server. Delegated Administrator stocke les données d’application et les données d’utilisateur dans Directory Server.
- Directory Preparation Tool. Delegated Administrator utilise Directory Preparation Tool pour préparer le répertoire à prendre en charge les fonctions de provisioning utilisateur de Delegated Administrator. Ainsi, les mises à niveau de Delegated Administrator peuvent dépendre de la préparation du répertoire pour la prise en charge de nouvelles fonctions.
- Access Manager (Access Manager SDK). Delegated Administrator est dépendant d’Access Manager pour l’enregistrement des services et la création d’entrées dans Directory Server.
Mise à niveau de Delegated Administrator à partir de Java ES version 3Cette section présente des informations sur la mise à niveau de Delegated Administrator à partir de Java ES 2005Q1 (version 3) vers Java ES version 4. Elle aborde les sujets suivants :
Introduction
Lors de la mise à niveau de Delegated Administrator 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 Delegated Administrator est effectuée à l’aide de l’utilitaire de configuration config-commda.
- Dépendances de mise à niveau. Bien que Delegated Administrator présente des dépendances par rapport à plusieurs composants partagés Java ES (voir le Tableau 1-6), la version 4 de Delegated Administrator 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 Delegated Administrator vers la version 4.
En outre, Delegated Administrator pour la version 4 dépend d’un conteneur Web et d’Access Manager, comme cela est décrit dans la section Dépendances de Delegated Administrator. Il s’agit de dépendances souples pour la mise à niveau. La mise à niveau de ces composants est facultative dans le cadre de la mise à niveau de Delegated Administrator vers la version 4. (Cependant, si Access Manager est mis à niveau, Delegated Administrator doit l’être également.)
Toutefois, Delegated Administrator pour la version 4 présente une dépendance stricte de mise à niveau par rapport à Directory Preparation Tool. Directory Preparation Tool pour la version 4 est requis pour la préparation de Directory Server à des opérations de provisioning utilisateur.
- Compatibilité ascendante. Delegated Administrator pour la version 4 présente une compatibilité ascendante avec la version 3.
- Annulation de la mise à niveau. L’annulation de la mise à niveau de Delegated Administrator pour la version 4 n’est pas possible.
- Problèmes relatifs à la plate-forme. L’approche générale de la mise à niveau de Delegated Administrator 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 Delegated Administrator pour la version 3
Cette section explique comment effectuer la mise à niveau de Delegated Administrator à 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 Delegated Administrator, 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 Delegated Administrator à l’aide de la commande suivante :
Appliquer les patchs nécessaires correspondant au système d’exploitation
Sur les plates-formes du système d’exploitation Solaris 10, vous devez appliquer un patch spécifique au système d’exploitation pour effectuer la procédure de mise à niveau de Delegated Administrator (voir la section Patchs du système d’exploitation nécessaires).
Mettre à niveau les composants présentant des dépendances par rapport à Delegated Administrator
Il est généralement recommandé de mettre à niveau tous les composants Java ES sur un même ordinateur (et dans son environnement) vers Java ES version 4. En revanche, Delegated Administrator ne présente de dépendance stricte de mise à niveau que par rapport à Directory Preparation Tool. La mise à niveau des autres composants Java ES version 3 dont dépend Delegated Administrator est donc facultative.
En revanche, si vous choisissez de mettre à niveau tous les composants présentant des dépendances par rapport à Delegated Administrator, vous devez le faire dans l’ordre suivant, et ce, avant de mettre à niveau Delegated Administrator. Vous pouvez ignorer tout composant déjà mis à niveau.
- 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.
- 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 ».
- Logiciels de conteneur Web. Les instructions de mise à niveau de Web Server ou d’Application Server sont présentées respectivement dans le Chapitre 6, « Web Server » et le Chapitre 9, « Application Server ».
- 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 ».
- Directory Preparation Tool. Directory Preparation Tool pour la version 4 doit avoir été exécuté sur Directory Server avant toute utilisation de Delegated Administrator pour la version 4. Si Directory Preparation Tool n’a pas encore été exécuté sur Directory Server, mettez-le à niveau vers la version 4 et utilisez-le pour modifier et étendre le schéma de Directory Server (voir les procédures indiquées dans le Chapitre 12, « Directory Preparation Tool »).
Sauvegarder les données de Delegated Administrator
La mise à niveau de Delegated Administrator à partir de la version 3 vers la version 4 ne requiert aucune reconfiguration de Delegated Administrator. Par mesure de sécurité, il est conseillé de sauvegarder les données de configuration, ainsi que la personnalisation de l’interface utilisateur de la version 3.
Obtenir les mots de passe et informations de configuration requis
Vous devez connaître les informations suivantes concernant la version actuellement installée :
- l’ID et le mot de passe de l’administrateur d’Access Manager ;
- le mot de passe LDAP interne d’Access Manager ;
- l’ID et le mot de passe supérieurs de l’administrateur ;
- l’ID et le mot de passe utilisateur de l’administrateur d’Application Server, si vous utilisez Application Server comme conteneur Web.
Mise à niveau de Delegated Administrator pour la version 3 (Solaris)
Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Delegated Administrator, suivies de la description de la procédure elle-même.
Considérations relatives à la mise à niveau (Solaris)
La mise à niveau de Delegated Administrator vers Java ES version 4 tient compte des considérations suivantes :
- Delegated Administrator ne doit pas être utilisé lors de l’application des patchs à l’image installée.
- Lors de la reconfiguration de Delegated Administrator, ce dernier doit être déployé sur le même conteneur Web qu’Access Manager.
- Le patch de mise à niveau de Delegated Administrator pour la version 4 sous Solaris est indiqué dans le tableau suivant :
Tableau 19-4 Patchs1 de mise à niveau de Delegated Administrator sous Solaris
Description
SPARC
Solaris 8, 9 et 10
X86
Solaris 9 et 10
Delegated Administrator
119777-09
119778-09
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 au logiciel Delegated Administrator installé sur l’ordinateur sur lequel est effectuée la mise à niveau.
- Notez les numéros des patchs requis indiqués dans le Tableau 19-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 -
- 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).
Voir Mettre à niveau les composants présentant des dépendances par rapport à Delegated Administrator.
- Appliquez les patchs appropriés de Delegated Administrator, répertoriés dans le Tableau 19-4.
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 4.
- Reconfigurez Delegated Administrator.
- Assurez-vous que Directory Server est en cours d’exécution.
- Vérifiez que le conteneur Web exécutant Access Manager et Delegated Administrator est actif.
Pour démarrer le conteneur Web :
Web Server:
WebServer-base/https-nomInstance/startApplication Server:
AppServer8-base/bin/asadmin start-domain nomDomaine
--user ID_admin --password mot_de_passeoù Access Manager et Delegated Administrator sont déployés sur une instance de serveur sur le domaine nomDomaine. nomDomaine par défaut est domain1 et l’instance de serveur par défaut est server1.
- Exécutez l’utilitaire de configuration de Delegated Administrator.
DelegatedAdmin-base/sbin/config-commda
Pour plus d’informations sur le fonctionnement de cet utilitaire, reportez-vous au chapitre 3 « Configuring Delegated Administrator » du manuel Sun Java System Communications Services 6 2005Q4 Delegated Administration Guide (http://docs.sun.com/doc/819-2658).
- Arrêtez et redémarrez le conteneur Web de Delegated Administrator.
Web Server:
WebServer-base/https-nomInstance/stop
WebServer-base/https-nomInstance/startApplication Server:
AppServer8-base/bin/asadmin stop-domain nomDomaine
AppServer8-base/bin/asadmin start-domain nomDomaine
--user ID_admin --password mot_de_passeMise à niveau de Delegated Administrator pour la version 3 (Linux)
Cette section traite des considérations ayant une incidence sur la procédure de mise à niveau de Delegated Administrator, 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 Delegated Administrator vers Java ES version 4 sous Linux et Solaris (voir Considérations relatives à la mise à niveau (Solaris)), sauf que les patchs de mise à niveau pour la version 4 sous Linux sont différents de ceux destinés à Solaris.
Le patch de mise à niveau de Delegated Administrator pour la version 4 sous Linux est indiqué dans le tableau suivant :
Tableau 19-5 Patchs1 de mise à niveau de Delegated Administrator sous Linux
Description
ID de patch et nom de RPM
Delegated Administrator
119779-09
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 Delegated Administrator 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.
- Procurez-vous les patchs requis à l’aide de leurs numéros et des noms de RPM indiqués dans le Tableau 19-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 -
- 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).
Voir Mettre à niveau les composants présentant des dépendances par rapport à Delegated Administrator.
- Appliquez les RPM indiqués dans le Tableau 19-5 à Delegated Administrator.
rpm -Fvh sun-commcli-client-1.1-11.9.i386.rpm
rpm -Fvh sun-commcli-server-1.1-11.9.i386.rpm- Confirmez la réalisation de la mise à niveau du patch :
rpm -qa | grep sun-commcli
Le système doit vous renvoyer les numéros de la nouvelle version des RPM.
- Reconfigurez Delegated Administrator.
- Vérifiez que le conteneur Web exécutant Access Manager et Delegated Administrator est actif.
Pour démarrer le conteneur Web :
Web Server:
WebServer-base/https-nomInstance/startApplication Server:
AppServer8-base/bin/asadmin start-domain nomDomaine
--user ID_admin --password mot_de_passeoù Access Manager et Delegated Administrator sont déployés sur une instance de serveur sur le domaine nomDomaine. nomDomaine par défaut est domain1 et l’instance de serveur par défaut est server1.
- Exécutez l’utilitaire de configuration de Delegated Administrator.
DelegatedAdmin-base/sbin/config-commda
Pour plus d’informations sur le fonctionnement de cet utilitaire, reportez-vous au chapitre 3 « Configuring Delegated Administrator » du manuel Sun Java System Communications Services 6 2005Q4 Delegated Administration Guide (http://docs.sun.com/doc/819-2658).
- Arrêtez et redémarrez le conteneur Web de Delegated Administrator.
Web Server:
WebServer-base/https-nomInstance/stop
WebServer-base/https-nomInstance/startApplication Server:
AppServer8-base/bin/asadmin stop-domain nomDomaine
AppServer8-base/bin/asadmin start-domain nomDomaine
--user ID_admin --password mot_de_passeVérification de la mise à niveau
Vous pouvez vérifier que la mise à niveau de Delegated Administrator a été correctement effectuée en procédant comme suit :
- Vérifiez le numéro de version.
DelegatedAdmin-base/bin/commadmin -V
Voir le Tableau 19-3 des valeurs de résultat.
- Connectez-vous à la console Delegated Administrator à l’aide de l’ID et du mot de passe administrateur de niveau supérieur indiqué au cours de la reconfiguration de Delegated Administrator.
http://nom_hôte:port/da/DA/Login
où nom_hôte:port sont les valeurs fournies au cours de la reconfiguration de Delegated Administrator.
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)
Il n’est pas possible d’annuler la mise à niveau de Delegated Administrator. Les modifications apportées au cours de la mise à niveau, telles que des entrées dans Directory Server ou dans le déploiement de Delegated Administrator dans le conteneur Web ne peuvent pas être facilement annulées.
Mise à niveau de Delegated Administrator à partir de Java ES version 2La procédure de mise à niveau de Delegated Administrator pour Java ES 2004Q2 (version 2) vers la version 4 est identique à celle de mise à niveau de Delegated Administrator pour la version 3 vers la version 4, avec quelques exceptions détaillées ci-dessous.
Mise à niveau des composants présentant des dépendances par rapport à Delegated Administrator
Les tâches à exécuter avant la mise à niveau de Delegated Administrator pour Java ES version 2 vers la version 4 sont semblables à celles de la mise à niveau de Delegated Administrator pour la version 3 vers la version 4, sauf que la mise à niveau des composants dépendant de Delegated Administrator doit inclure tous les composants partagés (voir le Tableau 1-6) et tous les composants locaux dont dépend Delegated Administrator.
La mise à niveau des composants dépendant de Delegated Administrator doit être effectuée dans l’ordre suivant, avant la mise à niveau de Delegated Administrator. Vous pouvez ignorer tout composant déjà mis à niveau.
- 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 Chapitre 2, « Mise à niveau des composants partagés Java ES ».
- 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 ».
- Logiciels de conteneur Web. Les instructions de mise à niveau de Web Server ou d’Application Server sont présentées respectivement dans les sections Mise à niveau de Web Server à partir de Java ESversion 2 et Mise à niveau d’Application Server à partir de Java ES version 2.
- Access Manager (SDK Access Manager). Les instructions de mise à niveau d’Access Manager vers la version 4 sont présentées dans le Mise à niveau d’Access Manager à partir de Java ES version 2.
- Directory Preparation Tool. Directory Preparation Tool se trouve rarement sur le même ordinateur que Delegated Administrator. Vous trouverez toutefois des instructions pour la mise à niveau de Directory Preparation Tool et son exécution sur Directory Server dans la section Mise à niveau de Directory Preparation Tool à partir de Java ES version 2.
Mise à niveau de Delegated Administrator pour la version 2
La procédure de mise à niveau de Delegated Administrator à partir de la version 2 vers la version 4 dépend du conteneur Web dans lequel vous déployez le logiciel Delegated Administrator.
Mise à niveau de Delegated Administrator pour la version 2 : conteneur Web Web Server
Pour mettre à niveau Delegated Administrator pour la version 2 vers la version 4, lors du déploiement dans un conteneur Web Server mis à niveau vers la version 4, suivez les instructions décrites dans la section Mise à niveau de Delegated Administrator pour la version 3 (Solaris) ou Mise à niveau de Delegated Administrator pour la version 3 (Linux), en remplaçant chaque occurrence de version 3 par version 2.
Mise à niveau de Delegated Administrator pour la version 2 : conteneur Web Application Server
Pour mettre à niveau Delegated Administrator pour la version 2 vers la version 4, lors du déploiement dans un conteneur Web Application Server mis à niveau vers la version 4, suivez les instructions décrites dans la section Mise à niveau de Delegated Administrator pour la version 3 (Solaris) ou Mise à niveau de Delegated Administrator pour la version 3 (Linux), en remplaçant chaque occurrence de version 3 par version 2.
L’instance d’Application Server pour la version 2 dans laquelle Delegated Administrator a été initialement déployé (nomInstance), lors de sa mise à niveau vers la version 4, a été migrée sous un agent du nud créé par le processus de mise à niveau.
Dans ce cas, pour la mise à niveau de Delegated Administrator, vous devez modifier l’étape 6 Reconfigurez Delegated Administrator. (Solaris) ou (more...) (Linux) comme suit :
- Reconfigurez Delegated Administrator.
- Modifiez le fichier AccessManagerConfig-base/config/AMConfig.properties.
Remplacez la ligne suivante :
com.sun.identity.webcontainer=IAS7.0
par
com.sun.identity.webcontainer=IAS8.1
- Vérifiez que l’instance d’Application Server mise à niveau sur laquelle Delegated Administrator est déployé (nomInstance) est en cours d’exécution.
Pour démarrer l’instance d’Application Server, démarrez le serveur d’administration du domaine et l’agent de nud sous lequel l’instance a été migrée :
AppServer8-base/bin/asadmin start-domain --user ID_admin
--password mot_de_passe nomDomaineAppServer8-base/bin/asadmin start-node-agent --user ID_Admin
--password mot_de_passe NomAgentNudDans les commandes ci-dessus et dans les étapes suivantes les conventions suivantes sont utilisées :
- Annulez le déploiement de l’application Web Delegated Administrator commcli de l’instance d’Application Server (nomInstance).
AppServer8-base/bin/asadmin undeploy --secure=false --user admin --password mot_de_passe --target nomInstance commcli
- Exécutez l’utilitaire de configuration de Delegated Administrator.
DelegatedAdmin-base/sbin/config-commda
Pour plus d’informations sur le fonctionnement de cet utilitaire, reportez-vous au chapitre 3 « Configuring Delegated Administrator » du manuel Sun Java System Communications Services 6 2005Q4 Delegated Administration Guide (http://docs.sun.com/doc/819-2658).
Indiquez les paramètres suivants :
- Lorsque le système vous demande l’hôte et le port d’Access Manager, indiquez le port de l’instance du serveur d’administration du domaine (par défaut=8080).
- Lorsque le système vous demande l’emplacement de déploiement de la console Delegated Administrator et du serveur Delegated Administrator, indiquez également les informations de l’instance du serveur d’administration du domaine (port par défaut=8080), et non les informations de l’instance d’Application Server mise à niveau (nomInstance).
Ces valeurs entraînent le redéploiement de Delegated Administrator sur l’instance du serveur d’administration du domaine. Ce n’est pas standard mais cela fonctionne.
- Copiez les informations classpath d’Access Manager pour classpath-prefix et classpath-suffix à partir du fichier domain.xml de l’instance nomInstance :
AppServer8Config-base/nodeagents/nomAgentNud/nomInstance/
config/domain.xmldans le fichier domain.xml du serveur d’administration du domaine (nom par défaut=server):
AppServer8Config-base/domains/nomDomaine/config/domain.xml
où la valeur par défaut de nomDomaine est domain1.
Vous pouvez également effectuer cette étape à partir de la console d’administration d’Application Server.
- Redémarrez le serveur d’administration de domaine :
le serveur d’administration du domaine est l’instance du serveur sur laquelle Delegated Administrator a été redéployé.
AppServer8-base/bin/asadmin stop-domain --user ID_admin
--password mot_de_passe nomDomaineAppServer8-base/bin/asadmin start-domain --user ID_admin
--password mot_de_passe nomDomaine