33.2 Utilisation de la procédure guidée pour installer les applications d'identité

La procédure suivante décrit comment installer les applications d'identité à l'aide de l'assistant d'installation, au format interface graphique ou à partir de la console. Pour effectuer une installation silencieuse sans surveillance, reportez-vous à la Section 33.3, Installation silencieuse des applications d'identité.

Pour préparer l'installation, passez en revue les opérations énumérées à la Section 33.1, Liste de contrôle de l'installation des applications d'identité. Reportez-vous également aux notes de version accompagnant le logiciel.

REMARQUE :

  • Le programme d'installation n'enregistre pas les valeurs que vous entrez dans les fenêtres de l'assistant. Si vous cliquez sur Précédent pour revenir à une fenêtre précédente, vous devez les réinsérer.

  • Le programme d'installation crée le compte utilisateur novlua et définit les autorisations de cet utilisateur dans les fichiers du serveur d'applications. Par exemple, le script idmapps_tomcat_init utilise ce compte utilisateur pour exécuter Tomcat.

  • Lorsque vous déployez les fichiers WAR de Home and Dashboard sous WebSphere,

    • L'option Map modules to server (Assigner des modules au serveur) affiche la valeur de module uadash pour les deux WAR. Les valeurs d'URI doivent correspondre au WAR en cours de déploiement.

    • L'option Map context roots for Web modules (Assigner des roots de contexte aux modules Web) affiche la valeur de module uadash pour les deux WAR. Les valeurs d'URI doivent correspondre au WAR en cours de déploiement.

    • Déployez les WAR dont les valeurs contextuelles correspondent au nom de leur fichier .war. Pour dash.war, spécifiez la valeur contextuelle dash, et pour landing.war, indiquez landing comme contexte.

    • Vérifiez que les fichiers WAR sont déployés sur le même noeud WebSphere que l'application utilisateur (IDMProv.war).

  • Lorsque vous déployez l'administrateur de catalogue (rra.war) sur WebSphere, dans Map context roots for Web modules (Assigner des roots de contexte aux modules Web), spécifiez la valeur contextuelle rra. Veillez à déployer rra.war sur le même noeud WebSphere que l'application utilisateur (IDMProv.war).

