
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 Insight Server 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.
Pourquoi et quand exécuter cette tâche
Pour configurer le serveur de rapport :
Remarque : Les étapes 2 à 13 sont requises uniquement si vous avez choisi la méthode d'installation manuelle.
- Configurez le serveur de rapport pour établir le connexion au récepteur de contenu en enregistrant les instances de base de données de sorte qu'elles soient démarrées automatiquement lors des réinitialisations du système :
- Exécutez la commande suivante :
db2iauto -on <nom de l'instance>
- Ouvrez le fichier /etc/inittab dans un éditeur.
- Recherchez la chaîne de code suivante :
fmc:2345:respawn:/opt/ibm/db2/V9.1/bin/db2fmcd #DB2 Fault Monitor Coordinator
- Déplacez cette chaîne de code pour la placer juste après la commande id:5:initdefault:.
- Créez une base de données de récepteur de contenu :
Remarque : Vérifiez que vous, l'utilisateur en cours, disposez des privilèges d'administration requis pour créer des bases de données et des conteneurs d'espace table. L'utilisateur en cours est celui qui peut se connecter lors de l'exécution au récepteur de contenu Cognos. Si vous souhaitez que d'autres utilisateurs se connectent lors de l'exécution au récepteur de contenu Cognos, reportez-vous au manuel IBM Cognos 8 Business Intelligence Installation
and Configuration Guide pour lire les instructions.
- Démarrez la fenêtre de commandes DB2 en utilisant un compte d'administrateur de base de données DB2 valide. Par défaut, l'utilisateur est db2inst1.
- Accédez au répertoire /opt/ibm/RationalInsight/reportal/contentstore.
- Connectez-vous en tant qu'utilisateur root à l'aide de la commande su.
Si vous y êtes invité, entrez le mot de passe root.
- Définissez les autorisations pour les fichiers et les dossiers à l'aide de la commande suivante :
chown db2inst1.db2iadm1 /opt/ibm/RationalInsight/reportal/contentstore -R
où db2inst1 est le propriétaire de l'instance DB2 et db2iadm1 le groupe DB2.
- Retournez à la console de l'administrateur de base de données et exécutez le script de shell install.sh à l'aide de la commande suivante :
[db2inst1@VEGAVM contentstore]$ ./install.sh
- 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.
- Développez le dossier Toutes les bases de données et vérifiez que la base de données que vous avez ajoutée y figure.
- Configurez l'environnement JRE (Java™ Runtime
Environment) de sorte que Cognos et le serveur de rapport s'exécutent sur la même instance JRE :
- Export JAVA_HOME=[WASDIR]/java/jre
- Export PATH=$JAVA_HOME/bin:…
- Copiez le fichier [INSTALLDIR]/cognos/bin/jre/1.5.0/lib/ext/bcprov-jdk14-134.jar dans le dossier [WASDIR]/java/jre/lib/ext.
- Assurez-vous que les pilotes DB2 suivants sont installés dans le répertoire [INSTALLDIR]/cognos/webapps/p2pd/WEB-INF/lib :
- db2java.jar
- db2jcc.jar
- db2jcc_license_cu.jar
- db2policy.jar
Si le fichier db2java.jar est absent et que le fichier db2java.zip est présent,
renommez le dossier db2java.zip en db2java.jar. Si le fichier db2jcc4.jar est présent, supprimez-le.
- Copiez le fichier libdb2.so du répertoire [INSTALLDIR DB2]/lib32
ou [INSTALLDIR DB2]//lib64 vers le répertoire /usr/local/lib.
- Supprimez le service IBM Cognos 8 basé sur Tomcat :
- Démarrez la console d'administration de Cognos (exécutez la commande cogconfig.sh sous /opt/ibm/RationalInsight/cognos/bin).
- Cliquez à l'aide du bouton droit de la souris sur le noeud IBM Cognos 8, sélectionnez Delete,
et cliquez sur Yes.
- Cliquez sur Save, puis sur Close.
- Créez un nouveau récepteur de contenu dans Rational Insight pour référencer la base de données de récepteur de contenu DB2 :
- Démarrez la console d'administration de Cognos (exécutez la commande cogconfig.sh sous /opt/ibm/RationalInsight/cognos/bin).
- Cliquez sur , cliquez à l'aide du bouton droit de la souris sur Content Store, puis cliquez sur .
- Dans la zone Database name, entrez le nom de la base de données créée à l'étape 1.
- Sélectionnez la ligne User ID and password, cliquez sur l'icône Edit, et entrez le nom d'utilisateur et le mot de passe permettant d'accéder au récepteur de contenu de la base de données créé à l'étape 1.
- Sélectionnez Local Configuration, puis cliquez sur Save configuration.
- 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.
- Configurez l'instance WebSphere Application Server pour héberger le serveur de rapport :
- Redémarrez WebSphere Application Server si vous avez modifié la configuration de Cognos.
- Ouvrez la console d'administration de WebSphere Application Server (ouvrez un navigateur Web pour accéder à l'adresse http://localhost:9060/ibm/console/).
Si 9060 n'est pas le numéro de port enregistré à partir de l'outil de gestion de profil de WebSphere Application Server, remplacez-le par un autre numéro de port.
- Connectez-vous à la console d'administration de WebSphere Application Server (pointez le navigateur sur http://localhost:portnumber/ibm/console/login.do,
puis entrez vos nom d'utilisateur et mot de passe).
- Développez le noeud Serveurs dans la barre de navigation de gauche, puis sélectionnez Serveurs d'applications.
- Cliquez sur le lien RationalInsightServer, puis développez le noeud Gestion des processus et Java.
- Cliquez sur le lien Définition des processus, puis cliquez sur le lien Java Virtual Machine.
- Entrez les tailles de pile initiale et maximale 256 et 768.
- Cliquez sur Appliquer (au bas de la page), puis cliquez sur le lien Sauvegarder.
- Cliquez sur le lien Entrées d'environnement.
- Cliquez sur Nouveau et ajoutez la propriété suivante :
LD_LIBRARY_PATH=[INSTALLDIR]/cognos/bin
- Cliquez sur OK, puis sur Nouveau
et ajoutez la propriété suivante :
PATH=[INSTALLDIR]/cognos/bin
- Cliquez sur Appliquer puis sur Sauvegarder.
- Redémarrez WebSphere Application Server.
- Créez et déployez le fichier d'archive d'entreprise du serveur de rapport :
- Démarrez la console d'administration de Cognos (exécutez la commande cogconfig.sh sous /opt/ibm/RationalInsight/cognos/bin).
- Sélectionnez Environment et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server, qui par défaut est 9080.
- Sélectionnez Portal Services et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server.
- Cliquez sur Save, puis sur Close.
- Sélectionnez .
- Cliquez sur Next, acceptez les valeurs par défaut, puis cliquez sur Next.
- Cliquez sur Finish puis sur Close.
- Installez le fichier d'archive d'entreprise du serveur de rapport :
- Connectez-vous à la console d'administration de WebSphere Application Server (pointez le navigateur sur http://localhost:portnumber/ibm/console/login.do,
puis entrez vos nom d'utilisateur et mot de passe).
- Développez le noeud Applications dans la barre de navigation de gauche et sélectionnez Installation d'une nouvelle application.
- Cliquez sur Parcourir, accédez au dossier[répertoire_installation_rational_insight]/cognos
et sélectionnez le fichier p2pd.ear.
- Acceptez les options par défaut et cliquez sur Suivant.
Effectuez cette étape quatre fois.
- Cliquez sur le lien Sauvegarde, cliquez sur Applications d'entreprise dans la barre de navigation de gauche et, si Application par défaut est répertoriée, désinstallez-la.
- 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/NODENAME/IBM
Cognos 8.ear/p2pd.war.
- 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.
- Ouvrez un navigateur et accédez à la page http://server: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.
- Pointez le navigateur Web sur http://server:port/insight.
Vous devez voir la page d'accueil du portail Rational Insight.
- Déployez le fichier d'archive Web (WAR) pour accéder aux documents d'aide :
- Démarrez la console d'administration de WebSphere Application Server (pointez votre navigateur sur http://localhost:9060/ibm/console/login.do).
- Sélectionnez .
- 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.
- Dans la page Sélection des options d'installation,
cliquez sur Suivant.
- Dans la page Mappage des modules vers les serveurs,
cliquez sur Suivant.
- Dans la page Mappage des hôtes virtuels pour les modules Web,
cliquez sur Suivant.
- Dans la page Récapitulatif, cliquez sur Terminer.
- Cliquez sur Sauvegarder.
- Installez l'habillage Rational Insight :
- Démarrez la console d'administration de WebSphere Application Server. L'URL par défaut est http://localhost:9060/ibm/console/login.do.
- Open the Cognos administration
page ().
- Cliquez sur l'onglet Configuration.
- Dans le panneau de navigation à gauche de l'écran, cliquez sur Styles.
- Cliquez sur New Style.
- Dans la zone Name, entrez Rational Insight, puis cliquez sur Next.
- Dans la zone Style resource location,
entrez vega.
- Dans la zone Preview resource,
entrez preview.htm.
- Cliquez sur Finish.
- Sélectionnez l'habillage Rational Insight :
- Ouvrez la page d'accueil de Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi.
- Cliquez sur My Area, puis sur My
Preferences.
- Dans la zone Style, sélectionnez Rational Insight, puis cliquez sur OK.
- Définissez l'habillage Rational Insight comme l'habillage par défaut :
- 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.
- Cliquez sur Security.
- Cliquez sur Cognos.
- Cliquez sur l'icône Edit Default User Profile (à gauche du bouton de recherche).
- Cliquez sur Preferences.
- Dans la zone Style, sélectionnez Rational Insight, puis cliquez sur OK.
- Importez les rapports exemple Rational Insight :
- 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/.
- Ouvrez l'application Web Rational Insight à l'adresse server:port/insight.
- Ouvrez la page d'administration de Cognos.
- Cliquez sur Configuration.
- Cliquez sur Content Administration, puis sur l'icône New Import.
- Vérifiez que Rational_Example_Reports est répertorié comme archive de déploiement, puis cliquez deux fois sur Next.
- Pour importer tous les packages et les dossiers, sélectionnez la zone dans l'en-tête du tableau, et cliquez quatre fois sur Next.
- Cliquez sur Finish, Run,
puis sur OK.
- Cliquez sur l'icône Home et vérifiez que tous les packages et dossiers sont répertoriés dans Public Folders.
- 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 ClearQuest : au niveau de la base de données utilisateur
- Rational ClearCase : au niveau de la vue
- Rational TestManager :
au niveau projet
- Rational Team
Concert : au niveau projet
- Rational Quality Manager :
au niveau projet
- Démarrez XML Data Configuration.
- Cliquez sur , accédez au répertoire dans lequel sont situés les fichiers de configuration de données, puis ouvrez le fichier de configuration de données produit, par exemple, clearcase.xdc. L'emplacement par défaut est le répertoire /opt/ibm/RationalInsight/dataconfig/configs/.
Lorsque vous êtes invité à créer un projet ETL, cliquez sur OK.
- Dans l'explorateur de données XML, développez la structure arborescente jusqu'à ce que les groupes de ressources soient visibles (). Les groupes de ressources sont représentés par les icônes de source de données. Supprimez toutes les définitions de groupe de ressources qui ne sont pas applicables.
- Sélectionnez le groupe de ressources applicable, cliquez à l'aide du bouton droit de la souris, puis cliquez sur Edit.
- Dans la zone Data Service, entrez l'URL du groupe de ressources sur le serveur où 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://hôte:9080/DataServices/ClearQuest/ALM/SAMPL. Pour savoir comment rechercher l'URL du groupe de ressources, reportez-vous à la section relative à la configuration des sources de produit pour Rational Insight
Data Services.
- Sélectionnez .
- Testez les connexions aux sources de données pour l'entrepôt de données et les sources de produit :
- Ouvrez l'application Web Rational Insight à l'adresse http://server:port/insight.
- Ouvrez la page d'administration de Cognos (cliquez sur ou si vous êtes dans la page d'accueil de Rational Insight,
cliquez sur le lien Administration dans la bannière).
- Cliquez sur .
- Cliquez sur l'action Set properties pour la source de données RIDW.
- Cliquez sur Connection, sélectionnez la zone Connection
string, puis cliquez sur l'icône Edit (icône de crayon à droite de la zone).
- Dans la zone DB2 Connection string,
assurez-vous que SAMPLEDW est le nom de la base de données et que jdbc:db2://localhost:50000/SAMPLEDW
est la chaîne de connexion. Cliquez sur Test the connection.
- Cliquez deux fois sur OK.
- Cliquez sur , où sourceproduit est le nom de la source de données de produit.
- Cliquez sur l'action Set properties pour la source de données de produit.
- Cliquez sur Connection, sélectionnez la zone Connection
string, puis cliquez sur l'icône Edit (icône de crayon à droite de la zone).
- Dans la zone Connection string,
indiquez les propriétés Signon, si nécessaire.
- Cliquez deux fois sur OK.
- Lancez une série de tests sur les rapports exemple Rational Insight :
- Ouvrez l'application Web Rational Insight à l'adresse http://server:port/insight.
- Cliquez sur le dossier Définitions de rapport exemple.
- Exécutez les rapports.