Cette section fournit des informations sur la mise à niveau des applications d'identité et des logiciels de support, ce qui inclut la mise à jour des composants suivants :
Application utilisateur Identity Manager
One SSO Provider (OSP)
Self-Service Password Reset (SSPR)
Tomcat, JDK et ActiveMQ
NetIQ fournit un programme de mise à niveau pour ces composants. Ce programme se trouve dans le répertoire products/RBPM/ du paquetage d'installation d'Identity Manager. Accédez au répertoire qui contient les fichiers de mise à niveau suivants :
Linux : RBPM_upgrade.bin
Windows : RBPM_upgrade.exe
Cette section présente des renseignements sur les éléments suivants :
La procédure de mise à niveau lit les valeurs de configuration à partir des composants existants. Ces informations incluent les fichiers ism-configuration.properties, server.xml, SSPRConfiguration ainsi que d'autres fichiers de configuration. À l'aide de ces fichiers de configuration, la procédure de mise à niveau appelle en interne le programme de mise à niveau des composants. Ce programme crée en outre une sauvegarde de l'installation actuelle.
Avant d'effectuer une mise à niveau, passez en revue les considérations suivantes :
Identity Manager est mis à niveau vers la version 4.5.5 : vous ne pouvez pas effectuer une mise à niveau ou une migration vers Identity Manager 4.6 à partir d'une version antérieure à la version 4.5.5. Pour plus d'informations sur la mise à niveau vers Identity Manager 4.5, reportez-vous à la section Mise à niveau d'Identity Manager du Guide d'installation de NetIQ Identity Manager.
Le paquetage du pilote du service de rôles et ressources est mis à niveau : pour plus d'informations, reportez-vous à la section Upgrading Installed Packages (Mise à niveau des paquetages installés) du NetIQ Designer for Identity Manager Administration Guide (Guide d'administration de NetIQ Designer pour Identity Manager).
Tomcat en tant que serveur d'applications : cette version d'Identity Manager prend uniquement en charge Tomcat en tant que serveur d'applications.
REMARQUE :assurez-vous d'avoir installé le serveur d'applications Tomcat à l'aide d'un programme d'installation fourni à des fins de commodité lors de l'installation d'Identity Manager 4.5. La procédure de mise à niveau vous permet uniquement de mettre à niveau l'instance Tomcat installée à l'aide du programme d'installation fourni à des fins de commodité.
Si vos applications d'identité sont en cours d'exécution sur un serveur d'applications autre que Tomcat, migrez le serveur d'applications vers Tomcat. Pour plus d'informations, reportez-vous à la Section 58.6, Migration d'un serveur d'applications Web Websphere ou JBoss vers un serveur d'applications Web Tomcat.
La plate-forme de base de données est mise à niveau : ce programme ne met pas à niveau la plate-forme de base de données des applications d'identité. Mettez à niveau manuellement votre version actuelle de la base de données vers une version prise en charge. Pour mettre à niveau la base de données PostgreSQL, reportez-vous à la section Mise à niveau de la base de données PostgreSQL.
Assurez-vous que le nom de contexte de l'application utilisateur est défini sur le nom par défaut : si vous avez configuré un nom de contexte de l'application utilisateur autre que celui par défaut (IDMProv), vous devez modifier le nom du contexte. Pour plus d'informations, reportez-vous à la Modification du nom de contexte personnalisé pour l'application utilisateur.
Self Service Password Reset : si vous effectuez la mise à niveau à partir de SSPR 4.0, assurez-vous d'avoir mis à jour la propriété CATALINA_OPTS et d'avoir défini -Dsspr.application.Path sur le dossier hébergeant votre configuration SSPR.
Exemples :
Linux : export CATALINA_OPTS="-Dsspr.applicationPath=/home/sspr_data
Windows : set CATALINA_OPTS="-Dsspr.applicationPath=C:\sspr_data
Sauvegardez votre base de données LocalDB SSPR avant la mise à niveau. Pour exporter ou télécharger la base de données locale (LocalDB), effectuez les opérations suivantes :
Connectez-vous au portail SSPR en tant qu'administrateur.
Dans le menu déroulant situé dans le coin supérieur droit de la page, cliquez sur Configuration Manager (Gestionnaire de configuration).
Cliquez sur LocalDB.
Cliquez sur Download LocalDB (Télécharger la base de données locale).
Effectuez les étapes suivantes pour mettre à niveau la base de données PostgreSQL :
IMPORTANT :la procédure de mise à niveau peut prendre un certain temps en fonction de la taille de la base de données. Par conséquent, planifiez votre mise à niveau en conséquence.
Arrêtez le service PostgreSQL en cours d'exécution sur votre serveur.
Renommez le dossier postgres situé à l'emplacement suivant :
Linux : /opt/netiq/idm/apps
Windows : C:\Netiq\IdentityManager\apps
Par exemple, modifiez postgres pour le renommer postgresql_9_3.
Montez le fichier image Identity_Applications_version_plate-forme.iso, accédez au répertoire contenant le programme d'installation de PostgreSQL.
<chemin_extraction_iso>/products/RBPM/postgre_tomcat_install
Installez l'application PostgreSQL. Dans la liste, sélectionnez PostgreSQL :
Linux (Interface graphique) : exécutez ./TomcatPostgreSQL.bin
Linux (Console) : exécutez ./TomcatPostgreSQL.bin -i console
Windows : exécutez TomcatPostgreSQL.exe
Lors de l'installation, sélectionnez uniquement l'option PostgreSQL.
REMARQUE :sur la page Détails de PostgreSQL, ne cochez pas les cases Create database login account (Créer un compte de connexion à la base de données) ni Create empty database (Créer une base de données vide).
Arrêtez le service PostgreSQL qui vient d'être installé sur votre serveur.
Modifiez le propriétaire du répertoire PostgreSQL à l'aide de la commande suivante :
chown -R postgres:postgres <emplacement répertoire postgres>
Exemples :
chown -R postgres:postgres /opt/netiq/idm/apps/postgres
Basculez vers l'utilisateur postgres en entrant la commande suivante :
su - postgres
Accédez au répertoire postgres/bin.
Exportez l'emplacement d'installation de PostgreSQL à l'aide de la commande suivante :
export PATH=/opt/netiq/idm/apps/postgres/bin:$PATH
Exportez le mot de passe PostgreSQL à l'aide de la commande suivante :
export PGPASSWORD=<entrer mot de passe base de données>
Mettez à niveau PostgreSQL à l'aide de la commande suivante :
pg_upgrade --old-datadir <ancien_emplacement_postgres\data> --new-datadir <nouvel_emplacement_postgres\data> --old-bindir <ancien_emplacement_postgres\bin> --new-bindir <nouvel_emplacement_postgres\bin>
Par exemple : . /pg_upgrade --old-datadir /opt/netiq/idm/apps/postgresql_9_3/data/ --new-datadir /opt/netiq/idm/apps/postgres/data/ --old-bindir /opt/netiq/idm/apps/postgresql_9_3/bin --new-bindir /opt/netiq/idm/apps/postgres/bin/
Si la mise à niveau réussit, un message s'affiche pour vous demander d'exécuter analyze_new_cluster.sh et delete_old_cluster.sh.
Démarrez le service de base de données PostgreSQL nouveau ou mis à niveau.
Basculez vers l'utilisateur postgres et exécutez analyze_new_cluster.sh.
su - postgres ./analyze_new_cluster.sh
Assurez-vous que le script soit exécuté sans erreur.
Accédez à /opt/netiq/idm/apps/postgres/bin et exécutez delete_old_cluster.sh en tant qu'utilisateur root.
./delete_old_cluster.sh
Si vous avez spécifié un nom de contexte de l'application utilisateur autre que celui par défaut (IDMProv), procédez comme suit pour réinitialiser le nom du contexte par défaut (IDMProv) :
REMARQUE :vous pouvez vérifier le nom du contexte dans la propriété portal.context du fichier ism-configuration.properties.
Arrêtez le service Tomcat.
/etc/init.d/idmapps_tomcat_init stop
Accédez au dossier webapps et renommez le dossier portant un autre nom de contexte que IDMProv (son nom par défaut).
Linux : /opt/netiq/idm/apps/tomcat/webapps
Windows : C:\Netiq\IdentityManager\apps\tomcat\webapps
Par exemple, si le nom portal.context dans le fichier ism-configuration.properties est IDMDev, modifiez le nom du dossier IDMDev pour le renommer IDMProv.
Exécutez le programme de mise à niveau des applications d'identité. Reportez-vous à la Section 55.5.4, Utilisation du processus guidé de mise à niveau ou à la Section 55.5.5, Mise à niveau silencieuse des applications Identity Manager.
Après avoir mis à niveau les applications d'identité, restaurez les fichiers WAR en leur redonnant leur nom de contexte d'origine. Pour plus d'informations, reportez-vous à la section Applications d'identité.
Le processus de mise à niveau crée une sauvegarde de la configuration actuelle des composants installés. Assurez-vous que votre serveur dispose de suffisamment d'espace pour stocker la sauvegarde et d'espace libre supplémentaire pour la mise à niveau.
La procédure ci-dessous permet de mettre à niveau les applications d'identité, OSP, SSPR, Tomcat et les applications ActiveMQ à l'aide de l'assistant.
Connectez-vous en tant qu'utilisateur root ou administrateur au serveur sur lequel vous souhaitez exécuter la procédure de mise à niveau.
Montez le fichier image Identity_Applications.iso, accédez au répertoire contenant le fichier exécutable de mise à niveau, situé par défaut dans le répertoire products/RBPM/.
Lancez le programme de mise à niveau. Exécutez un des fichiers suivants, selon votre plate-forme :
Linux : RBPM_upgrade.bin
Windows : RBPM_upgrade.exe
Sur la page Introduction, passez en revue les composants Identity Manager que vous pouvez mettre à niveau, puis cliquez sur Suivant.
Lisez et acceptez l'accord de licence, puis cliquez sur Suivant.
Passez en revue la page Applications déployées, puis cliquez sur Suivant.
Cette page répertorie les composants actuellement installés. Elle indique également la version et les répertoires d'installation de Tomcat et du JRE. Si d'autres applications sont déployées sur le serveur, la procédure de mise à niveau affiche un avertissement indiquant que ces applications risquent de ne pas fonctionner correctement après la mise à niveau.
Par exemple : Identity Reporting ou fichiers WAR définis par l'utilisateur. Vous devez les restaurer manuellement à partir de la sauvegarde créée par le processus de mise à niveau.
Pour poursuivre la mise à niveau, cliquez sur Suivant.
Terminez le processus guidé en utilisant les paramètres ci-dessous. Ce programme propage automatiquement les valeurs des composants existants. Veillez à spécifier les valeurs adéquates pour les paramètres.
One SSO Provider
Représente le chemin d'un répertoire dans lequel le programme de mise à niveau crée les fichiers d'application pour OSP. Si le chemin n'est pas correct, accédez à l'emplacement auquel OSP est installé.
SSPR
Représente le chemin d'un répertoire dans lequel le programme de mise à niveau crée les fichiers d'application pour SSPR. Si le chemin n'est pas correct, accédez à l'emplacement auquel SSPR est installé.
Application utilisateur
Représente le chemin d'un répertoire dans lequel le programme de mise à niveau crée les fichiers d'application pour l'application utilisateur. Si le chemin n'est pas correct, accédez à l'emplacement auquel l'application utilisateur est installée.
Connexion à la base de données
Représente les paramètres pour la connexion à la base de données de l'application utilisateur. Les applications d'identité se connectent également à cette base de données. Le programme de mise à niveau inclut ces informations dans le fichier de configuration de l'application utilisateur.
Représente la plate-forme de la base de données de l'application utilisateur.
Spécifie le nom ou l'adresse IP du serveur qui héberge l'application utilisateur.
Spécifie le port utilisé par le serveur de base de données pour communiquer avec l'application utilisateur.
Spécifie le fichier JAR pour la plate-forme de base de données.
Le fournisseur de la base de données fournit le fichier JAR du pilote, qui représente le fichier JAR pour le serveur de base de données. Par exemple, pour PostgreSQL, vous pouvez spécifier postgresql-9.4-1212.jdbc42.jar, par défaut dans le dossier /opt/netiq/idm/apps/postgres sous Linux et C:\netiq\idm\apps\postgres sous Windows. De même, spécifiez les fichiers JAR appropriés pour votre plate-forme de base de données.
Référence de base de données
Indique le nom de la base de données. Par défaut, le nom de la base de données est idmuserappdb.
Indique le nom d'un compte qui permet à l'application utilisateur d'accéder à des données et de les modifier dans les bases de données. Par défaut, le nom d'utilisateur de la base de données est idmadmin.
Indique le mot de passe pour le nom d'utilisateur spécifié.
Mettre à niveau la base de données
Le programme de mise à niveau met à jour le schéma des tables de la base de données dans le cadre de la procédure de mise à niveau.
Le programme de mise à niveau laisse des instructions pour mettre à jour le schéma des tables de la base de données au premier démarrage de l'application utilisateur après la mise à niveau.
Génère un script SQL que l'administrateur de la base de données peut exécuter pour mettre à jour les base de données. Si vous choisissez cette option, vous devez également spécifier un nom pour le Fichier de schéma. Le paramètre se trouve dans la configuration Fichier de sortie SQL. Vous pouvez sélectionner cette option si vous ne disposez pas des autorisations nécessaires pour créer ou modifier une base de données dans votre environnement. Pour plus d'informations sur la création de tableaux avec le fichier, reportez-vous à la Section 39.2, Création manuelle du schéma de base de données.
Administrateur de la base de données
Représente le nom et le mot de passe de l'administrateur de la base de données.
Spécifie le compte d'un administrateur de la base de données qui peut créer des tables de base de données, des vues et d'autres artefacts.
Spécifie le mot de passe de l'administrateur de la base de données.
Dossier de sauvegarde
En fonction de l'endroit où vous avez installé les composants, le processus crée le répertoire de sauvegarde à cet emplacement et ajoute un horodatage (indiquant le moment de la sauvegarde) au répertoire sauvegardé.
Exemples :
Tomcat – /opt/netiq/idm/apps/tomcat_backup_02262017_033634
OSP et SSPR – /opt/netiq/idm/apps/osp_sspr_backup_02262017_033634
ActiveMQ – /opt/netiq/idm/apps/activemq_backup_02262017_033634
Application utilisateur – /opt/netiq/idm/apps/UserApplication_backup_02262017_033634
Passez en revue la page Résumé avant la mise à niveau, puis cliquez sur Installer.
Le processus de mise à jour arrête le service Tomcat et démarre la mise à niveau, laquelle peut prendre un certain temps.
Une fois la procédure de mise à niveau terminée, passez en revue les fichiers journaux correspondants à l'emplacement /tmp/rbpm_upgrade/ et si vous devez mettre à jour quelques configurations manuellement, reportez-vous à la Section 55.5.6, Tâches postérieures à la mise à niveau.
Une installation silencieuse (non interactive) n'affiche pas d'interface utilisateur.
Connectez-vous en tant qu'utilisateur root ou administrateur à l'emplacement où vous souhaitez mettre à niveau les applications Identity Manager.
Ouvrez une session de terminal.
Spécifiez les valeurs d'installation dans le fichier de propriétés.
Linux : products/RBPM/RBPM_Upgrade_Linux.properties
Windows : products\RBPM\RBPM_Upgrade_Win.properties
Pour lancer le programme de mise à niveau correspondant à votre plate-forme, entrez la commande suivante :
Linux : RBPM_Upgrade.bin -i silent -f RBPM_Upgrade_Linux.properties
Windows : RBPM_Upgrade.exe -i silent -f RBPM_Upgrade_Win.properties
REMARQUE :si le fichier RBPM_Upgrade_Linux.properties n'est pas dans le même répertoire que le script du programme d'installation, vous devez indiquer le chemin absolu du fichier. Le script décompresse les fichiers requis dans un répertoire temporaire et lance l'installation en mode silencieux.
À l'issue de la mise à niveau, vous devez restaurer manuellement les paramètres personnalisés pour Tomcat, SSPR, OSP ou les applications d'identité.
Effectuez les opérations post-mise à niveau pour les composants requis :
comparez les certificats situés à l'emplacement du nouveau JRE mis à niveau (jre/lib/security/cacerts) avec ceux se trouvant à l'emplacement de l'ancien JRE. Importez manuellement les certificats manquants dans vos cacerts.
Importez le fichier java cacerts à l'aide de la commande keytool :
keytool -import -trustcacerts -file Cerificate_Path -alias ALIAS_NAME -keystore cacerts
REMARQUE :après la mise à niveau, JRE est stocké à l'emplacement d'installation des applications identité. Par exemple : /opt/netiq/idm/apps/jre
Vérifiez l'emplacement d'accueil de JRE.
Linux : tomcat/bin/setenv.sh
Windows : tomcat/bin/setenv.bat
Lancez l'utilitaire de mise à jour de configuration et vérifiez le chemin de votre fichier cacerts.
(Conditionnel) Restaurez les fichiers personnalisés à partir de la sauvegarde effectuée précédemment par le processus de mise à niveau.
Exemples :
Certificats https personnalisés. Pour restaurer la configuration, copiez le contenu Java Secure Sockets Extension (JSSE) du fichier server.xml sauvegardé vers le nouveau fichier server.xml situé dans le répertoire /tomcat/conf.
Ne copiez pas les fichiers de configuration présents dans le répertoire Tomcat sauvegardé vers le nouveau répertoire Tomcat. Commencez avec la configuration par défaut de la nouvelle version et procédez aux éventuelles modifications nécessaires. Pour plus d'informations, reportez-vous au site Web d'Apache.
Si vous disposez de fichiers Keystore personnalisés, incluez le chemin d'accès correct dans le nouveau fichier server.xml.
(Conditionnel) Accédez à l'application utilisateur Identity Manager et restaurez les paramètres personnalisés manuellement en consultant la configuration sauvegardée.
Restaurez la configuration personnalisée des applications d'identité à partir de la sauvegarde effectuée pendant la procédure de mise à niveau.
Si vous avez renommé le nom du dossier de contexte personnalisé IDMProv avant d'exécuter le programme de mise à niveau, vous devez restaurer le nom d'origine du dossier de contexte à l'aide de l'utilitaire configupdate. Par exemple, le nom de contexte personnalisé d'origine est IDMDev et il a été renommé IDMProv.
Effectuez les étapes suivantes pour restaurer le nom d'origine du contexte :
Accédez au répertoire de l'application utilisateur /opt/netiq/idm/apps/UserApplication.
Lancez l'utilitaire ConfigUpdate.
Linux : configupdate.sh
Windows : configupdate.bat
Sous l'onglet Application utilisateur, cliquez sur Aff. options avancées et effectuez les opérations suivantes :
Cochez la case Modifier le nom du contexte RBPM.
Remplacez le nom du contexte RBPM par le nom du contexte d'origine.
Recherchez et sélectionnez le DN du pilote des rôles, puis cliquez sur OK.
Modifiez l'autorisation et la propriété du fichier WAE à l'aide de la commande suivante.
chmod 755 <Original_Context_Name>.war; chown -R novlua:novlua <Original_Context_Name>.war
Par exemple, si le nom d'origine du contexte personnalisé est IDMDev :
chmod 755 IDMDev.war; chown -R novlua:novlua IDMDev.war
(Conditionnel) Si vous avez terminé toutes les tâches postérieures à la mise à niveau, démarrez le service Tomcat pour les applications d'identité.
Si OSP et les applications utilisateur sont déployées sur des serveurs distincts, mettez à jour le paramètre du client SSO à l'aide de l'utilitaire de mise à jour de la configuration. Pour plus d'informations, reportez-vous à la Section 40.4.3, Tableau de bord IDM de la Section 40.4, Paramètres des clients SSO.
Par défaut, l'entrée LogHost située dans le fichier /etc/logevent.conf est définie sur localhost.
Pour modifier l'entrée LogHost, restaurez manuellement les configurations OSP personnalisées à partir de la sauvegarde effectuée pendant la procédure de mise à niveau.
Après la mise à niveau de SSPR, mettez à jour le paramètre de client SSO à l'aide de l'utilitaire de mise à jour de configuration. Pour plus d'informations, reportez-vous à la Section 40.4.8, Réinitialisation de mot de passe en self-service de la Section 40.4, Paramètres des clients SSO.
Pour mettre à jour les détails de configuration de SSPR, procédez comme suit :
Connectez-vous au portail SSPR en tant qu'administrateur.
Mettez à jour les détails du serveur d'audit :
Accédez à l'éditeur de configuration et spécifiez le mot de passe de configuration.
Sélectionnez Settings > Auditing > Audit Forwarding > Syslog Audit Server Certificates (Paramètres > Audit > Réacheminement d'audit > Certificats de serveur d'audit Syslog).
Importez ces certificats depuis le serveur, puis cliquez sur Save (Enregistrer).
Importez LocalDB dans SSPR :
Dans le menu déroulant situé dans le coin supérieur droit de la page, cliquez sur Configuration Manager (Gestionnaire de configuration).
Cliquez sur LocalDB.
Cliquez sur Import (Upload) LocalDB Archive File (Importer [Télécharger] le fichier d'archive LocalDB).
Pour configurer les autorisations d'administrateur pour SSPR, reportez-vous à la Section 32.3, Tâches de post-installation.
REMARQUE :si vous mettez à niveau SSPR 4.0 vers la version 4.1, l'emplacement personnalisé des configurations de SSPR est remplacé par l'emplacement par défaut de SSPR 4.1. Des informations supplémentaires à propos des emplacements des configurations sont disponibles dans le fichier setenv.sh. Toutefois, ce changement ne modifie pas le comportement des composants.
Par exemple, si, avant la mise à niveau, le chemin de la configuration de SSPR est défini sur -Dsspr.applicationPath='/home/sspr-data, il est remplacé par -Dsspr.applicationPath=/opt/netiq/idm/apps/osp_sspr/sspr/sspr_data après la mise à niveau et toutes les configurations associées sont restaurées à cet emplacement.
Pour vérifier si la mise à niveau a réussi, lancez les composants mis à niveau.
Par exemple, lancez le tableau de bord Identity Manager, puis cliquez sur À propos de. Vérifiez si l'application affiche la nouvelle version, par exemple 4.6.0.