Avec le processus d'installation guidée :

  1. Connectez-vous en tant que root ou administrateur sur l'ordinateur où vous souhaitez installer les applications d'identité.

  2. (Conditionnel) Pour procéder à l'installation dans un environnement WebSphere, appliquez les fichiers de stratégie non restreints au JDK IBM pris en charge.

    Pour plus d'informations, reportez-vous à la documentation IBM pour obtenir un lien vers ces fichiers et savoir comment les appliquer. Le fichier JAR pour les fichiers de stratégie non restreints doit être situé dans le répertoire JAVA_HOME\jre\lib\security.

    En l'absence de ces fichiers, le message d'erreur Taille de clé incorrecte s'affiche. La cause première de ce problème est l'absence de fichiers de stratégie non restreints. Veillez dès lors à utiliser le JDK d'IBM approprié.

  3. Arrêtez le serveur d'applications, tel que Tomcat.

  4. (Conditionnel) Si vous disposez du fichier image .iso pour le paquetage d'installation d'Identity Manager, accédez au répertoire contenant les fichiers d'installation, situés par défaut sous products/RBPM/user_app_install.

  5. (Conditionnel) Si vous avez téléchargé les fichiers d'installation, procédez comme suit :

    1. Accédez au fichier .tgz ou win.zip pour l'image téléchargée.

    2. Extrayez le contenu du fichier dans un répertoire de l'ordinateur local.

  6. À partir du répertoire contenant les fichiers d'installation, effectuez l'une des opérations suivantes :

    • Linux (console) : entrez ./IdmUserApp.bin -i console

    • Linux (GUI) : entrez ./IdmUserApp.bin

    • Windows : exécutez IdmUserApp.exe

  7. Terminez le processus guidé, à l'aide des paramètres suivants :

    • Plate-forme du serveur d'applications

      Représente le serveur d'applications qui doit exécuter l'application d'identité. Le serveur d'applications doit être préalablement installé.

      Pour votre confort, NetIQ fournit Tomcat.

    • Dossier d'installation

      Représente le chemin d'un répertoire où le programme d'installation crée les fichiers de l'application.

    • Plate-forme de la base de données

      Représente la plate-forme de la base de données de l'application utilisateur. La base de données doit déjà être installée. Toutefois, il n'est pas nécessaire de créer le schéma de base de données pendant l'installation.

      Pour votre confort, NetIQ fournit PostgreSQL.

    • Hôte et port de la base de données

      Représente les paramètres pour le serveur qui héberge la base de données de l'application utilisateur.

      REMARQUE :dans un environnement de grappe, vous devez spécifier les mêmes paramètres de base de données pour chaque membre de la grappe.

      Hôte

      Indique le nom ou l'adresse IP du serveur.

      Port

      Indique le port que le serveur doit utiliser pour la communication avec l'application utilisateur.

    • Nom d'utilisateur et mot de passe de la base de données

      Représente les paramètres pour l'exécution de la base de données de l'application utilisateur.

      REMARQUE :

      • Si vous avez installé une base de données PostgreSQL dans le cadre de l'installation de cette version d'Identity Manager, le processus d'installation a déjà créé la base de données et son administrateur. Par défaut, la base de données installée est idmuserappdb et l'utilisateur est idmadmin. Spécifier les mêmes valeurs que celles utilisées pour l'installation de PostgreSQL.

      • Dans un environnement de grappe, vous devez spécifier le même nom de base de données, le même nom d'utilisateur et le même mot de passe pour chaque membre de la grappe.

      Nom ou SID de la base de données

      Spécifie le nom de la base de données en fonction de la plate-forme de base de données. Par défaut, le nom de la base de données est idmuserappdb.

      • Pour une base de données PostgreSQL ou SQL Server, indiquez le nom.

      • Pour une base de données Oracle, indiquez l'identificateur de sécurité (SID) que vous avez créé avec l'instance de base de données.

      Nom d'utilisateur de la base de données

      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.

      Mot de passe de la base de données

      Indique le mot de passe pour le nom d'utilisateur spécifié.

      Fichier JAR du pilote de base de données

      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 du client léger pour le serveur de base de données. Par exemple, pour PostgreSQL, vous pouvez spécifiez postgresql-9.3-1101.jdbc41.jar, situé par défaut dans le dossier opt\netiq\idm\apps\Postgres.

      NetIQ ne prend pas en charge les fichiers JAR de pilote fournis par d'autres fournisseurs.

    • Administrateur de la base de données

      Facultatif

      Représente le nom et le mot de passe de l'administrateur de la base de données.

      Ce champ reprend automatiquement le même compte utilisateur et le même mot de passe que ceux spécifiés sous Nom d'utilisateur et mot de passe de la base de données. Pour utiliser ce compte, n'apportez pas de modification.

      Administrateur de la base de données

      (Facultatif) 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 artéfacts.

      Mot de passe

      (Facultatif) Entrez le mot de passe de l'administrateur de la base de données.

    • Créer des tables de base de données

      Indique si vous voulez configurer votre nouvelle base de données ou la base existante dans le cadre du processus d'installation, ou ultérieurement.

      Création des tables maintenant

      Le programme d'installation crée les tables de base de données dans le cadre du processus d'installation.

      Créer des tables au démarrage de l'application

      Le programme d'installation conserve des instructions pour créer les tables lorsque l'application utilisateur est lancée pour la première fois.

      Écrire SQL dans un fichier

      Génère un script SQL que l'administrateur de la base de données peut exécuter pour créer la base de données. Si vous choisissez cette option, vous devez également spécifier un nom pour le Fichier de schéma. Ce paramètre est défini dans le fichier de configuration Fichier de sortie SQL.

      Vous pouvez sélectionner cette option si vous ne disposez pas des autorisations permettant de créer ou de 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 35.1, Création manuelle du schéma de base de données.

    • Nouvelle base de données ou base de données existante

      S'applique uniquement si vous envisagez de créer des tableaux au cours de l'installation ou d'écrire dans un fichier SQL.

      Indique si vous voulez utiliser des bases de données existantes vides ou si vous souhaitez que l'installation en crée de nouvelles Tenez compte des considérations suivantes :

      • Si vous avez installé PostgreSQL dans le cadre de l'installation de cette version d'Identity Manager, sélectionnez Base de données existante. L'installation de PostgreSQL a déjà créé la base de données et son administrateur. Par défaut, la base de données installée est idmuserappdb et l'utilisateur est idmadmin.

      • Pour utiliser la base de données existante d'une installation précédente, cette base ne peut pas contenir de données ou de tableaux. Dans le cas contraire, l'installation peut générer des erreurs.

      • Si la base de données existante s'exécute sur une plate-forme Oracle, vous devez préparer Oracle avant de mettre à jour le schéma. Pour plus d'informations, reportez-vous à la Section 54.6.1, Préparation d'une base de données Oracle pour le fichier SQL.

    • Tester la connexion à la base de données

      Indique si vous souhaitez que le programme d'installation se connecte à la base de données pour créer des tables directement ou pour créer le fichier. sql.

      Le programme d'installation tente la connexion lorsque vous cliquez sur Suivant ou appuyez sur Entrée.

      REMARQUE :Vous pouvez poursuivre l'installation même si la connexion à la base de données échoue. Toutefois, une fois l'installation terminée, vous devrez créer manuellement les tables et la connexion avec la base de données. Pour plus d'informations, reportez-vous à la Section 35.1.2, Création manuelle du fichier SQL pour générer le schéma de base de données.

    • Installation de Java

      Représente le chemin d'accès au fichier JRE pour lancer le programme d'installation. Exemple : /root/opt/java/jre7.

    • Configuration Application_Server

      Représente le chemin d'accès aux fichiers d'installation pour le serveur d'applications. Exemple : /opt/apache-tomcat-7.0.52. Le processus d'installation ajoute des fichiers à ce dossier.

    • Configuration d'IDM

      Représente les paramètres du contexte de l'application d'identité utilisé dans les URL et pour le moteur de workflow.

      Noeud simple (par défaut) ou cluster (tout)

      S'applique uniquement si vous installez le fichier WAR de provisioning sur un noeud dans une grappe JBoss.

      Indique la configuration du serveur d'applications. Par exemple, si cette installation a lieu sur un noeud unique qui ne fait pas partie d'une grappe, sélectionnez par défaut.

      Si vous sélectionnez tout, vous devez spécifier l'ID du moteur de workflow.

      Contexte de l'application

      Indique un nom qui correspond à la configuration du serveur d'applications, au fichier WAR de l'application et au nom inclus dans le contexte de l'URL.

      Le script d'installation crée une configuration de serveur, puis nomme la configuration en fonction du nom que vous avez créé lors de l'installation du serveur d'applications. Exemple : IDMProv.

      IMPORTANT : NetIQ vous recommande de noter le Contexte de l'application spécifié. Vous utiliserez ce nom dans l'URL lorsque vous démarrez les applications d'identité à partir d'un navigateur.

      ID du moteur de workflow

      S'applique uniquement si vous installez le fichier WAR de provisioning sur un noeud dans une grappe JBoss.

      Spécifie l'ID du moteur de workflow.

      Il est limité à 32 caractères. Pour plus d'informations sur les ID de moteur de workflow, reportez-vous à la section relative à la configuration de workflows pour la mise en grappe du manuel User Application: Administration Guide (Guide d'administration de l'application utilisateur).

    • Sélectionner le type de consignation de l'audit

      Indique si vous voulez envoyer les événements consignés à un serveur d'audit. Sélectionnez Oui ou Non.

    • Consignation d'audit

      S'applique uniquement si vous spécifiez Oui pour l'option Sélectionner le type de consignation de l'audit.

      Indique le type de consignation que vous souhaitez activer.

      Pour plus d'informations sur la configuration de la consignation, reportez-vous au manuel User Application: Administration Guide (Guide d'administration de l'application utilisateur).

      Novell Identity Audit ou NetIQ Sentinel

      Active la consignation via un client Novell ou NetIQ pour l'application utilisateur.

      REMARQUE :si vous choisissez cette option, vous devez également spécifier le nom d'hôte ou l'adresse IP du serveur client et le chemin d'accès au cache de consignation. Ces paramètres sont repris dans la section de configuration Novell Identity Audit ou NetIQ Sentinel.

      OpenXDAS

      Permet à l'application utilisateur d'envoyer des événements à votre serveur de consignation OpenXDAS.

    • Sécurité - Clé principale

      Indique si vous souhaitez importer une clé principale existante. L'application utilisateur emploie la clé principale pour accéder aux données codées. Sélectionnez Oui ou Non.

      Vous pouvez importer la clé principale dans les situations suivantes :

      • Après l'installation de la première instance des applications d'identité dans une grappe. Chaque instance de l'application utilisateur dans une grappe doit utiliser la même clé principale. Pour plus d'informations, reportez-vous à la Section 32.3.3, Utilisation de la même clé principale pour chaque application utilisateur dans la grappe.

      • Si vous déplacez votre installation d'un système provisoire à un système de production et que vous souhaitez conserver l'accès à la base de données utilisée avec le système provisoire.

      • Si vous restaurez votre application utilisateur et que vous souhaitez accéder aux données codées stockées par votre version antérieure de l'application utilisateur.

      Oui

      Indique que vous souhaitez importer une clé principale existante.

      Non

      Indique que vous souhaitez que le programme d'installation crée la clé.

      Par défaut, la procédure d'installation inscrit la clé principale codée dans le fichier master-key.txt, situé dans le répertoire d'installation.

    • Importer la clé principale

      S'applique uniquement si vous spécifiez Oui pour l'option Sécurité - Clé principale

      Permet d'indiquer la clé principale que vous souhaitez utiliser. Vous pouvez copier la clé principale du fichier master-key.txt.

    • Connexion au serveur d'applications

      Représente les paramètres de l'URL dont les utilisateurs ont besoin pour se connecter aux applications d'identité sur le serveur d'applications. Exemple : https:myserver.mycompany.com:8080.

      REMARQUE :si OSP s'exécute sur une autre instance du serveur d'applications, vous devez également sélectionner l'option Se connecter à un serveur d'authentification externe et spécifier les valeurs du serveur OSP.

      Protocole

      Indique si vous souhaitez utiliser http ou https. Afin d'utiliser SSL (Secure Sockets Layer) pour les communications, indiquez https.

      Nom d'hôte

      Indique le nom DNS ou l'adresse IP du serveur qui héberge OSP. N'utilisez pas localhost.

      Port

      Indique le port que le serveur doit utiliser pour la communication avec des ordinateurs clients.

      Se connecter à un serveur d'authentification externe

      Indique si une autre instance du serveur d'applications héberge le serveur d'authentification (OSP). Le serveur d'authentification contient la liste des utilisateurs qui peuvent se connecter à SSPR.

      Si vous sélectionnez cette option, indiquez également les valeurs pour le Protocole, le Nom d'hôte et le Port.

    • Détails du serveur d'authentification

      Spécifie le mot de passe que vous souhaitez que les applications d'identité utilisent lors de la connexion au serveur d'authentification. Cette information est également appelée le secret du client. Le processus d'installation crée ce mot de passe.

  8. (Conditionnel) Pour configurer les paramètres des applications d'identité après l'installation, cliquez sur Annuler dans la fenêtre de configuration du module de provisioning basé sur les rôles.

    REMARQUE :après l'installation de l'application utilisateur, vous pouvez modifier la plupart des paramètres dans les fichiers configureupdate.sh ou configureupdate.bat. Pour plus d'informations sur la spécification des valeurs pour les paramètres, reportez-vous au Section 36.0, Configuration des paramètres pour les applications d'identité.

  9. (Conditionnel) Dans une installation de type GUI, pour configurer immédiatement les applications d'identité, procédez comme suit dans la fenêtre Configurer IDM :

    1. Cliquez sur Oui, puis sur Suivant.

    2. Dans configuration du module de provisioning basé sur les rôles, cliquez sur Aff. options avancées.

    3. Modifiez les paramètres à votre convenance.

      REMARQUE :

      • Pour plus d'informations sur la spécification des valeurs, reportez-vous au Section 36.0, Configuration des paramètres pour les applications d'identité.

      • Dans les environnements de production, toutes les assignations d'administrateur sont limitées par les licences. NetIQ recueille des données de surveillance dans la base de données d'audit afin de vérifier que les environnements de production sont conformes. Par ailleurs, NetIQ recommande de n'octroyer les autorisations de l'administrateur de la sécurité qu'à un seul utilisateur.

    4. Cliquez sur OK.

  10. (Conditionnel) En cas d'installation par console, pour configurer immédiatement les applications d'identité, procédez comme suit :

    1. Lancez l'utilitaire de mise à jour de configuration à partir de la ligne de commande :

      • Linux : configupdate.sh

      • Windows : configupdate.bat

    2. (Facultatif) Pour créer le certificat NMAS, accédez à Clients SSO > RBPM, et définissez Configuration SAML RBPM à eDirectory sur Auto.

    3. Spécifiez des valeurs pour d'autres paramètres, comme décrit au Section 36.0, Configuration des paramètres pour les applications d'identité.

  11. Cliquez sur Suivant.

  12. Dans la fenêtre Résumé avant installation, cliquez sur Installer.

  13. (Facultatif) Consultez les fichiers journaux de l'installation. Pour les résultats de l'installation de base, reportez-vous au fichier user_application_install_log.log dans le répertoire /opt/netiq/idm/apps/UserApplication/logs/.

    Pour plus d'informations sur la configuration des applications d'identité, reportez-vous au fichier NetIQ-Custom-Install.log dans le répertoire /opt/netiq/idm/apps/UserApplication/.

  14. (Facultatif) Si vous utilisez un WAR de gestion des mots de passe externe, copiez-le manuellement dans le répertoire d'installation et dans le répertoire de déploiement du serveur d'applications distant qui exécute la fonction WAR de mot de passe externe.

  15. (Conditionnel) Si vous installez les applications d'identité sur JBoss EAP (Enterprise Application Platform), passez à la section Étapes de post-installation pour JBoss.

  16. (Conditionnel) Dans un environnement WebSphere, créez des propriétés JVM pour l'application utilisateur. Pour plus d'informations, reportez-vous à la Section 33.6.2, Ajout de fichiers de configuration de l'application utilisateur et des propriétés système JVM.

  17. Passez aux tâches post-installation décrites au Section 35.0, Fin de l'installation des applications d'identité.