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
Base de données PostgreSQL
Après la mise à niveau, les composants sont mis à niveau vers les versions suivantes :
Tomcat – 8.5.27
ActiveMQ – 5.15.2
Java – 1.8.0_162
One SSO Provider – 6.2.1
Self-Service Password Reset – 4.2.0.4
Cette section fournit des informations concernant les rubriques suivantes :
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.6 : vous ne pouvez pas effectuer la mise à niveau ou la migration vers la version 4.7 à partir de versions antérieures à 4.5.6. Pour plus d'informations sur la mise à niveau vers Identity Manager 4.7, reportez-vous à la Section 25.3, Chemins de mise à niveau pris en charge.
Configuration système requise: La procédure de mise à niveau requiert au moins 3 Go d'espace disque pour stocker la configuration actuelle et les fichiers temporaires créés pendant la mise à niveau. Assurez-vous que votre serveur dispose de suffisamment d'espace pour stocker la sauvegarde et d'espace libre supplémentaire pour la mise à niveau.
Si vous avez installé les applications d'identité sur une partition distincte de la partition racine, vérifiez que la partition dispose de suffisamment d'espace pour stocker la configuration de sauvegarde. En outre, assurez-vous que le répertoire /tmp comporte suffisamment d'espace pour stocker les journaux et les fichiers temporaires. Si ce répertoire ne dispose pas de l'espace requis, définissez la variable d'environnement IATEMPDIR sur un répertoire d'une partition qui dispose de suffisamment d'espace. Le programme de mise à niveau sera redirigé vers ce répertoire pour stocker les fichiers de ce répertoire.
Pour définir IATEMPDIR sur un répertoire :
Ouvrez un terminal et entrez la commande suivante :
export IATEMPDIR=/opt/custom_tmp
où /opt/custom_tmp est le chemin d'accès au répertoire qui dispose de suffisamment d'espace.
REMARQUE :Sauvegardez les certificats des applications d'identité (cacerts).
Démarrez le programme de mise à niveau à partir de la ligne de commande.
Tomcat en tant que serveur d'applications : cette version d'Identity Manager prend uniquement en charge Tomcat en tant que serveur d'applications.
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 avant d'effectuer une mise à niveau. Pour plus d'informations, reportez-vous à la section Migration de Websphere ou JBoss vers 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 Section 26.5.4, Mise à niveau de la base de données PostgreSQL.
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).
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 :
export CATALINA_OPTS="-Dsspr.applicationPath=/home/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).
La procédure 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 suivante doit être effectuée avant la mise à niveau de la base de données PostgreSQL.
Arrêtez le service PostgreSQL.
su -s /bin/sh - postgres -c "/opt/netiq/idm/apps/postgres/bin/pg_ctl stop -w -D /opt/netiq/idm/apps/postgres/data"
Désactivez le fichier d'unité existant pour le service PostgreSQL.
systemctl disable postgresql-9.6.service
Nettoyez le fichier d'unité existant pour le service PostgreSQL.
rm /usr/lib/systemd/system/postgresql-9.6.service
systemctl daemon-reload
systemctl reset-failed
Créez un répertoire de sauvegarde et réalisez une sauvegarde du répertoire PostgreSQL existant.
Par exemple :
mkdir -p /home/backup
cp -rvf /opt/netiq/idm/apps/postgres/ /home/backup/
Accédez à l'emplacement où vous avez monté le fichier Identity_Manager_4.7_Linux.iso.
Accédez au répertoire /common/packages/postgres/.
Installez la nouvelle version de PostgreSQL.
rpm -ivh netiq-postgresql-9.6.6-0.noarch.rpm
REMARQUE :le répertoire privé de PostgreSQL est déplacé de l'emplacement d'installation personnalisé précédent vers /opt/netiq/idm/postgres/.
Créez un répertoire data à l'emplacement d'installation de PostgreSQL.
mkdir -p <répertoire_privé_POSTGRES>/data, où <répertoire_privé_POSTGRES> correspond à /opt/netiq/idm/postgres.
Par exemple :
mkdir -p /opt/netiq/idm/postgres/data
Changez les autorisations du répertoire de l'instance PostgreSQL qui vient d'être installée.
chown -R postgres:postgres <chemin_répertoire_postgres>
Par exemple :
chown -R postgres:postgres /opt/netiq/idm/postgres
Créez un répertoire privé pour l'utilisateur postgres.
Par exemple : mkdir -p /home/users/postgres
Changez les autorisations du répertoire privé pour l'utilisateur de l'instance PostgreSQL qui vient d'être installée.
chown -R postgres:postgres <chemin_répertoire_privé_postgres>
Par exemple :
chown -R postgres:postgres /home/users/postgres
Exportez le répertoire privé de PostgreSQL.
export PGHOME=<chemin_répertoire_privé_postgres>
Par exemple :
export PG_HOME=/opt/netiq/idm/postgres
Exportez le mot de passe PostgreSQL :
export PGPASSWORD=<entrer mot de passe base de données>
Initialisez la base de données.
su -s /bin/sh - postgres -c "LANG=en_US.UTF-8 <répertoire privé_POSTGRES>/bin/initdb -D <répertoire privé_POSTGRES>/data"
Par exemple :
su -s /bin/sh - postgres -c "LANG=en_US.UTF-8 /opt/netiq/idm/postgres/bin/initdb -D /opt/netiq/idm/postgres/data"
Remplacez le chemin du répertoire privé de l'utilisateur postgres par /opt/netiq/idm/postgres/ dans le fichier /etc/passwd.
Accédez au répertoire /etc/.
Modifiez le fichier passwd.
vi /etc/passwd
Déplacez le répertoire privé de l'utilisateur postgres vers /opt/netiq/idm/postgres/.
Accédez au répertoire /opt/netiq/idm/postgres/.
Connectez-vous en tant qu'utilisateur postgres.
Par exemple :
su postgres
Migrez les données existantes.
Par exemple :
/opt/netiq/idm/postgres/bin/pg_upgrade --old-datadir /opt/netiq/idm/apps/postgres/data/ --new-datadir /opt/netiq/idm/postgres/data/ --old-bindir /opt/netiq/idm/apps/postgres/bin --new-bindir /opt/netiq/idm/postgres/bin/
Déconnectez-vous de la session d'utilisateur postgres.
Mettez à jour le fichier pg_hba.conf de manière à approuver le réseau du serveur :
Accédez au répertoire /opt/netiq/idm/postgres/data/.
Modifiez le fichier pg_hba.conf :
vi pg_hba.conf
Ajoutez la ligne suivante au fichier pg_hba.conf :
host all all 0.0.0.0/0 trust
Pour vous assurer que votre instance de PostgreSQL écoute sur les instances du réseau autres que localhost, mettez à jour le fichier de configuration :
Accédez au répertoire /opt/netiq/idm/postgres/data/.
Modifiez le fichier postgresql.conf :
vi postgresql.conf
Ajoutez la ligne suivante au fichier postgresql.conf :
listen_addresses = '*'
REMARQUE :Pour écouter sur certaines interfaces réseau, spécifiez une liste d'adresses IP séparées par des virgules.
Créez le répertoire pg_log sous <chemin_répertoire_privé_postgres>/data.
Par exemple :
mkdir -p /opt/netiq/idm/postgres/data/pg_log
Modifiez les autorisations pour le répertoire pg_log.
chown -R postgres:postgres <chemin_répertoire_postgres>/data/pg_log
Par exemple :
chown -R postgres:postgres /opt/netiq/idm/postgres/data/pg_log
Démarrez le service PostgreSQL.
systemctl start netiq-postgresql
Cela lancera le nouveau service PostgreSQL.
(Facultatif) Lancez la nouvelle application pgAdmin à partir de l'interface graphique :
Copiez le répertoire scripts de l'ancien répertoire privé postgres vers le nouveau répertoire privé postgres.
Par exemple :
cp -rvf /opt/netiq/idm/apps/postgres/scripts /opt/netiq/idm/postgres
Accédez au répertoire /opt/netiq/idm/postgres/scripts.
Modifiez le fichier launchpgadmin.sh et remplacez l'ancien chemin de PostgreSQL par le nouveau.
Remplacez /opt/netiq/idm/apps/postgres/ avec /opt/netiq/idm/postgres.
Accédez au répertoire /usr/share/application et modifiez l'application .desktop pour fournir le nouveau chemin pour launchpgadmin.sh.
SLES : modifiez l'application pgadmin-pg-9_6.desktop et remplacez la valeur EXEC par le nouveau chemin du fichier launchpgadmin.sh.
Par exemple :
Remplacez la valeur de "Exec=/opt/netiq/idm/apps/postgres/scripts/launchpgadmin.sh" par :"Exec=/opt/netiq/idm/postgres/scripts/launchpgadmin.sh".
RHEL : accédez à /usr/share/application et créez le fichier pgadmin-pg-9_6.desktop avec les détails suivants :
Par exemple :
[Desktop Entry] Version=1.0 Encoding=UTF-8 Name=pgAdmin 4 Exec=/opt/netiq/idm/postgres/scripts/launchpgadmin.sh Icon=pg-pgadmin-9_6.png Terminal=false Type=Application
Supprimez l'ancien répertoire privé postgres du système.
rm -rf /opt/netiq/idm/apps/postgres/
Redémarrez le système pour que les modifications prennent effet.
Cette section explique comment mettre à jour les paquetages pour le pilote d'application utilisateur et les pilotes du service Rôles et ressource vers la dernière version. Vous devez effectuer cette tâche avant de mettre à niveau les applications d'identité.
Dans Designer, ouvrez votre projet en cours.
Cliquez avec le bouton droit sur Catalogue de paquetages > Importer le paquetage.
Sélectionnez le paquetage approprié. Par exemple, paquetage de base du pilote de l'application utilisateur.
Cliquez sur OK.
Dans la vue Développeur, cliquez avec le bouton droit sur le pilote, puis cliquez sur Propriétés.
Accédez à l'onglet Paquetages sur la page Propriétés.
Cliquez sur le symbole d'ajout de paquetage (+) dans le coin supérieur droit.
Sélectionnez le paquetage, puis cliquez sur OK.
Répétez la même procédure pour mettre à niveau le paquetage pour le pilote du service Rôles et ressource.
REMARQUE :assurez-vous que le pilote d'application utilisateur et le pilote du service Rôles et ressource sont connectés à la version mise à niveau d'Identity Manager.
REMARQUE :si vos applications d'identité et SSPR sont installés sur des serveurs différents, vous devez mettre à niveau SSPR manuellement. Pour plus d'informations, reportez-vous à la Mise à niveau de SSPR.
La procédure suivante décrit comment mettre à niveau les applications d'identité.
Téléchargez le fichier Identity_Manager_4.7_Linux.iso à partir du site Web de téléchargement de NetIQ.
Montez le fichier .iso téléchargé.
Exécutez la commande suivante :
./install.sh
Lisez le contrat de licence.
Entrez o pour accepter l'accord de licence.
Indiquez si vous souhaitez mettre à niveau les composants Identity Manager. Les options disponibles sont y (oui) et n (non).
Sélectionnez les applications d'identité pour poursuivre la mise à niveau.
Spécifiez les informations suivantes :
Dossier d'installation de SSPR : spécifiez le dossier d'installation de SSPR.
Dossier de l'application utilisateur : spécifiez le dossier de l'application utilisateur.
Mot de passe du service SSO One des applications d'identité : spécifiez le mot de passe SSO One.
Fichier JAR JDBC de la base de données des applications d'identité : spécifiez le fichier JAR de la base de données. L'emplacement par défaut du fichier JAR de la base de données existante est /opt/netiq/idm/apps/postgres/postgresql-9.4.1212.jar.
Créer le schéma pour les applications d’identité : indique si vous souhaitez créer le schéma de base de données. Les options disponibles sont Maintenant, Démarrage et Fichier.
REMARQUE :si SSPR est installé sur un serveur différent de celui des applications d'identité et d'OSP, vous devez mettre à niveau SSPR séparément.
Téléchargez le fichier Identity_Manager_4.7_Linux.iso comme indiqué dans la Section 5.11, Téléchargement des fichiers d'installation.
Montez le fichier .iso téléchargé.
À partir du répertoire racine du fichier .iso, accédez au répertoire SSPR.
Exécutez la commande suivante :
./install.sh
Lisez le contrat de licence.
Entrez o pour accepter l'accord de licence.
Vérifiez que le paramètre Configuration SAML RBPM à eDirectory dans l'utilitaire configupdate est défini sur Auto.
Lancez l'utilitaire ConfigUpdate.
Accédez à Clients SSO > RBPM et définissez Configuration SAML RBPM à eDirectory sur Auto.
Enregistrez les modifications apportées.
Démarrez Tomcat.
Modifiez l'autorisation et la propriété du répertoire OSP :
chmod +x novlua:novlua /opt/netiq/idm/apps/osp
Supprimez manuellement la version précédente de Tomcat et des services ActiveMQ.
/etc/init.d/idmapps_tomcat_init
/etc/init.d/idmapps_activemq_init
Vous devez également restaurer manuellement les paramètres personnalisés pour Tomcat, SSPR, OSP ou les applications d'identité.
Vérifiez que l'emplacement du JRE mis à niveau (jre/lib/security/cacerts) contient tous les certificats de l'emplacement de l'ancien JRE. Si un certificat est manquant, importez-le manuellement dans le fichier cacerts du JRE mis à niveau.
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'origine du JRE.
tomcat/bin/setenv.sh
Lancez l'utilitaire de mise à jour de la configuration et vérifiez le chemin de votre fichier cacerts.
(Conditionnel) Pour restaurer les fichiers personnalisés à partir de la sauvegarde effectuée précédemment dans le cadre de la procédure de mise à niveau, effectuez les tâches suivantes :
Restaurez les certificats https personnalisés. Pour restaurer ces certificats, 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.
Vérifiez que le nouveau fichier server.xml comporte les entrées suivantes :
<Connector port="8543" protocol="HTTP/1.1"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="path_to_keystore_file"
keystorePass="keystore_password" />
<!--
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
-->
ou
<Connector port="8543" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="path_to_keystore_file"
keystorePass="keystore_password" />
<!--
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
-->
REMARQUE :dans un environnement en grappe, supprimez manuellement le commentaire de la balise Cluster dans le fichier server.xml et copiez le fichier osp.jks sur tous les noeuds à partir du premier noeud situé à l'emplacement /opt/netiq/idm/apps/osp_backup_<date>.
Si vous disposez de fichiers Keystore personnalisés, incluez le chemin d'accès correct dans le nouveau fichier server.xml.
Importez les certificats des applications d'identité dans le coffre-fort d'identité dans /opt/novell/eDirectory/lib64/nds-modules/jre/lib/security/cacerts.
Par exemple, vous pouvez utiliser la commande keytool suivante pour importer des certificats dans le coffre-fort d'identité :
keytool -importkeystore -alias <keyalias> -srckeystore <backup cacert> -srcstorepass changeit -destkeystore /opt/novell/eDirectory/lib64/nds-modules/jre/lib/security/cacerts -deststorepass changeit
(Conditionnel) Accédez à l'application utilisateur et restaurez les paramètres personnalisés manuellement en consultant la configuration sauvegardée.
Restaurez les configurations personnalisées 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 situé dans /opt/netiq/idm/apps/UserApplication.
(Facultatif) Pour lancer l'utilitaire configupdate en mode GUI, assurez-vous que l'option use_console est définie sur false dans le fichier configupdate.sh.properties.
Cette étape est nécessaire, car l'utilitaire de mise à niveau modifie la valeur de cette option sur true.
Vous pouvez également lancer l'utilitaire configupdate et transmettre un argument de ligne de commande supplémentaires sous Linux.
./configupdate.sh use_console=false
Lancez l'utilitaire ConfigUpdate.
configupdate.sh
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 l'application utilisateur sont déployés 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 Tableau de bord IDM de la Section 11.6.5, 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.
L'utilitaire de mise à niveau crée un nouveau dossier Tomcat sur votre ordinateur. Si des fichiers Kerberos tels que keytab et Kerberos_login.config se trouvaient dans l'ancien dossier Tomcat, copiez ces fichiers dans le nouveau dossier Tomcat à partir du dossier sauvegardé.