Notes de version de Sun Java™ System Identity Manager 7.1 Update 1

Remarques sur l’installation et la mise à jour

Cette section contient des informations relatives à l’installation ou à la mise à jour, organisées comme suit :

La plupart des nouvelles versions principales d’Identity Manager entraînent un changement de schéma. Vous devez mettre à jour votre schéma avant d’effectuer une mise à niveau vers une nouvelle version d’Identity Manager. Pour passer à la version 7.1 d’Identity Manager, exécutez l’un des scripts de mise à niveau de schéma suivants, selon la version dont vous disposez au départ : (ID-15392 et ID-15722)


Remarques sur l’installation

Les informations suivantes portent sur le processus d’installation du produit :


Remarques sur la mise à niveau

Cette section récapitule les tâches à effectuer afin de mettre à niveau Identity Manager de la version 6.0 ou la version 7.0 vers la version 7.1. (Reportez-vous à la section Chemins de mise à niveau d’Identity Manager pour plus d’informations sur les versions pouvant être mises à niveau vers Identity Manager 7.1.)

Les informations contenues dans cette section sont présentées de la manière suivante :

Problèmes de mise à niveau

Utilisation du programme de mise à niveau d’Identity Manager

Cette section décrit les étapes à suivre pour mettre à niveau Identity Manager à l’aide du programme d’installation et de mise à niveau d’Identity Manager.


Remarques

  • La plupart des nouvelles versions principales d’Identity Manager entraînent un changement de schéma. Vous devez mettre à jour votre schéma avant d’effectuer une mise à niveau vers une nouvelle version d’Identity Manager. Pour passer à la version 7.1 d’Identity Manager, exécutez l’un des scripts de mise à niveau de schéma suivants, selon la version dont vous disposez au départ : (ID-15722)
    • À partir d’Identity Manager 6.0, exécutez le script upgradeto71from60 approprié.
    • À partir d’Identity Manager 7.0, exécutez le script upgradeto71from70 approprié.

    Pour plus d’informations, reportez-vous au guide Sun Java System Identity Manager Upgrade.

  • Dans certains environnements, y compris HP-UX, vous devez (ou souhaiterez peut-être) suivre les procédures de mise à jour manuelles. Dans ce cas, passez directement à la section Mise à niveau manuelle.
  • Dans les environnements UNIX, assurez-vous qu’un répertoire install existe à l’un des emplacements suivants et que ce répertoire est accessible en écriture :
    • Sous Linux/HP-UX : /var/opt/sun/install
    • Sous Solaris : /var/sadm/install
  • Lors de la mise à jour, vous devrez connaître l’emplacement d’installation du serveur d’application.
  • Les patchs précédemment installés seront archivés dans le répertoire suivant :

    $WSHOME/patches/NomCorrectif

  • Les commandes présentées dans les étapes suivantes sont propres à une installation Windows et à un serveur d’application Tomcat. Les commandes que vous utilisez peuvent être différentes suivant l’environnement dans lequel vous travaillez.

