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

REMARQUE :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. Vous devez appliquer les fichiers de stratégie non restreints au JDK IBM. Pour accéder à ces fichiers à partir IBM et savoir comment les appliquer, reportez-vous à la documentation de WebSphere. Appliquez ces fichiers à l'environnement JDK d'IBM avant de poursuivre l'installation. Le fichier JAR contenant les fichiers de stratégie non restreints doit être placé dans le dossier 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. Lancez le programme d'installation à partir de l'environnement Java d'IBM, comme décrit ci-après :

    Linux ou Solaris. 

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

    Windows. 

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

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

  4. 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

    Installation de l'application utilisateur

    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 :

  5. Aidez-vous des informations suivantes pour choisir un dossier d'installation et configurer la base de données :

    Écran d'installation

    Description

    Sélectionnez le dossier d'installation

    Indiquez l'emplacement auquel le programme d'installation doit mettre 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 :

    • Oracle

    • Microsoft SQL Server

    • IBM DB2

    • PostgreSQL

    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 DB2, 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

    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.

    Créer des tables de base de données

    Indiquez le moment auquel les tables de base de données doivent être créées :

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

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

    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 :

    Le programme d'installation doit se connecter à la base de données pour créer les tables directement et créer le fichier .SQL. Un échec au test de connexion à la base de données permet néanmoins de poursuivre l'installation. Dans ce cas, vous devrez créer les tables après l'installation, comme décrit dans le User Application: Administration Guide (Guide d'administration de l'application utilisateur).

  6. Aidez-vous des informations suivantes pour configurer Java et Identity Manager, 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

    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.

    Sélectionner le type de consignation de l'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 via un client 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 Identity Audit ou Novell Sentinel

    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.

  7. Si vous souhaitez configurer le module RBPM maintenant, sélectionnez Configurer maintenant, puis cliquez sur Suivant.

    (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 :

    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.

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

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

    Écran d'installation

    Description

    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 6.2.2, 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.