6.1 Installation et configuration du fichier WAR de l'application utilisateur

REMARQUE :pour WebSphere 6.1, le programme d'installation requiert le JDK IBM version 1.5 de la plate-forme Java 2 Standard Edition. Pour WebSphere 7.0, le programme d'installation requiert le JDK 1.6 d'IBM. Si vous utilisez une version différente, la procédure d'installation ne configurera pas correctement le fichier WAR de l'application utilisateur. L'installation semblera réussir, mais vous rencontrerez des erreurs lorsque vous tenterez de démarrer l'application utilisateur.

  1. Accédez au répertoire contenant vos fichiers d'installation.

  2. Lancez le programme d'installation à partir de l'environnement Java d'IBM, comme décrit ci-après :

    Solaris 

    $ /opt/WS/IBM/WebSphere/AppServer/java/bin/java -jar IdmUserApp.jar

    Windows 

    C:\WS\IBM\WebSphere\AppServer\java\bin\java -jar IdmUserApp.jar

    IMPORTANT :avec WebSphere, utilisez le JDK d'IBM sur lequel les fichiers de stratégie non restreints sont appliqués. Sans ces fichiers, l'erreur Taille de clé incorrecte sera générée. La première cause de ce problème est le manque de fichiers de stratégie non restreints. Veillez donc à utiliser le JDK d'IBM correct.

    Lors du lancement du programme d'installation, vous êtes invité à choisir une langue.

  3. Utilisez les informations suivantes pour sélectionner la langue, confirmer l'accord de licence et choisir la plate-forme du serveur d'applications :

    Écran d'installation

    Description

    Module de provisioning basé sur les rôles (RBPM) pour Novell Identity Manager

    Sélectionnez la langue du programme d'installation. La valeur par défaut est Français.

    Accord de licence

    Lisez l'accord de licence, puis sélectionnez J'accepte les termes de l'accord de licence.

    Plate-forme du serveur d'applications

    Sélectionnez WebSphere.

    Si le fichier WAR de l'application utilisateur est dans un répertoire différent du programme d'installation, ce dernier vous invite à saisir le chemin d'accès au WAR.

    Si le fichier WAR se trouve à l'emplacement par défaut, vous pouvez cliquez sur Restaurer le fichier par défaut. Ou, pour spécifier l'emplacement du fichier WAR, cliquez sur Choisir et sélectionnez un emplacement.

    Lorsque vous installez l'application sur WebSphere, vous devez lancer le programme d'installation à partir de l'environnement Java d'IBM. Si vous sélectionnez WebSphere comme serveur d'applications alors que vous n'utilisez pas l'environnement Java d'IBM pour lancer l'installation, vous recevez un message d'erreur et l'installation s'interrompt :

  4. Aidez-vous des informations suivantes pour sélectionner le type d'installation, choisir un dossier d'installation et configurer la base de données :

    Écran d'installation

    Description

    Type d'installation

    Provisioning basé sur les rôles : sélectionnez cette option pour installer le module de provisioning basé sur les rôles. Il s'agit du seul type d'installation pris en charge avec cette version.

    Sélectionnez le dossier d'installation

    Indiquez l'emplacement auquel le programme d'installation doit mette les fichiers.

    Plate-forme de la base de données

    Sélectionnez la plate-forme de la base de données. Vous devez avoir installé la base de données et le pilote JDBC. Pour WebSphere, les options sont les suivantes :

    • MySQL

    • Oracle (prend en charge Oracle 10g et 11g uniquement. Oracle 9i n'est plus pris en charge.)

    • Microsoft SQL Server

    • IBM DB2 (prend en charge la version 9.5 uniquement. La version 9.1 n'est plus prise en charge.)

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

    Hôte  : indiquez le nom d'hôte ou l'adresse IP du serveur de bases de données. Pour une grappe, indiquez le même nom d'hôte ou la même adresse IP pour chaque membre de la grappe.

    Port : indiquez le numéro du port d'écoute de la base de données. Pour une grappe, indiquez le même port pour chaque membre de la grappe.

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

    Nom de la base de données (ou SID) : pour MySQL, MS SQL Server ou PostgreSQL, indiquez le nom de votre base de données préconfigurée. Pour Oracle, donnez l'identificateur système Oracle (SID) que vous avez créé précédemment. Pour une grappe, indiquez le même nom ou SID de base de données pour chaque membre de la grappe.

    Nom d'utilisateur de la base de données : indiquez le nom d'utilisateur de la base de données. Pour une grappe, indiquez le même utilisateur de base de données pour chaque membre de la grappe.

    Mot de passe de la base de données : indiquez le mot de passe de la base de données. Pour une grappe, indiquez le même mot de passe de base de données pour chaque membre de la grappe.

    Fichier JAR du pilote de base de données : indiquez le fichier JAR du client léger pour le serveur de base de données. Ce paramètre est obligatoire.

    IMPORTANT :le bouton Parcourir en regard du champ Fichier JAR du pilote de base de données ne vous permet de sélectionner qu'un seul fichier JAR. Or, pour DB2, vous devez fournir 2 fichiers JAR :

    • db2jcc.jar

    • db2jcc_license_cu.jar

    Par conséquent, vous pouvez ne sélectionner qu'un seul fichier JAR mais vous devrez saisir le deuxième fichier manuellement. Pour cela, utilisez le séparateur de fichiers approprié pour le système d'exploitation sous lequel s'exécute le programme d'installation. Vous pouvez aussi spécifier manuellement les deux fichiers.

    Par exemple, sous Windows :

    c:\db2jars\db2jcc.jar;c:\db2jars\db2jcc_license_cu.jar

    Par exemple, sous Solaris et Linux :

    /home/lab/db2jars/db2jcc.jar:/home/lab/db2jcc_license_cu.jar

    Fichier de sortie SQL

    Dans cette version, les tables de base de données peuvent être créées au cours de l'installation de l'application utilisateur, plutôt qu'au lancement du serveur d'applications (comme c'était le cas dans les versions précédentes).

    L'écran Fichier de sortie SQL vous permet de créer un fichier de schéma que l'administrateur de base de données peut utiliser pour créer des tables (plutôt que de laisser le programme d'installation les créer).

    Si vous souhaitez générer un fichier de schéma, cochez la case Écrire le code SQL dans un fichier et indiquez un nom pour le fichier dans le champ Fichier de sortie du schéma.

    Administrateur de la base de données

    Cette page est préremplie avec les mêmes nom d'utilisateur et mot de passe que sur la page Nom d'utilisateur et mot de passe de la base de données. Si l'utilisateur de base de données spécifié précédemment ne possède pas les autorisations suffisantes pour créer des tables sur le serveur de base de données, alors vous devez indiquer l'ID d'un utilisateur possédant les droits requis.

    Mettre à jour la base de données ou en créer une nouvelle

    Si la base de données à utiliser est nouvelle ou vide, sélectionnez Nouveau. Si la base de données provient d'une installation précédente, sélectionnez Existant.

    Tester la connexion à la base de données

    Pour vérifier que les informations fournies dans les écrans précédents sont correctes, vous pouvez tester la connexion à la base de données en cochant la case Tester la connexion à la base de données :

  5. Aidez-vous des informations suivantes pour configurer Java et IDM ainsi que les paramètres d'audit et la sécurité.

    Écran d'installation

    Description

    Installation de Java

    Indiquez le dossier d'installation racine de Java. L'écran Installation de Java fournit le chemin d'accès à Java à partir de votre variable d'environnement JAVA_HOME et vous permet de le rectifier :

    À ce stade, le programme d'installation vérifie également que la plate-forme Java sélectionnée est appropriée pour le serveur d'applications spécifié. En outre, il vérifie qu'il peut éditer le fichier cacerts du JRE indiqué.

    Configuration d'IDM

    Sélectionnez le type de configuration du serveur d'applications :

    • Sélectionnez par défaut si cette installation est sur un noeud simple qui ne fait pas partie d'une grappe.

      Si vous sélectionnez par défaut et décidez que vous aurez besoin d'une grappe ultérieurement, vous devrez réinstaller l'application utilisateur.

    • Sélectionnez tout si cette installation fait partie d'une grappe.

    Contexte de l'application : noms de la configuration du serveur d'applications, du fichier WAR de l'application et du contexte de l'URL. Le script d'installation crée une configuration serveur et par défaut nomme la configuration en fonction du Nom de l'application. Notez le nom de l'application et ajoutez-le dans l'URL lorsque vous démarrez l'application utilisateur dans un navigateur.

    Consignation Audit

    Pour activer la consignation, cliquez sur Oui. Pour désactiver la consignation, cliquez sur Non.

    Le tableau de bord suivant vous invite à indiquer le type de consignation. Choisissez parmi les options suivantes :

    • Novell Identity Audit ou Novell Sentinel : permet d'activer la consignation Novell® pour l'application utilisateur.

    • OpenXDAS : les événements sont consignés sur votre serveur de consignation OpenXDAS.

    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 Audit

    Serveur : si vous activez la consignation, indiquez le nom d'hôte ou l'adresse IP du serveur. Si vous désactivez la consignation, cette valeur est ignorée.

    Dossier de cache des journaux : indiquez le répertoire du cache de consignation.

    Sécurité : clé principale

    Oui : vous permet d'importer une clé principale existante. Si vous choisissez d'importer une clé maîtresse codée existante, coupez et collez la clé dans la fenêtre de procédure d'installation.

    Non : crée une clé principale. Une fois l'installation terminée, vous devez enregistrer manuellement la clé maîtresse comme décrit dans la Section 9.1, Enregistrement de la clé maîtresse.

    La procédure d'installation inscrit la clé maîtresse codée dans le fichier master-key.txt dans le répertoire d'installation.

    Voici des raisons d'importer une clé principale existante :

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

    • Vous avez installé l'application utilisateur sur le premier membre d'une grappe et vous l'installez maintenant sur de nouveaux membres de la grappe (qui requièrent la même clé maîtresse).

    • En raison d'un disque défectueux, vous devez restaurer votre application utilisateur. Vous devez réinstaller l'application utilisateur et indiquer la même clé maîtresse codée que celle qu'utilisait l'installation précédente. Cela vous donne accès aux données codées stockées précédemment.

  6. Cliquez sur Suivant pour afficher le volet de configuration du module de provisioning basé sur les rôles. (Si le programme ne vous invite pas à saisir ces informations, vous n'avez peut-être pas suivi toutes les étapes définies à la Section 2.5, Installation du kit de développement Java.)

    La vue par défaut du volet de configuration du module de provisioning basé sur les rôles contient les six champs suivants :

    Le programme d'installation utilisera la valeur du champ DN du conteneur racine et l'appliquera aux valeurs suivantes :

    • DN du conteneur de l'utilisateur

    • DN du conteneur du groupe

    Le programme d'installation utilisera la valeur du champ Administrateur de l'application utilisateur et l'appliquera aux valeurs suivantes :

    • Administrateur du provisioning

    • Administrateur de conformité

    • Administrateur de rôles

    • Administrateur de la sécurité

    • Administrateur de ressources

    • Administrateur de la configuration RBPM

    Pour définir ces valeurs explicitement, vous pouvez cliquer sur le bouton Aff. options avancées et les modifier :

  7. Les informations suivantes permettent de terminer l'installation.

    Écran d'installation

    Description

    Configuration de l'application utilisateur

    Le programme d'installation de l'application utilisateur permet de configurer les paramètres de configuration de l'application utilisateur. La plupart de ces paramètres sont également éditables avec configupdate.sh ou configupdate.bat après l'installation ; les exceptions sont notées dans les descriptions des paramètres.

    Pour une grappe, indiquez les paramètres de configuration identiques de l'application utilisateur pour chaque membre de la grappe.

    Reportez-vous à l'Section A.0, Référence de configuration de l'application utilisateur IDM pour obtenir une description des options.

    Résumé pré-installation

    Lisez la page de résumé de la pré-installation pour vérifier vos paramètres d'installation.

    Si nécessaire, utilisez Retour pour retourner aux pages d'installation précédentes et modifier les paramètres d'installation.

    La page de configuration de l'application utilisateur ne sauvegarde pas de valeur. Une fois les pages précédentes de l'installation à nouveau spécifiées, vous devez saisir à nouveau les valeurs de configuration de l'application utilisateur. Lorsque vous êtes satisfait de vos paramètres d'installation et de configuration, retournez à la page Récapitulatif de pré-installation, puis cliquez sur Installer.

    Installation terminée

    Indique que l'installation est terminée.

6.1.1 Affichage des fichiers journaux d'installation

Si votre installation s'est terminée sans erreur, passez à la section Section 6.2.1, Ajout de fichiers de configuration de l'application utilisateur et des propriétés JVM.

Si l'installation a émis des messages d'erreur ou d'avertissement, examinez les fichiers journaux pour déterminer les problèmes :

  • Identity_Manager_User_Application_InstallLog.log contient les résultats des tâches d'installation de base

  • Novell-Custom-Install.log contient des informations sur la configuration de l'application utilisateur effectuée lors de l'installation.