Pour mettre à niveau Identity Manager:

  1. Arrêtez le serveur d’application.
  2. Si vous procédez à une mise à niveau vers Identity Manager 6.0 ou Identity Manager 7.0, mettez à niveau le schéma de base de données du référentiel en procédant comme suit :
    • Identity Manager 6.0 introduit un changement de schéma fournissant de nouveaux tableaux pour les tâches, les groupes, les organisations et le tableau du journal syslog. Vous devez créer ces nouvelles structures de tableaux et déplacer les données existantes.
    • Identity Manager 6.0 stocke les objets utilisateur dans deux tableaux. Vous pouvez vous servir des exemples de scripts situés dans le répertoire db_scripts pour modifier les schémas. Pour mettre à niveau les tableaux du référentiel, reportez-vous au script db_scripts/upgradeto2005Q4M3.NomBaseDeDonnées.

    • Remarques

      • Avant de mettre à jour le schéma du référentiel, effectuez une sauvegarde complète des tableaux de référentiel.
      • La mise à niveau des bases de données MySQL est très intense. Pour plus d’informations à ce sujet, reportez-vous au fichier db_scripts/upgradeto2005Q4M3.mysql.

    • Identity Manager 7.0 introduit de nouveaux tableaux destinés aux habilitations d’utilisateur.
      Vous devez créer ces nouvelles structures de tableaux et déplacer les données existantes. Vous pouvez vous servir des exemples de scripts situés dans le répertoire db_scripts pour modifier les schémas.

    • Remarques

      • Avant de mettre à jour le schéma du référentiel, effectuez une sauvegarde complète des tableaux de référentiel.
      • Pour plus d’informations, reportez-vous au script db_scripts/upgrade7.0.NomDBMS.

  3. Si vous exécutez Sun Identity Manager Gateway sur le serveur Identity Manager, faites appel à la commande suivante pour arrêter le service Gateway :
  4. net stop "Sun Identity Manager Gateway"

  5. Utilisez l’une des méthodes suivantes pour lancer le programme d’installation :
    • Pour utiliser le programme d’installation de l’interface graphique (IG), exécutez install.bat (pour Windows) ou install (pour UNIX).

      Le programme d’installation affiche le panneau de bienvenue.

    • Pour activer le programme d’installation en mode nodisplay, passez au répertoire contenant le logiciel, puis saisissez la commande suivante :

      install -nodisplay

      Le programme d’installation affiche le texte de bienvenue, puis présente une liste de questions afin de rassembler les informations d’installation dans le même ordre que le programme d’installation de l’IG.


      Remarques

      • En l’absence d’affichage, le programme d’installation est défini par défaut sur l’option nodisplay.
      • Il n’installe pas d’ancienne version du logiciel sur une version plus récente. Dans ce cas, un message d’erreur s’affiche et le programme d’installation se ferme.

  6. Sur le panneau Welcome (Bienvenue), cliquez sur Next (Suivant).
  7. Sur le panneau Install or Upgrade? (Installation ou mise à niveau ?), sélectionnez Upgrade (Mise à niveau), puis cliquez sur Next (Suivant).
  8. Sur le panneau Select Installation Directory (Sélection du répertoire d’installation), sélectionnez le répertoire contenant l’ancienne version d’Identity Manager, puis cliquez sur Next (Suivant).
  9. Le programme d’installation affiche des barres de progression pour les processus antérieurs et postérieurs à la mise à niveau, puis passe au panneau Installation Summary (Résumé de l’installation).

  10. Pour des informations détaillées sur l’installation, cliquez sur Details (Détails), affichez le fichier journal, puis cliquez sur Close (Fermer) pour quitter le programme d’installation.
  11. Supprimez tous les fichiers Identity Manager compilés du répertoire de travail du serveur d’application.
  12. Si vous exécutez Gateway sur un système distant, mettez-le à niveau en suivant la procédure ci-dessous.
    1. Connectez-vous au système Windows, puis passez au répertoire d’installation de Gateway.
    2. Arrêtez le service Gateway en exécutant la commande suivante :
    3. gateway -k

    4. Sous Windows 2000 ou version ultérieure, quittez toutes les instances du plug-in Services MMC.
    5. Supprimez le service Gateway à l’aide de la commande suivante :
    6. gateway -r

    7. Sauvegardez et supprimez les fichiers Gateway existants.
    8. Extrayez les nouveaux fichiers Gateway.
    9. Si vous installez la nouvelle version mise à niveau de Gateway sur un système autre que le serveur Identity Manager, copiez le fichier gateway.zip à partir du CD d’installation d’Identity Manager.

    10. Décompressez le fichier gateway.zip dans le répertoire d’installation de Gateway.
    11. Installez le service Gateway en exécutant la commande suivante :
    12. gateway -i

    13. Démarrez le service Gateway en exécutant la commande suivante :
    14. gateway -s

Mise à niveau manuelle

Dans certains environnements, il est conseillé de procéder à une mise à niveau manuelle au lieu de recourir au programme d’installation et de mise à niveau d’Identity Manager.


Remarques

  • Assurez-vous de définir la variable d’environnement JAVA_HOME.
  • Assurez-vous que le répertoire bin situé au sein du répertoire JAVA_HOME se trouve dans le chemin.
  • Les correctifs installés auparavant sont archivés dans le répertoire $WSHOME/patches/NomCorrectif.

Sur une plate-forme Windows

