
Configurez l'environnement JRE (Java™ Runtime
Environment), créez l'écouteur Oracle et le service Oracle Net, configurez Oracle en tant que récepteur de contenu Cognos, configurez l'instance
IBM® WebSphere Application Server pour gérer le serveur de rapport, créez et déployez les fichiers d'archive d'entreprise, et créez les entrepôts de données.
Pourquoi et quand exécuter cette tâche
Pour configurer le serveur de rapport :
Remarque : Les étapes 1 et 5 à 16 ne sont pas nécessaires si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- 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.
- Connectez-vous en tant qu'utilisateur DBA Oracle.
- 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 oinstall.oinstall /opt/ibm/RationalInsight/reportal/contentstore -R
- 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 :
[oinstall@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.
- Créez l'écouteur :
- Définissez la variable système ORACLE_SID=$SID,
où $SID est la base de donnée que vous avez créée à l'étape 1.
- Démarrez Oracle Net Manager.
- Développez les noeuds et sélectionnez Listeners.
Cliquez sur .
- Entrez le nom de l'écouteur et cliquez sur OK.
- Cliquez sur Add Address, puis indiquez l'hôte et le port pour Rational Insight
Data Services.
- Cliquez sur Add Database, entrez le nom de la base de données, le répertoire principal et le SID, puis cliquez sur .
- Démarrez l'écouteur à l'aide de la commande suivante :
lsnrctl start
- Créez le nom du service :
- Démarrez Oracle Net Configuration Assistant.
- Sélectionnez la configuration Local Net Service Name et cliquez sur Next.
- Sélectionnez Add et cliquez sur Next.
- Entrez le nom du service et cliquez sur Next.
- Sélectionnez un protocole et cliquez sur Next.
- Entrez le nom d'hôte et le port. Sélectionnez Yes,
perform a test, cliquez sur Next, modifiez les informations de connexion si nécessaire, assurez-vous que la connexion réussit le test.
- Entrez le nom du service Net et cliquez sur Next.
- Pour éviter tout problème de chiffrement, 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 :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Définissez la variable JAVA_HOME de sorte qu'elle pointe vers le dossier WebSphere Application Server JRE et ajoutez %JAVA_HOME%\bin au début du chemin d'accès système :
JAVA_HOME=[WASDIR]\java\jre
PATH=%JAVA_HOME%\bin;…
- Copiez le fichier [répertoire_installation_rational_insight]/cognos/bin/jre/1.5.0/lib/ext/bcprov-jdk14-134.jar dans le répertoire [répertoire_installation_websphere]/java/jre/lib/ext.
- Assurez-vous que les pilotes Oracle appropriés sont installés dans le répertoire [répertoire_installation_rational_insight]/cognos/webapps/p2pd/WEB-INF/lib :
- Oracle 10g: ojdbc14.jar
- Oracle 11g: ojdbc5.jar
- Supprimez le service IBM Cognos 8 basé sur Tomcat :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Démarrez la console d'administration de Cognos (exécutez 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 cliquez sur Close.
- Créez un nouveau récepteur de contenu dans Cognos pour référencer la base de données de contenu :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Démarrez la console d'administration de Cognos (exécutez cogconfig.sh sous /opt/ibm/RationalInsight/cognos/bin).
- Cliquez sur , cliquez à l'aide du bouton droit sur Content Store, puis cliquez .
- 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 un nom d'utilisateur et un mot de passe pouvant être utilisés pour 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 nécessaire si vous avez choisi d'installer WebSphere Application Server à l'aide du programme d'installation de Rational Insight.
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Si vous avez apporté des modifications à la configuration de Cognos,
redémarrez WebSphere Application Server.
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Configurez l'instance WebSphere Application Server pour héberger le serveur de rapport :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Ouvrez la console d'administration de WebSphere Application Server (ouvrez un navigateur pour pointer sur 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.
- 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 JVM 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.
- Créez et déployez le fichier d'archive d'entreprise du serveur de rapport :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Ouvrez la console d'administration de WebSphere Application Server (ouvrez un navigateur pour accéder à la page http://localhost:9060/ibm/console/).
- Sélectionnez Environnement et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server.
- Sélectionnez Portal Services et remplacez tous les ports 9300 par le numéro de port du profil WebSphere Application Server.
- Cliquez sur Sauvegarder, puis cliquez sur Fermer.
- Sélectionnez .
- Cliquez sur Suivant, acceptez les valeurs par défaut, puis cliquez sur Suivant.
- Cliquez sur Terminer, puis cliquez sur Fermer.
- Installez le fichier d'archive d'entreprise du serveur de rapport :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- Connectez-vous à la console d'administration de WebSphere Application Server (pointez le navigateur sur http://localhost:port/ibm/console/login.do,
et 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,
puis 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 l'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 : [WASDIR]\profiles\RationalInsight\installedApps\vega9Node01Cell\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://host: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 que la racine de contexte est help et cliquez sur Suivant.
- Dans la page Sélection des options d'installation,
cliquez sur Suivant.
- Dans la page Mappages des modules vers le 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 :
- Ouvrez l'application Web Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi.
- Ouvrez la page d'administration de Cognos ().
- 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 et 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 et 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 et cliquez sur OK.
- Importez les rapports exemples Rational Insight :
Remarque : Cette étape n'est pas nécessaire si vous avez choisi la méthode d'installation automatique pour installer le serveur de rapport.
- 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 Cognos à l'adresse http://host/cognos8/cgi-bin/cognos.cgi.
- 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 sur Next.
- Dans la zone Name, remplacez le nom Rational_Example_Reports par Rational_Reports, puis cliquez 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.
- Cliquez sur Run.
- Cliquez sur OK.
- Cliquez sur l'icône Home.
- 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 exemples définissent les correspondances par défaut pour tous les modèles et les données exemples 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 Quality Manager :
au niveau de la racine de REST Service
- Rational Team
Concert : 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 C:/Program Files/IBM/Rational Insight/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.
- Cliquez deux fois sur le groupe de ressources applicable, 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.
- Sélectionnez .
- Répétez les étapes e à g pour tous les groupes de ressources pour la source de données produit.
- Répétez les étapes b à h pour tous les autres produits.
- Testez les connexions aux sources de données Cognos pour l'entrepôt de données et les produits pris en charge :
- Démarrez la console d'administration de WebSphere Application Server. L'URL par défaut est http://localhost:9060/ibm/console/login.do.
- 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 à l'extrémité droite de la zone).
- Dans la zone Connection string, assurez-vous que SAMPLEDW est le nom de la base de données.
- Testez la connexion.
- Cliquez deux fois sur OK.
- Cliquez sur .
- Cliquez sur l'action Set properties pour la source de données produit, par exemple, ClearQuest.
- Cliquez sur Connection, sélectionnez la zone Connection
string, puis cliquez sur l'icône Edit (icône de crayon à l'extrémité droite de la zone).
- Cliquez deux fois sur OK.
- Lancez une série de tests sur les rapports exemples Rational Insight :
- Ouvrez l'application Web Cognos à l'adresse http://server:port/insight.
- Cliquez sur le dossier Définitions de rapport exemple.
- Exécutez les rapports.
- Créez un utilisateur pour accéder à la source de données :
- Ouvrez la page d'administration Cognos (cliquez sur IBM Cognos Administration ou si vous êtes dans la page d'accueil par défaut de IBM Cognos, cliquez sur ).
- Cliquez sur .
- Cliquez sur RIDW.
- Cliquez sur New Signon, entrez un nom, puis cliquez sur Next.
- 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.