Configuration du serveur de rapport : tâches pour DB2

Windows La procédure requise pour configurer la base de données DB2 pour le serveur de rapport dépend des options que vous avez choisies pour la fonction Serveur Insight durant l'installation. Vous devrez éventuellement créer la base de données de récepteur de contenu DB2, configurer l'instance IBM® WebSphere Application Server pour héberger le serveur de rapport, et créer, déployer et installer les fichiers d'archive d'entreprise (EAR).
Pourquoi et quand exécuter cette tâche
La liste suivante fournit la procédure à suivre pour configurer le serveur de rapport.
  1. Créez une base de données de récepteur de contenu : Vérifiez que vous, l'utilisateur en cours, disposez des privilèges d'administration requis pour créer des bases de données et leurs composants. L'utilisateur en cours est celui qui peut se connecter lors de l'exécution au récepteur de contenu. Si vous souhaitez que d'autres utilisateurs se connectent lors de l'exécution au récepteur de contenu, reportez- vous au instructions fournies dans le manuel IBM Cognos 8 Business Intelligence Installation and Configuration Guide.
    1. Accédez à la fenêtre de commande DB2 (sous Windows®, cliquez surDémarrer > Exécuter, entrez db2cw, puis cliquez sur OK).
    2. Accédez au répertoire C:\Program Files\ibm\Rational Insight\reportal\contentstore.
    3. Exécutez le fichier de commandes install.bat.
    4. Lorsque vous y êtes invité, indiquez les paramètres pour le récepteur de contenu. Pour afficher la liste des paramètres et leur explication, voir les liens connexes au bas de cette page.
  2. Copiez les pilotes DB2 suivants à partir du répertoire [répertoire_installation_DB2]/java/ vers le répertoire [répertoire_installation_rational_insight]/cognos/webapps/p2pd/WEB-INF/lib :
    • db2java.jar ou db2java.zip
    • db2jcc*.jar
    • db2policy.jar

    Si le fichier db2java.jar est absent et que le fichier db2java.zip est présent, renommez db2java.zip en db2java.jar.

  3. Créez un récepteur de contenu dans Rational Insight pour référencer la base de données de contenu DB2 :
    1. Accédez à la console d'administration de Cognos(sous Windows, cliquez sur Démarrer > Programmes > IBM Cognos 8 > Configuration IBM Cognos Configuration).
    2. Cliquez sur Data Access > Content Manager, cliquez à l'aide du bouton droit de la souris sur Content Store et cliquez sur New Resource > Database.
    3. Dans la zone Database name, entrez le nom de la base de données créée à l'étape 1.
    4. Sélectionnez la ligne User ID and password, cliquez sur l'icône Edit, et entrez un nom d'utilisateur et un mot de passe permettant d'accéder au récepteur de contenu de la base de données créé à l'étape 1.
    5. Sélectionnez Local Configuration, puis cliquez sur Save configuration.
  4. Créez une nouvelle instance WebSphere Application Server pour héberger le serveur de rapport. Cette étape n'est pas indispensable si vous avez choisi d'installer WebSphere Application Server à l'aide du programme d'installation de Rational Insight.
  5. Configurez l'instance WebSphere Application Server pour héberger le serveur de rapport :
    1. Ouvrez la console d'administration de WebSphere Application Server (ouvrez un navigateur pour accéder à la page http://localhost:9060/ibm/console/). Remplacez le port 9060 par un autre numéro de port s'il est différent du numéro que vous avez enregistré à partir de l'outil de gestion de profil de WebSphere Application Server.
    2. Développez le noeud Serveurs dans la barre de navigation de gauche, puis sélectionnez Serveurs d'applications.
    3. Cliquez sur le lien server1 et développez le noeud Gestion des processus et Java.
    4. Cliquez sur le lien Définition des processus, puis sur le lien Machine virtuelle Java.
    5. Entrez les tailles de pile JVM initiale et maximale 256 et 768.
    6. Cliquez sur Appliquer (au bas de la page), puis cliquez sur le lien Sauvegarder.
    7. Cliquez sur le lien Entrées d'environnement.
    8. Cliquez sur Nouveau et ajoutez la propriété suivante :

      LD_LIBRARY_PATH=[INSTALLDIR]\cognos\bin

    9. Cliquez sur OK, cliquez sur Nouveau et ajoutez la propriété suivante :

      PATH=[INSTALLDIR]\cognos\bin

    10. Cliquez sur Appliquer puis sur Sauvegarder.
    11. Ouvrez le panneau de configuration de Windows Services et redémarrez le service IBM WebSphere Application Server V6.1 – Rational Insight.
  6. Créez et déployez le fichier EAR de serveur de rapport :
    1. Accédez à la console d'administration de Cognos(sous Windows, cliquez sur Démarrer > Programmes > IBM Cognos 8 > Configuration IBM Cognos Configuration).
    2. Sélectionnez Environment et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server.
    3. Sélectionnez Portal Services et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server.
    4. Cliquez sur Save puis sur Close.
    5. Sélectionnez Actions > Build Application Files.
    6. Cliquez sur Next, acceptez les valeurs par défaut, puis cliquez sur Next.
    7. Cliquez sur Finish puis sur Close.
  7. Installez le fichier EAR du serveur de rapport :
    1. Connectez-vous à la console d'administration WebSphere Application Server (pointez le navigateur sur http://localhost:portnumber/ibm/console/login.do). Si vous y êtes invité, entrez vos nom d'utilisateur et mot de passe.
    2. Développez le noeud Applications dans la barre de navigation de gauche et sélectionnez Installation d'une nouvelle application.
    3. Cliquez sur Parcourir, accédez au dossier[répertoire_installation_rational_insight]/cognos et sélectionnez le fichier p2pd.ear.
    4. Acceptez les options par défaut et cliquez sur Suivant. Effectuez cette étape quatre fois.
    5. Cliquez sur le lien Sauvegarde, cliquez sur Applications d'entreprise dans la barre de navigation de gauche, et si l'application par défaut est répertoriée, désinstallez-la.
    6. Copiez les fichiers de contenu Web Cognos statiques à partir de [répertoire_installation_rational_insight]\cognos\webcontent\*.* dans le répertoire d'archive Web développé de l'application. Voici un exemple de répertoire d'archive Web : [répertoire_installation_WebSphere]\profiles\RationalInsight\installedApps\vega9Node01Cell\IBM Cognos 8.ear\p2pd.war.
    7. Sélectionnez l'application IBM Cognos 8 et cliquez sur Démarrer. Quelques minutes sont nécessaires pour que l'application se charge et démarre.
    8. Ouvrez un navigateur et pointez-le sur http://host:port/insight/servlet. Si Cognos Content Manager fonctionne correctement, un texte du type suivant s'affiche sur la page Web :
      IBM Cognos 8
      
      Content Manager
      
      Build: 8.4.2519.0
      
      Start time: Tuesday, November 18, 2008 3:00:41 PM PST
      
      Current time: Tuesday, November 18, 2008 3:01:25 PM PST
      
      State: Running.
    9. Pointez le navigateur Web sur http://server:port/insight. Vous devez voir la page d'accueil du portail Rational Insight.
  8. Déployez le fichier d'archive Web (WAR) pour accéder aux documents d'aide :
    1. Démarrez la console d'administration de WebSphere Application Server. L'URL par défaut est http://localhost:9060/ibm/console/login.do.
    2. Sélectionnez Applications > Installation d'une nouvelle application.
    3. Cliquez sur Parcourir et recherchez le fichier WAR INSIGHThelp.war. L'emplacement par défaut est C:\Program Files\IBM\Rational Insight\UA. Indiquez la racine de contexte help et cliquez sur Suivant.
    4. Dans la page Sélection des options d'installation, cliquez sur Suivant.
    5. Dans la page Mappage des modules vers les serveurs, cliquez sur Suivant.
    6. Dans la page Mappage des hôtes virtuels pour les modules Web, cliquez sur Suivant.
    7. Dans la page Récapitulatif, cliquez sur Terminer.
    8. Cliquez sur Sauvegarder.
  9. Installez l'habillage Rational Insight :
    1. Ouvrez l'application Web Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi.
    2. Ouvrez la page d'administration Cognos (Launch > IBM Cognos Administration).
    3. Cliquez sur l'onglet Configuration.
    4. Dans le panneau de navigation à gauche de l'écran, cliquez sur Styles.
    5. Cliquez sur New Style.
    6. Dans la zone Name, entrez Rational Insight, puis cliquez sur Next.
    7. Dans la zone Style resource location, entrez vega.
    8. Dans la zone Preview resource, entrez preview.htm.
    9. Cliquez sur Finish.
  10. Sélectionnez l'habillage Rational Insight :
    1. Ouvrez la page d'accueil de Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi.
    2. Cliquez sur My Area, puis sur My Preferences.
    3. Dans la zone Style, sélectionnez Rational Insight, puis cliquez sur OK.
  11. Définissez l'habillage Rational Insight comme l'habillage par défaut :
    1. Ouvrez la page d'accueil de Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi. Assurez-vous que vous disposez des droits d'administrateur.
    2. Cliquez sur Security.
    3. Cliquez sur Cognos.
    4. Cliquez sur l'icône Edit Default User Profile (à gauche du bouton de recherche).
    5. Cliquez sur Preferences.
    6. Dans la zone Style, sélectionnez Rational Insight, puis cliquez sur OK.
  12. Importez les rapports exemple Rational Insight :
    1. Copiez le fichier [répertoire_installation_rational_insight]\reportal\deployment\Rational_Example_Reports.zip dans le répertoire [répertoire_installation_rational_insight]\cognos\deployment\.
    2. Ouvrez l'application Web Cognos Web à l'adresse http://server:port/insight.
    3. Ouvrez la page d'administration Cognos (Launch > IBM Cognos Administration).
    4. Cliquez sur Configuration.
    5. Cliquez sur Content Administration, puis sur l'icône New Import.
    6. Vérifiez que Rational_Example_Reports est répertorié comme archive de déploiement, puis cliquez sur Next.
    7. Dans la zone Name, remplacez le nom Rational_Example_Reports par Rational_Reports, puis cliquez sur Next.
    8. Pour importer tous les packages et les dossiers, sélectionnez la zone dans l'en-tête du tableau, puis cliquez quatre fois sur Next.
    9. Cliquez sur Finish.
    10. Cliquez sur Run.
    11. Cliquez sur OK.
    12. Cliquez sur l'icône Home.
    13. Vérifiez que tous les packages et dossiers sont répertoriés dans Public Folders.
  13. Modifiez le fichier de configuration de données XML :
    Les fichiers de configuration de données exemple définissent les correspondances par défaut pour tous les modèles et les données exemple de chaque produit. Effectuez une sauvegarde de tous les fichiers de configuration de données XML exemple, puis modifiez-les en fonction de votre environnement. Les groupes de ressources sont définis aux niveaux suivants :
    • Rational RequisitePro : au niveau projet
    • Rational ClearQuest : au niveau de la base de données utilisateur
    • Rational ClearCase : au niveau de la vue
    • Rational TestManager : au niveau projet
    • Rational Quality Manager : au niveau de la racine de REST Service
    • Microsoft® Project : au niveau projet
    1. Démarrez XML Data Configuration (cliquez sur Démarrer > Programmes > IBM Rational Insight > XML Data Configuration).
    2. Cliquez sur File > Open Configuration, accédez au répertoire dans lequel sont situés les fichiers de configuration de données et ouvrez le fichier de configuration de données de produit ; par exemple, clearcase.xdc. L'emplacement par défait est le répertoire C:\Program Files\IBM\Rational Insight\dataconfig\configs\Configurations. Lorsque vous êtes invité à créer un projet ETL, cliquez sur OK.
    3. Dans l'explorateur de données XML, développez la structure arborescente jusqu'à ce que les groupes de ressources soient visibles (XML Data Configuration > Resource Category). Les groupes de ressources sont représentés par les icônes de source de données.
    4. Supprimez toutes les définitions de groupe de ressources qui ne sont pas applicables.
    5. Cliquez deux fois sur le groupe de ressources applicable, puis cliquez sur Edit.
    6. Dans la zone Data Service, entrez l'URL du groupe de ressource sur le serveur où IBM Rational Insight Data Services est installé.

      La syntaxe de l'URL est http://hôte:port/Data Services/Nom de l'adaptateur/nom de la ressource, où hôte est le nom du serveur Rational Insight Data Services, port est le port utilisé par Rational Insight Data Services, Data Services est le répertoire principal dans lequel Rational Insight Data Services est installé, Nom de l'adaptateur est le nom du produit pour la source de données et nom de la ressource est le nom de la ressource du produit.

      Par exemple : http://host:9088/DataServices/ClearQuest/ALM/SAMPL. Pour savoir comment rechercher l'URL du groupe de ressources, reportez-vous à la section Tâches générales pour les sources de produit.

    7. Sélectionnez File > Save.
    8. Répétez les étapes e à g pour tous les groupes de ressources pour la source de données produit.
    9. Répétez les étapes b à h pour tous les autres produits.
  14. Testez les connexions aux sources de données pour l'entrepôt de données et les produits Rational :
    1. Ouvrez l'application Web Rational Insight Web à l'adresse http://server:port/insight.
      Remarque : Si vous ne connaissez pas l'URL, reportez-vous au fichier [répertoire_installation_rational_insight]\AppServer\profiles\RationalInsight\logs\AboutThisProfile.txt.
    2. Ouvrez la page d'administration de Cognos (cliquez sur IBM Cognos Administration, ou si vous êtes dans la page d'accueil par défaut de Rational Insight, cliquez sur le lien Administration dans la bannière).
    3. Cliquez sur Configuration > Data Source Connections > RIDW.
    4. Cliquez sur l'action Set properties pour la source de données RIDW.
    5. Cliquez sur Connection, sélectionnez la zone Connection string et cliquez sur l'icône Edit (icône de crayon à l'extrémité droite de la zone).
    6. Dans la zone DB2 Connection string, assurez-vous que SAMPLEDW est le nom de la base de données et jdbc:db2://localhost:50000/SAMPLEDW la chaîne de connexion.
    7. Testez la connexion.
    8. Cliquez deux fois sur OK.
    9. Cliquez sur Configuration > Data Source Connections > NomProduitRational.
    10. Cliquez sur l'action Set properties pour la source de données produit, par exemple, ClearQuest.
    11. Cliquez sur Connection, sélectionnez la zone Connection string et cliquez sur l'icône Edit (icône de crayon à l'extrémité droite de la zone).
    12. Cliquez deux fois sur OK.
  15. Lancez une série de tests sur les rapports exemple Rational Insight :
    1. Ouvrez l'application Web Rational Insight à l'adresse http://server:port/insight.
    2. Cliquez sur le dossier Définitions de rapport exemple.
    3. Exécutez les rapports.
  16. Créez un utilisateur pour accéder à la source de données :
    1. Ouvrez la page d'administration de Cognos (cliquez sur Launch > IBM Cognos Administration ou si vous êtes dans la page d'accueil de Rational Insight, cliquez sur le lien Administration dans la bannière).
    2. Cliquez sur Configuration > Data Source Connections > RIDW.
    3. Cliquez sur RIDW.
    4. Cliquez sur New Signon, entrez un nom, puis cliquez sur Next.
    5. Entrez l'ID utilisateur et le mot de passe pour accéder à la source de données. Pour exécuter des rapports, un utilisateur doit disposer au minimum des privilèges de lecture sur la source de données.