Pour mettre à niveau Identity Manager manuellement sur une plate-forme Windows prise en charge, procédez comme suit :

  1. Arrêtez le serveur d’application et Sun Identity Manager Gateway.
  2. Mettez à jour la base de données d’Identity Manager. Pour des instructions détaillées, voir l’étape 2.
  3. Saisissez les commandes suivantes pour définir l’environnement :
  4. set ISPATH=Chemin d’installation du logiciel
    set WSHOME=Chemin d’accès au répertoire d’installation OU de transfert d’Identity Manager
    set TEMP=Chemin d’accès au répertoire temporaire

  5. Exécutez le prétraitement :
  6. mkdir %TEMP%
    cd /d %TEMP%
    jar -xvf %ISPATH%\IDM.WAR \
    WEB-INF\lib\idm.jar WEB-INF\lib\idmcommon.jar
    set TMPLIBPTH=%TEMP%\WEB-INF\lib
    set CLASSPATH=%TMPLIBPTH%\idm.jar;\
    %TMPLIBPTH%\idmcommon.jar;
    java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME% \
       com.waveset.install.UpgradePreProcess

  7. Installez le logiciel :
  8. cd %WSHOME%
    jar -xvf %ISPATH%\IDM.WAR

  9. Exécutez le post-traitement :
  10. java -classpath %CLASSPATH% -Dwaveset.home=%WSHOME%
      com.waveset.install.UpgradePostProcess


    Remarque

    Le programme d’installation prend en charge la mise à niveau d’installations ayant renommé, supprimé ou désactivé le compte Configurator par défaut.

    Le programme d’installation vous demande le nom d’utilisateur et le mot de passe permettant d’importer le fichier update.xml lors du post-traitement. Si le nom d’utilisateur ou le mot de passe saisi est erroné, vous êtes à nouveau invité à le taper (trois fois maximum). L’erreur s’affiche dans la zone de texte prévue à cet effet.

    Pour effectuer une installation manuelle, vous devez spécifier les indicateurs -U nom-utilisateur -P mot-de-passe afin de passer les informations d’identification à la procédure UpgradePostProcess.


  11. Si vous avez procédé à une installation dans un répertoire de transfert, créez un fichier .war à des fins de déploiement vers le serveur d’application.
  12. Supprimez les fichiers d’Identity Manager du répertoire de travail du serveur d’application.
  13. Si le processus de mise à niveau ne l’a pas déjà fait, déplacez les fichiers de classe de correctifs du répertoire WEB-INF\classes vers le répertoire $WSHOME\patches\NomCorrectif.
  14. Démarrez le serveur d’application.
  15. Procédez à la mise à niveau, puis redémarrez Sun Identity Manager Gateway. Pour des instructions détaillées, voir l’étape 10.

Sur une plate-forme UNIX

Pour mettre à niveau Identity Manager manuellement sur une plate-forme UNIX prise en charge, procédez comme suit :

  1. Arrêtez le serveur d’application et Sun Identity Manager Gateway.
  2. Mettez à jour la base de données d’Identity Manager. Pour les instructions, voir l’étape 2.
  3. Saisissez les commandes suivantes pour définir l’environnement :
  4. export ISPATH=Chemin d’installation du logiciel
    export WSHOME=Chemin d’accès au répertoire d’installation OU de transfert d’Identity Manager
    export TEMP=Chemin d’accès au répertoire temporaire

  5. Exécutez le prétraitement :
  6. mkdir $TEMP
    cd $TEMP
    jar -xvf $ISPATH/idm.war \
    WEB-INF/lib/idm.jar WEB-INF/lib/idmcommon.jar
    CLASSPATH=$TEMP/WEB-INF/lib/idm.jar:\
    $TEMP/WEB-INF/lib/idmcommon.jar:
    java -classpath $CLASSPATH -Dwaveset.home=$WSHOME \
    com.waveset.install.UpgradePreProcess

  7. Installez le logiciel :
  8. cd $WSHOME
    jar -xvf $ISPATH/idm.war

  9. Exécutez le post-traitement :
  10. java -classpath $CLASSPATH -Dwaveset.home=$WSHOME
      com.waveset.install.UpgradePostProcess


    Remarque

    Le programme d’installation prend en charge la mise à niveau d’installations ayant renommé, supprimé ou désactivé le compte Configurator par défaut.

    Le programme d’installation vous demande le nom d’utilisateur et le mot de passe permettant d’importer le fichier update.xml lors du post-traitement. Si le nom d’utilisateur ou le mot de passe saisi est erroné, vous êtes à nouveau invité à le taper (trois fois maximum). L’erreur s’affiche dans la zone de texte prévue à cet effet.

    Pour effectuer une installation manuelle, vous devez spécifier les indicateurs -U nom-utilisateur -P mot-de-passe afin de passer les informations d’identification à la procédure UpgradePostProcess.


  11. Passez au répertoire $WSHOME/bin/solaris ou $WSHOME/bin/linux, puis définissez les autorisations s’appliquant aux fichiers contenus dans le répertoire de manière à les rendre exécutables.
  12. Si vous avez procédé à une installation dans un répertoire de transfert, créez un fichier .war à des fins de déploiement vers le serveur d’application.
  13. Supprimez les fichiers d’Identity Manager du répertoire de travail du serveur d’application.
  14. Si le processus de mise à niveau ne l’a pas déjà fait, déplacez les fichiers de classe de correctifs du répertoire WEB-INF/classes vers le répertoire $WSHOME/patches/NomCorrectif.
  15. Démarrez le serveur d’application.
  16. Procédez à la mise à niveau, puis redémarrez Sun Identity Manager Gateway. Pour les instructions, voir l’étape 10.