Inst CR Winux

IBM Cognos 8 Business Intelligence
GUIDE D'INSTALLATION ET DE CONFIGURATION
Informations sur le produit

Le prsent document s'applique IBM Cognos 8 Version 8.4 et peut aussi s'appliquer aux versions ultrieures de ce produit. Pour vrifier s'il existe une version plus rcente du document, visitez le site Web de Cognos Software Services (http://support.cognos.com).
Copyright
Copyright 2008 Cognos ULC (auparavant Cognos Incorporated). Cognos ULC est une socit d'IBM. Portions of Cognos ULC software products are protected by oneor more of the following U.S. Patents: 6,609,123 B1; 6,611,838 B1;6,662,188 B1; 6,728,697 B2; 6,741,982 B2; 6,763,520 B1; 6,768,995B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2; 6,986,135B2; 6,995,768 B2; 7,062,479 B2; 7,072,822 B2; 7,111,007 B2; 7,130,822B1; 7,155,398 B2; 7,171,425 B2; 7,185,016 B1; 7,213,199 B2; 7,243,106B2; 7,257,612 B2; 7,275,211 B2; 7,281,047 B2; 7,293,008 B2; 7,296,040B2; 7,318,058 B2; 7,325,003 B2; 7,333,995 B2. Cognos et le logo Cognos sont des marques de Cognos ULC (auparavant Cognos Incorporated) dans divers pays, dont les tats-Unis. IBM et le logo IBM sont des marques de la socit International Business Machines Corporation dans divers pays, dont les tats-Unis. Les autres noms de socits, de produits ou de services peuvent tre des marques ou marques de services d'autres socits. Bien que tout ait t mis en uvre pour assurer le caractre exact et complet des informations contenues dans le prsent document, il est possible que des erreurs typographiques ou des inexactitudes techniques subsistent. Cognos Incorporated ne peut tre tenu pour responsable des dommages ou pertes, quels qu'ils soient, pouvant dcouler de l'exploitation de ces informations. La date de publication figure ci-aprs. Cognos Incorporated se rserve le droit de modifier le contenu du prsent document sans pravis. Toute amlioration ou autre modification apporte aux informations contenues dans ce document sera consigne dans les ditions ultrieures. Ce document contient des informations qui sont la proprit exclusive de Cognos. Tous droits rservs. De plus, aucune partie de cette documentation ne peut tre copie, photocopie ou reproduite de quelque autre faon, enregistre dans un systme de stockage de donnes, transmise sous quelque forme ou par quelque moyen que ce soit, ou traduite, sans l'autorisation crite pralable de Cognos.
Table des matires

Introduction
13
Partie 1: IBM Cognos 8 Business Intelligence Chapitre 1: Nouveauts
17
Nouveauts de la version 8,4 17 Prise en charge des adresses IPv6 17 Masquage de l'espace-noms de la vue des utilisateurs durant la connexion 17 IBM Cognos Apache 2.2 Web Server 18 Fonctions modifies dans la version 8,4 18 IBM Cognos 8 Go! Office 18 IBM Cognos 8 Portal Services 18 Prise en charge multilingue des sources de donnes Microsoft Analysis Services 18 Fonctions obsoltes dans la version 8,4 18 Fonctions supprimes dans la version 8,4 18 Nouveauts de la version 8.3 19 IBM Cognos 8 Transformer 19 Tlchargement du programme d'installation de Transformer 8 19 Series 8 IQD Bridge 19 Proprit d'emplacement des archives 20 Portal Services pour Microsoft SharePoint 20 Prise en charge de Windows Vista 20 Fonctions modifies dans la version 8.3 20 IBM Cognos 8 Go! Office 20 Comportement des produits aprs une mise niveau 21 Installation de Transformer 21 Configuration de Transformer 21 Exemples IBM Cognos 8 22 Prsentations rapides d'IBM Cognos 8 22 Fonctions obsoltes dans la version 8.3 22 Configuration de Content Manager 22 Configuration du fichier cogformat.xml : avis de changement 22 Fonctions supprimes dans la version 8.3 23 Dploiement du client intelligent pour IBM Cognos 8 GO! Office 23 Chapitre 2: Composants utiliss par IBM Cognos 8 Composants du serveur 25 Composants de modlisation 28 Autres composants 28 Partie 2: Planification de l'installation Chapitre 3: Options de rpartition pour IBM Cognos 8
25
31
Rpartition des composants de cration de rapports d'IBM Cognos 8 31 Installation de tous les composants sur un mme ordinateur 32
Guide d'installation et de configuration 3
Table des matires Installation des passerelles sur diffrents ordinateurs 33 Installation des composants d'application et des applications Content Manager sur diffrents ordinateurs 34 Installation des produits d'IBM Cognos 8 sur le mme ordinateur 36 Rpartition des composants de Framework Manager 37 Rpartition des composants de Transformer 39 Rpartition des composants de cration de tableaux de bord IBM Cognos 8 42 Installation de tous les composants sur un mme ordinateur 43 Installation des passerelles sur diffrents ordinateurs 44 Installation des composants d'application et des applications Content Manager sur diffrents ordinateurs 45 Installation des produits d'IBM Cognos 8 sur le mme ordinateur 47 Rpartition des composants de Metric Designer 47 IBM Cognos 8 avec d'autres produits d'IBM Cognos 49 Produits d'IBM Cognos pouvant tre mis niveau vers IBM Cognos 8 50 Produits IBM Cognos Series 7 pouvant migrer vers IBM Cognos 8 51 Produits d'IBM Cognos fonctionnant avec IBM Cognos 8 52 Contenu IBM Cognos Series 7 pouvant tre cr nouveau dans IBM Cognos 8 54 Chapitre 4: Prparation de l'installation
57
Recommandation - Consultation du fichier Lisezmoi avant l'installation 58 tude des environnements pris en charge 58 Vrification de la configuration systme requise 58 Vrification des paramtres de port implicites d'IBM Cognos 8 60 Configuration de la connectivit la base de donnes Content Store 61 Configuration de la connectivit la base de donnes de cration de rapports 62 Configuration de la connectivit la base de donnes de la bibliothque d'indicateurs 63 Cration de la base de donnes Content Store 63 Configuration du client de base de donnes 69 Configuration de variables d'environnement sous UNIX pour la bibliothque d'indicateurs 72 Configuration de navigateurs Web 73 Configuration de connexions ODBC vers Sybase IQ ou Netezza 76 Configuration du routeur pour tester la disponibilit d'un distributeur 77 Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8 78 Partie 3: Installation et configuration Chapitre 5: Mise niveau vers IBM Cognos 8
79
Planification de la mise niveau 80 Consultation de la documentation 80 tude du site 81 Excution d'une mise niveau d'essai 83 Examen du passage l'environnement de production 84 Mise niveau partir d'IBM Cognos Series 7 84 Mise niveau depuis ReportNet, Metrics Manager ou des versions antrieures d'IBM Cognos 8 85 Mise niveau partir d'une version antrieure d'IBM Cognos 8 89 Migration de bases de donnes Apache Derby vers la base de donnes de contenu d'IBM Cognos 95
Table des matires Nouveaux noms de produits, de fichiers et de rpertoires aprs la mise niveau partir de ReportNet 96 Mise niveau de ReportNet vers IBM Cognos 8 98 Mise niveau l'aide de l'option de configuration silencieuse 104 Mise niveau de Metrics Manager vers IBM Cognos 8 105 Installation ou mise niveau d'autres produits 110 Excution simultane de ReportNet et d'IBM Cognos 8 110 Dsinstallation manuelle du service ReportNet sous Windows 112 Configuration de la publication de cubes Series 7 aprs mise niveau depuis ReportNet 113 Mise niveau d'IBM Cognos 8 Go! Office 114 Dsinstallation de l'ancienne version 115 Installation de Microsoft .NET Framework et de la nouvelle version d'IBM Cognos 8 Go! Office 115 Mise niveau des modles et des cubes Transformer 116 Prparation de modles dans IBM Cognos Series 7 Transformer 117 Importation de modles non scuriss dans IBM Cognos 8 Transformer 117 Mise niveau d'un cube scuris IBM Cognos Series 7 118 Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 121 Installation des composants serveur d'IBM Cognos 8 122 Mise jour de l'environnement Java 126 Configuration des proprits d'environnement 127 Activation de la scurit 127 Dfinition des proprits de connexion la base de donnes Content Store 128 Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification 130 Dmarrage des services IBM Cognos 8 132 Configuration du serveur Web 133 Installation des prsentations rapides 136 Test de l'installation et de la configuration 136 Configuration de l'environnement de sources de donnes ou de sources d'importation 137 Cration de la base de donnes de bibliothque d'indicateurs 140 Cration d'un pack d'indicateurs 144 Dsinstallation d'IBM Cognos 8 147 Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux 148 Dsinstallation d'IBM Cognos 8 sous Windows 149 Dsinstallation de la base de donnes de contenu d'IBM Cognos 150 Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
153
Installation et configuration de Content Manager 154 Installation des composants de Content Manager 156 Installation d'IBM Cognos 8 Metrics Manager 159 Mise jour de l'environnement Java 159 Dmarrez IBM Cognos Configuration. 160 Dfinition des proprits de connexion la base de donnes Content Store 160 Configuration des proprits d'environnement pour les ordinateurs Content Manager 164 Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification 166 Activation de la scurit 168 Dmarrage de Content Manager 168 Test de l'installation de Content Manager 169 Installation et configuration des composants d'application 169 Guide d'installation et de configuration 5
Table des matires Installation des composants d'application 169 Installation d'IBM Cognos 8 Metrics Manager 172 Dmarrez IBM Cognos Configuration. 172 Configuration des proprits d'environnement des ordinateurs des composants d'application 173 Dmarrage des composants d'application 174 Test des composants d'application 174 Installation et configuration de la passerelle 174 Installation des composants de la passerelle 175 Installation d'IBM Cognos 8 Metrics Manager 178 Dmarrez IBM Cognos Configuration. 178 Configuration des proprits d'environnement et de scurit des ordinateurs passerelle 179 Configuration du serveur Web 180 Installation des prsentations rapides 184 Test de la passerelle 185 Cration de la base de donnes de bibliothque d'indicateurs 185 Cration d'un pack d'indicateurs 189 Dsinstallation d'IBM Cognos 8 192 Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux 192 Dsinstallation d'IBM Cognos 8 sous Windows 193 Dsinstallation de la base de donnes de contenu d'IBM Cognos 194 Chapitre 8: Installation des composants d'IBM Cognos 8
197
Installation et configuration de Framework Manager 197 Paramtres implicites de Framework Manager 199 Installation de Framework Manager 199 Mise jour de l'environnement Java 200 Configuration des proprits d'environnement pour les ordinateurs Framework Manager 201 Configuration de l'environnement de sources de donnes pour Framework Manager 203 Configuration des proprits d'environnement pour les ordinateurs Framework Manager 206 Test de l'installation et de la configuration 208 Installation et configuration d'IBM Cognos 8 Transformer 209 Installation d'IBM Cognos 8 Transformer 209 Paramtres implicites d'IBM Cognos 8 Transformer 212 Configuration des ordinateurs IBM Cognos 8 Transformer 213 Configuration de l'environnement de sources de donnes pour Transformer 216 Test de l'installation et de la configuration 219 Installation et configuration de Metric Designer 219 Paramtres implicites de Metric Designer 221 Installation de Metric Designer 221 Configuration des proprits d'environnement des ordinateurs Metric Designer 222 Configuration de l'environnement de sources d'importation pour Metric Designer 223 Test de l'installation et de la configuration 227 Configuration et dploiement de client d'IBM Cognos 8 Go ! Office 227 Copie des fichiers client d'IBM Cognos 8 Go! Office dans un emplacement rseau central 228 Activation du support SSL pour l'interface HTTPS de PowerPlay 228 Activation de l'accs anonyme pour PowerPlay 229 Dploiement du client IBM Cognos 8 Go! Office 230
Table des matires Chapitre 9: Exemples
235
Exemples pour la socit Vacances et aventure 235 Le groupe de socits Vacances et aventure 236 Employs 238 Ventes et marketing 238 Base de donnes, modles et packs de la socit Vacances et aventure 239 Installation des exemples IBM Cognos 8 242 Configuration des exemples 244 Restauration des fichiers de sauvegarde des exemples de bases de donnes 244 Cration de connexions entre la source de donnes et les exemples de bases de donnes 247 Configuration des exemples de cubes de Microsoft Analysis Services 249 Configuration de l'exemple de cube Essbase 250 Cration de connexions la source de donnes vers des sources de donnes OLAP 251 Configuration de l'exemple de Metric Studio 253 Importation des exemples 255 Exemples de modles de bases de donnes 257 Exemple - Excution de l'exemple d'agent ELM Returns Agent avec des donnes modifies 258 Suppression des exemples de bases de donnes d'IBM Cognos 8 259 Partie 4: Personnalisation d'IBM Cognos 8 dans votre environnement Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 261 Dsactivation de l'accs anonyme 263 Restriction de l'accs l'espace-noms IBM Cognos 263 Configuration des composants d'IBM Cognos 8 pour Active Directory Server 264 Configuration d'un espace-noms Active Directory 264 Mise disposition des proprits d'utilisateur personnalises d'Active Directory pour les composants d'IBM Cognos 8 266 Activation de la communication scurise pour Active Directory Server 267 Inclusion ou exclusion de domaines l'aide des proprits avances 267 Activation du code d'accs unique entre Active Directory Server et les composants d'IBM Cognos 8 268 Configuration d'IBM Cognos 8 pour l'espace-noms IBM Cognos Series 7 270 Configuration d'un espace-noms IBM Cognos Series 7 270 Activation de la communication scurise pour le serveur d'annuaire utilis par l'espacenoms IBM Cognos Series 7 272 Activation du code d'accs unique entre IBM Cognos Series 7 et IBM Cognos 8 272 Espaces-noms IBM Cognos Series 7 et module d'extension IBM Cognos Series 7 Trusted Signon 272 Configuration d'IBM Cognos 8 pour l'utilisation d'un fournisseur d'authentification personnalis 275 Configuration d'un espace-noms d'authentification personnalis 275 Masquage de l'espace-noms de la vue des utilisateurs durant la connexion 276 Configuration des composants d'IBM Cognos 8 pour LDAP 276 Configuration d'un espace-noms LDAP 278 Configuration d'un espace-noms LDAP pour Active Directory Server 279 Configuration d'un espace-noms LDAP pour IBM Directory Server 282 Configuration d'un espace-noms LDAP pour Novell Directory Server 285
Table des matires Configuration d'un espace-noms LDAP pour Sun Java System Directory Server 287 Mise disposition des proprits d'utilisateur personnalises de LDAP pour les composants d'IBM Cognos 8 290 Activation de la communication scurise pour le serveur LDAP 290 Activation du code d'accs unique entre LDAP et les composants d'IBM Cognos 8 292 Opration de remplacement 292 Configuration des composants d'IBM Cognos 8 pour eTrust SiteMinder 293 Configuration d'un espace-noms Netegrity SiteMinder 295 Activation de la communication scurise pour l'annuaire d'utilisateurs eTrust SiteMinder 296 Activation du code d'accs unique entre eTrust SiteMinder et IBM Cognos 8 296 Protection de l'alias Web IBM Cognos 296 Masquage de l'espace-noms de la vue des utilisateurs durant la connexion 297 Configuration des composants d'IBM Cognos 8 pour un espace-noms NTLM 297 Configuration d'un espace-noms NTLM 297 Activation du code d'accs unique entre NTLM et les composants d'IBM Cognos 8 298 Configuration d'IBM Cognos 8 pour l'utilisation de SAP 299 Configuration d'un espace-noms SAP 300 Activation du code d'accs unique entre SAP et IBM Cognos 8 301 Test des espaces-noms 302 Suppression d'un fournisseur d'authentification 302 Chapitre 11: Options de configuration
305
Dmarrez IBM Cognos Configuration 306 Modification des paramtres de configuration implicites 306 Modifier l'utilisateur et le mot de passe implicites pour la base de donnes de contenu d'IBM Cognos 307 Modification d'un URI 309 Configuration des paramtres cryptographiques 311 Configuration des composants d'IBM Cognos 8 pour IBM Cognos Application Firewall 314 Configuration des proprits des fichiers temporaires 316 Configuration de la passerelle pour l'utilisation d'un espace-noms 316 Activation et dsactivation de services 317 Dfinition des ressources du service IBM Cognos 8 318 Configuration des polices 319 Modification de la police implicite pour les rapports PDF 321 Configuration des polices incorpores pour les rapports PDF 322 Enregistrement d'une version de rapport 323 Modification de l'emplacement des graphiques type Carte pour Report Studio 325 Configuration du protocole SSL 325 Configuration du protocole SSL pour IBM Cognos 8 326 Configuration de la scurit partage entre les serveurs IBM Cognos et d'autres serveurs 328 Slection et classement des algorithmes de chiffrement (ciphersuites) pour SSL 329 Activation du protocole SSL sur le serveur Web 330 Configuration des messages de journalisation 332 Destination des messages de journalisation 333 Configuration du client de base de donnes pour une base de donnes de journalisation 335 Indication de la destination des messages de journalisation 336 Modification des paramtres globaux 338
Table des matires Personnalisation de la prise en charge linguistique de l'interface utilisateur 339 Personnalisation de la prise en charge de la monnaie 340 Personnalisation de la prise en charge des paramtres rgionaux du contenu 342 Mise en correspondance des paramtres rgionaux (contenu) 343 Mise en correspondance des langues du produit 345 Personnalisation du fuseau horaire du serveur 346 Modification de l'encodage pour les courriers lectroniques 346 Personnalisation des tmoins (cookies) 348 Changement de passerelle 349 Configuration de la passerelle pour le module IBM Cognos Apache Web Server 350 Configuration de la passerelle du servlet 352 Modification de la version de l'adresse IP 354 Configuration d'IBM Cognos 8 pour une utilisation avec d'autres produits d'IBM Cognos 354 Activation des rapports et agents programms pour les sources de donnes d'IBM Cognos Planning Contributor 355 Mise jour des proprits d'emplacement des fichiers sous Windows Vista 355 Configuration d'un systme de contrle de la source 357 Configuration d'IBM Cognos 8 Transformer 358 Mise jour des prfrences implicites pour Windows Vista 358 Ajout de sources de donnes IBM Cognos Series 7 Transformer 359 Cration d'un emplacement d'installation rseau pour les modlisateurs Transformer 360 Exportation des donnes de configuration pour les modlisateurs Transformer 361 Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs 362 Chapitre 12: Configuration de Cognos Portal Services
365
Indication de l'emplacement du fichier Applications.xml 365 Configuration de la scurit de Cognos Portal Services 366 Dsactivation de l'accs anonyme aux composants d'IBM Cognos 8 367 Activation du code d'accs unique avec le secret partag 367 Activation du code d'accs unique pour SAP EP avec le permis de connexion SAP 373 Activation du code d'accs unique pour SAP EP avec mise en correspondance des utilisateurs 373 Activation de la communication scurise entre le portail SAP EP et les composants d'IBM Cognos 8 375 Activation du code d'accs unique pour le portail WebSphere l'aide du serveur d'application 375 Activation du code d'accs unique pour le portail BEA ALUI l'aide de l'authentification de base 376 Activation du code d'accs unique pour le portail BEA ALUI l'aide de SiteMinder 376 Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat
379
Cration d'une instance JVM spare 380 Vrification de la configuration des composants d'IBM Cognos 381 Sauvegarde des informations IBM Cognos 382 Dfinition des variables d'environnement 383 Mise jour de l'environnement Java 384 Configuration des composants d'IBM Cognos pour une excution dans le serveur d'application 385 Identifier la version de JDK pour WebLogic 9 sur AIX 387 Modification du script de dmarrage du serveur d'application 387 Guide d'installation et de configuration 9
Table des matires Configuration des proprits du serveur d'application et dploiement des composants d'IBM Cognos 390 Activation du protocole SSL 397 Configuration du serveur Web 398 Annulation de l'inscription des distributeurs 398 Importation des donnes de la base de donnes Content Store 399 Mise niveau vers IBM Cognos 8 dans un environnement de serveur d'application 399 Mise niveau de Metrics Manager vers IBM Cognos 8 dans un environnement de serveur d'application 400 Chapitre 14: Options de configuration avances
401
Changement du type de JVM utilise par IBM Cognos 8 401 Changement de la version de Java Runtime Environment utilise par les composants d'IBM Cognos 8 402 Sauvegarde des informations IBM Cognos 402 Mise jour de l'environnement Java 404 Importation des donnes de la base de donnes Content Store 405 Configuration des composants d'IBM Cognos 8 pour l'utilisation d'une autre autorit de certification 405 Cration de cls et de demandes de signature de certificat 405 Configuration des composants d'IBM Cognos 8 excuter avec une autre autorit de certification 409 Chapitre 15: Excution d'une installation et d'une configuration sans surveillance Excution d'une installation sans surveillance 411 Excution d'une configuration sans surveillance 415 Partie 5: Mise jour Chapitre 16: Gestion des performances
411
417
Indicateurs de performances du systme 417 Activation des services requis uniquement 417 Mise au point d'un Content Store DB2 421 Mise au point des paramtres Apache Tomcat 421 Augmentation de la capacit de traitement des demandes pour la base de donnes de contenu d'IBM Cognos 422 Amlioration des performances de la bibliothque d'indicateurs 423 Rduction du dlai de diffusion pour les rapports sur un rseau 423 Augmentation du dlai d'attente asynchrone dans les environnements forte charge utilisateur 423 Partie 6: Annexes Annexe A: Configuration manuelle d'IBM Cognos 8
425
Configuration manuelle d'IBM Cognos 8 sous UNIX et Linux 425 Modification manuelle des paramtres de configuration implicites sur les ordinateurs UNIX et Linux 426 Modification manuelle des paramtres globaux sur les ordinateurs UNIX et Linux 429 Dmarrage et arrt d'IBM Cognos 8 en mode silencieux sur des ordinateurs UNIX et Linux 431 Cration manuelle du fichier d'application d'IBM Cognos 432
10
Table des matires Annexe B: Dpannage
437
Fichiers journaux 437 Problmes de dmarrage d'IBM Cognos 8 439 Erreur CFG-ERR-0106 lors du dmarrage du service IBM Cognos 8 dans IBM Cognos Configuration 440 Erreur de chiffrement lors du dmarrage d'IBM Cognos 8 441 chec du dmarrage du service IBM Cognos 8 car le port est utilis par un autre processus 442 Le service IBM Cognos 8 ne dmarre pas ou choue aprs le dmarrage 443 Le serveur IBM Cognos 8 ne dmarre pas mais ne renvoie aucun message d'erreur 443 Non-disponibilit du serveur IBM Cognos BI lors du dmarrage d'IBM Cognos 8 443 chec de la connexion un espace-noms lors de l'utilisation d'IBM Cognos Connection (Erreur PRSCSE1255) 448 chec du redmarrage des services d'IBM Cognos 8 aprs une panne de rseau 448 Aucun avertissement pour indiquer que la version antrieure de Content Store sera mise jour automatiquement lors de l'installation d'une version plus rcente d'IBM Cognos 8 448 chec du tlchargement des ressources 449 Erreur SQL1224N retourne par DB2 en cas de connexion depuis AIX 449 Erreur de Content Manager lors du dmarrage d'IBM Cognos 8 449 DPR-ERR-2014 Une erreur s'affiche dans le fichier journal sur l'ordinateur Content Manager 450 La prsence de caractres non ASCII dans le rpertoire d'installation entrane des erreurs d'excution 450 Impossible d'ouvrir un cube MS ou Cognos 450 Impossible d'ouvrir une source de donnes OLAP 451 Page introuvable lors du dmarrage d'IBM Cognos 8 sous Windows 2003 451 La page ne s'affiche pas l'ouverture du portail aprs avoir install IBM Cognos 8 452 L'erreur DPR-ERR-2058 s'affiche dans le navigateur Web lors du dmarrage d'IBM Cognos 8 452 Erreur EBA-090034 au dmarrage de WebLogic 8 454 Report Studio ne dmarre pas 454 L'erreur DPR-ERR-2022 s'affiche dans le navigateur Web lors du dmarrage d'IBM Cognos 8 455 chec du tlchargement du fichier cognos.xts 455 chec du script de dmarrage d'un serveur d'application 456 Problmes avec IBM WebSphere 6.0 sous AIX 5.3 456 chec de l'excution d'IBM Cognos 8 sous WebLogic Application Server sur AIX 456 chec du dploiement d'IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere 456 Non-fonctionnement du type de rapport multipage Microsoft Excel 2000 457 Impossible de dsrialiser l'attribut contextuel lors du dploiement du fichier p2pd.war vers WebLogic 458 Une erreur s'affiche aprs la mise niveau d'IBM Cognos 8 sur un serveur d'application WebLogic 458 Les caractres chinois, japonais et coren sont diffrents aprs la mise jour 458 Les caractres accentus ou deux octets risquent de ne pas s'afficher correctement lors de l'installation d'IBM Cognos 8 sous Linux 459
Table des matires L'erreur RSV-SRV-0066 indiquant qu'un incident soap a t renvoy ou l'erreur RQP-DEF0114 indiquant que l'utilisateur a annul la demande s'affiche dans les environnements forte charge d'utilisateurs. 459 Problmes de configuration d'IBM Cognos 8 459 Excution de scripts de nettoyage de base de donnes 460 Erreur de chiffrement lors de l'enregistrement de la configuration 462 Problmes de gnration de cls cryptographiques dans IBM Cognos Configuration 463 CAM-CRP-1315 Erreur lors de l'enregistrement de la configuration 463 Le changement manuel du nom du rpertoire d'installation a une incidence sur les installations s'excutant sous un serveur d'application 464 Les donnes de configuration sont verrouilles par une autre instance d'IBM Cognos Configuration 464 Echec de sortie d'une squence de tabulations en cas de navigation l'aide du clavier dans IBM Cognos Configuration 465 chec de l'enregistrement de la configuration 465 Erreur Java lors du dmarrage d'IBM Cognos Configuration 465 Erreur de chiffrement lors du dmarrage d'IBM Cognos Configuration 466 Paramtres de configuration actuels non appliqus l'ordinateur 466 CM-CFG-029 Une erreur s'est produite en tentant d'enregistrer un configuration qui indique que la source de donnes est de type SQL Server 467 DPR-ERR-2079 Quand Content Manager est configur pour la reprise 467 Les utilisateurs sont invits fournir les rfrences d'identification Active Directory 467 Police introuvable au dmarrage d'IBM Cognos Configuration sous UNIX 468 Impossible de charger la bibliothque Essbase/DB2 OLAP dans Framework Manager 468 Une adhsion un groupe manque dans l'espace-noms Active Directory 469 Dploiement d'IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere 470 Erreurs affiches lors du dploiement vers le serveur d'application Oracle 10G 470 Erreur de page introuvable lors de l'excution de rapports l'aide d'IBM Cognos 8 Go! Office 471 Erreur d'initialisation de la base de donnes Content Store d'Oracle aprs une mise niveau partir de ReportNet 471 Erreur de dlai d'attente d'un script CGI lors de la connexion aux composants d'IBM Cognos 8 par le biais d'un navigateur Web 471 chec du chargement de la classe de servlets dans WebLogic 472 Les icnes du bureau ou la fentre IBM Cognos Configuration scintillent sous Windows 473 Glossaire Index
475
481
12
Introduction
Ce document est destin tre utilis avec IBM Cognos 8. IBM Cognos 8 est un produit Web qui intgre des fonctionnalits d'excution de rapports, d'analyse, de cration de tableaux de bord et de gestion d'vnements. Ce guide contient des instructions d'installation, de mise niveau, de configuration et de test d'IBM Cognos 8, ainsi que des instructions relatives au changement des serveurs d'application et la dfinition des exemples.
Public concern
Pour utiliser ce manuel, vous devez matriser : les concepts lis la cration de rapports, les concepts lis la cration de tableaux de bord, les concepts de base de donnes et d'entrept de donnes, les problmes de scurit, l'administration de base de Windows et UNIX, l'environnement serveur existant et l'infrastructure de scurit de votre socit.
Documentation connexe
Notre documentation comprend des guides d'utilisation, des guides de dmarrage, des guides sur les nouveauts, des fichiers Lisezmoi et des informations complmentaires destins rpondre aux besoins des diffrents utilisateurs. Les documents suivants contiennent des informations connexes et peuvent tre mentionns dans le prsent manuel. Remarque : Pour les utilisateurs qui affichent ce document en ligne, une page Web du type La page est introuvable peut s'afficher pour certains liens du tableau ci-dessous. Les documents sont compatibles avec votre configuration spcifique. Si un lien n'est pas disponible, vous pouvez accder au document correspondant via le site Web Cognos Software Services (http://support.cognos.com). Les rfrences d'identification pour la connexion sont disponibles soit auprs de votre administrateur, soit en envoyant une demande l'adresse cogcsslo@ca.ibm.com.
Document
Description
IBM Cognos 8 - Guide d'admi- Gestion des serveurs, de la scurit, des rapports et des services nistration et de scurit de portail ; configuration des exemples d'IBM Cognos ; dpannage ; personnalisation d'IBM Cognos 8 Guide de l'utilisateur d'IBM Cognos Configuration Utilisation d'IBM Cognos Configuration pour configurer IBM Cognos 8
Introduction
Document
Description
IBM Cognos 8 Architecture and Prsentation de l'architecture d'IBM Cognos 8, laboration de Deployment Guide stratgies d'installation, prise en compte des considrations de scurit et optimisation des performances Framework Manager User Guide Cration et publication des modles dans Framework Manager
Guide de l'utilisateur de Metric Cration d'applications de cration de tableaux de bord et suivi Studio des indicateurs qu'ils contiennent Metrics Designer User Guide Cration d'extraits permettant de mettre en correspondance des informations et de les transfrer de sources de donnes relationnelles et dimensionnelles vers Metric Studio Utilisation d'IBM Cognos 8 Go! Office pour extraire le contenu des produits d'excution de rapports IBM Cognos dans Microsoft Office Modlisation et cration de cubes l'aide de scripts MDL (Model Definition Language)
Guide de l'utilisateur d'IBM Cognos 8 Go! Office
IBM Cognos 8 Transformer Guide de l'utilisateur
IBM Cognos 8 and Composite Installation, configuration et utilisation du module Composite Information Server Getting Information Server avec IBM Cognos 8 et Framework Manager ; Started donne accs des sources d'informations rparties
Recherche d'informations
Pour obtenir la documentation la plus rcente sur les produits, y compris tous les documents localiss, accdez au site Web Cognos Software Services (http://support.cognos.com). Cliquez sur le lien Documentation pour accder la documentation. Cliquez sur le lien Knowledge Base pour accder l'ensemble de la documentation, des documents techniques et des supports multimdias. La documentation sur les produits est disponible dans l'aide en ligne partir du menu ou du bouton Aide des produits IBM Cognos. Vous pouvez galement tlcharger la documentation au format PDF partir du site Web Cognos Software Services. Vous pouvez galement consulter la version PDF des fichiers Lisezmoi des produits et les guides d'installation directement partir des CD-ROM fournis par IBM Cognos.
Utilisation des prsentations rapides

Les prsentations rapides sont des didacticiels en ligne de courte dure qui illustrent les fonctions cls des composants des produits IBM Cognos. Pour afficher une prsentation rapide, lancez IBM Cognos Connection et cliquez sur le lien Prsentation rapide dans l'angle infrieur droit de la page d'accueil.
14
Introduction
Obtenir de l'aide
Pour en savoir davantage sur l'utilisation de ce produit ou pour obtenir une assistance technique, consultez le site Web Cognos Software Services (http://support.cognos.com). Ce site Web fournit des informations sur les produits, des services, des forums d'utilisateurs, ainsi qu'une base de connaissances de supports de documentation et multimdias. Pour faire une demande de service, accdez la section IBM Cognos Insight!, l'adresse http://support.cognos.com/en/support/insight. Pour des questions gnrales, contactez votre bureau local Cognos Software Services. Les coordonnes sont disponibles l'adresse http://support.cognos.com/en/support/about/contact.html. Pour en savoir davantage sur les formations, cliquez sur le lien Training.
Impression de documents protgs par les droits d'auteur

Vous pouvez imprimer des pages prcises, une section ou l'intgralit d'un manuel. IBM Cognos vous concde une licence non exclusive et non transfrable du droit d'utilisation, de copie et de reproduction des publications protges par copyright, au format lectronique ou papier, uniquement aux fins d'utilisation et d'entretien du logiciel IBM Cognos, et de formation interne sur ce dernier.
Introduction
16
Chapitre 1: Nouveauts
Cette section contient la liste des nouvelles fonctionnalits de cette version, ainsi que des fonctions qui ont t modifies, qui sont dsormais obsoltes ou qui ont t supprimes. Vous pourrez ainsi plus facilement planifier vos mises niveau et vos stratgies de dploiement d'application, ainsi que les critres de formation requis pour vos utilisateurs. Pour en savoir davantage sur la mise niveau, reportez-vous au Guide d'installation et de configuration de votre produit. Pour en savoir davantage sur les autres nouveauts de cette dition, reportez-vous au Guide des nouveauts. Pour prendre connaissance des changements apports aux versions prcdentes, reportez-vous la section : Nouveauts de la version 8.3 Fonctions modifies dans la version 8.3 Fonctions obsoltes dans la version 8.3 Fonctions supprimes dans la version 8.3
Pour consulter une liste jour des environnements pris en charge par les produits IBM Cognos, tels que les systmes d'exploitation, les correctifs, les navigateurs, ainsi que les serveurs Web, d'annuaire, de bases de donnes et d'applications, consultez le site Web Cognos Software Services (http://support. cognos.com).
Nouveauts de la version 8,4

La liste ci-dessous rpertorie toutes les nouveauts ajoutes depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes.
Prise en charge des adresses IPv6

IBM Cognos 8 prend maintenant en charge deux types d'adresses IP : IPv4 et IPv6. IPv4 utilise des adresses IP 32 bits et IPv6 des adresses IP 128 bits. La valeur implicite est IPv6, avec autorisation des adresses IP mises en correspondance avec IPv4. Pour en savoir davantage, reportez-vous la section "Modification de la version de l'adresse IP" (p. 354).
Masquage de l'espace-noms de la vue des utilisateurs durant la connexion

Vous avez maintenant la possibilit de masquer des espaces-noms de la vue des utilisateurs durant la connexion. Vous pouvez ainsi disposer d'espaces-noms de codes d'accs scuriss sans qu'ils apparaissent dans la liste de slection des espaces-noms qui s'affiche lors de la connexion des utilisateurs. Pour en savoir davantage, reportez-vous la section "Masquage de l'espace-noms de la vue des utilisateurs durant la connexion" (p. 276).
IBM Cognos Apache 2.2 Web Server

IBM Cognos 8 prend maintenant en charge les serveurs Web Apache 2.2.
Fonctions modifies dans la version 8,4

La liste ci-dessous rpertorie toutes les modifications apportes aux fonctionnalits depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes.
IBM Cognos 8 Go! Office

Dans les prcdentes versions, le programme d'installation copiait automatiquement les fichiers de configuration d'IBM Cognos 8 Go! Office dans le dossier emplacement_c8\webcontent\coc lors de l'installation des composants serveur. Aprs l'installation, l'administrateur copiait la configuration IBM Cognos 8 Go! Office dans un emplacement accessible aux utilisateurs en vue de l'installation du logiciel IBM Cognos 8 Go! Office sur leurs clients Windows. Dans cette version, les fichiers d'installation du client IBM Cognos 8 Go! Office ne sont plus copis automatiquement sur le serveur. Le client peut tre install l'aide du CD IBM Cognos 8 Go! Office fourni avec IBM Cognos 8 (p. 227).
IBM Cognos 8 Portal Services

Le portail Plumtree est remplac par le portail BEA AquaLogic User Interaction (ALUI). Pour en savoir davantage, reportez-vous la section "Configuration de Cognos Portal Services" (p. 365).
Prise en charge multilingue des sources de donnes Microsoft Analysis Services

Les utilisateurs travaillant dans diffrentes langues peuvent dsormais se connecter une source de donnes MSAS 2005 partir d'une seule instance d'IBM Cognos 8. Pour en savoir davantage, reportez-vous : "Configuration de l'environnement de sources de donnes ou de sources d'importation" (p. 137) "Configuration de l'environnement de sources de donnes pour Framework Manager" (p. 203) "Configuration de l'environnement de sources de donnes pour Transformer" (p. 216)
Fonctions obsoltes dans la version 8,4

Une fonction est dite obsolte lorsqu'elle est remplace par une version plus rcente ou par une mise en uvre mieux adapte. Le but est de suspendre l'utilisation de cette fonction et de fournir des recommandations concernant l'adaptation ce changement dans plusieurs ditions. La liste ci-dessous rpertorie les fonctions obsoltes, ainsi que des liens vers des rubriques connexes.
Fonctions supprimes dans la version 8,4

La liste ci-dessous rpertorie toutes les fonctionnalits supprimes depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes. 18
Nouveauts de la version 8.3

La liste ci-dessous rpertorie toutes les nouveauts ajoutes depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes.
IBM Cognos 8 Transformer

IBM Cognos Series 7 Transformer est dsormais totalement intgr IBM Cognos 8. Vous pouvez installer ce composant optionnel dans votre environnement IBM Cognos 8. Il offre toutes les fonctionnalits d'IBM Cognos Series 7 Transformer et prend en charge l'authentification et la connexion des utilisateurs par le biais des fournisseurs de scurit compatibles avec IBM Cognos 8. Transformer peut s'excuter sur toutes les plates-formes prises en charge par IBM Cognos 8, y compris Linux, HP/UX Itanium et Windows Vista. Pour en savoir davantage, reportez-vous la section "Installation et configuration d'IBM Cognos 8 Transformer" (p. 209). Vous pouvez importer des mtadonnes (ce qui inclut les invites et filtres associs) partir de packs et de rapports IBM Cognos 8, afin de les utiliser en tant que source de donnes dans Transformer 8. Pour en savoir davantage, reportez-vous la rubrique relative la cration d'un modle dans le Guide de l'utilisateur d'IBM Cognos 8 Transformer. Les cubes scuriss crs dans Transformer 8 sont destins aux studios Web d'IBM Cognos 8 Business Intelligence et ne sont pas compatibles avec les produits IBM Cognos Series 7.x PowerPlay. Les cubes non scuriss, mais protgs par mot de passe, qui ont t crs dans Transformer 8 sont accessibles dans IBM Cognos 8.3 Mobile Analysis pour une utilisation en local (sans connexion). Transformer 8 prend en charge les encodages UTF-8. Bien que vous puissiez utiliser le codage UTF8 en tant que paramtre de modle lors de la cration de cubes, Transformer 8 ne prend pas en charge les cubes multilingues. Les modlisateurs doivent aussi tre conscients des diffrences qui existent entre les paramtres rgionaux du contenu dans les rapports enregistrs et les paramtres rgionaux que Transformer utilise lorsqu'il accde aux rapports pour crer des cubes. Pour en savoir davantage sur la gestion des langues et des paramtres rgionaux dans Transformer, reportez-vous au Guide de l'utilisateur de Transformer.
Tlchargement du programme d'installation de Transformer 8

Transformer peut dsormais tre mis plus facilement la disposition des spcialistes mtier qui souhaitent concevoir des modles et crer des cubes pour leur usage personnel. Ainsi, les dpartements informatiques peuvent fournir aux spcialistes mtier ou aux modlisateurs Transformer un programme d'installation Web tlchargeable partir d'un portail professionnel ou scuris, de faon faciliter la distribution des fichiers d'installation. Pour en savoir davantage, reportez-vous aux sections "Cration d'un emplacement d'installation rseau pour les modlisateurs Transformer" (p. 360) et "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362).
Series 8 IQD Bridge

IBM Cognos 8 Business Intelligence Transformer utilise le moteur de requte d'IBM Cognos 8 pour prendre en charge les fonctionnalits d'IBM Cognos 8. Le composant Series 7 IQD Bridge permet Transformer 8 de continuer prendre en charge les fichiers .iqd d'IBM Cognos Series 7, que ceuxci aient t crs dans IBM Cognos Series 7 Impromptu ou dans IBM Cognos 8 Framework
Chapitre 1: Nouveauts Manager en tant que requtes externalises. Pour utiliser une source de donnes .iqd avec Transformer 8, installez le composant Series 7 IQD Bridge sur chaque ordinateur Transformer devant accder ce type de source de donnes. Le composant Series 7 IQD Bridge est facultatif et n'est pas pris en charge sur les nouvelles platesformes telles que Linux ou HP-UX Itanium. Pour en savoir davantage, reportez-vous la section "Installation et configuration d'IBM Cognos 8 Transformer" (p. 209).
Proprit d'emplacement des archives

Dans les anciennes versions d'IBM Cognos 8, les versions de rapports taient enregistres par dfaut dans la base de donnes Content Store. Vous pouvez maintenant configurer deux autres emplacements de sauvegarde, un dans IBM Cognos 8 et l'autre en dehors. Pour en savoir davantage, reportez-vous la section "Enregistrement d'une version de rapport" (p. 323).
Portal Services pour Microsoft SharePoint

IBM Cognos 8 prend dsormais en charge les portlets Cognos l'intrieur du portail Microsoft SharePoint. Pour bnficier de cette fonctionnalit, vous devez configurer des paramtres de scurit aprs avoir dploy les portlets dans le portail SharePoint. Pour en savoir davantage, reportez-vous la section "Configuration de Cognos Portal Services" (p. 365).
Prise en charge de Windows Vista

IBM Cognos 8 est pris en charge sous Windows Vista pour les composants client uniquement. Avec Windows Vista, Microsoft a introduit des fonctions de scurit avances charges de mieux protger le rpertoire Program Files. Cela a ncessit certaines modifications au niveau des variables d'environnement et des rpertoires dans lesquels sont stocks les profils utilisateur. Pour en savoir davantage, reportez-vous aux sections "Systmes d'exploitation" (p. 88) et "Mise jour des proprits d'emplacement des fichiers sous Windows Vista" (p. 355).
Fonctions modifies dans la version 8.3

La liste ci-dessous rpertorie toutes les modifications apportes aux fonctionnalits depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes.

Dans la version prcdente, l'assistant d'installation affichait le nom Cognos 8 Go! Office et utilisait l'un des rpertoires d'installation implicites de Cognos Office. Dans la nouvelle version, l'assistant d'installation affiche le nom IBM Cognos 8 pour Microsoft Office et utilise le rpertoire d'installation implicite d'IBM Cognos 8 pour Microsoft Office. Cet assistant est employ pour une famille de produits IBM Cognos compatibles avec Microsoft Office. Pour en savoir davantage, reportez-vous la section "Dploiement du client IBM Cognos 8 Go! Office" (p. 230). Dans la version prcdente, vous pouviez configurer la scurit pour Microsoft .NET Framework l'aide d'un client intelligent ou d'un module d'extension COM. prsent, IBM Cognos 8 Go! Office utilise exclusivement le module d'extension COM et aucune opration n'est requise pour le configurer. En outre, la version prcdente exigeait que l'on dfinisse des proprits personnalises dans 20
Chapitre 1: Nouveauts les modles Microsoft Office. Dans la nouvelle version, ces proprits personnalises ne sont plus requises. Pour en savoir davantage, reportez-vous la section "Configuration et dploiement de client d'IBM Cognos 8 Go ! Office" (p. 227).
Comportement des produits aprs une mise niveau

Lorsque vous effectuez une mise niveau d'IBM Cognos 8 BI version 8.2 vers la version 8.3, il est possible que certaines fonctionnalits d'IBM Cognos 8 se comportent diffremment aprs la mise niveau. Ainsi, lorsque vous mettez niveau des rapports, des changements de comportement peuvent entraner des erreurs de validation. Des documents relatifs ces changements de comportement sont disponibles. Ils contiennent notamment des exemples de changements et dcrivent les solutions adaptes aux problmes susceptibles de se produire lors de la mise niveau. Pour en savoir davantage, reportez-vous la section Upgrading to IBM Cognos 8 BI 8.3 : Changes in Product Behavior sur le site Web Cognos Software Services (http://support.cognos.com/go/docs/cognos8_ bi/8.3/changes_productbehavior.html).
Installation de Transformer
Dans les versions prcdentes, vous ne pouviez pas installer IBM Cognos Series 7 Transformer et IBM Cognos 8 Transformer 8.x sur le mme ordinateur. IBM Cognos 8 Transformer 8 peut tre install sur un ordinateur sur lequel IBM Cognos Series 7 Transformer est dj install, sans que cela ne cre de conflits. Dans les versions antrieures de Transformer, l'emplacement d'installation tait un rpertoire cern, o n correspondait au numro de version de Transformer 7.x. L'emplacement d'installation de Transformer 8 est le mme rpertoire c8 que celui utilis par tous les autres produits IBM Cognos 8. Le nom de l'excutable de Transformer 8 (sous Windows et UNIX) et les noms des fichiers .ini sont dsormais cogtr. Remarque : Lorsque Transformer 8 est install sous Windows Vista, si vous ne disposez pas de droits d'administrateur sur l'ordinateur et effectuez des modifications dans le fichier cogtr.xml, le fichier mis jour est enregistr par dfaut dans un rpertoire de type Magasin virtuel, et non dans le rpertoire emplacement_c8/configuration. Les fichiers de modle, de cube et journaux de Transformer 8 sont conservs dans le rpertoire ..\Mes documents\Transformer\, dans un sous-dossier appropri. Les rpertoires des fichiers temporaires et de la source de donnes sont stocks dans les emplacements implicites dfinis dans IBM Cognos Configuration. Pour les stocker dans un autre emplacement, dfinissez celui-ci dans Transformer. Pour en savoir davantage, reportez-vous la section "Installation et configuration d'IBM Cognos 8 Transformer" (p. 209).
Configuration de Transformer
Contrairement aux versions antrieures de Transformer, qui utilisaient IBM Cognos Series 7 Configuration Manager, Transformer 8 fait appel IBM Cognos Configuration pour la configuration des produits. Cela permet une intgration complte de tous les produits IBM Cognos 8 Business Intelligence.
Chapitre 1: Nouveauts Pour en savoir davantage, reportez-vous la section "Configuration des ordinateurs IBM Cognos 8 Transformer" (p. 213).
Exemples IBM Cognos 8

Dans les versions prcdentes d'IBM Cognos 8, les exemples taient installs automatiquement avec les composants serveur. prsent, les exemples se trouvent sur un CD distinct de celui de votre produit IBM Cognos 8. Si vous souhaitez utiliser les exemples, vous devez les installer depuis le CD de la version 8.3 des exemples d'IBM Cognos 8 Business Intelligence. Pour en savoir davantage, reportez-vous la section "Installation des exemples IBM Cognos 8" (p. 242).
Prsentations rapides d'IBM Cognos 8

Les prsentations rapides ne sont pas automatiquement installes en mme temps qu'IBM Cognos 8. Vous devez les installer partir du site Web Cognos Software Services (http:/support.cognos.com/ supported/en/support/downloads/cognos8/8.3/index.html). Pour en savoir davantage, reportez-vous la section "Installation des prsentations rapides" (p. 136).
Fonctions obsoltes dans la version 8.3

Une fonction est dite obsolte lorsqu'elle est remplace par une version plus rcente ou par une mise en uvre mieux adapte. Le but est de suspendre l'utilisation de cette fonction et de fournir des recommandations concernant l'adaptation ce changement dans plusieurs ditions. La liste ci-dessous rpertorie les fonctions obsoltes, ainsi que des liens vers des rubriques connexes.
Configuration de Content Manager

Dans les versions prcdentes, la proprit Voulez-vous crer une bibliothque de cls symtriques ? pouvait tre active ou dsactive. Gnralement, elle est dfinie sur Vrai sur le serveur Content Manager actif et sur Faux sur les serveurs Content Manager en attente. Ces paramtres permettaient aux serveurs Content Manager en attente de rcuprer la cl symtrique commune sur le serveur Content Manager actif. Dans la version 8.3, la proprit Voulez-vous crer une bibliothque de cls symtriques ? est obsolte, car les serveurs Content Manager peuvent maintenant identifier de faon dynamique le serveur Content Manager actif et donc rcuprer automatiquement la cl. Pour en savoir davantage, reportez-vous la section "Installation et configuration de Content Manager" (p. 154).
Configuration du fichier cogformat.xml : avis de changement

Actuellement, les proprits d'emplacement et de spcification de format du fichier cogformat.xml sont configures lors de l'installation. Les informations sont enregistres dans un fichier de configuration sur l'ordinateur local, fichier qui est conserv lors des mises niveau. Dans la prochaine version, la configuration de l'emplacement du fichier cogformat.xml et des proprits de spcification de format s'effectuera dans IBM Cognos Administration. Elles seront stockes dans la base de donnes Content Store et mises la disposition de tous les groupes et rles. Pour anticiper ce changement, vous devez crer une copie de sauvegarde des personnalisations que vous avez pu apporter ce fichier. Pour en savoir davantage sur la sauvegarde de fichiers contenant des donnes person22
Chapitre 1: Nouveauts nalises, reportez-vous la section "Mise niveau partir d'une version antrieure d'IBM Cognos 8" (p. 89).
Fonctions supprimes dans la version 8.3

La liste ci-dessous rpertorie toutes les fonctionnalits supprimes depuis la dernire version. Vous y trouverez galement des liens vers des rubriques connexes.
Dploiement du client intelligent pour IBM Cognos 8 GO! Office

Le dploiement d'IBM Cognos 8 Go! Office ne prend plus en charge le client intelligent. Vous devez utiliser le client de module d'extension COM, ce qui implique d'effectuer une installation sur les ordinateurs des utilisateurs. Si vous mettez niveau IBM Cognos Office Connection, les utilisateurs du module doivent installer la nouvelle version. Pour en savoir davantage sur le dploiement d'IBM Cognos GO! Office, reportez-vous la section "Configuration et dploiement de client d'IBM Cognos 8 Go ! Office" (p. 227).
24
Chapitre 2: Composants utiliss par IBM Cognos 8

IBM Cognos 8 est une solution Web d'information dcisionnelle qui intgre des fonctionnalits d'excution de rapports, d'analyse, de cration de tableaux de bord et de gestion d'vnements. IBM Cognos 8 comprend IBM Cognos 8 Business Intelligence Server et IBM Cognos 8 Business Intelligence Modeling. IBM Cognos 8 s'intgre aisment dans votre infrastructure existante en exploitant les ressources qui se trouvent dans votre environnement. Certaines de ces ressources sont indispensables, telles qu'un composant Java Virtual Machine pour les installations UNIX. D'autres sont facultatives, telles que l'utilisation d'une autre base de donnes pour Content Store, ou d'un autre fournisseur de scurit pour l'authentification. Par dfaut, IBM Cognos 8 utilise Tomcat comme serveur d'application. Vous pouvez configurer les produits IBM Cognos 8 pour qu'ils s'excutent sur les serveurs d'application pris en charge dans votre environnement.
Composants du serveur
Les composants du serveur offrent l'utilisateur des interfaces pour la cration de rapports et de tableaux de bord, pour l'analyse et pour la gestion d'vnements, ainsi que des fonctionnalits de serveur permettant d'acheminer et de traiter les requtes des utilisateurs. Les composants du serveur incluent les outils suivants :
IBM Cognos Connection

IBM Cognos Connection est un portail Web fourni avec IBM Cognos 8 ; il offre un point d'accs unique aux donnes d'entreprise disponibles pour ses produits. Il offre un point d'entre unique pour interroger, analyser et organiser les donnes, ainsi que pour crer des rapports, des tableaux de bord et des vnements. Les utilisateurs peuvent excuter toutes leurs applications Web d'IBM Cognos 8 par l'intermdiaire d'IBM Cognos Connection. Les autres applications d'information dcisionnelle, ainsi que les adresses URL vers d'autres applications, peuvent tre intgres IBM Cognos Connection.
Administration d'IBM Cognos

L'outil Administration d'IBM Cognos est une interface de gestion centrale qui renferme les tches administratives d'IBM Cognos 8. Il permet d'effectuer facilement la gestion globale de l'environnement IBM Cognos et est accessible par le biais d'IBM Cognos Connection.
IBM Cognos Viewer

Le visualiseur IBM Cognos est un portlet travers lequel vous pouvez interagir avec tous types de contenus publis de IBM Cognos. Vous pouvez y accder par l'intermdiaire d'IBM Cognos Connection et de tout portail d'entreprise existant.
Report Studio
Report Studio permet aux auteurs de crer, de modifier et de distribuer une large gamme de rapports de qualit professionnelle.Ils peuvent galement dfinir des modles de rapports standard pour l'entreprise utiliser dans Query Studio, ainsi que modifier des rapports crs dans Query Studio ou Analysis Studio.
Query Studio
Query Studio permet aux utilisateurs disposant de connaissances limites de concevoir, de crer et d'enregistrer des rapports qui rpondent aux besoins non couverts par les rapports standard de qualit professionnelle crs dans Report Studio.
Analysis Studio
Dans Analysis Studio, les utilisateurs peuvent explorer, analyser et comparer les donnes dimensionnelles. Analysis Studio offre un accs aux sources de donnes dimensionnelles et OLAP (Online Analytical Processing), ainsi qu'aux sources de donnes relationnelles modlises sous forme de dimension. Les analyses cres dans Analysis Studio peuvent tre ouvertes dans Report Studio et servir laborer des rapports de qualit professionnelle.
Event Studio
Dans Event Studio, vous dfinissez des agents pour suivre vos donnes et excuter des tches lorsque vous devez faire face des conditions exceptionnelles ou des vnements qui s'y rapportent. Lorsqu'un vnement survient, les utilisateurs sont alerts afin qu'ils puissent ragir. Les agents peuvent publier des informations dtailles sur le portail, envoyer des alertes par courrier lectronique, excuter et distribuer des rapports bass sur les vnements, ainsi que surveiller l'volution de ces derniers. Par exemple, la demande d'assistance d'un client important ou l'annulation d'une grosse commande peut dclencher un vnement, savoir l'envoi d'un courrier lectronique aux personnes concernes.
Metric Studio
Dans Metric Studio, vous pouvez crer et proposer un environnement personnalis compos de tableaux de bord pour surveiller et analyser les indicateurs l'chelle de votre entreprise. Les utilisateurs peuvent surveiller et analyser les informations critiques et crer des rapports en utilisant des tableaux de bord bass sur des indicateurs interfonctionnels.

IBM Cognos 8 Go! Office permet aux utilisateurs de Microsoft Office d'accder aux donnes des produits d'excution de rapports d'IBM Cognos dans les applications Microsoft Office. Les composants d'IBM Cognos 8 Go! Office sont automatiquement installs avec IBM Cognos 8. IBM Cognos 8 Go! Office n'est pas install avec IBM Cognos 8 Metrics Manager.
IBM Cognos Configuration

IBM Cognos Configuration est un outil qui sert configurer IBM Cognos 8, ainsi qu' en dmarrer et en arrter les services.
26
Passerelle
Dans IBM Cognos 8, les communications Web s'effectuent gnralement par l'intermdiaire de passerelles qui rsident sur un ou plusieurs serveurs Web. Une passerelle est une extension de programme de serveur Web qui transfre les informations d'un serveur Web vers un autre serveur. Les passerelles sont souvent des programmes CGI mais elles peuvent suivre d'autres normes, telles que ISAPI (Internet Server Application Program Interface) et Apache Modules (apache_mod).
Content Manager
Content Manager est le service d'IBM Cognos 8 qui gre le stockage des donnes d'application de l'utilisateur, notamment la scurit, les donnes de configuration, les modles, les indicateurs, ainsi que les spcifications et les sorties de rapports. Content Manager est requis pour la publication de packs, lextraction ou le stockage de spcifications de rapports, la gestion dinformations de calendrier ou bien encore la gestion de lespace-noms IBM Cognos. Content Manager stocke des informations dans une base de donnes Content Store.
Base de donnes de contenu d'IBM Cognos

La base de donnes de contenu d'IBM Cognos est une instance de la base de donnes Apache Derby. Il s'agit d'un composant et qui peut tre slectionn, il n'est pas install par dfaut. Si vous l'installez sur le mme ordinateur que Content Manager, la base de donnes de contenu d'IBM Cognos est configure en tant que Content Store implicite pour IBM Cognos 8. Vous pouvez utiliser la base de donnes de contenu d'IBM Cognos si vous ne souhaitez pas implmenter une autre base de donnes pour Content Store. Apache Derby est un logiciel libre dont les termes de la licence sont consultables sur le site Web d'Apache Derby (http://db.apache.org/derby/license.html). La modification de la base de donnes Apache Derby ou son utilisation avec d'autres produits ne sont pas prises en charge. Les modifications que vous apportez la base de donnes Apache Derby sont faites vos propres risques. Vous pouvez utiliser la base de donnes de contenu d'IBM Cognos en tant que Content Store ou en tant que base de donnes de notification, mais pas en tant que base de donnes de requtes.
Composite Information Server

Composite Information Server permet d'accder d'autres sources de donnes telles que LDAP, JDBC, Open XML et WSDL, et amliore les performances lors de l'interrogation de donnes issues de plusieurs sources.
Exemples IBM Cognos 8

En s'appuyant sur les donnes de la socit fictive Vacances et Aventure, les exemples IBM Cognos 8 illustrent les fonctions du produit, ainsi que les meilleures pratiques adopter en termes techniques et professionnels. Vous pouvez aussi les utiliser pour tester et partager des techniques de conception de rapports, ainsi que pour le dpannage.
Composants de modlisation
Les composants de modlisation modlisent des donnes dans des sources de donnes afin de structurer et de prsenter ces donnes de faon ce qu'elles puissent tre apprhendes par l'utilisateur. Les composants de modlisation incluent les outils suivants :
Framework Manager
Framework Manager est l'outil de modlisation d'IBM Cognos 8 permettant de crer et de grer des mtadonnes d'entreprise utilises dans les analyses et les rapports IBM Cognos 8. Les mtadonnes sont publies de faon tre utilises par des outils de cration de rapports sous forme de pack, offrant ainsi une vue intgre unique d'un ventail de sources de donnes.
Metric Designer
Metric Designer est l'outil de modlisation d'IBM Cognos 8 qui sert crer des extraits utiliss dans les applications de cration de tableaux de bord IBM Cognos 8. Les extraits servent mettre en correspondance et transfrer des informations partir de sources de mtadonnes existantes telles que des fichiers Framework Manager et Impromptu Query Definition (.iqd).
IBM Cognos 8 Transformer

IBM Cognos 8 Transformer est l'outil de modlisation d'IBM Cognos 8 utilis pour crer des cubes utiliser dans IBM Cognos 8. Les cubes IBM Cognos 8 scuriss ne sont pas compatibles avec IBM Cognos Series 7. Pour en savoir davantage sur l'installation et la configuration de versions de Transformer antrieures la 8,4, reportez-vous la documentation fournie avec votre dition de Transformer.
Series 7 IQD Bridge

Series 7 IQD Bridge contient des informations de connexion requises par IBM Cognos 8 pour utiliser les sources de donnes IQD IBM Cognos Series 7 Impromptu et les requtes externalises IBM Cognos 8 Framework Manager dans IBM Cognos 8 Transformer. Il prend galement en charge le paramtre de traitement multi-processeurs dans les modles Series 7 imports dans IBM Cognos 8 Transformer.
Map Manager
Les administrateurs et les modlisateurs font appel un utilitaire Windows appel Map Manager pour importer des cartes et mettre jour les libells associs dans Report Studio. Pour les lments de cartes, tels que les noms de pays et de villes, les administrateurs et les modlisateurs peuvent dfinir d'autres noms afin de fournir des versions multilingues du texte apparaissant sur la carte. Pour en savoir davantage sur l'utilisation de Map Manager, reportez-vous au manuel Map Manager Installation and User Guide.
Autres composants
Outre les outils fournis avec IBM Cognos 8, les composants suivants crs par d'autres fabricants sont galement requis.
28
Content Store
Le Content Store est une base de donnes relationnelle qui contient des donnes dont IBM Cognos 8 a besoin pour fonctionner. Il s'agit de spcifications de rapports, de modles publis et des packs qui les contiennent, ainsi que des informations de connexion pour les sources de donnes, des informations sur l'espace-noms externe et celui d'IBM Cognos, et des informations sur la planification et la diffusion de rapports en rafale. La base de donnes relationnelle peut tre la base de donnes de contenu d'IBM Cognos ou une autre base de donnes prise en charge. Les modles de conception et les fichiers journaux ne sont pas stocks dans Content Store. Le service IBM Cognos 8 qui utilise la base de donnes Content Store s'appelle Content Manager.
Bibliothque d'indicateurs
Une bibliothque d'indicateurs est une base de donnes relationnelle contenant des donnes relatives aux packs d'indicateurs. Une bibliothque d'indicateurs contient aussi les paramtres de Metric Studio, tels que les prfrences de l'utilisateur. Vous pouvez crer plusieurs bibliothques d'indicateurs. Par exemple, une bibliothque d'indicateurs peut disposer de contenu pour une application de type ventes, tandis qu'une autre proposera du contenu destin une application financire.
Sources de donnes
Les sources de donnes, galement appeles bases de donnes de requtes, sont des bases de donnes relationnelles, des cubes dimensionnels, des fichiers ou d'autres types de bibliothques de donnes physiques accessibles par l'intermdiaire d'IBM Cognos 8. Les composants d'application utilisent des connexions spcifiques pour accder aux sources de donnes.
30
Chapitre 3: Options de rpartition pour IBM Cognos 8

Avant de mettre en uvre IBM Cognos 8, dterminez la faon dont vous allez l'installer dans votre environnement. Vous pouvez installer tous les composants d'IBM Cognos 8 sur un seul ordinateur ou les rpartir sur un rseau. Le choix du mode de rpartition dpend de vos besoins en matire d'excution de rapports ou d'utilisation de tableaux de bord, de vos ressources et de vos prfrences. La configuration requise varie selon que vous installez tous les composants sur un ou plusieurs ordinateurs. IBM Cognos 8 est compatible avec d'autres produits d'IBM Cognos. Si d'autres produits d'IBM Cognos sont installs dans votre environnement, vous devez tudier la faon dont IBM Cognos 8 va s'intgrer cet environnement.
Rpartition des composants de cration de rapports d'IBM Cognos 8

Lors de l'installation des composants de cration de rapports IBM Cognos 8, vous devez prciser l'emplacement o les passerelles, les composants d'application et Content Manager doivent tre installs. Vous pouvez installer ces composants l'aide de l'une des options suivantes : Installer tous les composants sur un ordinateur. Cette option est habituellement utilise pour une dmonstration ou dans un environnement de banc d'essai. Installer la passerelle sur un ordinateur distinct. Si vous choisissez cette option, la passerelle et le serveur Web se trouvent sur le mme ordinateur, et les composants d'IBM Cognos restants figurent sur d'autres ordinateurs. Vous pouvez slectionner cette option si vous disposez de serveurs Web capables de grer les demandes des composants d'IBM Cognos. Installer les composants d'application et Content Manager sur des ordinateurs distincts. Choisissez cette option pour optimiser les performances, la disponibilit, la capacit ou la scurit en fonction des caractristiques de traitement de votre organisation. Si vous envisagez d'installer la base de donnes de contenu d'IBM Cognos, vous pouvez l'installer sur le mme ordinateur que Content Manager ou sur un autre ordinateur. Si vous l'installez sur le mme ordinateur, la base de donnes de contenu d'IBM Cognos est automatiquement configure pour tre utilise en tant que Content Store. Si vous l'installez sur un autre ordinateur, pensez dfinir les proprits de connexion de la base de donnes de contenu d'IBM Cognos sur votre ordinateur Content Manager. Installer les composants de cration de rapports d'IBM Cognos 8 sur le mme ordinateur que celui o sont installs les autres produits d'IBM Cognos 8. Guide d'installation et de configuration 31
Chapitre 3: Options de rpartition pour IBM Cognos 8 IBM Cognos 8 partage les composants de cration de rapports et de tableaux de bord, tels que Content Manager. Si vous prvoyez d'installer les composants de cration de rapports et de tableaux de bord d'IBM Cognos 8 sur le mme ordinateur, il est conseill d'utiliser le mme emplacement d'installation. Aprs avoir install les composants de cration de rapports d'IBM Cognos 8, vous devez les configurer afin qu'ils puissent communiquer entre eux. Outre l'installation de Content Manager, des composants d'application et des passerelles, vous devez installer Framework Manager, qui constitue l'application de modlisation des mtadonnes pour les informations dcisionnelles. Vous pouvez aussi choisir d'installer Transformer, l'outil de modlisation et de cration de cubes utilisables dans IBM Cognos 8. Quel que soit le scnario d'installation d'IBM Cognos choisi, vous pouvez installer Framework Manager ou Transformer et la base de donnes Content Store sur un ordinateur distinct de celui o sont installs les composants d'application.
Installation de tous les composants sur un mme ordinateur

Vous pouvez installer tous les composants de cration de rapports d'IBM Cognos 8 sur un seul ordinateur. Optez pour ce scnario pour les environnements de banc d'essai ou de dmonstration o la charge des utilisateurs est faible. tant donn que la passerelle doit tre installe sur le mme ordinateur que le serveur Web, l'ordinateur isol doit galement excuter un serveur Web. Si le serveur Web tourne sous UNIX ou Linux, vous devez installer Framework Manager pour Windows sur un ordinateur spar fonctionnant sous Windows. Dans le diagramme ci-dessous, tous les composants serveur de cration de rapports d'IBM Cognos 8, l'exception de Framework Manager, sont installs sur le mme ordinateur. La base de donnes Content Store, les bases de donnes de requtes et Framework Manager se trouvent sur des ordinateurs spars.
32

Installation des composants du serveur IBM Cognos sur un seul ordinateur
Framework Manager
Composants d'application de la passerelle du serveur Web
Content Manager
Content Store
Bases de donnes de requtes
Configuration requise
Si vous installez tous les composants serveur de cration de rapports d'IBM Cognos 8 sur le mme ordinateur, vous devez : configurer votre serveur Web pour afficher le contenu d'IBM Cognos, indiquer les informations de connexion la base de donnes Content Store, configurer un compte de courrier lectronique pour les notifications (si vous avez l'intention d'envoyer des rapports par courrier lectronique).
Installation des passerelles sur diffrents ordinateurs

La passerelle gre les communications entre les composants de cration de rapports IBM Cognos 8. Elle peut rsider sur un ou plusieurs serveurs Web. Vous pouvez installer la passerelle et un serveur Web sur un mme ordinateur, puis installer les composants restants de cration de rapports IBM Cognos 8 sur d'autres ordinateurs. Si vous disposez d'une ferme Web, vous pouvez installer une passerelle sur chaque serveur Web. L'utilisation de plusieurs serveurs Web pour grer les demandes entrantes permet d'offrir un meilleur niveau de service. Si vous installez uniquement le composant passerelle sur le mme ordinateur que le serveur Web, celui-ci gre les services Web principaux sans traiter les demandes d'utilisateurs. Cette sparation du traitement s'impose si un pare-feu est install entre le serveur Web et les ordinateurs des composants d'application.
Chapitre 3: Options de rpartition pour IBM Cognos 8 Dans le diagramme ci-dessous, une passerelle est installe sur chacun des deux serveurs Web. Les demandes entrantes sont transmises l'une des passerelles, puis transfres vers l'ordinateur des composants d'application.
Passerelle du serveur Web Passerelle du serveur Web Installation de plusieurs passerelles
Composants d'application Content Manager
Content Store
Si vous installez une ou plusieurs passerelles sur des ordinateurs spars, assurez-vous que vous pouvez consulter le contenu IBM Cognos et que les passerelles peuvent communiquer avec les autres composants d'IBM Cognos. Sur chacun des ordinateurs o la passerelle est installe, vous devez : configurer les proprits cryptographiques, configurer votre serveur Web pour afficher le contenu d'IBM Cognos, configurer les URI du distributeur.
Installation des composants d'application et des applications Content Manager sur diffrents ordinateurs
Un ou plusieurs serveurs de rapports utilisent l'interface d'IBM Cognos Connection pour quilibrer les charges, accder aux donnes, effectuer les requtes, programmer les travaux et afficher les rapports. Content Manager conserve l'ensemble des spcifications de rapports, des rsultats, des packs, des dossiers et des travaux dans la base de donnes Content Store. Vous pouvez installer les composants d'application et Content Manager sur un ou plusieurs ordinateurs. L'installation sur plusieurs ordinateurs peut amliorer les performances, la disponibilit et la capacit. Dans un souci d'amlioration de la modularit dans un environnement o le volume de demandes de rapports traiter est gnralement important, vous pouvez installer les composants d'application sur plusieurs ordinateurs rservs au traitement des demandes entrantes. En installant les composants d'application sur plusieurs ordinateurs, vous rpartissez et quilibrez les charges entre ordinateurs. Vous bnficiez galement d'une accessibilit et d'un dbit accrus par rapport une installation sur un seul ordinateur, de mme que d'une prise en charge des reprises.
34
Chapitre 3: Options de rpartition pour IBM Cognos 8 Dans le diagramme ci-dessous, les demandes entrantes sont achemines vers une passerelle. La passerelle transmet la demande l'un des ordinateurs des composants d'application. Le serveur de rapports transfre la demande Content Manager, qui adresse une requte la base de donnes Content Store et renvoie les rsultats au serveur de rapports pour affichage.
Framework Manager Installation de plusieurs services Content Manager
Composants d'application de la passerelle du serveur Web
Ordinateurs Content Manager en attente Content Manager actif par dfaut
Content Store
Si vous installez un ou plusieurs composants d'application sur un ordinateur spar, pour vous assurer qu'ils peuvent communiquer avec les composants de cration de rapports IBM Cognos 8, vous devez : configurer les proprits cryptographiques, dfinir tous les URI de Content Manager. dfinir les URI du distributeur, dfinir l'URI du distributeur des applications externes,
Installation de plusieurs applications Content Manager

Vous pouvez installer un nombre quelconque d'installations de Content Manager, mais une seule est active tout instant. Chacune des autres installations agit en tant que Content Manager en attente. Une installation est active uniquement si l'ordinateur sur lequel l'instance active de Content Manager est installe subit une dfaillance. Pour prendre en charge la reprise, il est recommand d'installer Content Manager sur au moins deux ordinateurs. La base de donnes Content Store stocke les donnes ncessaires au fonctionnement d'IBM Cognos 8, notamment des spcifications de rapports, des modles publis et les packs les contenant, des informations de connexion pour les sources de donnes, des informations relatives l'espace-noms externe, l'espace-noms d'IBM Cognos lui-mme et des informations concernant la programmation Guide d'installation et de configuration 35
Chapitre 3: Options de rpartition pour IBM Cognos 8 de rapports et leur diffusion en rafale. Content Store est un systme de gestion de bases de donnes relationnelles (RDBMS). chaque installation d'IBM Cognos n'est associe qu'une seule base de donnes Content Store. Vous pouvez installer Content Manager indpendamment des composants d'application si vos donnes contiennent des informations sensibles. Les donnes sont conserves au niveau correspondant, avec les informations de scurit. Lorsqu'un Content Manager actif choue, toutes les donnes de session non enregistres sont perdues. Lorsque le nouveau Content Manager actif prend le relais, les utilisateurs peuvent tre invits se connecter.
Sur chaque ordinateur sur lequel vous avez install Content Manager, vous devez : configurer les proprits cryptographiques, indiquer les informations de connexion la base de donnes Content Store, dfinir les URI du distributeur, dfinir tous les URI de Content Manager. dfinir l'URI du distributeur des applications externes, configurer un compte de courrier lectronique pour les notifications (si vous avez l'intention d'envoyer des rapports par courrier lectronique).
Installation des produits d'IBM Cognos 8 sur le mme ordinateur

Les produits d'IBM Cognos 8 sont conus pour partager certains composants, tels que la passerelle, Content Manager, la base de donnes Content Store, IBM Cognos Connection et IBM Cognos Configuration. Si vous installez plusieurs produits d'IBM Cognos 8 sur un mme ordinateur, nous vous conseillons de les installer dans un mme emplacement. Le programme d'installation vrifie si d'autres composants d'IBM Cognos 8 se trouvent dj dans l'emplacement d'installation. S'il y a dj un composant et qu'il peut tre partag, il n'est pas rinstall.
Accs la documentation sur les produits dans un environnement intgr

La documentation sur les composants d'IBM Cognos 8 est installe avec le composant passerelle. Si vous intgrez diffrents produits d'IBM Cognos 8, vous pouvez utiliser la mme passerelle ou des passerelles spares. Si vous souhaitez employer la mme passerelle, tous les composants passerelles doivent correspondre la mme version du produit et vous devez installer le composant passerelle IBM Cognos 8 pour chaque produit dans le mme emplacement, sur le mme ordinateur. Cela permet de garantir que l'ensemble de la documentation sur les produits est disponible pour tous les utilisateurs.Si vous souhaitez utiliser des passerelles distinctes pour chaque produit, vous pouvez installer le composant passerelle IBM Cognos 8 correspondant chaque produit sur des ordinateurs distincts, mais la documentation sur les produits prsente sur chaque passerelle sera spcifique au produit IBM Cognos 8 install. Pour que les utilisateurs aient accs chaque produit IBM Cognos 8 par le biais de passerelles spares, tout en tirant quand mme partie de la documentation sur tous les composants, vous 36
Chapitre 3: Options de rpartition pour IBM Cognos 8 pouvez installer le composant passerelle de chaque produit dans le mme emplacement que celui des autres composants passerelles IBM Cognos 8.
Rpartition des composants de Framework Manager

Framework Manager peut tre install sur un ordinateur contenant d'autres composants de cration de rapports IBM Cognos 8 ou sur un ordinateur spar. Framework Manager conserve des modles d'excution sur l'ordinateur des composants d'application. Il peut communiquer avec le serveur par les deux routes suivantes : en se connectant au distributeur de composants d'application avec l'URI interne du distributeur. Cette route est recommande. en se connectant une passerelle ddie supplmentaire, elle-mme configure pour se connecter au distributeur avec l'URI interne du distributeur. Vous devez configurer un niveau de scurit appropri pour cette passerelle (par exemple, SSL) (p. 325) Cette mthode est utile lorsque l'outil de modlisation se situe en dehors d'un pare-feu rseau. Remarque : Ne modifiez pas votre passerelle principale de faon utiliser l'URI interne du distributeur. Cela diminuerait le niveau de scurit des studios et du portail IBM Cognos 8. L'emplacement o vous installez Framework Manager et la manire dont vous le configurez dpendent de la taille des modles de mtadonnes et du serveur Web utilis.
Serveurs Web autres que Microsoft IIS

Pour les serveurs Web autres que Microsoft Internet Information Services (IIS), il n'existe pas de diffrence fonctionnelle entre les deux routes de communication avec l'outil de modlisation et le distributeur des composants d'application. Pour chaque route, l'outil de modlisation utilise l'API SOAP BI Bus. Si vous utilisez la route du serveur Web alors que les packs sont de taille moyenne grande (prs de 1 Mo), les modles sont fractionns en lments plus petits (blocs) pour la transmission. Si vous utilisez un serveur Web autre que Microsoft IIS, il est recommand de configurer l'outil de modlisation pour communiquer l'aide de la passerelle du serveur Web (en utilisant la premire route). Cela vous vite de devoir configurer des canaux de communication supplmentaires si vous utilisez des pare-feu pour sparer l'outil de modlisation, le serveur Web et les composants d'application. Pour en savoir davantage sur la configuration de Framework Manager, reportez-vous la section "Installation et configuration de Framework Manager" (p. 197).
Observations concernant le pare-feu

Lorsque l'outil de modlisation est situ en dehors du pare-feu rseau qui protge les composants d'application, des problmes de communication peuvent se poser au niveau du distributeur. Pour des raisons de scurit, la configuration implicite d'IBM Cognos 8 empche le distributeur d'accepter les requtes de l'outil de modlisation lorsque ce dernier se situe en dehors du pare-feu rseau.
Chapitre 3: Options de rpartition pour IBM Cognos 8 Par dfaut, l'outil de modlisation est configur pour envoyer des requtes directement au distributeur :
Framework Manager Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2 Communication avec les composants d'application
Pour viter tout problme lors d'une communication directe avec le distributeur, installez l'outil de modlisation dans le mme niveau architectural que les composants d'application.
Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2
Framework Manager
Vous pouvez galement installer une passerelle supplmentaire ddie la communication avec l'outil de modlisation. Vous configurez alors l'outil de modlisation et sa passerelle de telle manire que le distributeur accepte les requtes de l'outil de modlisation.
Framework Manager communique avec les composants d'application, que vous pouvez installer sur un ou plusieurs serveurs d'application. Pour publier des packs, vous devez configurer Framework Manager pour qu'il communique avec le distributeur, soit directement, soit par le biais d'une passerelle ddie. Veillez ce que Framework Manager puisse communiquer avec les composants serveur d'IBM Cognos 8. Sur l'ordinateur o Framework Manager est install, configurez les proprits cryptographiques et les proprits d'environnement suivantes : URI de la passerelle
38
Chapitre 3: Options de rpartition pour IBM Cognos 8 URI du distributeur des applications externes
Si l'outil de modlisation utilise une passerelle ddie au lieu de communiquer directement avec le distributeur, vous devez galement configurer la proprit URI du distributeur pour la passerelle sur l'ordinateur de la passerelle ddie.
Rpartition des composants de Transformer

Transformer peut tre install sur un ordinateur contenant d'autres composants d'IBM Cognos 8 ou sur un ordinateur spar. Lorsque Transformer est install sparment, il peut tre utilis en tant que produit autonome ou configur pour communiquer avec d'autres composants d'IBM Cognos 8. Lorsque vous utilisez Transformer en tant que produit autonome, vous pouvez employer des sources de donnes externes IBM Cognos 8 et vous ne pouvez pas crer des vues scurises l'aide de filtres dimensionnels. Si vous employez Transformer avec d'autres composants IBM Cognos 8, vous pouvez tirer parti des fonctions suivantes fournies par IBM Cognos 8 : fournisseurs d'authentification IBM Cognos 8, sources de donnes IBM Cognos 8, telles que des packs publis ou des rapports Query Studio et Report Studio, IBM Cognos Connection pour la publication du pack et de la source de donnes de cubes, cration de cubes sous Linux ou HP-UX Itanium. Les fichiers plats ne peuvent pas tre utiliss en tant que sources de donnes. Transformer est constitu des composants ci-dessous. Vous pouvez disposer de l'un de ces composants ou des deux selon votre environnement. Transformer Windows Il s'agit de l'outil de modlisation permettant de concevoir des cubes utiliss dans IBM Cognos 8. Il permet galement de crer et de publier des cubes. Transformer UNIX/Linux Il s'agit d'un utilitaire de ligne de commande permettant de crer des cubes. Vous concevez d'abord les modles l'aide de scripts Transformer Windows ou MDL, puis vous utilisez ces modles pour crer les cubes. Chacun de ces composants peut communiquer avec le serveur par l'une des deux routes suivantes : en se connectant au distributeur de composants d'application avec l'URI interne du distributeur (route recommande). en se connectant une passerelle ddie supplmentaire, elle-mme configure pour se connecter au distributeur avec l'URI interne du distributeur. Vous devez configurer un niveau de scurit appropri pour cette passerelle (par exemple, SSL) (p. 325) Cette route est utile lorsque l'outil de modlisation est situ en dehors d'un pare-feu rseau. Remarque : Ne modifiez pas votre passerelle principale de faon utiliser l'URI interne du distributeur. Cela diminuerait le niveau de scurit des studios et du portail IBM Cognos 8.

Pour les serveurs Web autres que Microsoft Internet Information Services (IIS), il n'existe pas de diffrence fonctionnelle entre les deux routes de communication avec l'outil de modlisation et le distributeur des composants d'application. Pour chaque route, l'outil de modlisation utilise l'API SOAP BI Bus. Si vous utilisez la route du serveur Web alors que les packs sont de taille moyenne grande (prs de 1 Mo), les packs sont fractionns en lments plus petits (blocs) pour la transmission. Lors de la publication de packs, seul le modle d'excution du pack est transfr, pas le cube. Nanmoins, ce cube doit se trouver dans un emplacement accessible pour le distributeur. Si vous utilisez un serveur Web autre que Microsoft IIS, il est recommand de configurer l'outil de modlisation pour communiquer l'aide de la passerelle du serveur Web (en utilisant la premire route). Cela vous vite de devoir configurer des canaux de communication supplmentaires si vous utilisez des pare-feu pour sparer l'outil de modlisation, le serveur Web et les composants d'application.

Lorsque l'outil de modlisation est situ en dehors du pare-feu rseau qui protge les composants d'application, des problmes de communication peuvent se poser au niveau du distributeur. Pour des raisons de scurit, la configuration implicite d'IBM Cognos 8 empche le distributeur d'accepter les requtes de l'outil de modlisation lorsque ce dernier se situe en dehors du pare-feu rseau. Par dfaut, l'outil de modlisation est configur pour envoyer des requtes directement au distributeur :
Transformer Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2 Communication avec les composants d'application
Pour viter tout problme lors d'une communication directe avec le distributeur, installez l'outil de modlisation dans le mme niveau architectural que les composants d'application.
40
Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2 Transformer
Vous pouvez galement installer une passerelle supplmentaire ddie la communication avec l'outil de modlisation. Vous configurez alors l'outil de modlisation et sa passerelle de faon ce que le distributeur accepte les demandes de l'outil de modlisation.
Considrations relatives aux serveurs bass sur des rles

Vous souhaitez peut-tre configurer des serveurs Transformer ddis pour bnficier de performances de cration de cubes optimales et d'une accessibilit maximale pour les utilisateurs d'IBM Cognos 8. Si tel est le cas, tenez compte des exigences suivantes : Le logiciel du client de base de donnes est install sur un ordinateur qui sera utilis pour la cration ou le test de donnes de cubes dans Transformer. Les variables d'environnement appropries sont dfinies pour les serveurs UNIX et Linux. Les serveurs IBM Cognos 8 ont accs l'emplacement dans lequel sont stocks les cubes, de sorte que le distributeur peut accder ces derniers.
La cration et la mise jour de cubes de production peuvent tre excutes par le biais d'un script et effectues distance lorsque les droits d'accs et les privilges utilisateur configurs sont suffisants. Pour en savoir davantage sur la cration et la mise jour de cubes de production, reportez-vous au Guide de l'utilisateur de Transformer.
Spcialistes et analystes en informatique de gestion

Certains de vos utilisateurs avancs ou spcialiss souhaitent peut-tre crer des cubes modliss selon des sources de donnes la fois personnelles et professionnelles. Ces utilisateurs voudront srement effectuer leur propre analyse des donnes pour leur domaine professionnel prcis ou pour un petit groupe d'utilisateurs. Grce l'infrastructure informatique et de scurit de l'entreprise, vous pouvez permettre ces utilisateurs d'tre autonomes ; il suffit pour cela que les conditions suivantes soient remplies : Le logiciel du client de base de donnes est install (ou la disposition des modlisateurs en vue d'une installation) sur les ordinateurs Transformer utiliss pour accder aux sources de donnes IBM Cognos 8 ou IBM Cognos Series 7 IQD. Les modlisateurs doivent disposer de droits pour crer une source de donnes dans IBM Cognos Administration. Ils n'ont pas besoin d'un accs direct cette application. Ils peuvent crer et mettre jour des sources de donnes l'aide de Transformer ou d'outils de ligne de commande. Vous pouvez
Chapitre 3: Options de rpartition pour IBM Cognos 8 fournir aux modlisateurs un dossier scuris dans IBM Cognos Connection, dans lequel ils pourront publier les packs de cubes. Les modlisateurs doivent avoir accs un emplacement dans lequel stocker les cubes crs. Cet emplacement doit galement tre accessible pour le service IBM Cognos 8 et il peut s'agir d'un dossier de partage scuris sur un rseau local. Les modlisateurs auront peut-tre besoin de droits spciaux pour excuter distance l'utilitaire de connexion de cubes d'IBM Cognos 8, qui se trouve sur le serveur IBM Cognos 8. Pour en savoir davantage, reportez-vous la rubrique relative la mise jour de cubes publis et de connexions de cubes dans le Guide de l'utilisateur de Transformer. Pour crer des cubes sur un serveur Transformer spcifique, les modlisateurs doivent disposer de droits FTP pour transfrer les modles et de droits d'excution pour crer les cubes sur ce serveur. Ils peuvent transfrer les modles et crer les cubes l'aide de scripts. Ils peuvent galement utiliser des mthodes automatises pour crer les cubes. Pour en savoir davantage, reportezvous au Guide d'administration et de scurit.
Pour publier des packs de cubes, vous devez configurer Transformer de faon ce qu'il communique avec le distributeur, soit directement, soit au moyen d'une passerelle ddie. Si IBM Cognos Connection est scuris, vous devez disposer de privilges pour crer des sources de donnes et publier des packs dans IBM Cognos Connection. Sur l'ordinateur o Transformer est install, configurez les proprits cryptographiques et les proprits d'environnement suivantes : URI de la passerelle URI du distributeur des applications externes
Si l'outil de modlisation utilise une passerelle ddie au lieu de communiquer directement avec le distributeur, vous devez galement configurer les URI du distributeur pour la proprit de la passerelle sur l'ordinateur de la passerelle ddie.
Rpartition des composants de cration de tableaux de bord IBM Cognos 8

Lors de l'installation des composants de cration de tableaux de bord IBM Cognos 8, vous devez prciser l'emplacement o les passerelles, les composants d'application et Content Manager doivent tre installs. Vous pouvez installer ces composants l'aide de l'une des options suivantes : Installer tous les composants sur un ordinateur. Cette option est habituellement utilise pour une dmonstration ou dans un environnement de banc d'essai. Installer la passerelle sur un ordinateur distinct.
42
Chapitre 3: Options de rpartition pour IBM Cognos 8 Si vous choisissez cette option, la passerelle et le serveur Web se trouvent sur le mme ordinateur, et les composants d'IBM Cognos restants figurent sur d'autres ordinateurs. Vous pouvez slectionner cette option si vous disposez de serveurs Web capables de grer les demandes des composants d'IBM Cognos. Installer les composants d'application et Content Manager sur des ordinateurs distincts. Choisissez cette option pour optimiser les performances, la disponibilit, la capacit ou la scurit en fonction des caractristiques de traitement de votre organisation. Si vous envisagez d'installer la base de donnes de contenu d'IBM Cognos, vous pouvez l'installer sur le mme ordinateur que Content Manager ou sur un autre ordinateur. Si vous l'installez sur le mme ordinateur, la base de donnes de contenu d'IBM Cognos est automatiquement configure pour tre utilise en tant que Content Store. Si vous l'installez sur un autre ordinateur, pensez dfinir les proprits de connexion de la base de donnes de contenu d'IBM Cognos sur votre ordinateur Content Manager. Installer les composants de cration de tableaux de bord IBM Cognos 8 sur le mme ordinateur que celui o sont installs les autres produits d'IBM Cognos 8. Les produits d'IBM Cognos 8 partagent certains composants, tels que Content Manager. Si vous prvoyez d'installer les composants de cration de tableaux de bord IBM Cognos 8 sur le mme ordinateur que les autres produits d'IBM Cognos 8, il est conseill d'utiliser le mme emplacement d'installation. Aprs avoir install les composants de cration de tableaux de bord IBM Cognos 8, vous devez les configurer afin qu'ils puissent communiquer entre eux. Outre l'installation de Content Manager, des composants d'application et des passerelles, vous pouvez installer Metric Designer (p. 219), qui constitue l'application de modlisation des mtadonnes pour la cration de tableaux de bord. Quel que soit le scnario d'installation d'IBM Cognos choisi, vous pouvez installer Metric Designer et la base de donnes Content Store sur un autre ordinateur que celui o sont installs les composants d'application. La bibliothque d'indicateurs est gnralement installe sur le mme ordinateur que Content Manager. Elle peut galement tre installe sur un ordinateur diffrent.
Installation de tous les composants sur un mme ordinateur

Vous pouvez installer tous les composants de cration de tableaux de bord IBM Cognos 8 sur un seul ordinateur. Optez pour ce scnario pour les environnements de banc d'essai ou de dmonstration o la charge des utilisateurs est faible. tant donn que la passerelle doit tre installe sur le mme ordinateur que le serveur Web, l'ordinateur isol doit galement excuter un serveur Web. Si le serveur Web est install sous UNIX, vous devez installer Metric Designer pour Windows sur un ordinateur spar fonctionnant sous Windows. Dans le diagramme ci-dessous, tous les composants de cration de tableaux de bord IBM Cognos 8, l'exception de Metric Designer, sont installs sur le mme ordinateur. La base de donnes Content Store et la bibliothque d'indicateurs sont installes sur des ordinateurs spars.

Installation des composants d'IBM Cognos8 Scorecarding sur un seul ordinateur
Serveur Web Passerelle Composants d'application Content Manager
Content Store
Bibliothques d'indicateurs
Si vous installez tous les composants de cration de tableaux de bord IBM Cognos 8 sur le mme ordinateur, vous devez : configurer votre serveur Web pour afficher le contenu d'IBM Cognos, indiquer les informations de connexion la base de donnes Content Store,
Installation des passerelles sur diffrents ordinateurs

La passerelle gre les communications entre les composants de cration de tableaux de bord IBM Cognos 8. Elle peut rsider sur un ou plusieurs serveurs Web. Vous pouvez installer la passerelle et un serveur Web sur un mme ordinateur, puis installer les composants restants de cration de tableaux de bord IBM Cognos 8 sur d'autres ordinateurs. Si vous disposez d'une ferme Web, vous pouvez installer une passerelle sur chaque serveur Web. L'utilisation de plusieurs serveurs Web pour grer les demandes entrantes permet d'offrir un meilleur niveau de service. Si vous installez uniquement le composant passerelle sur le mme ordinateur que le serveur Web, celui-ci gre les services Web principaux sans traiter les demandes d'utilisateurs. Cette sparation du traitement s'impose si un pare-feu est install entre le serveur Web et les autres composants de cration de tableaux de bord IBM Cognos 8. Dans le diagramme ci-dessous, une passerelle est installe sur chacun des deux serveurs Web. Les demandes entrantes sont transmises l'une des passerelles, puis transfres vers l'ordinateur des composants d'application en vue de leur traitement.
44

Installation des composants d'IBM Cognos 8 Scorecarding sur plusieurs ordinateurs
Serveur Web Passerelle
Composants d'application Content Manager
Content Store
Bibliothques d'indicateurs
Si vous installez une ou plusieurs passerelles sur un ordinateur spar, assurez-vous que vous pouvez consulter le contenu IBM Cognos et que les passerelles peuvent communiquer avec les autres composants d'IBM Cognos. Sur chacun des ordinateurs o la passerelle est installe, vous devez : configurer les proprits cryptographiques, configurer votre serveur Web pour afficher le contenu d'IBM Cognos, configurer les URI du distributeur.
Installation des composants d'application et des applications Content Manager sur diffrents ordinateurs
Les composants d'application traitent les demandes IBM Cognos, quilibrent les charges, excutent des tches et crent des tableaux de bord. Content Manager stocke et extrait des informations, telles que les connexions la source de donnes dans la base de donnes Content Store. Vous pouvez installer les composants d'application et Content Manager sur un ou plusieurs ordinateurs. L'installation sur plusieurs ordinateurs peut amliorer les performances, la disponibilit et la capacit. Dans un souci d'amlioration de la modularit dans un environnement o le volume de demandes de rapports traiter est gnralement important, vous pouvez installer les composants d'application sur plusieurs ordinateurs rservs au traitement des demandes entrantes. Ce faisant, vous rpartissez et quilibrez les charges entre ordinateurs. Vous bnficiez galement d'une accessibilit et d'un dbit accrus par rapport une installation sur un seul ordinateur, de mme que d'une prise en charge des reprises. Dans le diagramme ci-dessous, les demandes entrantes sont achemines vers une passerelle. La passerelle transmet la demande l'un des composants d'application en vue de son traitement.
Passerelle du serveur Web
Installation de plusieurs instances de Content Manager avec des composants d'IBM Cognos8 Scorecarding
Composants d'application
Ordinateurs Content Manager Content Manager en attente actif par dfaut
Content Store
Bibliothque d'indicateurs
Si vous installez un ou plusieurs composants d'application sur un ordinateur spar, veillez ce qu'ils puissent communiquer avec les autres composants d'IBM Cognos 8. Vous devez effectuer les oprations suivantes : configurer les proprits cryptographiques, dfinir tous les URI de Content Manager. dfinir les URI du distributeur,
Installation de plusieurs applications Content Manager

Vous pouvez installer un nombre quelconque d'installations de Content Manager, mais une seule est active tout instant. Chacune des autres installations agit en tant que Content Manager en attente. Une installation est active uniquement si l'ordinateur sur lequel l'instance active de Content Manager est installe subit une dfaillance. Pour prendre en charge la reprise, il est recommand d'installer Content Manager sur au moins deux ordinateurs. La base de donnes Content Store stocke les donnes ncessaires au fonctionnement d'IBM Cognos 8, notamment des spcifications de rapports, des modles publis et les packs les contenant, des informations de connexion pour les sources de donnes, des informations relatives l'espace-noms externe, l'espace-noms d'IBM Cognos lui-mme et des informations concernant la programmation de rapports et leur diffusion en rafale. Content Store est un systme de gestion de bases de donnes 46
Chapitre 3: Options de rpartition pour IBM Cognos 8 relationnelles (RDBMS). chaque installation d'IBM Cognos n'est associe qu'une seule base de donnes Content Store. Vous pouvez installer Content Manager indpendamment des composants d'application si vos donnes contiennent des informations sensibles. Les donnes sont conserves au niveau correspondant, avec les informations de scurit. Lorsqu'un Content Manager actif choue, toutes les donnes de session non enregistres sont perdues. Lorsque le nouveau Content Manager actif prend le relais, les utilisateurs peuvent tre invits se connecter.
Sur chaque ordinateur sur lequel vous avez install Content Manager, vous devez : configurer les proprits cryptographiques, indiquer les informations de connexion la base de donnes Content Store, dfinir les URI du distributeur, dfinir tous les URI de Content Manager.
Installation des produits d'IBM Cognos 8 sur le mme ordinateur

Les produits d'IBM Cognos 8 sont conus pour partager certains composants, tels que la passerelle, Content Manager, la base de donnes Content Store, IBM Cognos Connection et IBM Cognos Configuration. Si vous installez plusieurs produits d'IBM Cognos 8 sur un mme ordinateur, nous vous conseillons de les installer dans un mme emplacement. Le programme d'installation vrifie si d'autres composants d'IBM Cognos 8 se trouvent dj dans l'emplacement d'installation. S'il y a dj un composant et qu'il peut tre partag, il n'est pas rinstall.
Rpartition des composants de Metric Designer

Dans Metric Studio, pour dfinir et charger un grand nombre d'indicateurs partir de sources de donnes relationnelles et dimensionnelles (notamment des cubes, des packs Framework Manager ou des fichiers .iqd de dfinitions de requtes Impromptu), installez Metric Designer pour extraire ces donnes. Installez Metric Designer une fois tous les autres composants d'IBM Cognos 8 installs et configurs. Si les composants d'IBM Cognos 8 fonctionnent dans un environnement UNIX, vous devez installer Metric Designer pour Windows sur un ordinateur fonctionnant sous Windows. Si Metric Designer est install sur un ordinateur Windows diffrent de celui o sont installs les autres composants d'IBM Cognos 8, les communications peuvent emprunter l'une de ces deux routes : en se connectant au distributeur de composants d'application avec l'URI interne du distributeur. Cette route est recommande. en se connectant une passerelle ddie supplmentaire, elle-mme configure pour se connecter au distributeur avec l'URI interne du distributeur. Vous devez configurer un niveau de scurit
Chapitre 3: Options de rpartition pour IBM Cognos 8 appropri pour cette passerelle (par exemple, SSL) (p. 325) Cette mthode est utile lorsque l'outil de modlisation se situe en dehors d'un pare-feu rseau. Remarque : Ne modifiez pas votre passerelle principale de faon utiliser l'URI interne du distributeur. Cela diminuerait le niveau de scurit des studios et du portail IBM Cognos 8. L'emplacement o vous installez Metric Designer et la manire dont vous le configurez dpendent de la taille des modles de mtadonnes et du serveur Web utilis.

Pour les serveurs Web autres que Microsoft Internet Information Services (IIS), il n'existe pas de diffrence fonctionnelle entre les deux routes de communication avec l'outil de modlisation et le distributeur des composants d'application. Pour chaque route, l'outil de modlisation utilise l'API SOAP BI Bus. Si vous utilisez la route du serveur Web alors que les packs sont de taille moyenne grande (prs de 1 Mo), les modles sont fractionns en lments plus petits (blocs) pour la transmission. Si vous utilisez un serveur Web autre que Microsoft IIS, il est recommand de configurer l'outil de modlisation pour communiquer l'aide de la passerelle du serveur Web (en utilisant la premire route). Cela vous vite de devoir configurer des canaux de communication supplmentaires si vous utilisez des pare-feu pour sparer l'outil de modlisation, le serveur Web et les composants d'application. Pour en savoir davantage sur la configuration de Metric Designer, reportez-vous la section "Installation et configuration de Metric Designer" (p. 219).

Lorsque l'outil de modlisation est situ en dehors du pare-feu rseau qui protge les composants d'application, des problmes de communication peuvent se poser au niveau du distributeur. Pour des raisons de scurit, la configuration implicite d'IBM Cognos 8 empche le distributeur d'accepter les requtes de l'outil de modlisation lorsque ce dernier se situe en dehors du pare-feu rseau. Par dfaut, l'outil de modlisation est configur pour envoyer des requtes directement au distributeur :
Metric Designer Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2 Communication avec les composants d'application
48
Chapitre 3: Options de rpartition pour IBM Cognos 8 Pour viter tout problme lors d'une communication directe avec le distributeur, installez l'outil de modlisation dans le mme niveau architectural que les composants d'application.
Pare-feu rseau Passerelle du serveur Web 1 Pare-feu rseau Composants d'application 2
Metric Designer
Vous pouvez galement installer une passerelle supplmentaire ddie la communication avec l'outil de modlisation. Vous configurez alors l'outil de modlisation et sa passerelle de telle manire que le distributeur accepte les requtes de l'outil de modlisation.
Metric Designer communique avec les composants d'application, que vous pouvez installer sur un ou plusieurs serveurs d'application. Pour publier des extraits, vous devez configurer Metric Designer pour qu'il communique avec le distributeur, soit directement, soit au moyen de la passerelle ddie. Vous devez veiller ce que Metric Designer puisse communiquer avec les autres composants de cration de tableaux de bord IBM Cognos 8. Sur l'ordinateur o Metric Designer est install, configurez les proprits cryptographiques et les proprits d'environnement suivantes : URI de la passerelle URI du distributeur des applications externes
Des tches de configuration supplmentaires sont requises aprs l'installation de Metric Designer, de faon ce que ce dernier puisse accder certains types de sources de donnes (p. 219). Si l'outil de modlisation utilise une passerelle ddie au lieu de communiquer directement avec le distributeur, vous devez galement configurer la proprit URI du distributeur pour la passerelle sur l'ordinateur de la passerelle ddie.
IBM Cognos 8 avec d'autres produits d'IBM Cognos

Vous pouvez installer IBM Cognos 8 dans un environnement incluant d'autres produits d'IBM Cognos. L'assistant d'installation d'IBM Cognos 8 reconnat les rpertoires compatibles et affiche un avertissement en cas de conflits. Une fois qu'IBM Cognos 8 est install, vous pouvez accder dans ce produit des objets crs dans un autre produit d'IBM Cognos. Les conditions requises pour l'accs dpendent du mode d'excution choisi pour les deux produits.
Produits d'IBM Cognos pouvant tre mis niveau vers IBM Cognos 8
Les produits d'IBM Cognos suivants correspondent des versions antrieures des composants faisant maintenant partie d'IBM Cognos 8 : ReportNet, IBM Cognos Metrics Manager, DecisionStream et PowerPlay Web. Lorsque vous mettez niveau ces produits vers IBM Cognos 8, vous pouvez continuer excuter simultanment des versions antrieures dans le mme environnement jusqu' ce que la transition vers IBM Cognos 8 vous convienne.
ReportNet
Pour que ReportNet et IBM Cognos 8 s'excutent simultanment, chaque version doit disposer de ports, d'une base de donnes Content Store, d'alias et de paramtres de tmoin (cookie) uniques. Si vous utilisez les paramtres implicites, la configuration est requise uniquement pour slectionner de nouveaux ports et une nouvelle base de donnes Content Store pour IBM Cognos 8. Vous ne pouvez pas exploiter les donnes ReportNet directement dans IBM Cognos 8 tant que vous ne mettez pas niveau ReportNet. Lorsque vous procdez la mise niveau vers IBM Cognos 8, la base de donnes Content Store est galement mise niveau pour utiliser le schma IBM Cognos 8. Ainsi, vous devez conserver la fois l'ancienne base de donnes Content Store et la nouvelle pour excuter les deux versions de produits. Vous pouvez conserver les deux bases de donnes Content Store en suivant l'une des approches suivantes : Copier la base de donnes Content Store ReportNet et l'utiliser avec IBM Cognos 8 Exporter la base de donnes Content Store ReportNet et l'importer dans IBM Cognos 8
Vous pouvez mettre niveau des rapports simultanment ou ultrieurement si la compatibilit avec des applications SDK existantes est requise.
IBM Cognos Metrics Manager

Pour utiliser le contenu de la bibliothque de donnes d'IBM Cognos Metrics Manager dans IBM Cognos 8, vous devez le mettre niveau en l'exportant, en installant IBM Cognos 8, puis en l'important dans la bibliothque d'indicateurs IBM Cognos 8. Notez que le slecteur de cube (permettant de faire correspondre des indicateurs spcifiques avec des intersections de cubes) d'IBM Cognos Metrics Manager n'est pas disponible dans IBM Cognos 8.
IBM Cognos DecisionStream

Vous pouvez continuer excuter IBM Cognos DecisionStream Series 7 simultanment avec les produits IBM Cognos 8. Les catalogues crs l'aide de DecisionStream Series 7 doivent tre mis niveau pour que vous puissiez les utiliser avec Data Manager. Pour obtenir des instructions concernant l'excution simultane et la mise niveau des catalogues DecisionStream vers l'environnement IBM Cognos 8 Data Manager, consultez le chapitre traitant de la mise niveau d'un catalogue dans le manuel Data Manager User Guide.
IBM Cognos PowerPlay Web

Vous pouvez continuer utiliser des rapports PowerPlay Web dans les interfaces utilisateur PowerPlay 7 du portail IBM Cognos 8. Il est galement possible d'utiliser la fonction d'accs au dtail entre PowerPlay Web et IBM Cognos 8. Vous pouvez procder une publication depuis PowerPlay Enterprise Server vers IBM Cognos 8, condition d'utiliser le mme nom d'hte ou la 50
Chapitre 3: Options de rpartition pour IBM Cognos 8 mme adresse IP pour identifier l'espace-noms Series 7 dans IBM Cognos Series 7 et dans IBM Cognos 8. Vous avez galement la possibilit de mettre niveau les rapports suivants vers IBM Cognos 8 au moyen des outils de migration : rapports PowerPlay Windows, rapports PowerPlay Web Explorer, rapports PowerPlay for Excel, rapports PowerPlay for Windows publis dans PowerPlay Web.
Ces outils sont disponibles sur le site Web Cognos Software Services (support.cognos.com). Pour obtenir des instructions concernant la mise niveau, reportez-vous au manuel Migration Tools User Guide.
Produits IBM Cognos Series 7 pouvant migrer vers IBM Cognos 8

Vous pouvez migrer des mtadonnes et des applications d'IBM Cognos Series 7 vers IBM Cognos 8. Les lments pouvant faire l'objet d'une migration incluent les modles Architect conus dans Windows, les catalogues et rapports de clients Impromptu crs dans Windows, le contenu d'Upfront et le contenu Web provenant de Windows et d'UNIX. Pour en savoir davantage, reportez-vous au manuel Migration Tools User Guide. Pour obtenir la liste des versions d'IBM Cognos Series 7 prises en charge et pour tlcharger les outils de migration et la documentation, reportez-vous au site Web Cognos Software Services (http: //support.cognos.com).
Architect
Vous pouvez migrer des modles Architect afin de les utiliser comme source de mtadonnes pour Framework Manager.
Impromptu
Vous pouvez migrer les rapports et les catalogues Impromptu vers IBM Cognos 8. Les catalogues migrs peuvent tre utiliss comme source de mtadonnes pour Framework Manager. Une fois le processus de migration de catalogues termin, vous pouvez migrer et dployer les rapports Impromptu.
Upfront
Vous pouvez migrer un contenu Upfront vers IBM Cognos 8. Le processus de migration met en correspondance la structure du contenu Upfront avec celle d'un dossier IBM Cognos Connection. tant donn que l'organisation Upfront existante est conserve, il est plus facile d'effectuer des tches d'administration, telles que l'application de la scurit au contenu migr.
Rapports Impromptu Web Reports

Vous pouvez migrer le contenu de rapports Impromptu Web Reports, tel que des calendriers et des vnements, vers IBM Cognos 8. Pour effectuer cette opration, vous pouvez utiliser un pack
Chapitre 3: Options de rpartition pour IBM Cognos 8 Deployment Manager d'IBM Cognos Series 7 comme source de migration. Avant les rapports Impromptu Web Reports, vous devez migrer les mtadonnes de catalogues Impromptu qui sont utilises par les rapports. Il n'est pas possible de migrer des fichiers .iqd (Impromptu Query Definition), mais vous pouvez continuer utiliser des fichiers .iqd existants pour crer des cubes dans IBM Cognos 8 BI Transformer 8.4. Pour ce faire, vous devez installer le composant facultatif, Series 7 IQD Bridge, qui peut tre install avec IBM Cognos 8 BI sur des plates-formes prises en charge par IBM Cognos Series 7. Les lments PowerPrompts ne sont pas migrs, mais vous pouvez mettre en uvre des fonctions similaires en utilisant la fonctionnalit d'administrateur intgre ou le Software Development Kit.
Produits d'IBM Cognos fonctionnant avec IBM Cognos 8

Certains produits d'IBM Cognos offrent des fonctions non disponibles dans IBM Cognos 8. Vous pouvez utiliser ces produits dans le mme environnement qu'IBM Cognos 8. Avec certains produits, vous pouvez accder aux diffrents types de cubes ou rapports dans le portail IBM Cognos 8. Avec d'autres, vous pouvez uniquement accder aux fonctionnalits du portail IBM Cognos 8.
IBM Cognos Planning - Analyst

Vous pouvez accder aux donnes de plans publis dans IBM Cognos 8 l'aide de l'assistant Generate Framework Manager Model, qui requiert IBM Cognos Planning - Analyst 7.3 MR1 ou version ultrieure. Pour en savoir davantage, reportez-vous au Guide de l'utilisateur d'Analyst.
IBM Cognos PlanningContributor

Vous pouvez accder aux cubes Contributor (en temps rel) dans IBM Cognos 8 en procdant une installation personnalise du composant IBM Cognos 8 - Contributor Data Server qui est fourni avec IBM Cognos Planning - Contributor 7.3 MR1 ou ultrieure. Vous pouvez accder aux donnes de plans publis dans IBM Cognos 8 l'aide de l'extension d'administration Generate Framework Manager Model, qui requiert IBM Cognos Planning - Analyst 7.3 MR1 ou version ultrieure. Pour en savoir davantage, reportez-vous au manuel Contributor Administration Guide.
IBM Cognos Finance

Vous pouvez accder aux cubes IBM Cognos Finance scuriss par rapport un espace-noms Series 7 au moyen du service d'API rseau IBM Cognos Finance. Il est galement possible d'exporter des donnes et des mtadonnes partir d'IBM Cognos Finance pour les utiliser dans Framework Manager.
IBM Cognos Controller

Vous pouvez accder IBM Cognos 8 pour crer des rapports standard IBM Cognos Controller au moyen d'un modle Framework Manager prdfini, cr lors de l'installation d'IBM Cognos Controller. Vous avez galement la possibilit d'accder des structures et des donnes Controller publies dans Framework Manager pour produire des analyses et des rapports personnaliss. IBM Cognos Controller et IBM Cognos 8 BI doivent tre au mme niveau de version.
52
Transformer
Vous pouvez utiliser directement dans IBM Cognos 8 les cubes IBM Cognos et les modles Transformer crs par Transformer 7.3 ou version ultrieure. Les cubes et modles sont compatibles avec les versions ultrieures et ne requirent pas d'outil de migration ou de mise niveau. Vous pouvez excuter des rapports et des analyses dans IBM Cognos 8 par rapport aux cubes IBM Cognos. Si vous voulez utiliser les nouvelles fonctions d'intgration de Transformer avec IBM Cognos 8, vous pouvez mettre niveau les modles IBM Cognos Series 7.x Transformer vers IBM Cognos 8 BI Transformer 8.4. Vous pouvez ainsi utiliser les sources de donnes IBM Cognos 8 (telles que les packs publis), dresser la liste des rapports crs dans Query Studio ou Report Studio, procder l'authentification via la scurit IBM Cognos 8 et publier directement les donnes dans IBM Cognos Connection. Avant de charger le modle, l'espace-noms IBM Cognos Series 7 doit tre configur dans IBM Cognos 8 (p. 270) et l'identificateur de nom utilis pour le configurer dans IBM Cognos 8 doit correspondre au nom utilis dans IBM Cognos Series 7. Pour en savoir davantage sur la mise niveau de cubes scuriss IBM Cognos Series 7, reportezvous Guide de l'utilisateur d'IBM Cognos 8 Transformer. Pour que les cubes IBM Cognos Series 7 puissent tre utiliss dans IBM Cognos 8, nous vous recommandons de les optimiser des fins d'utilisation dans IBM Cognos 8 l'aide de l'utilitaire pcoptimizer, fourni avec IBM Cognos 8. Si vous n'effectuez pas cette opration, les cubes crs avec les versions antrieures de Transformer risquent d'tre trs longs s'ouvrir dans les studios Web d'IBM Cognos 8. Cet utilitaire d'optimisation convient aux cubes des versions antrieures dont les modles n'existent plus ainsi qu'aux cubes crs partir de donnes qui ne sont plus disponibles. Il n'est pas ncessaire d'excuter cet utilitaire pour les cubes crs dans Transformer 8,4. Pour en savoir davantage sur l'optimisation des cubes, reportez-vous au Guide de l'utilisateur de Transformer. Vous pouvez publier des cubes l'aide de Transformer 8.4, de Framework Manager ou directement dans le portail IBM Cognos 8. Vous pouvez publier des sources de donnes de cubes et des packs individuels dans IBM Cognos Connection de faon interactive, par le biais de Transformer ou de la ligne de commande. Vous pouvez galement procder une publication silencieuse l'aide de scripts de traitement par lots, aprs avoir cr un cube. Un utilisateur habilit crer des sources de donnes et des packs dans IBM Cognos Connection peut galement y publier des cubes. Le fichier MDC doit se trouver dans un emplacement scuris auquel le distributeur IBM Cognos 8 doit pouvoir accder. Les packs qui utilisent plusieurs cubes ou des cubes combins avec d'autres sources de donnes doivent tre publis l'aide de Framework Manager. Si vous utilisez un cube IBM Cognos Series 7 comme source de donnes, IBM Cognos 8 convertit ses donnes en fonction de l'encodage utilis sur le systme o le cube a t cr. Pour garantir la russite de la conversion, vous devez crer les cubes IBM Cognos Series 7 avec des paramtres rgionaux dfinis pour s'adapter aux donnes du cube.
Data Manager
Data Manager sert crer et grer des entrepts et des rfrentiels de donnes pour la cration de rapports, l'analyse et la gestion des performances. Lorsque Data Manager est install dans votre environnement IBM Cognos 8, vous pouvez utiliser le service de transfert de donnes pour excuter des oprations de cration et des flux de travaux dans IBM Cognos Connection. Vous devez installer
Chapitre 3: Options de rpartition pour IBM Cognos 8 le moteur Data Manager dans le mme emplacement que les composants d'application d'IBM Cognos 8. Data Manager et IBM Cognos 8 BI doivent tre au mme niveau de version.
IBM Cognos 8 Go! Mobile

Avec IBM Cognos 8 Go! Mobile, vous pouvez accder des rapports crs l'aide d'Analysis Studio, de Report Studio et de Query Studio sur un appareil mobile (un BlackBerry, par exemple). En plus des composants de serveur IBM Cognos 8, IBM Cognos 8 Go! Mobile ncessite qu'un client riche spcialement adapt soit install sur le priphrique mobile, afin de permettre le tlchargement et l'affichage de rapports et l'interaction avec ceux-ci. IBM Cognos 8 Go! Mobile et IBM Cognos 8 BI doivent tre au mme niveau de version.
IBM Cognos 8 Go! Search

Le module d'extension IBM Cognos 8 Go! Search fournit des options avances de recherche et de navigation dans IBM Cognos 8. Dans IBM Cognos Connection, vous pouvez utiliser la recherche plein texte pour trouver des donnes. Dans Analysis Studio, Query Studio et IBM Cognos Viewer, vous pouvez utiliser la recherche plein texte et la navigation automatique pour trouver du contenu relatif aux donnes affiches. La base de donnes Content Store IBM Cognos 8 doit inclure du contenu indexable. IBM Cognos 8 Go! Search et IBM Cognos 8 BI doivent tre au mme niveau de version.
Contenu IBM Cognos Series 7 pouvant tre cr nouveau dans IBM Cognos 8
Il est impossible de migrer ou de mettre niveau par le biais de la programmation certains produits d'IBM Cognos avec les outils de migration ou de mise niveau pour IBM Cognos 8. IBM Cognos 8 offre deux options pour dupliquer le contenu ou les fonctions des produits dcrits ci-dessous : utiliser le portail Upfront dans le portail IBM Cognos 8 ou dupliquer des requtes, des visualisations ou des objets au moyen des studios IBM Cognos 8.
IBM Cognos Query

Vous pouvez utiliser les outils de migration pour identifier les objets IBM Cognos Query dans la source de migration IBM Cognos Series 7. Il est alors possible de dupliquer la plupart des fonctions d'IBM Cognos Query dans IBM Cognos 8. Les interrogations de base sont disponibles dans IBM Cognos 8 lorsque vous migrez un modle Architect. Vous pouvez galement dupliquer manuellement des requtes enregistres l'aide des composants SQL de Report Studio.
IBM Cognos Visualizer

Vous pouvez dupliquer des fonctions en utilisant les options de cration de graphiques, de prsentation et de mise en forme de Report Studio et d'Analysis Studio.
IBM Cognos NoticeCast

Vous pouvez dupliquer les fonctions d'alerte et de notification en utilisant Event Studio et d'autres composants d'IBM Cognos 8.
IBM Cognos Web Services

Vous pouvez dupliquer la plupart des fonctions IBM Cognos Web Services l'aide d'IBM Cognos 8 Software Development Kit. 54
IBM CognosScript
Vous pouvez dupliquer les fonctions d'automatisation l'aide d'IBM Cognos 8 Software Development Kit.
IBM Cognos Portal Services

Vous pouvez dupliquer la plupart des fonctions IBM Cognos Portal Services l'aide d'IBM Cognos Connection.
56
Chapitre 4: Prparation de l'installation

Avant d'installer IBM Cognos 8, vous devez configurer des ressources dans votre environnement, afin que les composants puissent fonctionner. Vous devez notamment crer une base de donnes utiliser comme Content Store, configurer les navigateurs Web et crer un compte utilisateur pour IBM Cognos 8. Si vous souhaitez utiliser la base de donnes de contenu d'IBM Cognos comme Content Store, vous n'avez pas besoin de crer une base de donnes ou de configurer un client de base de donnes. Une base de donnes est cre au cours de l'installation et IBM Cognos 8 est configur pour l'utiliser. Utilisez la liste de contrle suivante comme guide de configuration : Consultation du fichier Lisezmoi Vrification des environnements pris en charge Vrification de la configuration systme requise Vrification des paramtres de port implicites Configuration de la connectivit la base de donnes Content Store Configuration de la connectivit la base de donnes de cration de rapports Configuration de la connectivit la base de donnes de la bibliothque d'indicateurs Cration de la base de donnes Content Store Configuration du client de base de donnes Content Store (Oracle, DB2 et Sybase) et, si vous utilisez IBM Cognos 8 Metrics Manager, d'une bibliothque d'indicateurs (Oracle et DB2) Configuration des variables d'environnement sous UNIX pour la bibliothque d'indicateurs, si vous utilisez IBM Cognos 8 Metrics Manager Configuration des navigateurs Web. Configuration de connexions ODBC vers Sybase IQ ou Netezza, le cas chant. Configuration du routeur pour tester la disponibilit du distributeur, le cas chant Configurez un utilisateur ou un compte de serveur de rseau pour IBM Cognos 8 .
Une fois ces tches effectues, poursuivez la procdure avec l'installation des composants d'IBM Cognos 8 sur un seul ordinateur ou l'installation des composants serveur d'IBM Cognos 8 dans une installation rpartie.
Recommandation - Consultation du fichier Lisezmoi avant l'installation

Avant d'installer votre produit IBM Cognos, il est important de connatre tous les points pouvant avoir une incidence sur votre stratgie d'installation. Il peut exister des problmes rcents qui n'taient pas connus lors de la cration de ce guide. Il est recommand de consulter le fichier Lisezmoi avant d'installer le produit. Le fichier Lisezmoi contient des informations de dernire minute sur les problmes connus, ainsi que des mises jour de la documentation et des avis relatifs l'obsolescence. Il est disponible depuis la premire page de l'Assistant d'installation ou sur le CD du produit.
tude des environnements pris en charge

Afin de garantir le bon fonctionnement de vos produits, veillez appliquer tous les programmes de correction requis au systme d'exploitation et n'utiliser que les versions d'autres logiciels prises en charge par le produit d'IBM Cognos. Pour consulter une liste jour des environnements pris en charge par les produits d'IBM Cognos, tels que les systmes d'exploitation, les programmes de correction, les navigateurs, les serveurs Web, les serveurs d'annuaire, les serveurs de bases de donnes et les serveurs d'application Visitez le site Web Software Services de Cognos (http://support.cognos.com). Il est important de noter que le systme d'exploitation Linux est disponible dans plusieurs versions et prend en charge plusieurs plates-formes. Assurez-vous que le systme d'exploitation et la combinaison de matriel que vous utilisez sont pris en charge.
Vrification de la configuration systme requise

Utilisez le tableau ci-dessous pour connatre les configurations matrielle et logicielle minimales requises pour installer et excuter les composants d'IBM Cognos 8 sur un ordinateur. D'autres ressources peuvent s'avrer ncessaires pour les environnements rpartis ou les environnements de production.
Spcifications
Systme d'exploita- Windows tion UNIX : Sun Solaris HP-UX IBM AIX
Linux Certains composants d'IBM Cognos 8 ne sont pas pris en charge sous Linux. 58
RAM Spcifications pour le systme d'exploitation Espace disque
Spcifications
Minimum : 2 Go Limite de descripteur de fichier fixe 1024 sur Solaris (recommand)
Un minimum de 2,5 Go d'espace libre est requis pour installer le logiciel, ainsi que 1 Go d'espace libre sur le lecteur contenant le rpertoire temporaire utilis par les composants d'IBM Cognos. Pour IBM Cognos 8 Metrics Manager, la taille de la bibliothque d'indicateurs s'accrot au fil du temps. Prvoyez suffisamment d'espace disque pour la suite.
Serveur Web JRE
Un serveur Web doit tre install et dmarr. Java Runtime Environment (JRE) JRE est automatiquement install avec IBM Cognos 8 sous Windows. Si vous employez un serveur d'application, utilisez le module JRE install avec celui-ci, s'il est pris en charge dans IBM Cognos 8.
Base de donnes
La base de donnes de contenu d'IBM Cognos peut tre installe et configure en tant que base de donnes de contenu implicite. Si vous souhaitez utiliser une autre base de donnes, vous devez disposer de l'une des bases de donnes suivantes pour le stockage des donnes d'IBM Cognos : Oracle DB2 Microsoft SQL Server Connectivit TCP/IP Microsoft SQL Server Sybase
Pour IBM Cognos 8 Metrics Manager, les bases de donnes suivantes sont prises en charge par la bibliothque d'indicateurs : Oracle DB2 Microsoft SQL Server Connectivit TCP/IP Microsoft SQL Server
navigateur Web
Spcifications
Pour tous les navigateurs Web, les lments suivants doivent tre activs : Tmoins (cookies) JavaScript
Pour Microsoft Internet Explorer uniquement, les fonctions suivantes doivent tre actives : Autre Excuter les contrles ActiveX et les plug-ins Contrles ActiveX reconnus srs pour l'criture de scripts Active Scripting META REFRESH autoris
Pour qu'un mulateur de terminal installe IBM Cognos 8 sous UNIX, mulation dfinie sur l'quivalent VT220 ou mieux pour garantir que les touches de raccourci clavier de l'Assistant d'installation fonctionnent. Sous Windows, composant MDAC (Microsoft Data Access Component) utiliser avec les exemples de produits Si vous voulez envoyer les rapports par courrier lectronique, possibilit d'utiliser un serveur de messagerie.
SAP BW
Les composants frontaux SAP suivants, installs sur chaque serveur IBM Cognos 8 : Interface utilisateur graphique SAP Complments BW
Vrification des paramtres de port implicites d'IBM Cognos 8

Le tableau ci-dessous rpertorie les ports et les paramtres d'URI implicites de la solution IBM Cognos 8. Aprs installation, vous pouvez utiliser l'outil de configuration pour modifier ces paramtres (p. 309). Vous pouvez galement les modifier en ditant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8\configuration.
Paramtre
URI de Content Manager
Implicite
http://localhost:9300/p2pd/servlet
Description
Indique l'URI de Content Manager. Indique l'URI de la passerelle.
URI de la passerelle
http://localhost:80/cognos8/cgi-bin/cognos.cgi
60
Paramtre
URI du distributeur (Interne, externe) URI du distributeur des applications externes
Implicite
http://localhost:9300/p2pd/servlet/dispatch
Description
Indique l'URI du distributeur. Indique l'URI du distributeur. URI du distributeur principal utilis par la passerelle Indique le port utilis par le serveur de journalisation local. Indique le port utilis par la base de donnes de contenu d'IBM Cognos.
URI du distributeur pour la http://localhost:9300/p2pd/servlet/dispatch/ext passerelle
Ports du serveur de journali- 9362 sation
Numro de port d'coute
1527
Le tableau ci-dessous prsente les paramtres implicites utiliss par IBM Cognos 8 pour Tomcat. Les connecteurs SSL et non SSL sont automatiquement mis jour dans le fichier server.xml lorsque vous utilisez IBM Cognos Configuration pour modifier le port du distributeur (p. 309) ou pour activer le protocole SSL (p. 325). IBM Cognos Configuration permet de directement mettre jour le port dsactiver.
Paramtre
Connecteur non SSL Coyote HTTP/1.1 Connecteur SSL Coyote HTTP/1.1 Port d'arrt
Port
9300
Description
Port utilis par Tomcat pour transmettre des demandes du serveur Web IBM Cognos 8 Port que Tomcat utilise pour couter les connexions scurises Port que Tomcat utilise pour couter les commandes d'arrt
9334 9399
Configuration de la connectivit la base de donnes Content Store

Si vous utilisez une base de donnes autre que la base de donnes de contenu d'IBM Cognos en tant que Content Store, un logiciel client de base de donnes doit tre install et configur sur chaque ordinateur sur laquelle vous installez Content Manager. Pour configurer la connectivit la base de donnes Content Store, procdez comme suit :
Chapitre 4: Prparation de l'installation Installez le pilote JDBC correspondant votre base de donnes Content Manager, comme indiqu ci-dessous :
Base de donnes
DB2 Oracle
Pilote JDBC
Pilote JDBC ncessitant l'installation du client DB2 Pilote JDBC Thin, ojdbc14.jar Pour Oracle 11g, ojdbc5.jar Si le rpertoire contient le fichier classes12.jar, vous devez le supprimer avant d'installer le fichier ojdbc14.jar ou ojdbc5.jar.
Microsoft SQL Server
Inclus avec les composants IBM Cognos. Aucun autre logiciel n'est requis. IBM Cognos 8 ncessite une connectivit TCP/IP avec Microsoft SQL Server.
Sybase
Pilote JDBC, jconn2.jar
Base de donnes de Inclus avec les composants IBM Cognos. Aucun autre logiciel n'est contenu d'IBM Cognos requis.
Configuration de la connectivit la base de donnes de cration de rapports

Pour IBM Cognos 8, le seul service qui accde la base de donnes de requte (galement appele base de donnes d'excution de rapports) est le moteur excutant les rapports. Pour configurer la connectivit la base de donnes de cration de rapports, procdez comme suit : Veillez installer le logiciel API de base de donnes pour les sources d'excution de rapports sur chaque serveur IBM Cognos 8. Sous Windows, le serveur de rapports prend en charge la connectivit la base de donnes native ou ODBC. Sous UNIX et Linux, le serveur de rapports prend en charge la connectivit la base de donnes native. Sous UNIX, pour Microsoft SQL Server uniquement, le serveur de rapports prend en charge le pilote Data Direct ODBC. Ce pilote est disponible auprs de Data Direct. IBM Cognos 8 ncessite une connectivit TCP/IP avec Microsoft SQL Server.
62
Configuration de la connectivit la base de donnes de la bibliothque d'indicateurs

Pour IBM Cognos 8 Metrics Manager, les composants d'application doivent tre en mesure d'accder la bibliothque d'indicateurs. Le logiciel client de base de donnes pour la bibliothque d'indicateurs doit tre install et configur sur chaque ordinateur sur lequel les composants d'application sont installs. Pour configurer la connectivit la base de donnes de la bibliothque d'indicateurs, procdez comme suit : Installez le pilote JDBC appropri.
Base de donnes Pilote JDBC

DB2 Oracle Pilote JDBC ncessitant l'installation du client DB2 Pilote JDBC OCI
Microsoft SQL Ser- Inclus avec les composants IBM Cognos. Aucun autre logiciel n'est requis. ver IBM Cognos 8 ncessite une connectivit TCP/IP avec Microsoft SQL Server.
Cration de la base de donnes Content Store

Le Content Store est une base de donnes que Content Manager utilise pour stocker des donnes de configuration globales, des paramtres gnraux (par exemple, la langue et l'unit montaire utilises dans l'interface), des connexions des sources de donnes et du contenu spcifique aux produits. Les modles de conception et les fichiers journaux ne sont pas stocks dans Content Store. Par dfaut, les produits IBM Cognos 8 partagent la base de donnes Content Store. Vous devez crer cette base de donnes l'aide d'une des applications suivantes : DB2 Oracle Microsoft SQL Server Sybase Adaptive Server Enterprise (ASE)
Sous Linux, vous pouvez utiliser une base de donnes DB2, Oracle ou de contenu d'IBM Cognos pour Content Store. Une base de donnes DB2 ou Sybase doit utiliser l'encodage UTF-8. Une base de donnes Oracle ou Microsoft SQL Server peut utiliser l'encodage UTF-8 ou UTF-16. Toutes les bases de donnes doivent utiliser le protocole TCP/IP, requis par IBM Cognos 8 pour accder aux donnes. Il est noter qu'IBM Cognos 8 utilise un seul ordre de tri spcifiant les rgles que la base de donnes utilise pour interprter, collecter, comparer et prsenter les donnes de texte. Un ordre de tri dfinit, Guide d'installation et de configuration 63
Chapitre 4: Prparation de l'installation par exemple, si la lettre A possde une valeur de position infrieure, gale ou suprieure la lettre B, si l'assemblage est sensible la casse et l'accentuation. Pour en savoir davantage sur l'assemblage et les squences d'assemblage, reportez-vous la documentation relative la base de donnes. L'administrateur de base de donnes doit sauvegarder rgulirement les bases de donnes IBM Cognos 8, car elles contiennent toutes les donnes d'IBM Cognos.Pour garantir la scurit et l'intgrit des bases de donnes, protgez-les contre tout accs non autoris ou inappropri. Si vous procdez une mise niveau depuis ReportNet, vous pouvez utiliser votre base de donnes Content Store existante avec IBM Cognos 8. Une fois que la base de donnes Content Store a t mise niveau vers IBM Cognos 8, vous ne pouvez plus l'utiliser avec ReportNet. Si vous procdez une mise niveau et que vous souhaitez conserver la version existante de ReportNet, vous devez crer une base de donnes Content Store pour IBM Cognos 8. Vous devez suivre la procdure de mise niveau adquate (p. 92) lorsque vous crez la base de donnes Content Store. Si vous avez install la base de donnes de contenu d'IBM Cognos pour l'utiliser en tant que base de donnes Content Store, une base de donnes a dj t cre et configure. Cependant, vous pouvez crer une autre instance de base de donnes en utilisant la base de donnes de contenu d'IBM Cognos.
Procdure pour DB2

1. Dfinissez les variables d'environnement suivantes pour DB2 :
Variable d'environne- Description ment

DB2DIR Rpertoire de niveau suprieur qui contient le logiciel client de base de donnes ou l'installation complte de la base de donnes. Chemin d'accs la bibliothque de chargement. Vous devez ajouter l'emplacement du pilote. Exemples : Sous Solaris : LD_LIBRARY_PATH= $DB2DIR/lib: $LD_LIBRARY_PATH Sous AIX : LIBPATH=$DB2DIR/lib: $LIBPATH Sous HP-UX : SHLIB_PATH=$DB2DIR/lib: $SHLIB_PATH DB2INSTANCE DB2CODEPAGE Connexion au serveur de base de donnes implicite. L'affectation de la valeur 1208 cette variable d'environnement facultative permet la prise en charge de bases de donnes multilingues. Pour en savoir davantage sur l'usage de cette variable d'environnement, reportez-vous la documentation sur DB2.
bibliothquePATH
64
Chapitre 4: Prparation de l'installation 2. Crez une base de donnes et assurez-vous de bien slectionner UTF-8 comme valeur d'ensemble de codes. Pour vrifier que votre base de donnes dispose de l'ensemble de codes appropri, saisissez l'invite dans l'interface de ligne de commande : db2 get database configuration for nom_base_de_donnes La valeur de l'ensemble de codes doit tre UTF-8 et celle de la page de codes doit tre 1208. 3. Veillez dfinir les paramtres de configuration suivants pour la base de donnes :
Paramtre
Paramtre
Taille de segment mmoire de l'application 1024 Ko (applheapsz) Dlai d'attente de verrouillage (locktimeout) 240 secondes Ne dfinissez pas de dlai d'attente infini pour cette proprit.
4. Crez un groupe de mmoire tampon avec une taille de page de 32 Ko et un autre avec une taille de page de 4 Ko. 5. Crez un espace de table systme temporaire l'aide du groupe de mmoire tampon de 32 Ko cr l'tape prcdente. 6. Crez un espace de table utilisateur temporaire l'aide du groupe de mmoire tampon de 4 Ko cr l'tape 4. Les tables temporaires globales sont cres dans l'espace de table utilisateur temporaire. 7. Crez un espace de table utilisateur standard l'aide du groupe de mmoire tampon de 4 Ko cr l'tape 4. Si vous crez aussi une base de donnes de journalisation, crez un autre espace de table utilisateur standard, avec une taille de page de 8 Ko. 8. Accordez les droits d'accs la base de donnes suivants au compte utilisateur qu'IBM Cognos 8 utilisera pour accder la base de donnes : connect to database create tables create schemas implicitly
Conseil : Pour hberger plusieurs bases de donnes Content Store sur l'instance de DB2 et les utiliser simultanment, utilisez un compte utilisateur diffrent pour chaque base de donnes Content Store, de faon ce que les instances d'IBM Cognos 8 soient parfaitement indpendantes les unes des autres.
Chapitre 4: Prparation de l'installation 9. Assurez-vous que le compte utilisateur dispose des droits d'accs Use pour l'espace de table utilisateur temporaire et pour les autres espaces de table appropris associs la base de donnes. Sous Windows XP, assurez-vous que le compte utilisateur dispose des droits d'accs Grant pour l'espace de table utilisateur temporaire. 10. Crez un schma pour le compte utilisateur qu'IBM Cognos 8 utilisera pour accder la base de donnes et vrifiez que l'utilisateur dispose de droits de cration, de suppression et de modification sur le schma.
Procdure pour Oracle

1. Assurez-vous que le paramtre du niveau de compatibilit de l'instance de base de donnes de Content Store est dfini 9.0.1 ou plus. Pour en savoir davantage sur la modification du paramtre de configuration d'une instance, reportez-vous la documentation Oracle. 2. Dterminez si la base de donnes est Unicode. Conseil : L'une des mthodes consiste saisir l'instruction select suivante : select * from NLS_DATABASE_PARAMETERS Les rsultats indiquent que NLS_CHARACTERSET est UTF-8, UTF-16, AL32UTF8, AL16UTF16 ou non Unicode. Si l'ensemble de rsultats renvoie un lment NLS_CHARACTERSET non Unicode, crez une base de donnes en indiquant AL32UTF8 ou UTF-8 comme paramtres du jeu de caractres de la base de donnes. 3. Indiquez quel compte utilisateur sera utilis pour accder la base de donnes. Conseil : Pour hberger plusieurs bases de donnes Content Store sur l'instance d'Oracle et les utiliser simultanment, utilisez un compte utilisateur diffrent pour chaque base de donnes Content Store, de faon ce que les instances d'IBM Cognos 8 soient parfaitement indpendantes les unes des autres. 4. Assurez-vous que le compte utilisateur qui accde la base de donnes dispose des autorisations appropries pour effectuer les oprations suivantes : Connexion la base de donnes Cration, modification et annulation des tables, des lments dclencheurs, des vues, des procdures et des squences Insertion, mise jour et suppression de donnes dans les tables de la base de donnes
Procdure pour Microsoft SQL Server 2005

1. Assurez-vous que votre installation de Microsoft SQL Server est configure de la faon suivante : L'encodage UTF-8 ou UTF-16 est utilis. Pour en savoir davantage sur les jeux de caractres, l'encodage et l'assemblage, reportezvous la documentation de Microsoft SQL.
66
Chapitre 4: Prparation de l'installation La squence d'assemblage est sensible la casse. Dans le cadre d'une installation personnalise, vous choisissez un assemblage, qui comprend des jeux de caractres et un ordre de tri, lors de la configuration de SQL Server. Dans le cadre d'une installation standard, l'installation utilise les paramtres rgionaux identifis par le programme d'installation pour l'assemblage. Par la suite, ce paramtre ne pourra pas tre modifi. Le protocole TCP/IP est activ. Ce protocole est requis par IBM Cognos 8 pour accder aux donnes. 2. Ouvrez Microsoft SQL Server Management Studio et connectez-vous au serveur de base de donnes l'aide de l'authentification de serveur SQL. Si vous vous connectez l'aide de l'authentification Windows, la base de donnes que vous allez crer utilisera galement ce type d'authentification. IBM Cognos 8 est configur par dfaut pour utiliser une base de donnes avec authentification de serveur SQL. 3. Crez la base de donnes. Si vous vous tes connect au serveur de base de donnes en utilisant l'authentification Windows, vous devez configurer la connexion la base de donnes l'aide d'un type Base de donnes Microsoft SQL Server (Authentification Windows) dans IBM Cognos Configuration. Pour en savoir davantage, reportez-vous la section "Dfinition des proprits de connexion la base de donnes Content Store" (p. 128). 4. Crez le compte utilisateur qui sera utilis pour accder la base de donnes : Sous Security, cliquez avec le bouton droit de la souris sur Logins et slectionnez l'option New Login. Indiquez un nom de connexion. Slectionnez SQL Server authentication et indiquez le mot de passe dans la zone Password. Dslectionnez l'option Enforce password policy. Les trois cases sont ainsi dslectionnes. Cliquez sur OK.
Conseil : Pour hberger plusieurs bases de donnes Content Store sur l'instance de Microsoft SQL Server et les utiliser simultanment, utilisez un compte utilisateur diffrent pour chaque base de donnes Content Store, de faon ce que les instances d'IBM Cognos 8 soient parfaitement indpendantes les unes des autres. 5. Crez un schma : Sous Databases, dveloppez la base de donnes (nouvelle_base_de_donnes) cre l'tape 3. Sous nouvelle_base_de_donnes, dveloppez Security. Cliquez avec le bouton droit de la souris sur Schemas, puis slectionnez New Schema. Indiquez le nom du schma dans la zone Schema name, puis cliquez sur OK. Guide d'installation et de configuration 67
Chapitre 4: Prparation de l'installation 6. Configurez l'utilisateur de base de donnes : Sous Databases, nouvelle_base_de_donnes, Security, cliquez avec le bouton droit de la souris sur Users, puis slectionnez New User. Indiquez le nom de l'utilisateur dans la zone User name. Pour l'option Login name, accdez l'identifiant cr l'tape 4 et slectionnez-le. Pour l'option Default schema, accdez au schma cr l'tape 5 et slectionnez-le. Dans la liste Owned Schemas, slectionnez le mme schma que celui dfini par l'option Default schema. Dans la liste Role Members, slectionnez db_datareader, db_datawriter et db_ddladmin. Cliquez sur OK.
7. Rptez les tches 4 6 pour chaque nouveau compte utilisateur.
Procdure pour Sybase Adaptive Server Enterprise

1. Sur le serveur Sybase, crez une instance de serveur avec une page serveur de 8 Ko. Pour en savoir davantage, reportez-vous la documentation de Sybase. 2. Au besoin, installez jConnect version 5.5. Cet outil tablit la communication entre le pilote JDBC et l'instance de Sybase Adaptive Server. Pour en savoir davantage, reportez-vous la documentation de Sybase. Si votre version de Sybase n'inclut pas JConnect 5.5, vous devez tlcharger le programme d'installation partir du site Web de Sybase. 3. Ajoutez le jeu de caractres UTF-8 l'instance de serveur. 4. Au besoin, dfinissez-le comme jeu de caractres implicite du serveur. 5. Crez une instance de base de donnes. Conseil : Dfinissez log_segment sur une valeur minimum de 10 Mo. 6. Dfinissez-la comme instance de base de donnes par dfaut. Les informations relatives la nouvelle base de donnes seront stockes dans la nouvelle instance de base de donnes. Conservez une copie de sauvegarde de l'instance de base de donnes en vue d'une ventuelle rcupration. 7. Crez la base de donnes. 8. Indiquez quel compte utilisateur sera utilis pour accder la base de donnes. Conseil : Pour hberger plusieurs bases de donnes Content Store sur votre instance de serveur Sybase tout en les exploitant, employez un compte utilisateur diffrent pour chaque base de donnes Content Store, de faon ce que toutes les instances d'IBM Cognos 8 soient parfaitement indpendantes les unes des autres.
68
Chapitre 4: Prparation de l'installation 9. Accordez, crez et annulez les droits d'accs la base de donnes pour le compte utilisateur. Vrifiez que le compte utilisateur dispose des droits d'accs suivants la base de donnes : cration de valeurs implicites, de procdures, de rgles, de tables et de vues. 10. Pour la base de donnes, dfinissez la proprit Select into sur Vrai et redmarrez le serveur.
Procdure pour la base de donnes de contenu d'IBM Cognos

1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\derby10.1.2.1\bin. Vous n'avez effectuer cette tche que si vous voulez crer une autre base de donnes Content Store dans la base de donnes de contenu d'IBM Cognos. Une base de donnes a t cre lors de l'installation de la base de donnes de contenu d'IBM Cognos et IBM Cognos 8 est dj configur pour utiliser cette base de donnes. 2. Dmarrez l'utilitaire ij avec le script ij.bat ou ij.ksh. L'utilitaire ij est un utilitaire de ligne de commande destin crer et grer la base de donnes de contenu d'IBM Cognos. 3. Crez une base de donnes en saisissant la commande suivante dans l'utilitaire ij : connect 'jdbc:derby://hte:port/nom_base;create=true;user=nom_utilisateur; password=mot_de_passe'; Par exemple, pour crer une base de donnes appele contentstore sur le numro de port 1527 de l'ordinateur localhost, en tant qu'utilisateur cognos avec le mot de passe of cognos, vous devriez saisir : connect 'jdbc:derby://localhost:1527/contentstore;create=true;user=cognos;password=cognos'; Le nom de la base de donnes est sensible la casse. Les fichiers de la base de donnes se trouvent dans le rpertoire emplacement_c8\contentstore. 4. Fermez l'utilitaire ij en saisissant la commande suivante : disconnect;
Configuration du client de base de donnes

Si vous utilisez DB2, Oracle ou Sybase comme serveur de base de donnes pour Content Store, vous devez configurer le client de base de donnes sur chaque ordinateur o Content Manager, Framework Manager ou IBM Cognos 8 Transformer est install. Le client de base de donnes prend en charge l'utilisation des packs et rapports IBM Cognos 8, en tant que sources de donnes, dans Framework Manager et IBM Cognos 8 Transformer. Pour configurer le client de base de donnes, procdez comme suit :
Base de donnes
DB2
Tches complmentaires
Configurez le logiciel client de base de donnes et le pilote JDBC 2.0. Sous UNIX, vrifiez que les bibliothques DB2 32 bits figurent dans le chemin d'accs aux bibliothques (gnralement le rpertoire $DB2DIR/lib ou $DB2DIR/lib32).
Oracle Sybase
Configurez le pilote JDBC. Configurez le pilote JDBC.
Microsoft SQL Server Aucune tche supplmentaire n'est requise. Par dfaut, le fichier JSQLConnect.jar est install dans l'emplacement appropri. Base de donnes de contenu d'IBM Cognos Aucune tche supplmentaire n'est requise.
Si vous utilisez DB2 ou Oracle pour les bibliothques d'indicateurs, vous devez configurer les lments suivants sur chaque ordinateur sur lequel les composants d'application d'IBM Cognos 8 Metrics Manager ou Metric Designer sont installs :
Base de donnes
DB2 Oracle
Tches complmentaires
Configurez le logiciel client de base de donnes et le pilote JDBC 2.0. Configurez le pilote OCI JDBC. Installez l'utilitaire SQL Loader.
Microsoft SQL Server Par dfaut, le fichier JSQLConnect.jar est install dans l'emplacement appropri. Vous devez installer l'utilitaire bcp. Si vous utilisez Oracle pour votre bibliothque d'indicateurs, vous devez installer l'utilitaire SQL Loader sur chaque ordinateur sur lequel les composants d'application d'IBM Cognos 8 Metrics Manager ou Metric Designer sont installs. Si vous utilisez Microsoft SQL Server, vous devez installer l'utilitaire bcp sur chaque ordinateur sur lequel les composants d'application d'IBM Cognos 8 Metrics Manager ou Metric Designer sont installs.
Procdure pour DB2

1. Installez le logiciel client DB2 sur les ordinateurs appropris.
70
Chapitre 4: Prparation de l'installation 2. Si la base de donnes Content Store se trouve sur un autre ordinateur que celui sur lequel Content Manager est install, configurez un pseudonyme de base de donnes pour Content Store en excutant l'assistant de configuration du client DB2 : Sous UNIX ou Linux, utilisez l'interface de ligne de commande DB2. Si la base de donnes Content Store et Content Manager se trouvent sur le mme ordinateur, le nom de Content Store devient automatiquement le pseudonyme. Lorsque vous configurez les ordinateurs Content Manager, assurez-vous qu'ils sont tous configurs pour utiliser la mme base de donnes Content Store . 3. Sous Windows, arrtez les services DB2 et le serveur de recherche HTML. 4. Pour copier le pilote JDBC2, copiez le fichier installation_DB2/sqllib/java/db2java.zip dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. 5. Renommez le fichier db2java.zip en db2java.jar. 6. Sous Windows, redmarrez les services DB2 et le serveur de recherche HTML. 7. Rptez l'intgralit de la procdure sur les ordinateurs IBM Cognos 8 sur lesquels le logiciel doit tre install.

1. Sur l'ordinateur o le client Oracle est install, accdez au rpertoire ORACLE_HOME/jdbc/ lib. 2. Copiez le fichier ojdbc14.jar (ou le fichier ojdbc5.jar, pour Oracle 11g) dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib des ordinateurs sur lesquels Content Manager est install. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar. Si vous utilisez IBM Cognos 8 Metrics Manager, copiez le fichier ojdbc14.jar ou ojdbc5.jar dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib des ordinateurs sur lesquels IBM Cognos 8 Metrics Manager est install. Ce fichier contient le pilote requis par la base de donnes Content Store. Vous pouvez mettre au point la base de donnes afin de tirer profit des fonctions de DB2. Pour en savoir davantage, reportez-vous au manuel Architecture and Deployment Guide.
Procdure pour Sybase

1. Sur l'ordinateur o Sybase est install, accdez au rpertoire emplacement_Sybase/jConnect-5_ 5/classes. 2. Copiez le fichier jconn2.jar dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib de tous les ordinateurs sur lesquels Content Manager est install.
Configuration de variables d'environnement sous UNIX pour la bibliothque d'indicateurs

Pour IBM Cognos 8, vous devez dfinir des variables d'environnement pour pouvoir utiliser une base de donnes DB2 ou Oracle comme bibliothque d'indicateurs. La syntaxe correcte pour crer des variables d'environnement dpend de l'interprteur de commandes.
DB2
Pour les bases de donnes IBM DB2, vous devez dfinir les variables en excutant les scripts d'installation d'environnement inclus dans le programme d'installation de DB2. Pour les interprteurs de commandes Bourne et Korn, excutez la commande suivante ou ajoutez-la au script .profile : rpertoire_installation_DB2/db2profile Contactez votre administrateur de base de donnes ou de rseau pour obtenir les valeurs adaptes votre systme.
Oracle
Pour les bases de donnes Oracle, vous devez dfinir et exporter les variables d'environnement de la base de donnes pour l'utilisateur de la bibliothque d'indicateurs avant de dmarrer les processus IBM Cognos. IBM Cognos 8 utilise ces variables pour se connecter votre base de donnes. Pour dfinir ces variables d'environnement, vous pouvez inclure ces commandes dans le script .profile ou .login de l'utilisateur qui dmarre les services IBM Cognos. Lors de la dfinition des chemins d'accs la bibliothque de chargement, assurez-vous que les bibliothques Oracle 32 bits se trouvent sur le chemin d'accs la bibliothque (gnralement le rpertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle 64 bits). Le tableau ci-dessous dcrit les variables d'environnement des bases de donnes Oracle. Contactez votre administrateur de base de donnes ou de rseau pour obtenir les valeurs adaptes votre systme.
Variable Description d'environnement

ORACLE_ Rpertoire de niveau suprieur qui contient le logiciel client de base de donnes ou l'installation HOME complte de la base de donnes. Exemple : /usr/oracle Il est possible d'utiliser un script Oracle pour crer les variables d'environnement. Pour en savoir davantage, reportez-vous la documentation Oracle. Exemple : /usr/local/bin/coraenv
72
Variable Description d'environnement

TNS_ ADMIN Rpertoire contenant le fichier Oracle tnsnames.ora, permettant les appels vers la base de donnes Oracle pour dterminer les connexions serveur requises. Exemple : $ORACLE_HOME/network/admin PATH Variable permettant de localiser les fichiers excutables. Exemple : $PATH:$ORACLE_HOME/bin biblioChemin d'accs la bibliothque de chargement. thquePATH Exemples : Sous Solaris : LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH LD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATH Sous AIX : LIBPATH=$ORACLE_HOME/lib:$LIBPATH LIBPATH=$ORACLE_HOME/lib32:$LIBPATH Sous HP-UX : SHLIB_PATH=$ORACLE_HOME/lib:$SHLIB_PATH SHLIB_PATH=$ORACLE_HOME/lib32:$SHLIB_PATH NLS_ LANG La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux.
Configuration de navigateurs Web

IBM Cognos 8 utilise les configurations de navigateur implicites de Microsoft, Netscape et Firefox. Dans tous les navigateurs, vous devez vous assurer que les paramtres des tmoins (cookies) et des scripts Java sont bien activs. Les paramtres supplmentaires requis sont spcifiques au navigateur. Le tableau suivant indique les paramtres qui doivent tre activs dans les navigateurs Web pris en charge :
Navigateur
Paramtre
Composant IBM Cognos

IBM Cognos Connection IBM Cognos Administration IBM Cognos Viewer Report Studio Query Studio Analysis Studio Event Studio Metric Studio
Internet Explorer Autoriser les tmoins de connexion (paramtres pour les (cookies) studios et les porActive Scripting tails) META REFRESH autoris
Internet Explorer (paramtres pour certains studios)
Excuter les contrles ActiveX et Report Studio les plug-ins Query Studio Contrles ActiveX reconnus srs Analysis Studio pour l'criture de scripts
Internet Explorer Comportements binaires et de Report Studio (paramtres pour un script studio) Autoriser l'accs programmatique au Presse-papiers Netscape Autoriser les tmoins de connexion IBM Cognos Connection (cookies) IBM Cognos Administration JavaScript Query Studio Event Studio Metric Studio Firefox Autoriser les tmoins de connexion IBM Cognos Connection (cookies) IBM Cognos Administration Activer Java IBM Cognos Viewer Activer JavaScript Charger des images Remarque : Report Studio et Query Studio utilisent la norme native XML de Microsoft Internet Explorer, qui est un composant du navigateur. La prise en charge de la technologie ActiveX doit tre active car Microsoft l'utilise pour implmenter le langage XML. IBM Cognos 8 ne fournit ni ne tlcharge de contrles ActiveX. Seuls les contrles ActiveX installs en mme temps qu'Internet Explorer sont activs pour cette configuration. Important : Si Adblock Plus est install avec Firefox, dsactivez-le l'aide de l'option par page. Adblock Plus empche le bon fonctionnement de certaines ressources d'IBM Cognos Connection. 74 Query Studio
Chapitre 4: Prparation de l'installation IBM Cognos 8 utilise les tmoins (cookies) suivants pour stocker des informations utilisateur :
Cookie
AS_TICKET
Type
Session temporaire Session temporaire Session temporaire Session temporaire Session temporaire
Fonction
Il est cr si IBM Cognos 8 est configur de faon utiliser un espace-noms IBM Cognos Series 7. Contient des informations sur l'tat de la scurit.
caf
Cam_passport
Contient une rfrence une session utilisateur stocke sur le serveur Content Manager. Conserve des informations spcifiques IBM Cognos Connection relatives la session. Conserve des informations pendant les oprations de modification (par exemple, couper, copier, coller). Contient des informations rgionales sur le produit et le contenu. Dfini pour tous les utilisateurs d'IBM Cognos. Enregistre le choix effectu par l'utilisateur pour Afficher le dossier des membres dans Report Studio. Contient le chemin du dossier actuel si l'accs au fichier local est utilis. Mis jour aprs utilisation de la bote de dialogue Ouvrir ou Enregistrer. Enregistre les paramtres slectionns par l'utilisateur pour les lments d'interface utilisateur tels que les menus et les barres d'outils. Contient un identificateur de session utilisateur unique, valide uniquement pour la dure de la session de navigateur.
cc_session
cc_state
CRN
Session temporaire
CRN_RS
Permanent
PAT_CURRENT_ FOLDER Permanent
qs
Permanent
usersessionid
Session temporaire
Aprs avoir mis niveau ou install un nouveau logiciel, redmarrez le navigateur Web et demandez aux utilisateurs de vider l'antmmoire du navigateur.
Configuration de connexions ODBC vers Sybase IQ ou Netezza

Si vous utilisez un pilote ODBC sous UNIX ou Linux pour vous connecter une source de donnes ODBC Sybase IQ ou Netezza, vous devez configurer l'environnement et dfinir les sources de donnes. Aprs avoir configur les connexions ODBC, vous devez crer les connexions aux sources de donnes dans IBM Cognos Connection. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8. Pour UNIX, le gestionnaire de pilotes libre iODBC fournit une connectivit ODBC aux sources de donnes ODBC Sybase IQ ou Netezza. Les fichiers binaires pour ce gestionnaire de pilotes sont installs automatiquement avec IBM Cognos 8. Pour Linux, le pack unixODBC livr avec le systme d'exploitation fournit une connectivit ODBC aux sources de donnes ODBC Sybase IQ ou Netezza.
Procdure
1. Vrifiez que le logiciel de connectivit ODBC est correctement install : Sous UNIX, vrifiez que les fichiers binaires fournis par IBM Cognos 8 pour l'installation iODBC sont correctement installs en saisissant ce qui suit dans l'invite de commande : which iodbctest emplacement_c8/bin/iodbctest Sous Linux, vrifiez que le pack unixODBC livr avec le systme d'exploitation est correctement install en saisissant ce qui suit dans l'invite de commande : odbcinst -version unixODBC version Si des problmes se produisent lors de l'utilisation de cette commande, reportez-vous la documentation propose par votre fournisseur Linux. 2. Dfinissez la variable d'environnement de chemin d'accs aux bibliothques approprie pour indiquer l'emplacement des bibliothques ODBC pour votre systme d'exploitation. Pour Linux, assurez-vous que la variable indique le rpertoire /usr/lib contenant le fichier libodbc.so avant tout autre rpertoire d'installation de base de donnes. Pour UNIX, assurez-vous que la variable inclut le rpertoire emplacement_c8/bin avant tout autre rpertoire d'installation de base de donnes.
Le tableau ci-dessous rpertorie les variables d'environnement devant indiquer l'emplacement des bibliothques ODBC pour chaque systme d'exploitation.
Systme d'exploitation
AIX Solaris et Linux HP-UX
Variable d'environnement
LIBPATH LD_LIBRARY_PATH SHLIB_PATH
76
Chapitre 4: Prparation de l'installation 3. Copiez le fichier emplacement_ODBC/lib/odbc.ini dans le rpertoire emplacement_c8/bin. 4. Renommez le fichier odbc.ini situ dans le rpertoire emplacement_c8/bin en .odbc.ini 5. Dans la section [ODBC], indiquez le rpertoire racine ODBC et prcisez si la fonction de suivi du gestionnaire de pilotes est active. Voici un exemple :
[ODBC] InstallDir=/isvdb/sql/odbc Trace =1 TraceFile = /uda/dev/boileaum/ trace.log TraceAutoStop=1
6. Dans la section [ODBC Data Sources], dfinissez le nom et le pilote pour chaque source de donnes. Voici un exemple :
[ODBC Data Sources]dsn-name=driver-description
7. Crez une copie de la section [dsn-name] pour chaque source de donnes dfinie dans la section [ODBC Data Sources]. 8. Pour chaque source de donnes dfinie dans la section [ODBC Data Sources], dfinissez des dtails supplmentaires l'aide d'une section [dsn-name]. Voici un exemple :
[dsn-name] Driver=driver_path Keyword=value
9. Si vous souhaitez dfinir une source de donnes utilise lorsque aucune autre source n'est disponible, crez une section [Default], comme illustr ci-dessous :
[Default] Driver=driver-path Keyword=value
10. Enregistrez et fermez le fichier odbc.ini. 11. Testez la connexion la source de donnes en effectuant l'une des oprations suivantes : Sous UNIX, saisissez la commande suivante dans l'invite de commande puis excutez une instruction Select depuis une table connue : iodbctest DSN=nom-dsn;UID=IDutilisateur;PWD=mot_de_passe Sous Linux, testez la connexion l'aide de l'application odbctest.
Configuration du routeur pour tester la disponibilit d'un distributeur

Si vous utilisez un routeur pour distribuer des demandes aux distributeurs d'IBM Cognos 8 et si ce routeur peut tester la disponibilit d'un serveur l'aide d'une adresse URL test, vous pouvez le configurer pour qu'il teste la disponibilit d'un distributeur d'IBM Cognos 8. Pour tester la disponibilit d'un distributeur, procdez comme suit : Configurez le routeur pour qu'il utilise une URL dont le chemin d'accs est /p2pd/servlet/ping.
Si le distributeur n'est pas prt, la rponse suivante est envoye : 503 Service non disponible Guide d'installation et de configuration 77
Chapitre 4: Prparation de l'installation Si le distributeur est prt, la rponse suivante est envoye : 200 OK
Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8
Vous pouvez configurer un compte utilisateur ou un compte de service rseau pour IBM Cognos 8. Le compte utilisateur ou le compte de service rseau sous lequel IBM Cognos 8 est excut doit : avoir accs toutes les ressources requises, telles que des imprimantes et des serveurs Web, tre autoris se connecter en tant que service et agir en tant qu'lment du systme d'exploitation,
En outre, le compte utilisateur doit appartenir au groupe d'administration local. Par exemple, pour imprimer des rapports l'aide d'une imprimante rseau, il est ncessaire que le compte ait accs celle-ci ou que vous attribuiez un compte de connexion au service IBM Cognos 8.
Configuration d'un compte utilisateur

Pour Windows, il est recommand d'attribuer un nom de connexion au service IBM Cognos 8. Sous Windows, vous pouvez configurer le service IBM Cognos 8 pour qu'il utilise un compte d'utilisateur spcial en slectionnant le service IBM Cognos 8 dans la liste de services affiche dans la fentre Services. Vous avez ensuite la possibilit dfinir les proprits du compte utilisateur. Pour UNIX ou Linux, il est recommand de crer un groupe UNIX ou Linux appel cognos8. Ce groupe doit contenir l'utilisateur qui est propritaire des fichiers IBM Cognos. Dfinissez les droits de propritaire des fichiers IBM Cognos pour le groupe cognos8 et dfinissez les droits d'accs tous les fichiers IBM Cognos sur GROUP READABLE/WRITABLE/EXECUTABLE. Vous devez configurer le serveur Web pour utiliser des alias. Pour en savoir davantage, reportezvous la section "Configuration du serveur Web" (p. 133).
Configuration d'un compte de service rseau

Le compte de service rseau est le compte intgr NT AUTHORITY\NetworkService stock dans le systme d'exploitation.Les administrateurs n'ont pas besoin de grer un mot de passe ou le compte. Utilisez un compte ayant des privilges d'administrateur si vous installez sur le serveur Windows 2008. Vous devez configurer le serveur Web pour utiliser le groupe d'applications. Pour en savoir davantage, reportez-vous la section "Configuration du serveur Web" (p. 133).Vous devez aussi disposer de droits d'criture pour faire des installations sur le rpertoire.
78
Chapitre 5: Mise niveau vers IBM Cognos 8

Si vous disposez de donnes IBM Cognos Series 7, vous pouvez en transfrer une partie vers IBM Cognos 8 l'aide des outils de migration disponibles dans une installation spare. Si vous utilisez une ancienne version de ReportNet, Metrics Manager, IBM Cognos 8 Go! Office ou Transformer, vous pouvez mettre niveau votre contenu vers IBM Cognos 8. Vous pouvez galement effectuer une mise niveau des versions antrieures d'IBM Cognos 8, ce qui inclut les versions compltes et celles de maintenance (MR). La mise niveau d'IBM Cognos 8 est un processus en plusieurs tapes. Le flux de travail ci-dessous indique les tches excutes lors de chaque phase d'un processus de mise niveau standard.
Rvision de la documentation tude du site Cration du plan de mise niveau
Planification
Prparation de l'environnement de test
Prparation de l'environnement de production
Dploiement de l'application dans l'environnement de test
Dploiement de l'application dans l'environnement de production
Test des rapports
Dploiement des rapports de l'environnement de production
Rparation des rapports
Nouveau test des rapports rpars
Rvision du plan de mise niveau
Excution d'une mise niveau de test
Passage en mode production
Lors de la phase de prparation, rassemblez des informations, valuez votre environnement de production de rapports et mettez au point le plan de mise niveau. Lors de la mise niveau d'essai, Guide d'installation et de configuration 79
Chapitre 5: Mise niveau vers IBM Cognos 8 mettez niveau vos applications et vos rapports IBM Cognos 8 dans un environnement de test. Lors du passage la phase de production, exploitez ce que vous avez appris dans l'environnement de test pour dployer votre configuration depuis ce dernier vers l'environnement de production. Dans certains scnarios de mise niveau, d'autres tches peuvent tre ncessaires. Par exemple, si vous utilisez des applications SDK dpendant des spcifications de rapports, vous devez mettre niveau ces applications avant les spcifications. Reportez-vous aux rubriques suivantes pour en savoir davantage sur la mise niveau : Planification de la mise niveau Mise niveau partir d'IBM Cognos Series 7 Mise niveau depuis ReportNet, Metrics Manager ou des versions antrieures d'IBM Cognos 8 Mise niveau d'IBM Cognos 8 Go! Office Mise niveau des modles et des cubes Transformer
Planification de la mise niveau

Il est recommand de planifier la mise niveau de faon connatre le droulement de chaque tape du processus. Lors de l'tape de planification, vous pouvez consulter la documentation relative la mise niveau pour en savoir davantage sur le comportement attendu du systme, les nouvelles fonctions, les fonctions obsoltes, la compatibilit entre les versions et les conditions requises pour la prparation de l'environnement de production. Une fois que vous avez pass en revue ces informations, vous pouvez procder une tude du site pour identifier l'infrastructure BI, les applications, les rapports et les paramtres de configuration personnaliss. Vous pouvez enfin tester la mise niveau sur un sous-ensemble de donnes de faon optimiser vos rapports et vos donnes avant d'entreprendre la mise niveau complte. Utilisez la liste de contrle suivante comme guide de planification : Consultation de la documentation tude du site Excution d'une mise niveau d'essai Examen du passage l'environnement de production
Consultation de la documentation
La documentation fournie est tablie partir de diverses sources pour vous aider mener bien la mise niveau. L'ensemble de la documentation est disponible en ligne sur le site Web Cognos Software Services (http://support.cognos.com).
Procdure
1. Lisez la section Nouveauts du prsent manuel (p. 17). Elle contient la liste des nouvelles fonctionnalits, ainsi que des fonctions qui ont t modifies, qui sont dsormais obsoltes ou qui ont t supprimes de cette version. 80
Chapitre 5: Mise niveau vers IBM Cognos 8 2. Consultez les autres informations de mise niveau contenues dans le prsent document. 3. Lisez la rubrique relative l'utilisation d'IBM Cognos 8 avec d'autres produits IBM Cognos (p. 49). Elle contient des informations concernant les autres produits IBM Cognos que vous pouvez installer dans votre environnement et qui doivent tre pris en compte lors de la mise niveau. 4. partir du lien Documentation du site Web Cognos Software Services (http://support.cognos. com), vous pouvez tlcharger et consulter les dernires versions de la documentation suivante : Fichier Lisezmoi d'IBM Cognos 8 Le fichier Lisezmoi est rgulirement mis jour de faon documenter les problmes susceptibles de survenir lors d'une mise niveau. Guide des nouveauts d'IBM Cognos 8 Sections relatives aux nouveauts et la mise niveau dans le manuel Framework Manager User Guide Sections relatives aux nouveauts et la mise niveau dans le Guide de l'utilisateur de Report Studio - Cration de rapports professionnelle. Sections relatives aux nouveauts et la mise niveau dans le Guide de l'utilisateur d'IBM Cognos 8 Transformer. Lisez ces sections uniquement si vous utilisez Transformer. IBM Cognos 8 Migration Tools User Guide Ce document explique comment mettre niveau des mtadonnes, des rapports et des catalogues Impromptu, des rapports PowerPlay ou un contenu Upfront partir d'IBM Cognos Series 7 vers IBM Cognos 8. Sections relatives aux notes de mise jour et la mise niveau dans le manuel IBM Cognos 8 SDK Developer Guide Lisez ces sections uniquement si vous utilisez des applications SDK. Tous les documents Conseils pratiques relatifs la mise niveau
tude du site
Procdez une tude du site pour valuer l'environnement de production en cours et identifier les points auxquels vous devez prter attention lors d'une mise niveau. Cette tude doit fournir des informations sur l'infrastructure, les applications, les utilisateurs et les paramtres de configuration des produits d'IBM Cognos 8.
Procdure
1. Vous pouvez valuer les logiciels utiliss dans votre application d'excution de rapports en procdant comme suit : Rpertoriez les logiciels (par exemple, systmes d'exploitation, serveurs Web, scurit et bases de donnes). Guide d'installation et de configuration 81
Chapitre 5: Mise niveau vers IBM Cognos 8 Comparez la liste obtenue celle des versions prises en charge pour votre version de mise niveau cible, qui est disponible partir des liens Production Information et Software Environments du site Web Cognos Software Services (http://support.cognos.com). Dterminez si des composants doivent tre mis jour.
2. Rpertoriez vos applications BI, parmi lesquelles les rapports, les packs et les modles Framework Manager, les extraits, les projets et les packs Metrics Manager, les applications SDK et leurs dpendances.
3. Rpertoriez le contenu que vous envisagez de migrer ou de mettre niveau partir d'autres produits IBM Cognos, tels que les cubes et les modles Transformer. 4. Rpertoriez tous les rapports contenus dans votre application et procdez comme suit : Marquez les rapports trs utiliss ou de premier plan de faon ce qu'ils soient traits en priorit lors de la mise niveau. Utilisez les donnes des rapports d'analyse pour dterminer l'utilisation des rapports. Pour en savoir davantage sur les rapports d'analyse, reportez-vous au Guide d'administration et de scurit. Marquez les rapports dont l'excution ou la validation dans l'environnement en cours a chou. Il est peu probable qu'ils puissent tre mis niveau. Corrigez ces rapports pour pouvoir les mettre niveau. Envisagez le retrait des rapports inutiliss ou peu employs.
5. Si vous envisagez de mettre niveau des modles Transformer, rpertoriez-les. 6. Rpertoriez les informations suivantes concernant votre configuration : Paramtres de configuration activs l'aide d'IBM Cognos Configuration. Ces paramtres sont conservs au cours de la mise niveau. Ils sont stocks dans deux fichiers. Pour ReportNet, il s'agit des fichiers crnstartup.xml et crnlocale.xml. Pour IBM Cognos 8, il s'agit des fichiers cogstartup.xml et coglocale.xml. Modifications apportes d'autres fichiers de configuration. Les modifications concernant les autres fichiers doivent tre apportes manuellement lors de la mise niveau. Si vous avez modifi d'autres fichiers de configuration, vous devez valuer les changements que vous souhaitez conserver dans l'environnement mis niveau. Il peut s'agir notamment des fichiers .xml, .txt et .css des rpertoires configuration, templates, webapps et webcontent de l'emplacement d'installation. Important : Les modifications apportes aux fichiers .ini ne sont pas prises en charge. Si vous avez modifi des fichiers .ini, veuillez contacter le support client.
82
Chapitre 5: Mise niveau vers IBM Cognos 8 7. Effectuez une copie de sauvegarde de tous les rapports et modles, ainsi que des fichiers et donnes de configuration. 8. Crez un plan de mise niveau.
Excution d'une mise niveau d'essai

Il est recommand d'excuter une mise niveau d'essai plusieurs semaines avant la mise niveau de votre systme de production. Cette opration permet d'identifier avec un minimum d'efforts les composants qui vont tre mis niveau ainsi que ceux pouvant ncessiter des actions supplmentaires avant ou aprs la mise niveau.
Procdure
1. Prparez l'environnement de test : Installez le systme de la nouvelle version dans l'environnement de test. Configurez le systme de test de faon ce qu'il corresponde votre environnement de production. Configurez manuellement la personnalisation.
2. Dployez votre application d'excution de rapports en cours sur le systme de test : Mettez niveau les spcifications de rapport de la source vers le systme de test. Validez les spcifications de rapport sur le systme de test.
3. Testez vos rapports : Dans Report Studio, validez chaque rapport et vrifiez si la validation est termine. Dans Report Studio, Query Studio et Analysis Studio, excutez les rapports concerns et vrifiez si chaque rapport a t correctement excut.
4. Testez les modles et les cubes dans IBM Cognos 8 Transformer, si ncessaire : Ouvrez les modles l'aide des options de scurit appropries et enregistrez-les. Testez les cubes.
5. Corrigez ou excluez les rapports et les modles qui ne fonctionnent pas correctement. 6. Testez les rapports et les modles corrigs en les excutant de nouveau sur le systme de test. Corrigez les problmes ventuels et consultez le site Web Cognos Software Services si certains demeurent non rsolus. 7. Rvisez le plan de mise niveau en y incluant les adaptations que vous avez effectues durant la mise niveau d'essai.
Examen du passage l'environnement de production

Lorsque vous avez rsolu tous les problmes trouvs durant la mise niveau d'essai, vous tes prt commencer la mise niveau complte dans votre environnement de production. Votre plan de mise niveau indiquera tous les dtails de chaque tape de la mise niveau complte. La procdure ci-aprs constitue un rsum du processus. La procdure dtaille est prsente la section "Mise niveau depuis ReportNet, Metrics Manager ou des versions antrieures d'IBM Cognos 8" (p. 85).
Procdure
1. Prparez l'environnement de production : Effectuez une copie de sauvegarde des fichiers et des donnes. Installez le systme de la nouvelle version dans l'environnement de production. Configurez le systme. Configurez manuellement la personnalisation.
2. Dployez l'application sur le systme de production. 3. Dployez les rapports et les modles depuis le systme de test vers le systme de production.
Mise niveau partir d'IBM Cognos Series 7

Vous pouvez transfrer le contenu d'IBM Cognos Series 7 vers IBM Cognos 8. Pour obtenir la liste des versions prises en charge, reportez-vous au site Web Cognos Software Services (http://support. cognos.com). Si vous utilisez une version d'IBM Cognos Series 7 non prise en charge pour la migration vers IBM Cognos 8, vous devez d'abord mettre le logiciel et les donnes niveau vers une version prise en charge d'IBM Cognos Series 7. Le transfert de tout autre type de contenu IBM Cognos Series 7 vers IBM Cognos 8 est considr comme une migration. Vous pouvez transfrer les types de contenus suivants vers IBM Cognos 8 : Contenu Web d'IBM Cognos Series 7, tel que des rapports PowerPlay Web Explorer, provenant de Windows ou UNIX. rapports PowerPlay Windows, contenu Upfront, tel que des classeurs et des index, crs sous Windows et UNIX, rapports et catalogues Impromptu crs sous Windows, contenu Impromptu Web Reports, tels que des vnements, des calendriers et des rapports et catalogues Impromptu publis dans Impromptu Web Reports sous la forme de rapports, modles Architect crs sous Windows, cubes Transformer, y compris les vues de classes d'utilisateurs et les classes d'utilisateurs des modles comportant des cubes scuriss.
84
Chapitre 5: Mise niveau vers IBM Cognos 8 Si vous avez publi des rapports PowerPlay Web dans IBM Cognos Connection, version ReportNet ou IBM Cognos 8, vous pouvez toujours les ouvrir dans PowerPlay Web Explorer ou les mettre niveau vers IBM Cognos 8 Analysis. Transformer vous permet d'importer des objets de scurit issus d'espaces-noms diffrents dans une vue personnalise unique. IBM Cognos 8 prend en charge plusieurs espaces-noms pour scuriser les cubes, mais uniquement dans le but de vrifier le contenu lors de la migration de la scurit d'IBM Cognos Series 7 vers un autre fournisseur de scurit. Vous ne pouvez pas dployer des cubes qui sont scuriss en fonction de plusieurs espaces-noms dans IBM Cognos 8. Aprs avoir vrifi le contenu du modle, vous devez associer un espace-noms unique avec chaque cube. Pour en savoir davantage, reportez-vous au Guide de l'utilisateur de Transformer. Pour en savoir davantage sur la mise niveau du contenu Series 7 vers IBM Cognos 8 Transformer, reportez-vous la section "Mise niveau des modles et des cubes Transformer" (p. 116). Si vous transfrez votre contenu depuis IBM Cognos Series 7, vous devez installer les outils de migration d'IBM Cognos afin de mettre niveau votre contenu IBM Cognos Series 7 vers IBM Cognos 8. Vous pouvez tlcharger les outils de migration ou bien demander un CD. Pour en savoir davantage, visitez le site Web Cognos Software Services (http://support.cognos.com). La documentation relative l'installation et l'utilisation de ces outils est fournie avec ces derniers. Pour mettre niveau les rapports PowerPlay publis dans IBM Cognos Connection, aprs avoir install les outils de migration, vous devez activer les options qui permettent aux utilisateurs d'ouvrir les rapports IBM Cognos Series 7 dans Report Studio ou Analysis Studio. Pour activer ces options, utilisez IBM Cognos Connection. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Mise niveau depuis ReportNet, Metrics Manager ou des versions antrieures d'IBM Cognos 8
Vous devez mettre niveau le logiciel pour passer d'une version antrieure d'IBM Cognos 8, de ReportNet ou de Metrics Manager une nouvelle version d'IBM Cognos 8. Vous devez mettre niveau chacun des composants. Les composants provenant de versions diffrentes ne sont pas compatibles. Si vous utilisez des cubes IBM Cognos Series 7 en tant que source de donnes, il n'est pas ncessaire de mettre niveau Transformer, sauf si vous souhaitez utiliser les fonctions de la nouvelle version de Transformer. Pour en savoir davantage, reportez-vous la section "Mise niveau des modles et des cubes Transformer" (p. 116).Les cubes crs via Series 7.3 Transformer (ou suivante) et IBM Cognos 8.3 Transformer (ou suivante) sont pris en charge dans le cadre de l'excution de rapports et des indicateurs IBM Cognos 8. Vous pouvez effectuer une mise niveau directe vers IBM Cognos 8 partir des versions de produits suivantes : IBM Cognos 8 8.1 ou ultrieure, y compris les versions de maintenance (MR) ReportNet 1.1 MR1 MR4 Metrics Manager 2.0 ou ultrieur
Chapitre 5: Mise niveau vers IBM Cognos 8 Si vous possdez une version plus ancienne de ReportNet, vous devez d'abord effectuer une mise niveau vers l'une des versions MR de ReportNet 1.1 (1 4), puis procder la mise niveau vers IBM Cognos 8. Vous pouvez excuter plusieurs versions du logiciel sur votre ordinateur en mme temps, dans la mesure o vous les installez dans des rpertoires spars et que vous les configurez de faon utiliser une base de donnes Content Store diffrente et un jeu de ports et d'URL distinct pour chaque version. Avant de procder la mise niveau, vous devez planifier votre stratgie (p. 80) La stratgie dpend des donnes que vous souhaitez utiliser et de la personnalisation que vous avez effectue lors de la configuration d'origine. Pour utiliser le rpertoire de configuration existant lorsque vous effectuez une mise niveau partir de ReportNet, assurez-vous que les donnes de configuration de ReportNet sont copies dans le rpertoire d'installation d'IBM Cognos 8. Cela comprend la sauvegarde de donnes existantes, la configuration d'IBM Cognos 8 de faon utiliser la base de donnes Content Store existante ou une copie de celle-ci, la copie des fichiers de donnes de configuration vers le rpertoire d'installation d'IBM Cognos 8 et l'application des modifications ou personnalisations manuelles appliques dans la version prcdente. Si ReportNet et Metrics Manager sont installs sur le mme ordinateur et que vous prvoyez d'effectuer une mise niveau vers IBM Cognos 8, mettez d'abord niveau ReportNet, puis Metrics Manager. Aprs avoir procd la mise niveau vers IBM Cognos 8, des tches de configuration supplmentaires sont requises si vous souhaitez utiliser les nouvelles fonctions. Pour en savoir davantage sur les nouvelles fonctions d'IBM Cognos 8, reportez-vous au manuel Nouveauts d'IBM Cognos 8.
Applications SDK
Vous devez utiliser le SDK d'IBM Cognos 8 avec IBM Cognos 8 Business Intelligence. Lorsque vous effectuez une mise niveau, vous devez raliser certaines modifications sur votre programme SDK pour qu'il fonctionne avec la version IBM Cognos 8 du fichier WSDL. Toutefois, certaines mthodes, classes et proprits sont obsoltes dans IBM Cognos 8. Les fonctions obsoltes continuent fonctionner comme auparavant, mais seront supprimes dans les versions ultrieures. D'autres mthodes, classes et proprits sont primes et ont t supprimes du SDK d'IBM Cognos 8. Pour en savoir davantage sur les changements apports aux mthodes, aux classes, aux proprits et aux ensembles d'numrations, reportez-vous aux annexes comportant les notes de mise jour dans le manuel SDK Developer Guide d'IBM Cognos 8. De nouvelles spcifications de rapports ont t ajoutes IBM Cognos 8. Si vous excutez un rapport ReportNet dans IBM Cognos 8, il est automatiquement mis niveau au format IBM Cognos 8. Une fois mis niveau vers IBM Cognos 8, un rapport ne peut pas repasser au format ReportNet. Les utilisateurs ayant la possibilit de mettre niveau des spcifications de rapports dont peuvent dpendre des applications SDK, il est conseill de dfinir les droits d'accs de ces rapports de manire en limiter l'accs aux utilisateurs. Pour en savoir davantage sur la dfinition de droits d'accs, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8. Ne mettez pas niveau vos spcifications de rapports si vous disposez d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Vous devez d'abord mettre 86
Chapitre 5: Mise niveau vers IBM Cognos 8 jour vos applications SDK pour qu'elles soient conformes au schma de spcifications de rapports d'IBM Cognos 8. Sinon, elles risquent de ne pas pouvoir accder aux spcifications de rapports mises niveau. Pour en savoir davantage sur la mise niveau de spcifications de rapports, reportezvous au manuel SDK Developer Guide d'IBM Cognos 8. Il est conseill de ne pas mettre jour vos spcifications de rapports si vous n'tes pas certain de disposer d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Contactez votre administrateur SDK pour en savoir davantage concernant vos applications SDK.
Content Manager
Lors de la mise niveau de ReportNet, Content Manager met automatiquement niveau le schma et le contenu de la base de donnes Content Store. Une fois que vous avez effectu la mise niveau, vous ne pouvez pas utiliser la base de donnes Content Store mise niveau avec ReportNet car elle n'est pas rtrocompatible. Pour protger les donnes de la base de donnes Content Store d'origine, vous devez configurer IBM Cognos 8 de faon utiliser une copie de la base de donnes Content Store. Vous pouvez crer une copie de sauvegarde en enregistrant la base de donnes Content Store d'origine et en restaurant les donnes dans une nouvelle base de donnes Content Store. IBM Cognos 8 peut lire des archives de dploiement produites par ReportNet.
Content Store
Si vous avez enregistr des rapports de Series 7 PowerPlay ou des tableaux de bord d'IBM Cognos Metrics Manager 2.x dans ReportNet, la mise niveau de la base de donnes Content Store transfre ces rapports et tableaux de bord enregistrs dans IBM Cognos 8.
Framework Manager
Vous pouvez utiliser les mmes modles et les mmes projets dans Framework Manager pour IBM Cognos 8 que ceux utiliss avec la version antrieure. Lors de la mise niveau de modles, le processus de validation gnre des erreurs pour chacun d'eux. Pour mettre un projet niveau, ouvrezle et enregistrez-le dans la nouvelle version de Framework Manager. Pour en savoir davantage, reportez-vous au manuel Framework Manager User Guide. Si vous disposez d'applications SDK qui dpendent d'une version antrieure des spcifications de rapports, vous ne pouvez pas utiliser Framework Manager pour publier votre modle sans perdre la rtrocompatibilit.
Report Studio
La mise niveau ne rend pas compte des lments tels que les fonctions non documentes et non prises en charge, les modifications du comportement d'un rapport, de la mise en forme et des feuilles de style. Pour en savoir davantage, reportez-vous au Guide de l'utilisateur de Report Studio Cration de rapports professionnelle.
Cubes Series 7 publis dans ReportNet

Si vous avez publi des cubes depuis IBM Cognos Series 7 PowerPlay Enterprise Server dans ReportNet, il est possible que vous ne puissiez pas les publier dans IBM Cognos 8. Le chemin d'accs aux tmoins utilis par dfaut dans ReportNet n'est plus le mme dans IBM Cognos 8. Pour pouvoir
Chapitre 5: Mise niveau vers IBM Cognos 8 publier vos cubes IBM Cognos Series 7 dans IBM Cognos 8, reportez-vous la section"Configuration de la publication de cubes Series 7 aprs mise niveau depuis ReportNet" (p. 113).
Bibliothques de donnes Metrics Manager

Dans les versions antrieures, Metrics Manager utilisait une bibliothque de donnes pour stocker, organiser et extraire les informations. Dans IBM Cognos 8, cette base de donnes est appele bibliothque d'indicateurs. Pour utiliser le contenu de la bibliothque de donnes d'une version antrieure, vous pouvez l'exporter partir de la bibliothque de donnes, installer IBM Cognos 8, puis importer ce contenu dans la bibliothque d'indicateurs. Il n'est pas possible d'utiliser la bibliothque d'indicateurs avec une version antrieure de Metrics Designer car elle n'est pas rtrocompatible. Avant d'exporter le contenu de la bibliothque de donnes, effectuez une copie de sauvegarde, au cas o vous auriez besoin de revenir la version antrieure.
Scurit
Lorsque vous effectuez une mise niveau depuis ReportNet ou une version antrieure d'IBM Cognos 8, cela peut avoir un impact sur la scurit. Par exemple, l'apparition de nouveaux rles qui n'existaient pas dans les versions prcdentes et de nouvelles fonctions pour certains rles. Par consquent, il est possible que le niveau de scurit votre systme mis niveau ne soit pas celui souhait. Pour confirmer le niveau de scurit aprs la mise niveau, reportez-vous au Guide d'administration et de scurit.
Systmes d'exploitation
Lors de la mise niveau de vos produits IBM Cognos 8, vous pouvez choisir d'installer certains composants sur de nouveaux systmes d'exploitation. Vous devez tenir compte de l'incidence que ces systmes peuvent avoir sur l'installation et la configuration d'IBM Cognos 8. Si votre mise niveau inclut l'installation des composants client d'IBM Cognos 8 sous Windows Vista, vous devez prendre en compte les points suivants : profils itinrants Les profils des utilisateurs sont stocks dans un emplacement diffrent de celui dfini dans les anciens systmes d'exploitation Windows. Le rpertoire Documents and Settings est remplac par le rpertoire Utilisateurs. Le rpertoire Tous les utilisateurs est remplac par le rpertoire Public. variables d'environnement Les chemins d'accs associs par dfaut aux variables d'environnement ne sont plus les mmes. Si vous utilisez des scripts ou des applications faisant rfrence aux chemins d'accs dans les variables d'environnement, vous devrez probablement les mettre jour. En outre, vous devez configurer nouveau les emplacements de fichiers implicites dans IBM Cognos Configuration pour qu'un mme emplacement puisse tre utilis dans tous les systmes d'exploitation de votre environnement IBM Cognos 8. Pour en savoir davantage, reportez-vous la section traitant de la mise jour des proprits d'emplacement des fichiers dans le chapitre de configuration (p. 355).
88
Installations qui incluent des versions prcdentes d'autres produits IBM Cognos 8
Si vous mettez niveau IBM Cognos 8 BI dans un environnement qui inclut des versions prcdentes d'autres produits IBM Cognos 8, tels qu'IBM Cognos 8 Controller 8.3, IBM Cognos 8 Planning 8.3 ou IBM Cognos 8 BI Analysis pour Excel 8.3, installez la nouvelle version d'IBM Cognos 8 BI dans un emplacement diffrent de celui de l'autre produit IBM Cognos 8 et configurer IBM Cognos 8 BI afin qu'il s'excute de faon indpendante. Une fois la mise niveau de l'autre produit effectue vers une version compatible avec IBM Cognos 8 BI, vous pourrez configurer les deux produits pour qu'ils fonctionnent ensemble.
Mise niveau partir d'une version antrieure d'IBM Cognos 8

Vous pouvez mettre niveau IBM Cognos 8 dans le mme rpertoire qu'une version antrieure, ou dans un autre rpertoire. Si vous souhaitez mettre niveau IBM Cognos 8 dans le mme rpertoire, vous devez d'abord sauvegarder vos donnes, vous assurer que les projets de Framework Manager ne sont pas activs dans un systme de contrle de la source, puis dsinstaller la version prcdente d'IBM Cognos 8. Des instructions compltes sont prsentes dans la procdure d'installation dans le mme rpertoire. Si vous effectuez une installation sur un nouvel ordinateur, reportez-vous la procdure d'installation dans un nouveau rpertoire. Lorsque vous effectuez une copie de sauvegarde des donnes de configuration, vous les stockez dans un rpertoire scuris. Ce rpertoire doit tre protg contre tout accs non autoris ou inappropri. Une autre mthode de mise niveau consiste exporter l'intgralit de la base de donnes Content Store dans une archive de dploiement, puis importer cette archive dans IBM Cognos 8 aprs la mise niveau. Pour en savoir davantage sur le dploiement, reportez-vous au Guide d'administration et de scurit. Une mise niveau par dploiement est requise si vous souhaitez modifier le type de base de donnes Content Store utilis. Si vous optez pour la mthode de mise niveau par dploiement, seules les tapes d'exportation et de restauration des donnes de configuration diffrent. Toutes les autres tapes sont identiques celles dcrites dans la prsente section. IBM Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous ne souhaitez pas utiliser Tomcat, vous devez suivre une autre procdure de mise niveau. Pour en savoir davantage, reportez-vous la section "Mise niveau vers IBM Cognos 8 dans un environnement de serveur d'application " (p. 399). Lorsque vous effectuez une mise niveau, l'administrateur de rapports n'a plus accs l'outil d'administration du contenu. Il ne sera donc pas en mesure de crer des dfinitions de dploiement dans IBM Cognos 8.
Fichiers personnaliss IBM Cognos 8

Si vous avez modifi manuellement des fichiers de configuration, ces modifications seront remplaces lors de la mise niveau. Vous devez appliquer les modifications nouveau. Il est vivement conseill de conserver un enregistrement de toutes les personnalisations afin de garantir qu'elles pourront tre appliques nouveau aprs la mise niveau. Vous devriez galement enregistrer ces fichiers afin de pouvoir restaurer la version d'origine en cas de besoin.
Chapitre 5: Mise niveau vers IBM Cognos 8 Il est possible que vous ayez modifi des fichiers autres que ceux situs dans le dossier de configuration. Dans ce cas, vous devez galement sauvegarder ces autres fichiers avant de procder la mise niveau. Le service de prsentation d'IBM Cognos 8 prend en charge la mise niveau automatique de certains fichiers system.xml. Si vous avez effectu de nombreuses modifications de personnalisation sur des fichiers system.xml, vous pouvez utiliser cette fonction de mise niveau automatique au lieu d'intgrer manuellement les modifications aprs la mise niveau. Les fichiers system.xml sont crass lors de l'installation d'IBM Cognos 8. Par consquent, vous devez enregistrer les versions personnalises de ces fichiers et les copier dans le rpertoire aprs la mise niveau d'IBM Cognos 8. La mise niveau automatique s'excutera lorsque vous dmarrerez le service IBM Cognos 8. Les fichiers system.xml concerns par la mise niveau automatique se trouvent dans les rpertoires suivants : emplacement_c8/templates/ps emplacement_c8/templates/ps/portal emplacement_c8/templates/ps/qs
Remarque : Nous vous recommandons de mettre niveau manuellement les fichiers personnaliss en appliquant de nouveau les modifications aprs l'installation du nouveau logiciel. La mise niveau automatique des fichiers system.xml ne doit tre utilise que lorsque vous avez ralis d'importantes modifications sur ces fichiers.
Procdure d'installation dans le mme rpertoire

1. l'aide des outils de bases de donnes, enregistrez votre base de donnes Content Store existante. Pour en savoir davantage sur la ralisation de cette tche, reportez-vous la documentation de votre base de donnes. 2. Enregistrez une copie de sauvegarde des fichiers suivants dans un emplacement scuris : coglocale.xml dans le rpertoire emplacement_c8/configuration server.xml dans le rpertoire emplacement_c8/tomcat4.1.27/conf system.xml dans le rpertoire correspondant, le cas chant
Veillez noter le chemin d'accs au rpertoire. Par exemple : emplacement_c8/templates/ps 3. Dans IBM Cognos Configuration, exportez les donnes de configuration dans le mme rpertoire scuris. Pour que le processus de mise niveau puisse utiliser les donnes, nommez le fichier cogstartup.xml. Important : Veillez ce que l'emplacement soit scuris car le fichier crnstartup.xml export contient des mots de passe non chiffrs. 4. Dans un emplacement scuris, effectuez une copie de sauvegarde des fichiers modifis manuellement dans le rpertoire emplacement_c8/configuration ou dans d'autres rpertoires.
90
Chapitre 5: Mise niveau vers IBM Cognos 8 5. Arrtez tous les services IBM Cognos. 6. Important : Si vous utilisez un systme de contrle de la source tel que CVS, assurez-vous que tous les projets de Framework Manager mettre niveau sont extraits avant de procder la mise niveau. Les projets qui sont activs lorsque vous effectuez la dsinstallation ne sont pas mis niveau. 7. Prparez des modles Transformer, si ncessaire (p. 117). 8. Mettez niveau ou installez d'autres produits (p. 110). 9. Dsinstallez IBM Cognos 8 de tous les ordinateurs IBM Cognos 8 (p. 147). 10. Installez la nouvelle version d'IBM Cognos 8 dans le mme rpertoire que celui utilis pour IBM Cognos 8 sur chaque ordinateur (p. 122). 11. Copiez les fichiers .xml situs dans les emplacements de sauvegarde scuriss suivants : Copiez les fichiers cogstartup.xml et coglocale.xml dans le rpertoire emplacement_c8/configuration. Copiez le fichier server.xml dans le rpertoire emplacement_c8/tomcat4.1.27/conf. Copiez le fichier system.xml dans le rpertoire correspondant, le cas chant Par exemple : emplacement_c8/templates/ps Si vous tes invit remplacer les fichiers existants, cliquez sur Oui. 12. Pour les fichiers modifis manuellement dans une version antrieure d'IBM Cognos 8, modifiez ces mmes fichiers dans le rpertoire emplacement_c8 et appliquez nouveau les modifications apportes aux fichiers personnaliss d'origine. Ne copiez pas les fichiers personnaliss dans les rpertoires emplacement_c8, car il est probable que les versions antrieures de ces fichiers ne soient pas compatibles. 13. Si vous utilisez Oracle pour une source de donnes, une source d'importation, une base de donnes de journalisation ou la base de donnes Content Store, supprimez le fichier classes12.jar du rpertoire c8_location\webapps\p2pd\WEB-INF\lib. Des versions antrieures d'IBM Cognos 8 utilisaient ce fichier, qui n'est pas compatible avec le fichier ojdbc14.jar (ou ojdbc5.jar, pour Oracle 11g) employ dans les versions plus rcentes. 14. Dans IBM Cognos Configuration, vrifiez la configuration, puis enregistrez-la. Lorsque vous enregistrez la configuration, une bote de dialogue de mise niveau s'affiche et vous demande si vous souhaitez mettre niveau les spcifications de votre rapport.Par dfaut, les spcifications du rapport ne sont pas mises niveau. Important : Ne mettez pas niveau vos spcifications de rapports si vous disposez d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Vous devez d'abord mettre jour vos applications SDK pour qu'elles soient conformes au schma de spcifications de rapports d'IBM Cognos 8.Sinon, elles risquent de ne pas pouvoir accder
Chapitre 5: Mise niveau vers IBM Cognos 8 aux spcifications de rapports mises niveau. Par ailleurs, n'enregistrez pas vos rapports avant d'avoir mis jour vos applications SDK. Pour en savoir davantage sur la mise niveau de spcifications de rapports, reportez-vous au manuel SDK Developer Guide d'IBM Cognos 8. 15. Dmarrez IBM Cognos 8. IBM Cognos 8 met automatiquement niveau la base de donnes Content Store. Les fichiers system.xml sont mis niveau, le cas chant, vers une version compatible d'IBM Cognos 8. 16. Installez et configurez (p. 197) Framework Manager. 17. Mettez niveau les projets et les rapports Framework Manager de faon approprie. Pour obtenir des instructions, reportez-vous au manuel Framework Manager User Guide. Les utilisateurs de Report Studio doivent vider l'antmmoire de leur navigateur Web pour obtenir les images les plus rcentes. 18. Si vous utilisez des pages cres dans les versions antrieures d'IBM Cognos 8, vous devrez peut-tre configurer nouveau les proprits suivantes : Titre Ouvrir des liens d'opration vers l'extrieur d'un portail
Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 19. Installez (p. 209) et configurez (p. 213) Transformer, si ncessaire. 20. Effectuez la mise niveau des modles et des cubes Transformer (p. 116), si ncessaire. 21. Si vous utilisez SAP Enterprise Portal, mettez niveau votre iView principal. Les iViews SAP ne fonctionneront pas avec le nouveau composant de Portal Services. Pour en savoir davantage, reportez-vous aux rubriques relatives au dploiement des portlets Cognos vers SAP Enterprise Portal dans le Guide d'administration et de scurit.
Procdure d'installation dans un nouveau rpertoire

1. l'aide des outils de bases de donnes, copiez votre base de donnes Content Store existante dans une nouvelle base de donnes Content Store. Pour en savoir davantage sur la ralisation de cette tche, reportez-vous la documentation de votre base de donnes. 2. Enregistrez une copie de sauvegarde des fichiers suivants dans un emplacement scuris : coglocale.xml dans le rpertoire emplacement_c8/configuration server.xml dans le rpertoire emplacement_c8/tomcat4.1.27/conf system.xml dans le rpertoire correspondant, le cas chant Veillez noter le chemin d'accs au rpertoire. Par exemple : emplacement_c8/templates/ps Dans IBM Cognos Configuration, exportez les donnes de configuration dans le mme rpertoire scuris.
92
Chapitre 5: Mise niveau vers IBM Cognos 8 Pour que le processus de mise niveau puisse utiliser les donnes, nommez le fichier cogstartup.xml. Important : Veillez ce que l'emplacement soit scuris car le fichier cogstartup.xml export contient des mots de passe non chiffrs. Dans un emplacement scuris, effectuez une copie de sauvegarde des fichiers modifis manuellement dans le rpertoire emplacement_c8/configuration ou dans d'autres rpertoires.
3. Prparez des modles Transformer, si ncessaire (p. 117). 4. Mettez niveau ou installez d'autres produits (p. 110). 5. Installez IBM Cognos 8 dans un nouveau rpertoire (p. 153). 6. Copiez les fichiers .xml situs dans l'emplacement de sauvegarde scuris vers le rpertoire suivant : Copiez les fichiers cogstartup.xml et coglocale.xml dans le rpertoire emplacement_c8/configuration. Copiez le fichier server.xml dans le rpertoire emplacement_c8/tomcat4.1.27/conf. Copiez le fichier system.xml dans le nouvel emplacement, dans le mme rpertoire qu'il occupait dans une version antrieure, le cas chant. Par exemple : emplacement_c8/templates/ps Si vous tes invit remplacer les fichiers existants, cliquez sur Oui. 7. Pour les fichiers modifis manuellement, modifiez ces mmes fichiers dans le rpertoire emplacement_c8 et appliquez nouveau les modifications apportes aux fichiers personnaliss d'origine. Ne copiez pas les fichiers personnaliss dans les rpertoires emplacement_c8, car il est probable que les versions antrieures de ces fichiers ne soient pas compatibles avec IBM Cognos 8. 8. Configurez les nouveaux alias de serveur Web (p. 133). 9. Dans IBM Cognos Configuration, configurez IBM Cognos 8 de faon pointer vers la nouvelle base de donnes Content Store, configurez les nouveaux ports et les nouvelles adresses URL, utilisez un autre chemin d'accs aux tmoins (cookies), puis enregistrez la configuration (p. 110). Afin d'viter tout conflit, assurez-vous que les numros de port et le nom du service associs cette installation sont diffrents de ceux utiliss par les versions antrieures. Vrifiez que les paramtres d'authentification de scurit sont inchangs. Par exemple, les espaces-noms doivent tre les mmes pour que les stratgies, les utilisateurs, les rles et les groupes fonctionnent correctement. Lorsque vous enregistrez la configuration, une bote de dialogue de mise niveau s'affiche et vous demande si vous souhaitez mettre niveau les spcifications de votre rapport.Par dfaut, les spcifications du rapport ne sont pas mises niveau.
Chapitre 5: Mise niveau vers IBM Cognos 8 Important : Ne mettez pas niveau vos spcifications de rapports si vous disposez d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Vous devez d'abord mettre jour vos applications SDK pour qu'elles soient conformes au schma de spcifications de rapports d'IBM Cognos 8.Sinon, elles risquent de ne pas pouvoir accder aux spcifications de rapports mises niveau. Par ailleurs, n'enregistrez pas vos rapports avant d'avoir mis jour vos applications SDK. Pour en savoir davantage sur la mise niveau de spcifications de rapports, reportez-vous au manuel SDK Developer Guide d'IBM Cognos 8. 10. Dmarrez IBM Cognos 8. IBM Cognos 8 met automatiquement niveau la nouvelle base de donnes Content Store. Les fichiers system.xml sont mis niveau, le cas chant, vers une version compatible d'IBM Cognos 8. 11. Installez et configurez (p. 197) Framework Manager. 12. Mettez niveau les projets et les rapports Framework Manager de faon approprie. Pour obtenir des instructions, reportez-vous au manuel Framework Manager User Guide. Les utilisateurs de Report Studio doivent vider l'antmmoire de leur navigateur Web pour obtenir les images les plus rcentes. 13. Ouvrez le portail d'administration et annulez l'inscription des distributeurs utiliss avec des versions antrieures d'IBM Cognos 8. Lorsque vous ouvrez le portail d'administration dans IBM Cognos 8, vous pouvez visualiser les distributeurs inscrits pour les deux versions. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 14. Si vous utilisez des pages cres dans ReportNet, vous devrez peut-tre configurer nouveau les proprits suivantes : Titre Ouvrir des liens d'opration vers l'extrieur d'un portail
Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 15. Installez (p. 209) et configurez (p. 213) Transformer, si ncessaire. 16. Effectuez la mise niveau des modles et des cubes Transformer (p. 116), si ncessaire. 17. Si vous utilisez SAP Enterprise Portal, mettez niveau votre iView principal. Les iViews SAP ne fonctionneront pas avec le nouveau composant de Portal Services. Pour en savoir davantage, reportez-vous aux rubriques relatives au dploiement des portlets Cognos vers SAP Enterprise Portal dans le Guide d'administration et de scurit. 18. Lorsque vous tes prt dsinstaller la version antrieure d'IBM Cognos 8, procdez comme suit : Arrtez le service IBM Cognos 8. Dsinstallez IBM Cognos 8 de tous les ordinateurs.
94
Chapitre 5: Mise niveau vers IBM Cognos 8 Pour en savoir davantage, reportez-vous la section "Dsinstallation d'IBM Cognos 8" (p. 147). Lorsque vous effectuez les tches de mise niveau, IBM Cognos 8 est intgralement configur, l'exception des nouvelles fonctionnalits, des nouvelles proprits et des fonctions lies aux tableaux de bord. Si vous utilisez des caractres chinois, japonais ou coren, il est possible que vous constatiez quelques diffrences au niveau des caractres une fois la mise niveau effectue. Pour en savoir davantage, reportez-vous la section Dpannage du Guide d'administration et de scurit. Si vous utilisez une base de donnes DB2 comme Content Store, vous pouvez mettre au point la base de donnes afin de tirer profit des fonctions de DB2. Pour en savoir davantage, reportez-vous au manuel Architecture and Deployment Guide. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.
Migration de bases de donnes Apache Derby vers la base de donnes de contenu d'IBM Cognos
Si vous utilisez votre propre installation Apache Derby pour la base de donnes Content Store ou la base de donnes de notification, vous devez migrer les bases de donnes vers la base de donnes de contenu d'IBM Cognos avant de dmarrer IBM Cognos 8. Pour ce faire, supprimez le fichier CognosCMDerby.jar de la base de donnes Apache Derby et copiez les rpertoires de la base de donnes dans le rpertoire de la base de donnes Content Store de l'installation IBM Cognos 8.
Procdure
1. Vrifiez que le serveur de rseau Apache Derby est actif. 2. Dmarrez l'utilitaire ij avec le fichier de script ij.bat ou ij.ksh. 3. Connectez-vous la base de donnes Apache Derby en saisissant la commande suivante dans l'utilitaire ij : connect 'jdbc:derby://hte:port/nom_base;user=nom_utilisateur; password=mot_de_passe'; Voici un exemple : connect 'jdbc:derby://localhost:1527/cm;user=cognos; password=cognos'; Si vous avez modifi le numro de port implicite 1527, utilisez le port appropri pour votre base de donnes Apache Derby. Utilisez le nom exact de votre base de donnes Apache Derby. 4. Supprimez la proprit derby.database.classpath de la base de donnes en saisissant la commande suivante dans l'utilitaire ij : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.database.classpath',''); 5. Supprimer le fichier jar existant en saisissant la commande suivante dans l'utilitaire ij : CALL sqlj.remove_jar('nom_schma.CMFunctionsjar', 0); Par exemple, si vous utilisez un schma appel cognos, saisissez la commande suivante :
Chapitre 5: Mise niveau vers IBM Cognos 8 CALL sqlj.remove_jar('cognos.CMFunctionsjar', 0); 6. Activez le verrouillage des niveaux de lignes dans la base de donnes en saisissant la commande suivante dans l'utilitaire ij : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.storage.rowLocking','true'); 7. Fermez l'utilitaire ij en saisissant la commande suivante : disconnect; 8. Arrtez le serveur de rseau Apache Derby. 9. Copiez les rpertoires de la base de donnes Content Store et de la base de donnes de notification dans le rpertoire emplacement_c8\contentstore. Par exemple : xcopy "c:\derby\data\cm" "c:\Program Files\c8\contentstore\cm" /s /ixcopy "c:\derby\data\ notify_db" "c:\Program Files\c8\contentstore\notify_db" /s /i Dans cet exemple, la base de donnes Content Store est nomme cm et la base de donnes de notification est nomme notify_db. Elles se trouvent dans le rpertoire c:\derby\data.
Nouveaux noms de produits, de fichiers et de rpertoires aprs la mise niveau partir de ReportNet
Aprs avoir effectu une mise niveau depuis ReportNet, le nom de produit deviendra IBM Cognos 8. En outre, certains noms de fichiers, de rpertoires et de commandes seront diffrents. Si vous n'installez pas IBM Cognos 8 dans le mme rpertoire que ReportNet, les noms de rpertoires implicites sont modifis lorsque vous installez IBM Cognos 8. Si vous installez IBM Cognos 8 dans le mme rpertoire que ReportNet, les noms de rpertoires existants resteront inchangs. Certains noms de fichiers sont modifis lors de l'installation d'IBM Cognos 8 et d'autres modifications surviennent lors de l'enregistrement de la configuration d'IBM Cognos 8. Vous devez modifier manuellement l'alias du rpertoire virtuel, le cas chant. Les noms ci-aprs sont concerns :
ReportNet
crn crn
IBM Cognos 8
c8 cognos8
Description
Rpertoire implicite d'installation Alias du navigateur Web implicite ou du rpertoire virtuel Fichier des donnes de configuration utilis lors du dmarrage d'IBM Cognos Configuration Fichier des donnes de configuration qui stocke les prfrences lors de chaque enregistrement de la configuration
crnstartup.xml
cogstartup.xml
crnstartup_ aaaammjjhhmm. xml
cogstartup_ aaaammjjhhmm. xml
96
ReportNet
crnlocale.xml
IBM Cognos 8
coglocale.xml
Description
Fichier des donnes de configuration qui stocke les codes des paramtres de configuration internationaux
crnlocale_ aaaammjjhhmm.xml coglocale_ aaaammjjhhmm.xml Fichier des donnes de configuration qui stocke les prfrences lors de chaque enregistrement des paramtres de configuration internationaux crnformat.xml cogformat.xml Fichier des donnes de configuration qui stocke le format des donnes numriques, de la date et de l'heure Fichier de journalisation implicite Fichier de dmarrage d'IBM Cognos Configuration sous Windows Fichier de dmarrage d'IBM Cognos Configuration sous Windows en mode silencieux Fichier de dmarrage d'IBM Cognos Configuration sous UNIX et Linux Fichier des donnes de configuration qui stocke les prfrences de l'utilisateur dans IBM Cognos Configuration Fichier de journalisation en mode silencieux qui stocke les activits lors du fonctionnement d'IBM Cognos Configuration en mode silencieux Commande permettant de dmarrer l'assistant d'installation sous X Windows Commande permettant de dmarrer l'assistant d'installation sous UNIX et Linux Fichier pour dmarrer l'assistant d'installation sous Windows
crnserver.log crconfigw.exe
cogserver.log cogconfigw.exe
crconfig.bat
cogconfig.bat
crconfig.sh
cogconfig.sh
crconfig.prefs
cogconfig.prefs
crconfig_ rponse.csv
cogconfig_ rponse.csv
xstartup
issetup
xwsetup
issetupcc
xwsetup.exe
issetup.exe
ReportNetService_ codelangue. CognosService_ codelangue.xml Exemple de fichier pour les configurations moyexml nnes ou tendues
Mise niveau de ReportNet vers IBM Cognos 8

Vous pouvez installer et mettre niveau IBM Cognos 8 dans le mme rpertoire que ReportNet ou dans un rpertoire diffrent. Si vous souhaitez mettre niveau IBM Cognos 8 dans le mme rpertoire, vous devez d'abord sauvegarder vos donnes, vous assurer que les projets de Framework Manager ne sont pas activs dans un systme de contrle de la source, puis dsinstaller ReportNet. Des instructions compltes sont prsentes dans la procdure d'installation dans le mme rpertoire. Pour installer IBM Cognos 8 dans un nouveau rpertoire, vous pouvez maintenir ReportNet actif jusqu' ce que la nouvelle version fonctionne de faon approprie. Si vous effectuez une installation sur un nouvel ordinateur, reportez-vous la procdure d'installation dans un nouveau rpertoire. Lorsque vous effectuez une copie de sauvegarde des donnes de configuration, vous les stockez dans un rpertoire scuris. Ce rpertoire doit tre protg contre tout accs non autoris ou inappropri. Une autre mthode de mise niveau consiste exporter l'intgralit de la base de donnes Content Store dans une archive de dploiement de ReportNet, puis importer cette archive dans IBM Cognos 8. Pour en savoir davantage sur le dploiement, reportez-vous au Guide d'administration et de scurit. Une mise niveau par dploiement est requise si vous souhaitez modifier le type de base de donnes Content Store utilis. Si vous optez pour la mthode de mise niveau par dploiement, seules les tapes d'exportation et de restauration des donnes de configuration diffrent. Toutes les autres tapes sont identiques celles dcrites dans la prsente section. IBM Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous mettez niveau ReportNet et que vous ne souhaitez pas utiliser Tomcat, vous devez suivre une autre procdure de mise niveau. Pour en savoir davantage, reportez-vous la section "Mise niveau vers IBM Cognos 8 dans un environnement de serveur d'application " (p. 399). Lorsque vous effectuez une mise niveau de ReportNet 1.1 vers IBM Cognos 8, l'administrateur de rapports n'a plus accs l'outil d'administration du contenu. Il ne sera donc pas en mesure de crer des dfinitions de dploiement dans IBM Cognos 8.
Fichiers ReportNet personnaliss

Si vous avez modifi manuellement des fichiers de configuration, ces modifications seront remplaces lors de la mise niveau. Vous devez nouveau appliquer ces modifications dans l'environnement IBM Cognos 8. Il est vivement conseill de conserver un enregistrement de toutes les personnalisations afin de garantir qu'elles pourront tre appliques nouveau aprs la mise niveau. Vous devriez galement enregistrer ces fichiers afin de pouvoir restaurer la version d'origine en cas de besoin. Il est possible que vous ayez modifi des fichiers autres que ceux situs dans le dossier de configuration. Dans ce cas, vous devez galement sauvegarder ces autres fichiers avant de procder la mise niveau. Le service de prsentation d'IBM Cognos 8 prend en charge la mise niveau automatique de certains fichiers system.xml de ReportNet. Si vous avez effectu de nombreuses modifications de personnalisation sur des fichiers system.xml dans ReportNet, vous pouvez utiliser cette fonction de mise niveau automatique au lieu d'intgrer manuellement les modifications aprs la mise niveau. Les fichiers system.xml sont crass lors de l'installation d'IBM Cognos 8. Par consquent, vous devez enregistrer les versions ReportNet de ces fichiers et les copier dans le rpertoire aprs l'installation
98
Chapitre 5: Mise niveau vers IBM Cognos 8 d'IBM Cognos 8. La mise niveau automatique s'excutera lorsque vous dmarrerez le service IBM Cognos 8. Les fichiers system.xml concerns par la mise niveau automatique se trouvent dans les rpertoires suivants : emplacement_crn/templates/ps emplacement_crn/templates/ps/portal emplacement_crn/templates/ps/qs
Remarque : Nous vous recommandons de mettre niveau manuellement les fichiers personnaliss en appliquant de nouveau les modifications aprs l'installation du nouveau logiciel. La mise niveau automatique des fichiers system.xml ne doit tre utilise que lorsque vous avez ralis d'importantes modifications sur ces fichiers.
Procdure d'installation dans le mme rpertoire

1. l'aide des outils de bases de donnes, enregistrez votre base de donnes Content Store existante. Pour en savoir davantage sur la ralisation de cette tche, reportez-vous la documentation de votre base de donnes. 2. Enregistrez une copie de sauvegarde des fichiers suivants dans un emplacement scuris : crnlocale.xml dans le rpertoire emplacement_crn/configuration server.xml dans le rpertoire emplacement_crn/tomcat4.1.27/conf system.xml dans le rpertoire correspondant, le cas chant
Veillez noter le chemin d'accs au rpertoire. Par exemple : emplacement_crn/templates/ps 3. Dans IBM Cognos Configuration, exportez les donnes de configuration dans le mme rpertoire scuris. Pour que le processus de mise niveau puisse utiliser les donnes, nommez le fichier crnstartup.xml. Important : Veillez ce que l'emplacement soit scuris car le fichier crnstartup.xml export contient des mots de passe non chiffrs. 4. Dans un emplacement scuris, effectuez une copie de sauvegarde des fichiers modifis manuellement dans le rpertoire emplacement_crn/configuration ou dans d'autres rpertoires. 5. Arrtez tous les services IBM Cognos. 6. Important : Si vous utilisez un systme de contrle de la source tel que CVS, assurez-vous que tous les projets de Framework Manager mettre niveau sont extraits avant de dsinstaller ReportNet. Les projets qui sont activs lorsque vous effectuez la dsinstallation ne sont pas mis niveau. 7. Prparez des modles Transformer, si ncessaire (p. 117).
Chapitre 5: Mise niveau vers IBM Cognos 8 8. Mettez niveau ou installez d'autres produits (p. 110). 9. Dsinstallez ReportNet de tous les ordinateurs ReportNet. Pour en savoir davantage, reportez-vous aux instructions de l'ancienne version de ReportNet. 10. Installez IBM Cognos 8 dans le mme rpertoire que celui utilis pour ReportNet sur chaque ordinateur (p. 122). 11. Copiez les fichiers .xml situs dans les emplacements de sauvegarde scuriss suivants : Copiez les fichiers crnstartup.xml et crnlocale.xml dans le rpertoire emplacement_crn/configuration. Copiez le fichier server.xml dans le rpertoire emplacement_crn/tomcat4.1.27/conf. Copiez le fichier system.xml dans le rpertoire correspondant, le cas chant Par exemple : emplacement_crn/templates/ps Si vous tes invit remplacer les fichiers existants, cliquez sur Oui. 12. Pour les fichiers modifis manuellement dans ReportNet, modifiez ces mmes fichiers dans le rpertoire emplacement_crn et appliquez nouveau les modifications apportes aux fichiers personnaliss d'origine. Ne copiez pas les fichiers personnaliss dans les rpertoires emplacement_crn, car il est probable que les versions antrieures de ces fichiers ne soient pas compatibles avec IBM Cognos 8. 13. Si vous utilisez Oracle pour une source de donnes, une source d'importation, une base de donnes de journalisation ou la base de donnes Content Store, supprimez le fichier classes12.jar du rpertoire c8_location\webapps\p2pd\WEB-INF\lib. Des versions antrieures d'IBM Cognos 8 utilisaient ce fichier, qui n'est pas compatible avec le fichier ojdbc14.jar (ou ojdbc5.jar, pour Oracle 11g) employ dans les versions plus rcentes. 14. Dans IBM Cognos Configuration, vrifiez la configuration, puis enregistrez-la. Lorsque vous enregistrez la configuration, une bote de dialogue de mise niveau s'affiche et vous demande si vous souhaitez mettre niveau les spcifications de votre rapport.Par dfaut, les spcifications du rapport ne sont pas mises niveau. Important : Ne mettez pas niveau vos spcifications de rapports si vous disposez d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Vous devez d'abord mettre jour vos applications SDK pour qu'elles soient conformes au schma de spcifications de rapports d'IBM Cognos 8.Sinon, elles risquent de ne pas pouvoir accder aux spcifications de rapports mises niveau. Par ailleurs, n'enregistrez pas vos rapports avant d'avoir mis jour vos applications SDK. Pour en savoir davantage sur la mise niveau de spcifications de rapports, reportez-vous au manuel SDK Developer Guide d'IBM Cognos 8. 15. Dmarrez IBM Cognos 8. IBM Cognos 8 met automatiquement niveau la base de donnes Content Store. Les fichiers system.xml sont mis niveau, le cas chant, vers une version compatible d'IBM Cognos 8.
100
Chapitre 5: Mise niveau vers IBM Cognos 8 Si le service ReportNet continue de s'excuter, dsinstallez-le manuellement (p. 112). 16. Installez et configurez (p. 197) Framework Manager. 17. Mettez niveau les projets et les rapports Framework Manager de faon approprie. Pour obtenir des instructions, reportez-vous au manuel Framework Manager User Guide. Les utilisateurs de Report Studio doivent vider l'antmmoire de leur navigateur Web pour obtenir les images les plus rcentes. 18. Si vous utilisez des pages cres dans ReportNet, vous devrez peut-tre configurer nouveau les proprits suivantes : Titre Ouvrir des liens d'opration vers l'extrieur d'un portail
Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 19. Si vous avez publi des cubes IBM Cognos Series 7 dans ReportNet, restructurez vos rpertoires virtuels ou modifiez le chemin d'accs du tmoin (cookie) (p. 113). 20. Installez (p. 209) et configurez (p. 213) Transformer, si ncessaire. 21. Effectuez la mise niveau des modles et des cubes Transformer (p. 116), si ncessaire. 22. Si vous utilisez SAP Enterprise Portal, mettez niveau votre iView principal. Les iViews SAP ne fonctionneront pas avec le nouveau composant de Portal Services. Pour en savoir davantage, reportez-vous aux rubriques relatives au dploiement des portlets Cognos vers SAP Enterprise Portal dans le Guide d'administration et de scurit.
Procdure d'installation dans un nouveau rpertoire

1. l'aide des outils de bases de donnes, copiez votre base de donnes Content Store existante dans une nouvelle base de donnes Content Store. Pour en savoir davantage sur la ralisation de cette tche, reportez-vous la documentation de votre base de donnes. 2. Enregistrez une copie de sauvegarde des fichiers suivants dans un emplacement scuris : crnlocale.xml dans le rpertoire emplacement_crn/configuration server.xml dans le rpertoire emplacement_crn/tomcat4.1.27/conf system.xml dans le rpertoire correspondant, le cas chant Veillez noter le chemin d'accs au rpertoire. Par exemple : emplacement_crn/templates/ps Dans IBM Cognos Configuration, exportez les donnes de configuration dans le mme rpertoire scuris. Pour que le processus de mise niveau puisse utiliser les donnes, nommez le fichier crnstartup.xml.
Chapitre 5: Mise niveau vers IBM Cognos 8 Important : Veillez ce que l'emplacement soit scuris car le fichier crnstartup.xml export contient des mots de passe non chiffrs. Dans un emplacement scuris, effectuez une copie de sauvegarde des fichiers modifis manuellement dans le rpertoire emplacement_crn/configuration ou dans d'autres rpertoires.
3. Prparez des modles Transformer, si ncessaire (p. 117). 4. Mettez niveau ou installez d'autres produits (p. 110). 5. Installez IBM Cognos 8 dans un nouveau rpertoire (p. 153). 6. Copiez les fichiers .xml situs dans l'emplacement de sauvegarde scuris vers le rpertoire suivant : Copiez les fichiers crnstartup.xml et crnlocale.xml dans le rpertoire emplacement_c8/configuration. Copiez le fichier server.xml dans le rpertoire emplacement_c8/tomcat4.1.27/conf. Copiez le fichier system.xml dans le nouvel emplacement, dans le mme rpertoire qu'il occupait dans ReportNet, le cas chant. Par exemple : emplacement_c8/templates/ps Si vous tes invit remplacer les fichiers existants, cliquez sur Oui. 7. Pour les fichiers modifis manuellement dans ReportNet, modifiez ces mmes fichiers dans le rpertoire emplacement_c8 et appliquez nouveau les modifications apportes aux fichiers personnaliss d'origine. Ne copiez pas les fichiers personnaliss dans les rpertoires emplacement_c8, car il est probable que les versions antrieures de ces fichiers ne soient pas compatibles avec IBM Cognos 8. 8. Configurez les nouveaux alias de serveur Web (p. 133). 9. Dans IBM Cognos Configuration, procdez comme suit : Pour la nouvelle instance d'IBM Cognos 8, configurez IBM Cognos 8 afin qu'il pointe vers la nouvelle base de donnes Content Store, configurez les nouveaux ports et les adresses URL, puis enregistrez la configuration (p. 110). Pour ReportNet, configurez ReportNet pour qu'il utilise un nouveau chemin d'accs implicite aux tmoins (cookies) (p. 112).
Afin d'viter tout conflit, assurez-vous que les numros de port et le nom du service associs cette installation sont diffrents de ceux utiliss par les versions antrieures. Vrifiez que les paramtres d'authentification de scurit sont inchangs. Par exemple, les espaces-noms doivent tre les mmes pour que les stratgies, les utilisateurs, les rles et les groupes fonctionnent correctement.
102
Chapitre 5: Mise niveau vers IBM Cognos 8 Lorsque vous enregistrez la configuration, une bote de dialogue de mise niveau s'affiche et vous demande si vous souhaitez mettre niveau les spcifications de votre rapport.Par dfaut, les spcifications du rapport ne sont pas mises niveau. Important : Ne mettez pas niveau vos spcifications de rapports si vous disposez d'applications SDK permettant de crer, de modifier ou d'enregistrer des spcifications de rapports. Vous devez d'abord mettre jour vos applications SDK pour qu'elles soient conformes au schma de spcifications de rapports d'IBM Cognos 8.Sinon, elles risquent de ne pas pouvoir accder aux spcifications de rapports mises niveau. Par ailleurs, n'enregistrez pas vos rapports avant d'avoir mis jour vos applications SDK. Pour en savoir davantage sur la mise niveau de spcifications de rapports, reportez-vous au manuel SDK Developer Guide d'IBM Cognos 8. 10. Dmarrez IBM Cognos 8. IBM Cognos 8 met automatiquement niveau la nouvelle base de donnes Content Store. Les fichiers system.xml sont mis niveau, le cas chant, vers une version compatible d'IBM Cognos 8. 11. Installez et configurez (p. 197) Framework Manager. 12. Mettez niveau les projets et les rapports Framework Manager de faon approprie. Pour obtenir des instructions, reportez-vous au manuel Framework Manager User Guide. Les utilisateurs de Report Studio doivent vider l'antmmoire de leur navigateur Web pour obtenir les images les plus rcentes. 13. Ouvrez le portail d'administration dans IBM Cognos 8 et annulez l'inscription des distributeurs utiliss avec ReportNet. Lorsque vous ouvrez le portail d'administration dans IBM Cognos 8, celui-ci affiche les distributeurs inscrits pour les deux versions. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 14. Si vous utilisez des pages cres dans ReportNet, vous devrez peut-tre configurer nouveau les proprits suivantes : Titre Ouvrir des liens d'opration vers l'extrieur d'un portail
Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 15. Si vous avez publi des cubes IBM Cognos Series 7 dans ReportNet, restructurez vos rpertoires virtuels ou modifiez le chemin d'accs du tmoin (cookie) (p. 113). 16. Installez (p. 209) et configurez (p. 213) Transformer, si ncessaire. 17. Effectuez la mise niveau des modles et des cubes Transformer (p. 116), si ncessaire. 18. Si vous utilisez SAP Enterprise Portal, mettez niveau votre iView principal. Les iViews SAP ne fonctionneront pas avec le nouveau composant de Portal Services. Pour en savoir davantage, reportez-vous aux rubriques relatives au dploiement des portlets Cognos vers SAP Enterprise Portal dans le Guide d'administration et de scurit.
Chapitre 5: Mise niveau vers IBM Cognos 8 19. Lorsque vous tes prt dsinstaller ReportNet, procdez comme suit : Arrtez ReportNet. Dsinstallez ReportNet de tous les ordinateurs ReportNet. Pour en savoir davantage, reportez-vous aux instructions de l'ancienne version de ReportNet. Lorsque vous effectuez les tches de mise niveau, IBM Cognos 8 est intgralement configur, l'exception des nouvelles fonctionnalits, des nouvelles proprits et des fonctions lies aux tableaux de bord. Si vous utilisez des caractres chinois, japonais ou corens, il est possible que des diffrences apparaissent au niveau de certains caractres une fois la mise niveau vers IBM Cognos 8 effectue. Pour en savoir davantage, reportez-vous la section Dpannage du Guide d'administration et de scurit. Si vous utilisez une base de donnes DB2 comme Content Store, vous pouvez mettre au point la base de donnes afin de tirer profit des fonctions de DB2. Pour en savoir davantage, reportez-vous au manuel Architecture and Deployment Guide. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.
Mise niveau l'aide de l'option de configuration silencieuse

Vous pouvez excuter une configuration silencieuse pour mettre niveau la configuration de ReportNet vers IBM Cognos 8 Avant de dmarrer la configuration silencieuse, vrifiez la configuration de l'option de mise niveau des spcifications de rapports. Si vous avez install IBM Cognos 8 dans un nouveau rpertoire, vous devez galement modifier les paramtres des ports et les alias de serveurs Web. Si vous souhaitez mettre niveau la configuration en mode silencieux, suivez la procdure de la section prcdente et arrtez-vous l'tape de la configuration d'IBM Cognos 8 : Dans la procdure d'installation dans le mme rpertoire, arrtez-vous l'tape 12. Dans la procdure d'installation dans un nouveau rpertoire, arrtez-vous l'tape 8.
Lorsque vous atteignez cette tape, ne dmarrez pas IBM Cognos Configuration. Au lieu de cela, procdez comme suit et retournez la procdure de la section prcdente. Modifiez le fichier crnstartup.xml situ dans le rpertoire emplacement_crn/configuration ou emplacement_c8/configuration et recherchez les lignes suivantes :
<crn:parametername="doReportSpecUpgrade"> <crn:value xsi:type="xsd:boolean">false</crn:value> </crn:parameter>
Dfinissez la valeur de la mise niveau de la spcification de rapport : Pour ne pas effectuer la mise niveau des spcifications de rapports, conservez la valeur False. Pour mettre niveau les spcifications de rapports, remplacez la valeur par True.
104
Chapitre 5: Mise niveau vers IBM Cognos 8 Modifiez les autres paramtres selon les besoins. Si vous avez install IBM Cognos 8 dans un nouveau rpertoire, reportez-vous la section "Excution simultane de ReportNet et d'IBM Cognos 8" (p. 110) pour connatre les paramtres modifier. Saisissez la commande de configuration : Sous UNIX ou Linux, saisissez ./cogconfig.sh -s Sous Windows, saisissez cogconfig.bat -s
Mise niveau de Metrics Manager vers IBM Cognos 8

Vous devez installer Metrics Manager et le mettre niveau vers IBM Cognos 8 dans un rpertoire diffrent de celui contenant la version antrieure. Vous pouvez maintenir Metrics Manager actif jusqu' ce qu'IBM Cognos 8 fonctionne de faon approprie. Si ReportNet et Metrics Manager sont installs sur le mme ordinateur et que vous prvoyez d'effectuer une mise niveau vers IBM Cognos 8, mettez d'abord niveau ReportNet, puis Metrics Manager. IBM Cognos 8 et les versions antrieures de Metrics Manager utilisent des modles de scurit diffrents. Si vous souhaitez mettre niveau les informations de scurit d'une version prcdente de Metrics Manager, vous devez suivre une autre procdure de mise niveau. Pour en savoir davantage, reportez-vous la section "Mise niveau de Metrics Manager et des informations de scurit" (p. 106). IBM Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous mettez niveau Metrics Manager et que vous ne souhaitez pas utiliser Tomcat, vous devez suivre une autre procdure de mise niveau. Pour en savoir davantage, reportez-vous la section "Mise niveau de Metrics Manager vers IBM Cognos 8 dans un environnement de serveur d'application" (p. 400).
Procdure
1. Exportez le contenu de la bibliothque de donnes que vous souhaitez utiliser avec IBM Cognos 8 partir de l'ancienne version de Metrics Manager. Pour en savoir davantage, reportez-vous la documentation fournie avec l'ancienne version de Metrics Manager. 2. Installez IBM Cognos 8 : Si vous mettez niveau uniquement Metrics Manager, installez IBM Cognos 8 dans un rpertoire diffrent de celui de l'ancienne version de Metrics Manager (p. 153). Si ReportNet est install sur le mme ordinateur que Metrics Manager, suivez la procdure de mise niveau de ReportNet vers IBM Cognos 8 (p. 98).
3. Configurez l'environnement (p. 57).
Chapitre 5: Mise niveau vers IBM Cognos 8 Si vous avez export le contenu d'une ou plusieurs bibliothques de donnes l'tape 1, crez une bibliothque d'indicateurs (p. 63) pour chaque bibliothque de donnes. Pour chaque bibliothque d'indicateurs, configurez le client de base de donnes (p. 69) et les variables d'environnement sous UNIX (p. 72). 4. Crez un pack d'indicateurs (p. 144). 5. Si vous avez export du contenu des bibliothques de donnes l'tape 1, importez le contenu de toutes ces bibliothques de donnes dans une autre bibliothque d'indicateurs. Pour en savoir davantage sur l'importation de donnes, reportez-vous au Guide de l'utilisateur de Metric Studio pour les auteurs. 6. Installez et configurez (p. 153) Metric Designer sous Windows. 7. Effectuez la mise niveau des projets et extraits de Metric Designer de faon approprie. 8. Lorsque vous tes prt, arrtez l'ancienne version de Metrics Manager et dsinstallez-la comme indiqu dans la documentation fournie. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, protgez le rpertoire d'installation contre tout accs non autoris ou inappropri.
Mise niveau de Metrics Manager et des informations de scurit

IBM Cognos 8 et les versions antrieures de Metrics Manager utilisent des modles de scurit diffrents. Avant d'effectuer la mise niveau vers IBM Cognos 8, prenez connaissance des informations relatives la scurit d'IBM Cognos 8 afin de vous assurer qu'elle correspond vos besoins. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Un utilitaire de mise niveau est votre disposition si le modle de scurit d'IBM Cognos 8 ne rpond pas vos besoins et que vous devez mettre niveau les informations de scurit. Faites appel cet utilitaire pendant le processus de mise niveau pour tablir les correspondances entre les anciens droits d'accs pour les tableaux de bord et les types d'indicateurs et les nouveaux droits d'accs dans IBM Cognos 8. L'utilitaire de mise niveau n'tablit pas de correspondance pour les ventuels refus de droits d'accs utiliss dans l'ancienne version de Metrics Manager. Par exemple, imaginons un utilisateur appartenant deux classes d'utilisateurs. Pour un mme tableau de bord, l'une des classes d'utilisateurs dispose de droits en lecture tandis que l'autre classe est interdite d'accs. Aprs l'excution de l'utilitaire de mise niveau, l'utilisateur disposera uniquement de l'accs en lecture au tableau de bord. L'utilitaire de mise niveau tablit les correspondances des informations de scurit pour une bibliothque de donnes qui utilise ces informations dans un fichier de contrle cr par vous. Ce fichier est au format texte. Si vous envisagez de mettre niveau le contenu de plusieurs bibliothques de donnes, vous devez crer un fichier de contrle pour chacune d'entre elles et excuter l'utilitaire de mise niveau sur chaque fichier de contrle. Le tableau ci-dessous dcrit les proprits qui doivent tre dfinies dans le fichier de contrle. Un exemple de fichier de contrle vous est fourni sous le tableau.
106
Proprit
scorecard_file
Description
Une liste, dont les lments sont spars par une virgule, des fichiers object_stage (.cmo) qui contiennent les tableaux de bord de l'ancienne version de Metrics Manager. Cette liste doit contenir tous les tableaux de bord que vous souhaitez importer dans la bibliothque d'indicateurs d'IBM Cognos 8.Seuls les tableaux de bord sont imports, les autres objets contenus dans ces fichiers sont ignors. Une liste, dont les lments sont spars par une virgule, des fichiers source object_link_stage (.cml) de l'ancienne version de Metrics Manager qui contiennent les rgles mettre niveau. Cette liste de fichiers doit contenir tous les liens des rgles que vous souhaitez importer dans la bibliothque d'indicateurs d'IBM Cognos 8.Seuls les liens des rgles sont imports, les autres objets contenus dans ces fichiers sont ignors. Jeu de caractres des fichiers en entre. Cette proprit est facultative. Par dfaut, le jeu de caractres implicite de la plate-forme est utilis. Version du fichier plat de l'ancienne version de Metrics Manager. La valeur peut tre gale 2.0 ou 2.2. Cette proprit est facultative. La valeur implicite est 2.2.
policy_file
input_file_encoding
flat_file_version
output_file
Nom du fichier dans lequel les rgles cres dans IBM Cognos 8 seront crites. Cette proprit est facultative. Le nom implicite du fichier en sortie est policies.cms.
output_file_enco- Jeu de caractres souhait pour le fichier en sortie. ding Cette proprit est facultative. Par dfaut, le jeu de caractres implicite de la plate-forme est utilis. read_mapping Une liste, dont les lments sont spars par une virgule, des autorisations IBM Cognos 8 attribuer pour les droits de lecture dfinis dans l'ancienne version de Metrics Manager. L'un des suffixes suivants peut tre ajout afin de prciser les autorisations pour un type d'objet spcifique : metric ou .scorecard. write_mapping Une liste, dont les lments sont spars par une virgule, des autorisations IBM Cognos 8 attribuer pour les droits d'criture dfinis dans l'ancienne version de Metrics Manager. L'un des suffixes suivants peut tre ajout afin de prciser les autorisations pour un type d'objet spcifique : metric ou .scorecard.
Proprit
administrator_ mapping
Description
Une liste, dont les lments sont spars par une virgule, des autorisations IBM Cognos 8 attribuer pour les droits d'administration dfinis dans l'ancienne version de Metrics Manager. Ces autorisations incluent : Read Write Setpolicy Readannotations Annotate Writeproject Writeactual Writetarget Writetolerance Writeudc
L'un des suffixes suivants peut tre ajout afin de prciser les autorisations pour un type d'objet spcifique : metric ou .scorecard.
Exemple
Observez l'exemple de fichier de contrle ci-dessous :
scorecard_file=c:\\cmm_exports\\export_scorecards.cmo policy_file=c:\\cmm_exports\\export_permissions.cml flat_file_version=2.2 output_file=new_policies.cms read_mapping=read,readannotations write_mapping=read,readannotations,annotate,writeProject administrator_mapping=read,readannotations,annotate,writeProject,write, writeactual,writetarget,writetolerance,writeudc
Procdure
1. Exportez le contenu de la bibliothque de donnes de l'ancienne version de Metrics Manager, l'exception des utilisateurs. Pour en savoir davantage, reportez-vous la documentation fournie avec l'ancienne version de Metrics Manager. 2. Installez IBM Cognos 8 : Si vous mettez niveau uniquement Metrics Manager, installez IBM Cognos 8 dans un rpertoire diffrent de celui de l'ancienne version de Metrics Manager (p. 153).
108
Chapitre 5: Mise niveau vers IBM Cognos 8 Si ReportNet est install sur le mme ordinateur que Metrics Manager, suivez la procdure de mise niveau de ReportNet vers IBM Cognos 8 (p. 98).
3. Configurez l'environnement (p. 57). Assurez-vous que vous crez une bibliothque d'indicateurs (p. 63) et que vous configurez le client de base de donnes de la bibliothque d'indicateurs (p. 69) et les variables d'environnement sous UNIX (p. 72). Assurez-vous galement que l'espace-noms Series 7 est configur et accessible dans l'environnement IBM Cognos 8. 4. Crez un fichier de contrle pour rfrencer les fichiers object stage (.cmo), qui contiennent la dfinition des tableaux de bord, ainsi que les fichiers object link stage (.cml), qui contiennent la dfinition des autorisations gnres l'tape 1. Le fichier de contrle est au format texte. Consultez le tableau et l'exemple ci-dessus pour faciliter la cration de votre fichier de contrle. 5. Dans le rpertoire emplacement_c8\bin, saisissez la commande suivante dans l'invite de commande : cmm_migrate_policies nom_fichier_contrle 6. Crez un pack d'indicateurs (p. 144). 7. Importez dans la bibliothque d'indicateurs la bibliothque de donnes que vous avez exporte lors de l'tape 1. Vous n'avez pas besoin d'importer les fichiers object link stage (.cml) contenant la dfinition des autorisations. Dans l'exemple ci-dessus, le fichier contenant la dfinition des autorisations est nomm export_permission.cml. Pour en savoir davantage sur l'importation, reportez-vous au Guide de l'utilisateur de Metric Studio pour les auteurs. 8. Importez le contenu du fichier en sortie cr l'aide de la commande cmm_migrate_policy. Le fichier en sortie est nomm new_policies.cms dans l'exemple ci-dessus. Assurez-vous que le format des fichiers sources d'importation est dfini 8.1.2MR2. 9. Installez et configurez (p. 153) Metric Designer sous Windows. 10. Effectuez la mise niveau des projets et extraits de Metric Designer de faon approprie. 11. Lorsque vous tes prt, arrtez l'ancienne version de Metrics Manager et dsinstallez-la comme indiqu dans la documentation fournie. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, protgez le rpertoire d'installation contre tout accs non autoris ou inappropri.
Mise niveau de calendriers personnaliss Metrics Manager

Si vous souhaitez mettre niveau un calendrier Metrics Manager 2.2 utilisant des dates de dbut et de fin de priode personnalises, vous devez crer un calendrier standard dans IBM Cognos 8
Chapitre 5: Mise niveau vers IBM Cognos 8 qui reflte le mieux possible votre calendrier personnalis. Vous devez ensuite exporter ce calendrier standard et modifier les fichiers d'importation de priodes (.cal), d'importation de niveaux temporels (.lvl) et de noms localiss de priode (.tlt) de faon ce que le calendrier soit identique au calendrier Metrics Manager 2.2.
Installation ou mise niveau d'autres produits

Lorsque vous mettez niveau IBM Cognos 8, vous devrez peut-tre effectuer une mise niveau vers de nouvelles versions d'autres produits, mettre jour des composants d'autres produits ou installer des produits supplmentaires pour la prise en charge des nouvelles fonctions d'IBM Cognos 8. La liste des autres produits utiliss par IBM Cognos 8 figure la section "Vrification de la configuration systme requise" (p. 58). Pour consulter une liste jour des environnements pris en charge par les produits IBM Cognos, tels que les systmes d'exploitation, les correctifs, les navigateurs, ainsi que les serveurs Web, d'annuaire, de bases de donnes et d'applications, consultez le site Web Cognos Software Services (http://support. cognos.com).
Procdure
Si vous ne disposez pas de la version prise en charge d'un produit requis, installez le produit ou mettez-le niveau. Le prsent guide fournit des instructions pour certains des autres produits requis : configuration d'un client de base de donnes (p. 69) mise jour de l'environnement Java (p. 126) configuration d'un serveur Web (p. 133) configuration d'un navigateur Web (p. 73) modification du type de Java Virtual Machine (JVM) utilise dans IBM Cognos 8 (p. 401) changement de la version de Java Runtime Environment utilise dans IBM Cognos 8 (p. 402)
Pour savoir comment installer et mettre niveau d'autres produits, consultez les instructions associes ceux-ci.
Excution simultane de ReportNet et d'IBM Cognos 8

Pour excuter IBM Cognos 8 et ReportNet ou bien deux versions d'IBM Cognos 8 en mme temps et sur le mme ordinateur, vous devez modifier les ports et l'alias du serveur Web dans IBM Cognos 8. Dans ReportNet, il n'existe pas de chemin d'accs implicite aux tmoins (cookies), ce qui signifie que le tmoin est envoy toutes les adresses URL sur le serveur Web. Si IBM Cognos 8 utilise le mme serveur Web, IBM Cognos 8 reoit deux tmoins cam_passport. Pour viter ce conflit, vous devez dfinir un chemin d'accs aux tmoins (cookies) dans ReportNet. D'autres modifications de la configuration peuvent se rvler ncessaires en fonction de votre environnement. Si vous utilisez Portal Services, vous devez indiquer l'emplacement du fichier
110
Chapitre 5: Mise niveau vers IBM Cognos 8 applications.xml. Si vous utilisez une passerelle ISAPI sur un serveur Web IIS 6.0, vous devez isoler la passerelle IBM Cognos 8 pour empcher tout conflit avec la passerelle ReportNet. Isolez la passerelle en paramtrant leve la protection de l'application pour les sites Web et les rpertoires virtuels.
Procdure pour IBM Cognos 8

1. Dans IBM Cognos 8, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la section Paramtres du distributeur de la fentre Proprits, cliquez sur la valeur correspondant l'URI interne du distributeur : 4. Slectionnez le numro de port et saisissez le nouveau numro de port. 5. Le cas chant, modifiez le numro de port des URI ci-dessous, de manire ce qu'ils correspondent au nouveau numro de port que vous avez indiqu pour la proprit URI interne du distributeur. Dans la section Paramtres du distributeur, modifiez le port associ la proprit URI externe du distributeur. Dans la section Autres paramtres de l'URI, modifiez le port associ aux proprits URI du distributeur pour des applications externes et URI de Content Manager. La proprit URI de Content Manager ne s'affiche pas sur un ordinateur passerelle. 6. Dans la section Paramtres de la passerelle, cliquez sur la valeur correspondant la proprit URI de la passerelle et vrifiez que l'URI contient l'alias de serveur Web adapt IBM Cognos 8. Par exemple, remplacez crn par cognos8. 7. Si vous utilisez Portal Service, mettez jour le fichier applications.xml. Dans la fentre Explorateur, cliquez sur les options Environnement puis Portal Services. Dans la fentre Proprits, vrifiez que le numro de port associ la proprit Emplacement du fichier 'applications.xml' correspond celui des proprits des autres URI. 8. Dans la fentre Explorateur, cliquez sur Accs aux donnes, sur Content Manager, puis sur Content Store. 9. Dans la fentre Proprits, configurez IBM Cognos 8 de faon utiliser la nouvelle base de donnes Content Store : Pour la proprit Nom de la base de donnes, indiquez le nom de la nouvelle base de donnes Content Store. Pour la proprit Code d'utilisateur et mot de passe, cliquez sur le bouton d'dition et indiquez le code d'utilisateur et le mot de passe permettant d'accder la nouvelle base de donnes Content Store.
10. Si vous excutez deux instances d'IBM Cognos 8, remplacez le chemin d'accs aux tmoins (cookies) par la nouvelle version d'IBM Cognos 8. Guide d'installation et de configuration 111
Chapitre 5: Mise niveau vers IBM Cognos 8 Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. Dans la fentre Configuration globale, cliquez sur l'option Paramtres de tmoin (cookie). Slectionnez un chemin d'accs diffrent de celui utilis par l'ancienne version d'IBM Cognos 8. Cliquez sur OK.
11. Enregistrez la configuration et dmarrez IBM Cognos 8. 12. Si vous utilisez une passerelle ISAPI sur un serveur Web IIS 6.0, modifiez les paramtres de protection de l'application : Dans IIS Manager, cliquez avec le bouton droit de la souris sur le site Web par dfaut et cliquez sur Properties. Cliquez sur l'onglet Home Directory. Dans la zone Application Protection, cliquez sur High, puis sur OK. Rptez les trois tapes de la procdure ci-dessus pour chaque rpertoire virtuel d'IBM Cognos 8 en cliquant sur l'onglet Virtual Directory au lieu de l'onglet Home Directory. La prochaine fois que la passerelle d'IBM Cognos 8 sera sollicite, elle s'excutera dans un espace mmoire distinct.
Procdure pour ReportNet

1. Dans ReportNet, dmarrez IBM Cognos Configuration. 2. Modifiez le chemin d'accs aux tmoins (cookies) : Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. Dans la fentre Configuration globale, cliquez sur l'option Paramtres de tmoin (cookie). Dfinissez le chemin d'accs au rpertoire d'installation (par exemple, /crn). Cliquez sur OK.
3. Enregistrez la configuration. Vous pouvez maintenant excuter ReportNet et IBM Cognos 8, ou bien deux instances d'IBM Cognos 8, simultanment. Remarque : Lorsque vous modifiez des ports implicites sous Windows, le numro de port est automatiquement ajout au nom du service. Le nom du service dans IBM Cognos Configuration n'indique pas le numro de port. Le nom du service et le numro de port sont affichs dans la section Services, dans les outils d'administration de Windows.
Dsinstallation manuelle du service ReportNet sous Windows

Si le service ReportNet continue de s'excuter alors que vous avez dsinstall le logiciel ReportNet, puis install IBM Cognos 8, vous devez dsinstaller manuellement ce service.
112
Chapitre 5: Mise niveau vers IBM Cognos 8 Vous pouvez installer plusieurs versions d'IBM Cognos 8 diffrents emplacements sur le mme ordinateur. Si les versions utilisent les mmes ports, l'installation risque de ne pas mettre le service niveau correctement. IBM Cognos Configuration effectue la mise niveau vers le service configur le plus rcemment pour IBM Cognos 8. Conseil : Pour savoir si le service IBM Cognos 8 appropri est actif, vrifiez le numro de version dans la fentre propos de d'IBM Cognos Configuration.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Cliquez avec le bouton droit de la souris sur le nud de service IBM Cognos 8 (ou tout autre nom attribu au service) dans le panneau Explorateur et slectionnez Arrter. 3. Ouvrez une fentre Invite de commande. 4. Accdez au rpertoire emplacement_c8/bin. 5. Dsinstallez le service : Si vous avez utilis le nom implicite pour le service, saisissez cogbootstrapservice -u. Si vous avez indiqu un autre nom, saisissez cogbootstrapservice -u -name="nom_service_c8". 6. Fermez la fentre Invite de commande. 7. Redmarrez IBM Cognos Configuration. IBM Cognos 8 est mis niveau vers le service appropri.
Configuration de la publication de cubes Series 7 aprs mise niveau depuis ReportNet

Aprs la mise niveau d'IBM Cognos ReportNet vers IBM Cognos 8, vous ne pourrez peut-tre pas publier les cubes de PowerPlay Enterprise Server dans IBM Cognos Connection. De mme, l'utilisateur qui ouvre un cube publi partir de PowerPlay Enterprise Server dans IBM Cognos Connection peut obtenir le message d'erreur suivant lorsqu'il enregistre le rapport dans IBM Cognos Connection : Votre permis de session n'est pas valide. Il est peut-tre prim. Pour tre en mesure de publier les cubes Series 7 aprs la mise niveau, vous pouvez soit restructurer vos rpertoire virtuels de sorte que les passerelles Series 7 et IBM Cognos 8 se trouvent dans la mme structure, soit modifier le chemin d'accs implicite aux tmoins (cookies) dans IBM Cognos 8 selon les indications ci-aprs. Si vous utilisez la valeur indique pour le chemin d'accs implicite aux tmoins, vous ne pouvez pas excuter ReportNet et IBM Cognos 8 sur le mme ordinateur.
Procdure de restructuration des rpertoires virtuels

Crez une structure de rpertoires virtuels o la passerelle de PowerPlay Enterprise Server d'IBM Cognos Series 7 et celle d'IBM Cognos 8 sont dans la mme structure. Vous pouvez, par exemple, dfinir vos rpertoires virtuels de la faon suivante : Guide d'installation et de configuration 113
Chapitre 5: Mise niveau vers IBM Cognos 8 Crez un alias cognos8 pointant vers le rpertoire emplacement_c8\webcontent. Crez un alias cognos8/cgi-bin pointant vers le rpertoire emplacement_c8\cgi-bin. Crez un alias cognos8/series7 pointant vers le rpertoire emplacement_series7\webcontent. Crez un alias cognos8/series7/cgi-bin pointant vers le rpertoire emplacement_series7\cgi-bin. Crez un alias cognos8/series7/help pointant vers le rpertoire emplacement_series7\Documentation.
Procdure de modification du chemin d'accs implicite aux tmoins (cookies)

1. Dmarrez IBM Cognos Configuration. 2. Cliquez sur Oprations, Modifier la configuration globale, puis cliquez sur l'onglet Gnral. 3. Dans la zone Chemin d'accs, sous Paramtres de tmoin (cookie), saisissez / 4. Cliquez sur OK. 5. Enregistrez la configuration. Remarque : Si vous utilisez la valeur indique pour le chemin d'accs implicite aux tmoins, vous ne pouvez pas excuter ReportNet et IBM Cognos 8 sur le mme ordinateur. Pour faire fonctionner ReportNet et IBM Cognos 8 sur un mme ordinateur, modifiez les rpertoires virtuels selon la mthode dcrite ci-dessus.
Mise niveau d'IBM Cognos 8 Go! Office

Pour mettre niveau IBM Cognos 8 Go! Office, les utilisateurs des composants client doivent d'abord dsinstaller l'ancienne version, puis excuter un fichier qui permet l'installation d'une nouvelle version de Microsoft .NET Framework, la mise jour des composants .NET et l'installation de la nouvelle version d'IBM Cognos 8 Go! Office. Pour mettre niveau des rapports, les utilisateurs doivent les ouvrir dans la nouvelle version puis les enregistrer. Aucune opration n'est requise pour mettre niveau les composants serveur pour IBM Cognos 8 Go! Office. Ceux-ci sont inclus dans la mise niveau vers la nouvelle version d'IBM Cognos 8. Pour prendre en charge l'ajout d'autres produits IBM Cognos fonctionnant avec Microsoft Office, le nom utilis pour installer le nouveau produit est dsormais IBM Cognos 8 pour Microsoft Office. Ce nom est utilis dans l'assistant d'installation et dans la fentre des oprations qui s'affiche dans votre produit Microsoft Office aprs la mise niveau. En outre, le nom du rpertoire d'installation implicite est dsormais IBM Cognos 8 pour Microsoft Office. Si vous avez dploy les fichiers ou modles activs pour IBM Cognos 8 Go! Office, il n'est pas ncessaire de corriger les proprits personnalises dans la nouvelle version. Les proprits personnalises et les modles ne sont plus requis.
114
Dsinstallation de l'ancienne version

Avant de procder la mise niveau vers la nouvelle version d'IBM Cognos 8 Go! Office, vous devez dsinstaller l'ancienne version.
Procdure
1. Dans le menu Dmarrer, cliquez sur Paramtres, puis sur Panneau de configuration. 2. Cliquez deux fois sur Ajout/Suppression de programmes. 3. Dans la liste des programmes actuellement installs, cliquez sur IBM Cognos 8 Go! Office. 4. Cliquez sur Supprimer et suivez les instructions.
Installation de Microsoft .NET Framework et de la nouvelle version d'IBM Cognos 8 Go! Office
Pour installer Microsoft .NET Framework et IBM Cognos 8 pour Microsoft Office, vous devez excuter un fichier setup.exe partir d'un emplacement rseau central. Ce fichier installe et met jour Microsoft .NET Framework, installe les Primary Interop Assemblies (PIA) requis par Microsoft Office, puis installe les composants d'IBM Cognos 8 pour Microsoft Office. Lorsque vous installez Microsoft .NET Framework sur un systme d'exploitation qui n'est pas en anglais, les messages d'erreur, les raccourcis et les utilitaires Microsoft .NET s'affichent quand mme en anglais. Pour les langues autres que l'anglais, vous pouvez appliquer le pack linguistique Microsoft .NET pour voir les messages d'erreurs, raccourcis et utilitaires dans votre langue. Par exemple, si votre systme d'exploitation est franais et que vous avez install Microsoft .NET Framework, vous devez galement appliquer le pack linguistique Microsoft .NET franais. Vous pouvez tlcharger le pack linguistique de .NET Framework Version 2.0 l'adresse http://www.microsoft.com/downloads/. Avant de mettre jour et d'installer les composants, vrifiez que vous avez : des droits d'administrateur sur l'ordinateur, dsinstall la version prcdente d'IBM Cognos 8 Go! Office, la licence approprie pour utiliser IBM Cognos 8 Go! Office.
Procdure
1. partir de l'emplacement rseau, excutez le fichier setup.exe. L'assistant d'installation vrifie si Microsoft .NET Framework est install. 2. Si la bote de dialogue IBM Cognos 8 for Microsoft Office Setup affiche la page de contrat de licence de Microsoft .NET Framework 2.0, cliquez sur Accept. 3. Dans la bote de dialogue IBM Cognos 8 for Microsoft Office Setup, cliquez sur Install. Si Microsoft .NET Framework est en cours d'installation, une bote de dialogue de progression s'affiche pendant le tlchargement des fichiers partir du site Web de tlchargement de Microsoft.Cela peut prendre plusieurs minutes.
Chapitre 5: Mise niveau vers IBM Cognos 8 Une bote de dialogue de progression s'affiche pendant l'installation de la mise jour de la prise en charge du module d'extension partag pour Microsoft .NET Framework.Lorsque la mise jour est termine, l'assistant d'installation d'IBM Cognos 8 pour Microsoft Office s'affiche. 4. Dans la page Welcome to the IBM Cognos 8 for Microsoft Office Setup Wizard de la fentre IBM Cognos 8 pour Microsoft Office, cliquez sur Next. 5. Dans la page License Agreement, slectionnez I Agree et cliquez sur Next. 6. Dans la bote de dialogue Select Installation Folder, procdez comme suit : Slectionnez le rpertoire d'installation utilis pour l'ancienne version, tel que C:\Program Files\Cognos\Cognos Office\. Slectionnez Everyone. Lorsque vous slectionnez Everyone, tous les utilisateurs qui se connectent l'ordinateur voient IBM Cognos 8 dans la barre d'outils des produits Microsoft Office. Si vous slectionnez Just Me, seuls les utilisateurs qui ont install IBM Cognos 8 pour Microsoft Office peuvent voir IBM Cognos 8 dans la barre d'outils. Cliquez sur Next.
Si une bote de dialogue vous invite dsinstaller une version antrieure, suivez les consignes de dsinstallation de l'ancienne version et reprenez l'installation. 7. Dans la page Confirm Installation, cliquez sur Next. L'assistant installe les composants d'IBM Cognos 8 Go! Office. 8. Dans la page Installation Complete, cliquez sur Close. 9. Pour vrifier la russite de l'installation, procdez comme suit : Ouvrez Microsoft Office Word, Microsoft Office Excel ou Microsoft Office PowerPoint. Vrifiez que l'application IBM Cognos 8 apparat dans la barre d'outils. Si IBM Cognos 8 ne figure pas dans la barre d'outils, dans le menu Affichage, cliquez sur Barre d'outils, puis sur IBM Cognos 8 pour Microsoft Office. Cliquez sur le bouton IBM Cognos 8 dans la barre d'outils. Le volet IBM Cognos 8 pour Office apparat dans la partie droite de la fentre. Il contient un lien vers l'application IBM Cognos 8 Go! Office.
Mise niveau des modles et des cubes Transformer

Vous pouvez ouvrir des modles IBM Cognos Series 7 comportant des cubes scuriss dans Transformer, et mettre niveau les classes d'utilisateurs et vues de classes d'utilisateurs Series 7 pour les utiliser dans IBM Cognos 8.
116
Chapitre 5: Mise niveau vers IBM Cognos 8 Avant de charger le modle, l'espace-noms IBM Cognos Series 7 doit tre configur dans IBM Cognos 8 (p. 270). Pour mettre niveau les modles et les cubes Transformer, procdez comme suit : Prparez les modles IBM Cognos Series 7. Importez les modles non scuriss dans IBM Cognos 8 Transformer. Mettez niveau les cubes scuriss IBM Cognos Series 7 dans IBM Cognos 8 Transformer.
Prparation de modles dans IBM Cognos Series 7 Transformer

Pour mettre niveau des modles crs dans des versions antrieures de Transformer, vous devez les enregistrer au format MDL (Model Definition Language) avant de les importer dans Transformer 8,4. Ainsi, des dfinitions quivalentes sont cres pour tous les objets de modle. Vous pouvez mettre niveau des modles d'IBM Cognos Series 7 Transformer, versions 7.x. Assurez-vous d'enregistrer tous vos modles en tant que fichiers .mdl avant d'essayer de les mettre niveau.
Procdure
1. Ouvrez le modle dans la version prcdente de Transformer, puis cliquez sur l'option Enregistrer sous du menu Fichier. 2. Dans la zone Type, cliquez sur l'option Modles exports (*.mdl). Conseil : Par dfaut, Transformer enregistre les modles dans le rpertoire ../Mes documents/ Transformer/Models. Vous pouvez dfinir l'emplacement dans lequel Transformer enregistre les modles en modifiant le paramtre de rpertoire Modles dans l'onglet Rpertoires de la feuille de proprits Prfrences. 3. Effectuez une copie de sauvegarde des fichiers .mdl dans un emplacement scuris.
Importation de modles non scuriss dans IBM Cognos 8 Transformer

Aprs avoir install IBM Cognos 8 Transformer, vous pouvez importer les fichiers .mdl d'IBM Cognos Series 7 vers IBM Cognos 8 Transformer. Si vous importez des modles scuriss depuis IBM Cognos Series 7, reportez-vous la rubrique relative la mise niveau d'un modle scuris Series 7 dans Transformer 8.4. Vous pouvez ouvrir un modle IBM Cognos Series 7 comportant des cubes scuriss dans IBM Cognos 8 Transformer, puis convertir les vues de classes d'utilisateurs Series 7 en vues personnalises IBM Cognos 8. Vous pouvez choisir le fournisseur d'authentification utiliser avec ces vues personnalises. Pour en savoir davantage sur l'ajout de scurit, reportez-vous au Guide de l'utilisateur de Transformer. Lors de la transition entre un espace-noms IBM Cognos Series 7 et un autre fournisseur de scurit, vous pouvez utiliser la proprit de cube Tous les espaces-noms applicables (incluant les cubes non scuriss) pour associer tous les espaces-noms applicables lors du test de la migration. Lorsque vous associez tous les espaces-noms applicables au cube, vous pouvez vous assurer que les filtres dimensionnels dfinis au niveau des groupes, des rles ou des utilisateurs restent cohrents avec ceux qui Guide d'installation et de configuration 117
Chapitre 5: Mise niveau vers IBM Cognos 8 avaient t appliqus pour la classe d'utilisateurs Series 7. Cette option est prise en charge uniquement pour le test de la migration et ne peut pas tre utilise pour dployer des cubes dans les environnements de production. Vous pouvez modifier l'association d'une source de donnes IQD en association de source de donnes IBM Cognos 8, de faon tirer parti des amliorations offertes par l'utilisation d'une source de donnes de type rapport ou pack IBM Cognos 8. Vous pouvez modifier l'association pour les fichiers .iqd Series 7 et les fichiers .iqd (de requte externalise) Framework Manager, une fois que le modle mis jour a t enregistr dans Transformer 8,4. Pour en savoir davantage sur la modification d'un type de source de donnes, reportez-vous au Guide de l'utilisateur de Transformer. Transformer 8.4 prend en charge la mise niveau de modles depuis IBM Cognos Series 7.x. Lorsque vous importez des fichiers .mdl partir de versions antrieures, il est possible que certaines fonctionnalits ne soient pas correctement converties, notamment les donnes existantes contenant des caractres spciaux, des espaces et des guillemets. Pour en savoir davantage, consultez la documentation relative la migration fournie avec votre version du produit.
Procdure
Ouvrez le fichier .mdl dans IBM Cognos 8 Transformer, apportez les modifications requises la conception du modle, puis enregistrez-le en slectionnant nouveau le format .mdl. Lorsque vous tes prt utiliser le modle dans votre environnement de production, vous pouvez l'enregistrer au format .py?. Les modles IBM Cognos 8 Transformer ne sont pas rtrocompatibles (.mdl et .pyj). C'est pourquoi il est fortement conseill de conserver le fichier .mdl du modle Transformer 7.x pendant un certain temps aprs la mise niveau.
Mise niveau d'un cube scuris IBM Cognos Series 7

Vous pouvez ouvrir des modles IBM Cognos Series 7 comportant des cubes scuriss dans IBM Cognos 8 Transformer, et mettre niveau les classes d'utilisateurs et vues de classes d'utilisateurs Series 7 pour les utiliser dans IBM Cognos 8. Si vous souhaitez passer un fournisseur d'authentification pris en charge par IBM Cognos 8, autre qu'Access Manager, vous pouvez le faire au fil du temps. Lorsque vous ouvrez le modle scuris IBM Cognos Series 7 dans IBM Cognos 8 Transformer, vous avez plusieurs possibilits : Importer les vues de classes d'utilisateurs Series 7 associes au modle, mais pas les classes d'utilisateurs. Utilisez cette option lorsque vous souhaitez conserver les oprations de vues appliques dans les vues de classes d'utilisateurs de Series 7, sans utiliser d'espace-noms IBM Cognos Series 7 avec les vues personnalises. Employez-la galement si vous ne souhaitez pas configurer IBM Cognos Series 7 comme espace-noms disponible dans IBM Cognos 8. Remarque : Avant de crer et d'utiliser le cube IBM Cognos 8 Transformer dans l'un des studios Web d'IBM Cognos 8, vous devez associer de nouveaux objets de scurit aux vues personnalises mises niveau.
118
Chapitre 5: Mise niveau vers IBM Cognos 8 Importer les classes d'utilisateurs et les vues de classes d'utilisateurs Series 7 associes au modle. Choisissez cette option lorsque vous souhaitez conserver les oprations de vue appliques dans les vues de classe d'utilisateurs et utiliser les classes d'utilisateurs IBM Cognos Series 7. Slectionnez-la galement si vous souhaitez effectuer la transition vers un autre fournisseur de scurit, mais que vous avez besoin de conserver les objets de classes d'utilisateurs Series 7 afin de vous assurer que la transition se droule correctement. Cette option ncessite que vous configuriez comme espace-noms disponible dans IBM Cognos 8 la scurit d'IBM Cognos Series 7 en fonction de laquelle le modle mis niveau a t conu. Cet identificateur unique, qui indique o se trouve la classe d'utilisateurs dans Access Manager, est converti en identificateur IBM Cognos 8, mais cette opration n'aboutit pas si vous utilisez cette option avec un autre espace-noms IBM Cognos Series 7. Supprimer toutes les vues personnalises et tous les objets de scurit existants. Choisissez cette option si vous souhaitez crer des vues personnalises et utiliser uniquement les objets de scurit actuellement configurs dans l'espace-noms IBM Cognos 8. Pour les cubes en cours de dveloppement et de transition entre un espace-noms Series 7 et un autre fournisseur de scurit, vous pouvez associer tous les espaces-noms applicables sur la feuille des proprits du cube (onglet Source de donnes). Cette option est uniquement destine tester la migration et ncessite que le modlisateur ou l'administrateur se connecte tous les espaces-noms applicables avant d'accder au pack de cubes dans IBM Cognos 8. Si vous ne vous connectez pas tous les espaces-noms applicables, la vue des donnes s'avre inexacte. Cette fonction n'est pas prise en charge pour le dploiement des cubes destins aux utilisateurs finals. Pour en savoir davantage sur la publication des cubes, reportez-vous au Guide de l'utilisateur de Transformer.
Procdure
1. Dans le menu Fichier, cliquez sur Ouvrir, accdez l'emplacement du modle scuris de Series 7, slectionnez-le, puis cliquez sur Ouvrir. 2. Dans la bote de dialogue Importation d'un modle avec une vue de classe d'utilisateurs IBM Cognos Series 7, slectionnez l'option d'importation de scurit approprie, puis cliquez sur Suivant. 3. Si vous avez slectionn Importer les vues de classes d'utilisateurs et les classes d'utilisateurs du modle, dans la bote de dialogue Connexion, slectionnez l'espace-noms appropri, puis connectez-vous l'aide de votre code d'utilisateur et votre mot de passe. 4. Dans la zone Espaces-noms disponibles, slectionnez l'espace-noms utilis pour scuriser le cube Series 7. Conseil : Si l'espace-noms n'apparat pas dans la liste, cliquez sur Se connecter en tant que pour le slectionner et vous y connecter. 5. Cliquez sur Terminer.
120
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
Vous pouvez installer tous les composants d'IBM Cognos 8 sur un seul ordinateur. Vous pouvez galement rpartir l'installation d'IBM Cognos 8 sur diffrents ordinateurs. Pour en savoir davantage, reportez-vous la section "Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs" (p. 153). Utilisez la liste de contrle suivante pour vous guider dans le processus d'installation d'IBM Cognos 8 sur un seul ordinateur : Installation des composants serveur d'IBM Cognos 8 Mise jour de l'environnement Java Dmarrage d'IBM Cognos Configuration Configuration des proprits d'environnement Activation de la scurit Dfinition des proprits de connexion la base de donnes Content Store Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification Dmarrage des services IBM Cognos 8 Configuration du serveur Web Configuration de l'environnement de sources de donnes ou de sources d'importation Cration de la base de donnes de bibliothque d'indicateurs Cration d'un pack d'indicateurs Installation des prsentations rapides Test de l'installation et de la configuration
Si vous le souhaitez, une fois toutes ces oprations termines, vous pouvez galement installer IBM Cognos 8 Metrics Manager. Installez le composant Metrics Manager dans le mme emplacement que celui o vous avez install le composant IBM Cognos 8 Business Intelligence. Par exemple, installez le composant Content Manager d'IBM Cognos 8 Metrics Manager dans le mme emplacement que celui o vous avez install le composant Content Manager d'IBM Cognos 8 Business Intelligence. Ensuite, vous devez installer Framework Manager (p. 197). Si vous utilisez des cubes, vous devez installer Transformer (p. 209). Pour obtenir des instructions sur la dsinstallation, reportez-vous la section "Dsinstallation d'IBM Cognos 8" (p. 147).
Installation des composants serveur d'IBM Cognos 8

Utilisez l'Assistant d'installation pour slectionner les composants du serveur que vous souhaitez installer, ainsi que l'emplacement appropri sur votre ordinateur. Seuls les composants que vous dcidez d'installer sont copis du CD sur l'ordinateur. Les exemples se trouvent sur un CD spar de votre produit IBM Cognos 8. Si vous souhaitez utiliser les exemples, vous devez les installer depuis le CD de la version 8.4 des exemples d'IBM Cognos 8 Business Intelligence.
Mise niveau de l'installation

Si vous effectuez une mise niveau partir d'une version prcdente des produits IBM Cognos, vous devez respecter la procdure de mise niveau. Pour en savoir davantage sur la mise niveau partir de ReportNet ou de Metrics Manager, reportez-vous la section "Mise niveau vers IBM Cognos 8" (p. 79). Si vous procdez une mise niveau partir de ReportNet, tous les composants rpartis doivent correspondre la mme version d'IBM Cognos 8. Si vous installez IBM Cognos 8 dans de nouveaux emplacements, vous devez les mettre jour l'aide d'IBM Cognos Configuration. Si vous mettez niveau IBM Cognos 8 BI dans un environnement qui inclut des versions prcdentes d'autres produits IBM Cognos 8, tels qu'IBM Cognos 8 Controller 8.3, IBM Cognos 8 Planning 8.3 ou IBM Cognos 8 BI Analysis pour Excel 8.3, installez la nouvelle version d'IBM Cognos 8 BI dans un emplacement diffrent de celui de l'autre produit IBM Cognos 8 et configurer IBM Cognos 8 BI afin qu'il s'excute de faon indpendante. Une fois la mise niveau de l'autre produit effectue vers une version compatible avec IBM Cognos 8 BI, vous pourrez configurer les deux produits pour qu'ils fonctionnent ensemble.
Installations sous Windows

Pour les installations sous Windows, assurez-vous que vous disposez de droits d'administration sur l'ordinateur Windows o vous souhaitez effectuer l'installation. Assurez-vous galement que l'ordinateur dispose d'une variable systme TEMP pointant vers le rpertoire o vous voulez stocker les fichiers temporaires. Durant l'installation, les fichiers du CD sont copis temporairement dans ce rpertoire.
Installations sous UNIX

Pour les installations sous UNIX, vous pouvez installer les composants serveur l'aide d'une interface en texte intgral ou d'une interface graphique utilisateur. Pour une installation en mode graphique, la console connecte votre ordinateur UNIX doit prendre en charge les interfaces graphiques utilisateur de type Java. De plus, IBM Cognos 8 respecte le masque de cration de mode fichier (umask) du compte excutant le programme d'installation. Cela n'a une incidence que sur les rpertoires d'installation, et non sur les droits d'accs aux fichiers l'intrieur de ces rpertoires. Toutefois, les fichiers crs en cours d'excution, tels que les journaux, respectent le masque. Nous recommandons umask 022 pour le rpertoire d'installation.
122
Base de donnes de contenu d'IBM Cognos en tant que Content Store

Si vous utilisez la base de donnes de contenu d'IBM Cognos en tant que base de donnes Content Store, vous devez la slectionner avec l'Assistant d'installation. Si vous installez des composants sur plusieurs ordinateurs, vous n'avez besoin d'installer qu'une base de donnes de contenu d'IBM Cognos. Si vous installez la base de donnes de contenu d'IBM Cognos sur le mme ordinateur que Content Manager, et que vous dcidez ensuite d'utiliser une autre base de donnes pour votre Content Store, vous devez dsinstaller la base de donnes de contenu d'IBM Cognos.
Procdure pour UNIX et Linux

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'emplacement d'installation de Java Runtime Environment (JRE). Voici un exemple d'emplacement d'installation de Java Runtime Environment : /directory/java/version_java/jre. IBM Cognos 8 ncessite que Sun Java soit excut sous Linux. 3. Sous HP-UX, dfinissez la variable d'environnement _M_ARENA_OPTS comme suit : _M_ARENA_OPTS 1:4 Cette opration augmente l'allocation de mmoire pour HP-UX afin qu'elle corresponde mieux celle des autres plates-formes UNIX. 4. Sous AIX, dfinissez la variable d'environnement AIXTHREAD_SCOPE comme suit : AIXTHREAD_SCOPE=S La porte de contention des processus utilisateur est ainsi dfinie l'chelle du systme, ce qui permet une programmation plus efficace de ces processus. 5. Montez le CD de votre produit IBM Cognos avec les extensions de fichier Rock Ridge. Important : Pour monter le CD IBM Cognos sous HP-UX, procdez comme suit : Ajoutez le rpertoire pfs_mount votre chemin d'installation. Par exemple : PATH=/usr/sbin/:$PATH export PATH Pour dmarrer les dmons NFS requis et les excuter en arrire-plan, saisissez bg pfs_mountd, puis bg pfsd. Pour monter le lecteur, saisissez : pfs_mount -t rrip <priphrique><rp_mont> -o xlat=unix Par exemple : pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Vous pouvez prsent procder l'installation ou copier des fichiers en tant qu'utilisateur non-racine, en insrant un CD IBM Cognos dans ce lecteur. Une fois l'installation termine, saisissez pfs_umount /cdrom et arrtez les dmons pfsd et pfs_mountd pour dmonter le CD.
6. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. Pour Solaris, par exemple, accdez au rpertoire solaris. 7. Dmarrer l'Assistant d'installation ? Si vous utilisez X Windows, saisissez : ./issetup Remarque : Lorsque vous utilisez la commande issetup avec XWindows, les caractres japonais peuvent tre altrs. Lors d'une installation sous UNIX, utilisez l'cran de la console pour installer les composants et slectionnez l'anglais comme langue d'installation unique en paramtrant LANG=C et LC_ALL=C. Si vous n'utilisez pas X Windows, saisissez : ./issetupcc 8. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web UNIX et Linux ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez conserver ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous l'installez dans un rpertoire contenant d'autres composants IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 9. Slectionnez la faon dont vous souhaitez poursuivre la procdure sur la page Terminer de l'Assistant d'installation : Il est dconseill de configurer IBM Cognos 8 immdiatement, car il convient d'abord d'effectuer d'autres tches pour s'assurer que l'environnement est correctement configur. Toutefois, si la console connecte l'ordinateur prend en charge les interfaces graphiques utilisateur de type Java, vous pouvez cliquer sur l'option Dmarrer IBM Cognos Configuration Si vous voulez prendre connaissance des informations les plus rcentes sur IBM Cognos 8, slectionnez Afficher le fichier Lisezmoi, puis cliquez sur le bouton Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q.
124
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Si la console connecte l'ordinateur ne prend pas en charge les interfaces graphiques utilisateur de type Java, cliquez sur Terminer. Vous pourrez configurer IBM Cognos 8 ultrieurement l'aide d'IBM Cognos Configuration, en lanant la commande cogconfig.sh dans le rpertoire emplacement_c8/bin ou en modifiant le fichier cogstartup.xml dans le rpertoire emplacement_c8/configuration. 10. Ajoutez le rpertoire emplacement_c8/bin la variable d'environnement de chemin d'accs la bibliothque approprie : Pour Solaris et Linux, LD_LIBRARY_PATH Pour AIX, LIBPATH Pour HP-UX, SHLIB_PATH
11. Sous Linux, attribuez le nom de votre imprimante la variable d'environnement PRINTER Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri. Si vous envisagez de les utiliser, installez les exemples IBM Cognos 8. Vous devez galement mettre jour votre structure de scurit Java (p. 126) avant de configurer IBM Cognos 8. Sinon, vous risquez de voir s'afficher le message d'erreur suivant :
[Cryptography] 1. [ ERROR ] java.lang.NoClassDefFoundError:javax/net/ServerSocketFactory:
Procdure pour Windows

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Insrez le CD de votre produit IBM Cognos. La page Bienvenue de l'Assistant d'installation doit s'afficher. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 3. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web Windows ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 5. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration. Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi d'IBM Cognos. 6. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis. Si vous envisagez de les utiliser, installez les exemples IBM Cognos 8.
Mise jour de l'environnement Java

Les services cryptographiques d'IBM Cognos 8 utilisent un fichier .jar (Java Archive) spcifique, appel bcprov-jdknn-nnn.jar, qui doit se trouver dans votre environnement JRE. Ce fichier fournit des sous-programmes supplmentaires de chiffrement et de dchiffrement qui ne sont pas disponibles dans l'installation implicite du JVM. Pour garantir la scurit, le fichier de chiffrement doit tre charg par l'environnement JVM l'aide du rpertoire d'extensions Java. Si vous souhaitez utiliser votre propre JRE et dfinir la variable JAVA_HOME sur l'emplacement correspondant sous Windows ou si vous effectuez l'installation sous UNIX, vous devrez peut-tre mettre jour l'environnement Java pour les services cryptographiques. Sous Windows, vous pouvez dfinir JAVA_HOME en tant que variable systme ou variable utilisateur. Si vous la dfinissez en tant que variable systme, vous devrez probablement redmarrer votre ordinateur pour qu'elle prenne effet. Si vous la dfinissez en tant que variable utilisateur, faites en sorte que l'environnement dans lequel s'excute Tomcat puisse y accder. Si vous ne disposez pas d'une variable JAVA_HOME dj dfinie sous Windows ou si la variable JAVA_HOME pointe vers une version de Java non compatible avec IBM Cognos 8, les fichiers JRE fournis avec l'installation seront utiliss et vous n'aurez pas besoin de mettre jour les fichiers de votre environnement.
Procdure
1. Vrifiez que la variable d'environnement JAVA_HOME est dfinie de faon pointer vers l'emplacement du JRE. Par exemple, pour dfinir JAVA_HOME au niveau des fichiers JRE fournis avec l'installation, le chemin d'accs est emplacement_c8/bin/jre/version. 2. Copiez le fichier bcprov-jdknn-nnn.jar du rpertoire emplacement_c8/bin/jre/version/lib/ext dans le rpertoire emplacement_Java/jre/lib/ext.
126
Configuration des proprits d'environnement

Content Manager et les composants d'application doivent connatre l'emplacement de Content Store et de la base de donnes utilise pour la notification.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, remplacez la portion localhost de toutes les proprits de l'URI par le nom ou l'adresse IP de votre serveur IBM Cognos 8, en procdant comme suit : Pour URI de Content Manager, cliquez sur la valeur, puis sur le bouton de modification. Modifiez la portion localhost et cliquez sur OK. Pour toutes les autres proprits d'URI, cliquez sur la valeur et modifiez-la.
4. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 5. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Activation de la scurit
Par dfaut, IBM Cognos 8 permet un accs anonyme au portail Web. Si vous souhaitez appliquer un systme de scurit votre environnement IBM Cognos 8, vous devez dsactiver l'accs anonyme et configurer IBM Cognos 8 pour qu'il utilise un fournisseur d'authentification.
Procdure
1. Dans la fentre Explorateur d'IBM Cognos Configuration, cliquez sur Scurit, Authentification et IBM Cognos. 2. Cliquez sur la zone Valeur associe l'option Voulez-vous autoriser les connexions anonymes ?, puis slectionnez Faux. 3. Cliquez avec le bouton droit de la souris sur l'option Authentification, puis slectionnez Nouvelle ressource et Espace-noms. 4. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 5. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 6. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Pour en savoir davantage sur la configuration d'IBM Cognos 8 afin qu'il utilise un fournisseur d'authentification, reportez-vous la section "Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification" (p. 261). Pour en savoir davantage sur la configuration d'IBM Cognos 8 afin qu'il utilise un fournisseur d'authentification, reportez-vous la section Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification , dans le Guide d'installation et de configuration. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Dfinition des proprits de connexion la base de donnes Content Store

Pour toutes les installations qui n'utilisent pas la base de donnes de contenu d'IBM Cognos, vous devez fournir des informations sur le serveur de base de donnes pour vous assurer que Content Manager peut se connecter la base de donnes Content Store. Content Manager utilise la connexion la base de donnes pour accder Content Store. Aprs avoir dfini les proprits de connexion la base de donnes, vous pouvez tester la connexion entre Content Manager et la base de donnes Content Store. Assurez-vous que vous avez utilis l'un des serveurs de base de donnes pris en charge pour crer la base de donnes Content Store. Remarque : Certains serveurs de base de donnes sont disponibles avec des fonctions avances. Lorsque vous slectionnez une base de donnes avance, IBM Cognos 8 utilise les fonctions du serveur de base de donnes pour grer la connexion. Si vous slectionnez la base de donnes Oracle avance, par exemple, IBM Cognos 8 utilise les fonctions orientes entreprise d'Oracle pour slectionner un couteur, passer un autre couteur si le premier choue, se reconnecter automatiquement la base de donnes si la connexion choue ou encore quilibrer les demandes de connexion parmi les couteurs et parmi les distributeurs. IBM Cognos 8 requiert le protocole TCP/IP pour accder aux donnes et la base de donnes Content Store. Assurez-vous que le protocole TCP/IP est dfini pour le serveur de base de donnes. Si vous effectuez une mise niveau partir de ReportNet, configurez IBM Cognos 8 pour qu'il pointe vers la base de donnes Content Store existante. Aprs avoir enregistr la configuration et dmarr le service IBM Cognos 8, la base de donnes Content Store est automatiquement mise niveau et ne peut plus tre utilise par ReportNet. Si ReportNet continue s'excuter, vous devez configurer IBM Cognos 8 pour qu'il pointe vers une nouvelle base de donnes Content Store.
Procdure pour Microsoft SQL Server, Oracle, DB2 et Sybase

1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Accs aux donnes, Content Manager, cliquez avec le bouton droit de la souris sur l'option Content Store, puis slectionnez Supprimer. Cette opration supprime la ressource implicite. Content Manager doit tre configur de faon accder une seule base de donnes Content Store.
128
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 3. Cliquez avec le bouton droit de la souris sur l'option Content Manager, puis cliquez sur Nouvelle ressource et Base de donnes. 4. Dans la zone Nom, saisissez un nom pour la ressource. 5. Dans la zone Type, slectionnez le type de base de donnes, puis cliquez sur le bouton OK. Si vous procdez une mise niveau et que vous souhaitez utiliser une base de donnes Content Store existante, veillez slectionner le type de base de donnes utilis pour la version prcdente de ReportNet. Si vous avez install plusieurs versions d'IBM Cognos 8, vous devez utiliser une base de donnes Content Store diffrente pour chaque version. Lorsqu'une base de donnes Content Store est utilise par une nouvelle version d'IBM Cognos 8, elle ne peut pas tre utilise par une version antrieure de ReportNet. Conseil : Si vous utilisez la paire Net8 de type mot-cl et valeur d'Oracle pour grer la connexion la base de donnes, slectionnez Base de donnes Oracle (options avances). 6. Dans la fentre Proprits, fournissez des valeurs en fonction du type de base de donnes : Si vous utilisez une base de donnes Microsoft SQL Server, saisissez les valeurs appropries pour les proprits Serveur de base de donnes comportant un numro de port ou un nom d'instance et Nom de la base de donnes. Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance. Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre. Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire Si vous utilisez une base de donnes DB2, pour la proprit Nom de la base de donnes, saisissez le pseudonyme de la base de donnes. Si vous utilisez une base de donnes Oracle, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom du service. Si vous utilisez une base de donnes Oracle avance, pour la proprit Identificateur de base de donnes, saisissez la paire Net8 de type mot-cl et valeur d'Oracle pour la connexion. Voici un exemple : (description=(adresse=(hte=mon_hte)(protocole=tcp)(port=1521)(donnes_connexion= (sid=(orcl)))))
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Si vous utilisez une base de donnes Sybase, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom de la base de donnes. 7. Si vous souhaitez modifier les rfrences d'identification de connexion, prcisez un code d'utilisateur et un mot de passe : Cliquez sur la zone Valeur en regard de la proprit Code d'utilisateur et mot de passe, puis cliquez sur le bouton d'dition quand il s'affiche. Saisissez les valeurs appropries et cliquez sur OK.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les rfrences d'identification pour la connexion sont immdiatement chiffres. 9. Testez la connexion entre Content Manager et la base de donnes Content Store. Conseil : Dans le menu Oprations, cliquez sur Test pour tester la connexion entre Content Manager et la base de donnes Content Store. Content Manager se connecte la base de donnes, vrifie les droits d'accs de celle-ci, puis cre une table et la complte. La table n'est pas supprime et est utilise chaque excution du test. Content Manager peut dsormais crer les tables requises dans la base de donnes Content Store lors du premier dmarrage du service IBM Cognos 8. Si les proprits de connexion ne sont pas dfinies correctement, vous ne pouvez pas vous connecter IBM Cognos Connection. Si vous procdez une mise niveau partir de ReportNet, Content Manager peut dsormais accder aux tables requises dans la base de donnes Content Store utilise pour la version prcdente.
Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification

Si vous dsirez envoyer des rapports par courrier lectronique, vous devez configurer un compte de serveur de messagerie. Vous devez galement prciser l'emplacement de la base de donnes utilise par le serveur de notification pour stocker les donnes relatives aux travaux et aux calendriers. Par dfaut, le serveur de notification utilise la mme base de donnes que celle utilise par Content Manager comme base de donnes Content Store. Vous pouvez utiliser une base de donnes spare pour la notification lorsque vous excutez des volumes importants de production de rapports par lots et de courriers lectroniques. Si tel est le cas, assurez-vous que la base de donnes de notification existe et qu'aucune requte n'est en attente d'excution. Les requtes places en file d'attente ne sont pas supprimes. Tous les ordinateurs Content Manager doivent tre configurs de faon utiliser la mme base de donnes de notification. Une fois que vous avez fini de configurer un compte de serveur de messagerie et une base de donnes de notification, vous pouvez tester les connexions ces deux lments. Conseil : Pour tre en mesure d'ouvrir des rapports envoys par courrier lectronique, vous devez remplacer la partie correspondant au nom d'hte localhost dans l'URI de la passerelle par l'adresse
130
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur IP ou par le nom de l'ordinateur. Sinon, l'adresse URL du courrier lectronique contiendra la chane localhost, ce qui empchera les utilisateurs distants d'ouvrir le rapport. Si vous procdez une mise niveau partir de ReportNet, IBM Cognos 8 utilise les paramtres et le compte de serveur de messagerie dfinis pour ReportNet.
Procdure
1. Dans la fentre Explorateur, dans la section Accs aux donnes, cliquez sur l'option Notification. 2. Dans la fentre Proprits, pour la proprit Serveur de messagerie SMTP, saisissez le nom d'hte et le port du serveur de messagerie SMTP (sortant). 3. Cliquez sur la zone Valeur ct de la proprit Code d'utilisateur et mot de passe, puis cliquez sur le bouton d'dition quand il s'affiche. 4. Saisissez les valeurs appropries dans la bote de dialogue Valeur - Compte et mot de passe, puis cliquez sur le bouton OK. Conseil : Si les rfrences d'identification de connexion ne sont pas requises pour le serveur SMTP, supprimez les informations implicites pour la proprit Code d'utilisateur et mot de passe. Lorsque vous tes invit confirmer que cette proprit reste vide, cliquez sur Oui. Assurez-vous que le nom d'utilisateur implicite a t supprim. Dans le cas contraire, le compte implicite est utilis et les notifications ne fonctionnent pas correctement. 5. Dans la fentre Proprits, saisissez les valeurs appropries pour le compte de l'expditeur implicite. Conseil : Si vous utilisez la base de donnes de notification implicite, vous n'avez pas besoin d'excuter les tapes suivantes. 6. Identifiez la base de donnes utilise pour la notification : Dans la fentre de l'Explorateur, cliquez avec le bouton droit de la souris sur l'option Notification, puis slectionnez Nouvelle ressource et Base de donnes. Saisissez un nom pour la ressource de base de donnes. Slectionnez le type de base de donnes dans le menu droulant. Cliquez sur OK.
7. Dans la fentre Proprits, saisissez les valeurs pour la ressource de base de donnes de notification. Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance. Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. 9. Testez les connexions aux serveurs de notification et de messagerie. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur Notification, puis cliquez sur l'option Tester. IBM Cognos 8 teste la connexion la base de donnes et la connexion au serveur de messagerie. Si vous avez l'habitude d'utiliser la base de donnes Content Store pour la notification, les calendriers sont rpliqus dans les tables de la nouvelle base de donnes de notification. Important : Veillez ce que les valeurs utilises pour identifier la ressource de base de donnes de notification soient les mmes sur tous les ordinateurs Content Manager. Pour utiliser la base de donnes de notification implicite, vous n'avez pas besoin de modifier les valeurs de la fentre Proprits.
Dmarrage des services IBM Cognos 8

Pour enregistrer le service IBM Cognos 8 de faon ce que les utilisateurs puissent y accder par l'intermdiaire d'IBM Cognos Connection, vous devez dmarrer les services. Avant de dmarrer les services, testez la configuration l'aide de la fonction de test d'IBM Cognos Configuration. Pour pouvoir utiliser Framework Manager, IBM Cognos 8 Transformer ou Metric Designer, vous devez dmarrer le service IBM Cognos 8. Sous Windows, le service IBM Cognos 8 est configur par dfaut pour dmarrer automatiquement. Sous UNIX et Linux, vous devez configurer le processus IBM Cognos 8 comme dmon pour qu'il dmarre automatiquement. Pour en savoir davantage, reportez-vous la documentation relative votre systme d'exploitation. Vous devez installer et configurer Framework Manager et les composants du serveur IBM Cognos 8 pour pouvoir utiliser IBM Cognos 8 pour la production de rapports. Avant de commencer, vrifiez que le compte utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78). Remarque : IBM Cognos 8 ne peut accder aucune des donnes du rapport avant qu'elles ne soient organises en packs et publies dans Framework Manager.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Veillez enregistrer la configuration, sans quoi vous ne serez pas en mesure de dmarrer le service IBM Cognos 8. Lorsque vous procdez une mise niveau, un message indiquant la dtection de fichiers de configuration et leur mise niveau s'affiche. 3. Dans le menu Oprations, cliquez sur l'option Tester. 132
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur IBM Cognos Configuration vrifie la disponibilit des cls symtriques communes (CSK), teste la configuration de l'espace-noms et contrle les connexions la base de donnes Content Store et la base de donnes de journalisation. Si vous utilisez la base de donnes de notification et le serveur de messagerie, Cognos Configuration les teste galement. Conseil : Si l'option Tester ne peut pas tre slectionne, cliquez sur Configuration locale dans la fentre Explorateur. 4. Si le test choue, reconfigurez les proprits concernes, puis excutez nouveau le test. Vous pouvez tester les services individuellement en cliquant avec le bouton droit de la souris sur le service souhait dans le panneau Explorateur et en slectionnant l'option Tester. Dmarrez le service uniquement lorsque tous les tests ont abouti. 5. Dans le menu Oprations, cliquez sur l'option Dmarrer. Le dmarrage du service IBM Cognos 8 peut prendre quelques minutes. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution. Si vous souhaitez dmarrer un service spcifique, slectionnez son nud dans la fentre Explorateur et cliquez sur Dmarrer dans le menu Oprations.
Configuration du serveur Web

Pour toutes les installations, avant d'utiliser des pages Web cres par IBM Cognos 8, vous devez configurer votre serveur Web. Vous pouvez crer des rpertoires virtuels ou un pool d'applications. Pour la cration de rapports avec IBM Cognos 8, vous devez galement dfinir la date d'expiration applicable au contenu du rpertoire d'images de votre serveur Web pour que le navigateur ne contrle pas l'tat de ces dernires aprs le premier accs. Sous UNIX et Linux, le compte sous lequel le serveur Web s'excute doit disposer de droits de lecture sur le fichier cogstartup.xml qui se trouve dans le rpertoire emplacement_c8/configuration. Par dfaut, le fichier cogstartup.xml a des droits de lecture sur d'autres fichiers. Si vous excutez le serveur Web sous un groupe spcifique, vous pouvez modifier les droits du fichier cogstartup.xml pour tre certain qu'il appartienne au mme groupe que le serveur Web. Vous pouvez supprimer les droits de lecture sur d'autres fichiers. Pour en savoir davantage sur la cration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8, reportez-vous la section (p. 78).
Procdure de cration des rpertoires virtuels

1. Crez les rpertoires virtuels suivants :
Alias
cognos8 cognos8/cgi-bin
Emplacement
emplacement_c8/webcontent emplacement_c8/cgi-bin
Autorisation
Read Excution
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Vous pouvez utiliser un nom autre que cognos8 dans les alias. Cependant, vous devez utiliser cgi-bin en tant que deuxime partie de l'alias et vous devez modifier le rpertoire virtuel dans la proprit URI de la passerelle pour correspondre au nouvel alias d'IBM Cognos. Pour en savoir davantage, reportez-vous la section "Modification d'un URI" (p. 309). Si vous procdez une mise niveau partir de ReportNet, vous pouvez continuer utiliser les alias existants. Si vous installez les composants de cration de rapports d'IBM Cognos 8 dans un emplacement diffrent de celui de ReportNet, modifiez les alias existants pour inclure le nouvel emplacement. S'il existe plusieurs versions de ReportNet sur un ordinateur, vous devez utiliser des alias diffrents pour IBM Cognos 8. Pour le serveur Web Apache, dfinissez l'alias cognos8/cgi-bin avant l'alias cognos8 dans le fichier httpd.conf situ dans le rpertoire installation_Apache/conf. L'alias cognos8/cgi-bin doit tre dfini comme ScriptAlias. 2. Si vous souhaitez utiliser le navigateur d'images de Report Studio, activez le protocole WebDAV (Web Distributed Authoring and Versioning) sur votre serveur Web. Si vous utilisez un serveur Web Apache, dfinissez un rpertoire dans lequel activer WebDAV. Pour en savoir davantage sur la configuration du protocole WebDAV, reportez-vous la documentation sur le serveur Web. Si vous utilisez Microsoft Internet Information Services (IIS), activez les proprits de lecture et d'exploration des rpertoires pour l'adresse URL laquelle vous souhaitez accder : 3. Pour la cration de rapports avec IBM Cognos 8, dfinissez la date d'expiration du contenu dans le rpertoire virtuel emplacement_c8/pat/images du serveur Web. Chaque fois qu'un utilisateur ouvre Report Studio, son navigateur Web vrifie auprs du serveur Web si les images sont actualises. tant donn qu'il existe plus de 600 images, ce contrle peut engendrer un trafic rseau excessif. Vous pouvez le diffrer jusqu' une date dfinie au moyen de la fonction de spcification de la date d'expiration du contenu du serveur Web. Pour en savoir davantage sur la spcification de la date d'expiration du contenu, reportez-vous la documentation de votre serveur Web. Remarque : Lors de la mise niveau, les utilisateurs de Report Studio doivent vider l'antmmoire du navigateur Web pour obtenir les images les plus rcentes. Si vous utilisez des alias Web autres que cognos8, si votre serveur Web se trouve sur un autre ordinateur ou si vous utilisez Microsoft Internet Application Interface (ISAPI), apache_mod ou une passerelle de servlet, modifiez l'URI de la passerelle (p. 349) lors de la configuration des composants d'IBM Cognos.
Procdure de cration d'un groupe d'applications

1. Dans le menu Dmarrer, slectionnez Panneau de configuration, Systme et maintenance, puis cliquez deux fois sur Outils d'administration. 2. Lancez Gestionnaire des services Internet (IIS). Les options Outils d'administration Web et Services World Wide Web sont actives. 3. Dans la racine (le nom du systme et de l'utilisateur), slectionnez Affichage des fonctionnalits.
134
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 4. Dans la section IIS, lancez Restrictions ISAPI et CGI. 5. Slectionnez Modifier les paramtres de fonction et activez Autoriser les modules CGI non spcifis, puis cliquez sur OK. 6. Ajoutez vos alias. Par exemple, emplacement_c8,emplacement_c8/cgi-bin emplacement_c8/help. 7. Slectionnez votre alias cgi-bin et assurez-vous que l'option Affichage des fonctionnalits est slectionne. 8. Cliquez avec le bouton droit de la souris sur Pools d'application et slectionnez Ajouter. 9. Dans la bote de dialogue, saisissez un alias Web et le chemin d'accs correspondant vers le contenu Web d'IBM Cognos 8. 10. Cliquez avec le bouton droit de la souris sur l'application que vous venez de crer et ajoutez une autre application qui pointe sur le rpertoire cgi-bin d'IBM Cognos 8. 11. Slectionnez Site Web par dfaut. 12. Ouvrez Mappages de gestionnaires. 13. Slectionnez CGI-cgi mappings. 14. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 15. Dveloppez l'application qui pointe vers l'emplacement du contenu Web. 16. Dveloppez le nud d'application cgi-bin. 17. Ajoutez une mise en correspondance pointant vers *.cgi et nommez-la CGI-cgi. 18. Slectionnez les mises en correspondance CGI-cgi. 19. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 20. Redmarrez le serveur IIS. 21. Localisez le dossier qui contient cgi-bin (emplacement_c8/cgi-bin) et cliquez dessus avec le bouton droit de la souris. 22. Cliquez sur l'onglet Scurit. 23. Ajoutez l'utilisateur Services rseau, en lui accordant tous les droits l'exception de Contrle total. 24. Cliquez avec le bouton droit de la souris sur Service Cognos8 et slectionnez Proprits. 25. Cliquez sur l'onglet Connexion. 26. Cliquez sur This account et indiquez Service rseau en tant qu'utilisateur. 27. Supprimez les valeurs Mot de passe et Confirmer le mot de passe. 28. Cliquez sur OK. 29. Redmarrez IBM Cognos 8. Guide d'installation et de configuration 135
Installation des prsentations rapides

Vous devez tlcharger les prsentations rapides depuis le site Web Cognos Software Services et les installer sur l'ordinateur passerelle avant que les utilisateurs puissent y accder. Toutes les versions de langue des prsentations rapides sont disponibles sur ce site Web.
Procdure
1. Accdez la page http:/support.cognos.com/supported/en/support/downloads/cognos8/8.4/ index.html. 2. Sous Common Materials, slectionnez le lien des prsentations rapides d'IBM Cognos 8 Business Intelligence, puis cliquez sur Download Now. 3. Suivez les instructions de la fentre IBM Cognos Downloads pour tlcharger le pack et extraire son contenu. 4. Excutez le fichier issetup, puis suivez les instructions de l'assistant pour installer les prsentations rapides dans les langues dont vous avez besoin sur l'ordinateur de passerelle IBM Cognos, dans le rpertoire emplacement_c8. En cas d'installation de plusieurs produits IBM Cognos 8 utilisant plusieurs passerelles IBM Cognos, installez les prsentations rapides sur une seule passerelle. 5. Si vous installez les prsentations rapides sur une mme passerelle dans une installation impliquant plusieurs passerelles IBM Cognos, modifiez le fichier emplacement_c8\webcontent\ documentation\tours\crntours.html sur les autres passerelles en remplaant la variable de chane JavaScript sToursLocation par l'emplacement du rpertoire de la passerelle contenant les prsentations rapides.
Test de l'installation et de la configuration

Vous pouvez tester vos paramtres de configuration en excutant la fonction de test pendant que vous configurez IBM Cognos 8. Aprs avoir termin la configuration et dmarr les services, vous pouvez tester l'installation en ouvrant IBM Cognos Connection.
Procdure
1. Ouvrez un navigateur Web. 2. Vrifiez que la base de donnes Content Store a t correctement cre et que Content Manager a dmarr en saisissant ce qui suit : http://nom_hte:port/p2pd/servlet 3. Testez la disponibilit du distributeur en saisissant : http://nom_hte:port/p2pd/servlet/dispatch Si la rponse comprend la chane tat : En cours d'excution, le distributeur est disponible. 4. Dmarrez IBM Cognos Connection en saisissant ce qui suit, o cognos8 correspond au rpertoire virtuel que vous avez cr pendant la configuration du serveur Web.
136
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Pour la passerelle CGI : http://nom_hte:port/cognos8 Pour une passerelle ISAPI : http://nom_hte:port/cognos8/isapi Pour le connecteur Apache : http://nom_hte:port/cognos8/cgi-bin/module_cognos Pour un servlet de passerelle : http://nom_hte:port/racine_contexte/servlet/ Gateway L'ouverture de la page Web peut prendre quelques minutes. Si la page Bienvenue d'IBM Cognos Connection s'affiche, cela signifie que l'installation fonctionne.
Configuration de l'environnement de sources de donnes ou de sources d'importation

Les outils de modlisation d'IBM Cognos 8 permettent de crer et de grer des mtadonnes. Framework Manager cre et gre des mtadonnes pour les fonctions de cration de rapports. IBM Cognos 8 Transformer cre et gre des mtadonnes pour les cubes. Metric Designer cre et gre des mtadonnes destines aux fonctions de tableaux de bord. tant donn que les mtadonnes sont drives de sources de donnes d'environnements multilingues ou plusieurs plates-formes, vous devez prendre en compte plusieurs points ou effectuer diffrentes oprations lors de la configuration de l'environnement de sources de donnes pour Framework Manager ou IBM Cognos 8 Transformer, ou de la configuration de l'environnement de sources d'importation pour Metric Designer. Gnralement, ces oprations dpendent de l'autre technologie utilise pour votre source de donnes ou d'importation. Si vous utilisez une source de donnes Sybase, ces tapes ne sont pas ncessaires. Si vous avez procd une mise niveau partir d'une version antrieure de Framework Manager, aucun lment n'a besoin d'tre configur dans l'environnement de sources de donnes. Vous devez configurer l'environnement de sources de donnes uniquement si vous avez install Framework Manager dans un emplacement diffrent de celui de la version prcdente. Si des utilisateurs travaillant dans diffrentes langues doivent se connecter une source de donnes Microsoft Analysis Services (MSAS) 2000, vous devez crer une instance IBM Cognos 8 spare pour chaque langue. Les utilisateurs qui travaillent avec des langues diffrentes peuvent se connecter une source de donnes MSAS 2005 depuis la mme instance d'IBM Cognos 8. Les modlisateurs doivent crer un pack distinct pour chaque langue. Les utilisateurs peuvent excuter les rapports dans n'importe quelle langue. Pour en savoir davantage sur les connexions aux sources de donnes, reportez-vous au Guide d'administration et de scurit.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres et des symboles montaires que vous utilisez. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Paramtrez la variable d'environnement pour une prise en charge multilingue : Pour Oracle, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur chaque ordinateur sur lequel Framework Manager ou Metric Designer et le serveur IBM Cognos 8 sont installs, l'aide de la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. Pour DB2, attribuez la valeur 1252 la variable d'environnement DB2CODEPAGE. Pour en savoir davantage sur l'usage de cette variable d'environnement facultative, reportezvous la documentation sur DB2. Aucun paramtre n'est requis pour SAP BW. SAP prend en charge une seule page de codes sur les systmes SAP BW non-Unicode. 2. Pour Oracle, ajoutez $ORACLE_HOME/lib au chemin d'accs LD_LIBRARY_PATH. Lors de la dfinition des chemins d'accs la bibliothque de chargement, assurez-vous que les bibliothques Oracle 32 bits se trouvent sur le chemin d'accs la bibliothque (gnralement le rpertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle 64 bits). 3. Pour Oracle, copiez le fichier ojdbc14.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Pour Oracle 11g, copiez le fichier ojdbc5.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar. 4. Pour SAP BW, configurez les objets d'autorisation ci-dessous de faon ce que l'outil de modlisation puisse extraire les mtadonnes. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
138
Objet d'autorisation
S_RFC
Zone
Valeur
Activit Nom de RFC protger
16 SYST, RSOB, SUGU, RFC1, RS_UNIFICATION, RSAB, SDTX, SU_USER
Type d'objet RFC protger FUGR S_TABU_DIS Activit Groupe d'autorisation S_RFC Activit Nom de RFC protger 03 &NC& 16 SYST, RSOB, SUGU, RFC1, RS_UNIFICATION, RSAB, SDTX, SU_USER
Type d'objet RFC protger FUGR S_TABU_DIS Activit Groupes d'autorisation S_USER_GRP Activit Groupe d'utilisateurs pour maintenance principale des utilisateurs S_RS_COMP Activit InfoArea InfoCube 03 &NC& 03, 05 *
* Nom technique InfoArea Nom technique InfoCube
Nom (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports S_RS_COMP1 Activit *
Zone
Valeur
Nom (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports Propritaire (personne respon- * sable) S_RS_HIER Activit Nom de hirarchie InfoObject Version S_RS_ICUBE Activit Sous-objet d'InfoCube 71 Nom de hirarchie Nom technique InfoObject Version de hirarchie 03 DATA DFINITION InfoArea InfoCube Nom technique InfoArea Nom technique InfoCube
&NC& reprsente toute table n'ayant pas de groupe d'autorisation. Pour plus de scurit, crez un nouveau groupe d'autorisation et attribuez-lui la table RSHIEDIR. Le nouveau groupe d'autorisation empche l'utilisateur d'accder uniquement la table ci-dessus, ncessaire l'outil de modlisation.Crez le nouveau groupe d'autorisation en tant que personnalisation dans le systme SAP. Pour en savoir davantage sur les objets d'autorisation SAP BW, reportez-vous Transaction SU03. Une fois ces tches accomplies, vous devez configurer les composants de IBM Cognos 8 (p. 305) pour qu'ils fonctionnent dans votre environnement.
Cration de la base de donnes de bibliothque d'indicateurs

Une bibliothque d'indicateurs est une base de donnes contenant des donnes relatives aux packs d'indicateurs. Elle contient galement des paramtres d'application de tableaux de bord, tels que
140
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur les prfrences de l'utilisateur. Vous devez crer une base de donnes pour la bibliothque d'indicateurs l'aide d'Oracle, de Microsoft SQL Server ou de DB2. Si vous avez install la base de donnes de contenu d'IBM Cognos, elle ne peut pas tre utilise en tant que base de donnes de bibliothque d'indicateurs. L'administrateur de base de donnes doit sauvegarder rgulirement les bases de donnes IBM Cognos 8, car elles contiennent toutes les donnes de IBM Cognos. Pour garantir la scurit et l'intgrit des bases de donnes, il est galement important de les protger contre tout accs non autoris ou inappropri.
Procdure pour Microsoft SQL Server

1. Dans le rpertoire emplacement_c8/configuration/schemas/cmm/sqlserver, excutez le script cmm_create_db.cmd en saisissant la commande suivante : chemin_accs_script cmm_create_db nom_htenom_base_de_donnesnom_utilisateurmot_de_passe [utilisateur__crer] Utilisez les valeurs suivantes dans la commande :
Valeur
nom_hte nom_base_de_donnes nom_utilisateur
Paramtre
Nom de l'ordinateur sur lequel la base de donnes sera cre. Nom de la base de donnes qui sera cre. Code d'utilisateur disposant des autorisations pour crer la base de donnes. Le code d'utilisateur doit disposer des autorisations pour crer la base de donnes, par exemple sa (administrateur). Mot de passe correspondant l'lment nom_utilisateur. Utilisateur cr par le script et auquel les droits de propritaire de la base de donnes sont attribus. Cette valeur est facultative.
mot de passe utilisateur__crer
2. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Le compte utilisateur doit tre le propritaire de la base de donnes ou un pseudonyme de ce dernier.
Procdure pour Oracle si la base de donnes n'existe pas

1. Vrifiez que vous tes connect au serveur Oracle en tant qu'utilisateur membre du groupe ORA_DBA sous Windows ou du groupe dba sous UNIX.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 2. Sur l'ordinateur de la bibliothque d'indicateurs, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur le jeu de caractres UTF-8 en saisissant la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8
La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. 3. Depuis le rpertoire emplacement_c8/configuration/schemas/cmm/oracle, excutez le script cmm_create_db.cmd en saisissant la commande suivante : chemin_accs_script cmm_create_db sidchemin_accsversion_base_de_donnes [utilisateur__crer] Utilisez les valeurs suivantes dans la commande :
Valeur
chemin_accs_script
Paramtre
Chemin d'accs au script. Par exemple, emplacement_c8/ configuration/schemas/cmm/oracle/ SID de la base de donnes qui sera cre. Chemin d'accs aux fichiers de donnes qui seront crs. Version d'Oracle installe. Par exemple, oracle9 ou oracle10. Utilisateur cr par le script et auquel les droits de propritaire de la base de donnes sont attribus. Cette valeur est facultative.
sid chemin_accs version_base_de_donnes utilisateur__crer
4. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Si vous avez inclus l'utilisateur facultatif l'tape prcdente, il s'agit du compte que vous utiliserez pour accder la base de donnes. Si vous n'avez pas inclus d'utilisateur, vous devez ajouter un nom d'utilisateur de base de donnes Oracle valide disposant des autorisations suivantes : CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE TRIGGER, CREATE TYPE, CREATE SEQUENCE et CREATE SESSION EXECUTE sur les packs DBMS_LOCK et DBMS_UTILITY.
142
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Les autorisations CREATE TABLE et CREATE TRIGGER doivent tre accordes directement au compte utilisateur et non un rle.
Procdure pour Oracle si la base de donnes existe

1. Vrifiez que vous tes connect au serveur Oracle en tant qu'utilisateur membre du groupe ORA_DBA sous Windows ou du groupe dba sous UNIX. 2. Sur l'ordinateur de la bibliothque d'indicateurs, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur le jeu de caractres UTF-8 en saisissant la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8
La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. 3. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Vous devez utiliser un nom d'utilisateur de base de donnes Oracle valide disposant des autorisations suivantes : CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE TRIGGER, CREATE TYPE, CREATE SEQUENCE et CREATE SESSION EXECUTE sur les packs DBMS_LOCK et DBMS_UTILITY.
Les autorisations CREATE TABLE et CREATE TRIGGER doivent tre accordes directement au compte utilisateur et non un rle.
Procdure pour DB2

1. Dans le rpertoire emplacement_c8/configuration/schemas/cmm/db2, excutez le script cmm_create_db.cmd en saisissant la commande suivante : Sous Windows, saisissez cmm_create_db instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd Sous UNIX, saisissez cmm_create_db.sh instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd Utilisez les valeurs suivantes dans la commande :
Valeur
instance_bd
Paramtre
Nom de l'instance de DB2 sur laquelle la base de donnes sera cre. Guide d'installation et de configuration 143
Valeur
nom_utilisateur
Paramtre
Code d'utilisateur disposant des autorisations pour crer la base de donnes. Le code d'utilisateur doit disposer des droits d'accs SYSADM ou SYSCTRL, ainsi que des droits d'accs DBADM pour crer le schma. Mot de passe correspondant l'lment nom_utilisateur. Nom de la base de donnes qui sera cre. Le nom doit compter un maximum de 8 caractres et ne peut pas commencer par un chiffre. Sous Windows, lecteur sur lequel les objets de la base de donnes seront crs. Sous UNIX, chemin d'accs aux objets de la base de donnes qui seront crs. Pseudonyme de la base de donnes. Cette valeur est facultative.
mot de passe nom_bd
lecteur/chemin_accs
pseudonyme_bd
Remarque : L'administrateur de base de donnes peut vrifier les scripts pour s'assurer qu'ils conviennent votre environnement. Le script initializedb.db2 est appel par le script cmm_create_db.cmd et dfinit les groupes de mmoire tampon et les espaces de table. 2. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Le compte utilisateur doit disposer des droits d'accs suivants : CREATETAB BINDADD CONNECT IMPLICIT_SCHEMA LOAD
Cration d'un pack d'indicateurs

Pour permettre aux utilisateurs de se servir d'IBM Cognos 8 Metrics Manager, vous devez crer au moins un pack d'indicateurs l'aide de l'assistant Nouveau pack d'indicateurs. Un pack d'indicateurs est une reprsentation IBM Cognos Connection d'une application IBM Cognos 8 Metrics Manager. Un pack d'indicateurs contient des informations de connexion, des rapports et des tches de gestion des indicateurs pour cette application. Le contenu des packs d'indicateurs est stock dans une bibliothque d'indicateurs. Vous pouvez ouvrir l'Assistant Nouveau pack d'indicateurs depuis la barre d'outils d'IBM Cognos Connection et crer un pack d'indicateurs l'aide des lments suivants :
144
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur une nouvelle connexion la source de donnes vers une bibliothque d'indicateurs, une connexion existante la source de donnes vers une bibliothque d'indicateurs, une bibliothque d'indicateurs existante si la base de donnes a t utilise avec une version antrieure d'IBM Cognos 8 Metrics Manager 8.1 ou suprieure.
Il permet de dfinir le nom du pack d'indicateurs et la connexion entre la source de donnes et la bibliothque d'indicateurs. Dans le cas d'une nouvelle bibliothque d'indicateurs, vous fournissez galement les informations ncessaires l'initialisation de la base de donnes, notamment les dates de dbut et de fin de l'exercice fiscal. Pour pouvoir utiliser l'assistant Nouveau pack d'indicateurs, vous devez disposer de droits d'accs une bibliothque d'indicateurs employe avec Metrics Manager version 2.0 ou ultrieure, ou bien crer une base de donnes pour une nouvelle bibliothque d'indicateurs (p. 140).
Procdure avec une nouvelle connexion la source de donnes

1. Dmarrez IBM Cognos Connection. 2. Cliquez sur le bouton Nouveau pack d'indicateurs. 3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Cliquez sur l'option Nouvelle source de donnes. 5. Saisissez un nom et une description de la connexion entre la source de donnes et la bibliothque d'indicateurs renfermant le contenu de ce pack d'indicateurs, puis cliquez sur le bouton Suivant. 6. Dans la zone Type, cliquez sur le type de base de donnes. 7. Slectionnez le niveau d'isolement et cliquez sur Suivant. 8. Dfinissez les informations requises pour votre type de bases de donnes et cliquez sur Terminer. Pour une base de donnes Microsoft SQL Server, indiquez le nom du serveur de base de donnes et de la base de donnes elle-mme. Dans la section Codes d'accs, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes Oracle, saisissez la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes DB2, saisissez le nom de la base de donnes et la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Dans la plupart des cas, une squence d'assemblage n'est pas requise. Si vous souhaitez en indiquer une, assurez-vous que la valeur que vous saisissez est identique la squence
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur d'assemblage dfinie lors de la cration de la base de donnes. Pour en savoir davantage sur les squences d'assemblage, reportez-vous la documentation sur la base de donnes. Conseil : Pour vrifier si les paramtres sont corrects, cliquez sur le bouton Test de la connexion. 9. Slectionnez la nouvelle source de donnes puis cliquez sur Suivant. 10. Cliquez sur Suivant et suivez les instructions vous invitant fournir les informations ncessaires l'initialisation de la base de donnes. Lorsque vous atteignez la page rcapitulant les dtails de la source de donnes et les paramtres de la bibliothque d'indicateurs, cliquez sur l'option Initialiser. 11. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer. Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, et notamment sur la mthode de chargement des donnes, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8.
Procdure avec une connexion existante la source de donnes

1. Dmarrez IBM Cognos Connection. 2. Cliquez sur le bouton Nouveau pack d'indicateurs. 3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Slectionnez Nouvelle source de donnes puis cliquez sur Suivant. 5. Cliquez sur Suivant et suivez les instructions vous invitant fournir les informations ncessaires l'initialisation de la base de donnes. Lorsque vous atteignez la page rcapitulant les dtails de la source de donnes et les paramtres de la bibliothque d'indicateurs, cliquez sur l'option Initialiser. 6. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer. Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, et notamment sur la mthode de chargement des donnes, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8.
Procdure avec une bibliothque d'indicateurs existante

1. Dmarrez IBM Cognos Connection. 2. Cliquez sur le bouton Nouveau pack d'indicateurs .
3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Cliquez sur l'option Nouvelle source de donnes.
146
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 5. Saisissez le nom et la description de la connexion la source de donnes correspondant la bibliothque d'indicateurs contenant les donnes de ce pack d'indicateurs, puis cliquez sur Suivant. 6. Dans la zone Type, slectionnez le type de base de donnes, puis cliquez sur Suivant. 7. Fournissez les renseignements ncessaires concernant le type de votre base de donnes : Pour une base de donnes Microsoft SQL Server, indiquez le nom du serveur de base de donnes et de la base de donnes elle-mme. Dans la section Codes d'accs, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes Oracle, saisissez la chane de connexion. Dans la section Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe du compte utilisateur ayant accs cette base de donnes. Pour une base de donnes DB2, saisissez le nom de la base de donnes et la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Dans la plupart des cas, une squence d'assemblage n'est pas requise. Si vous souhaitez en indiquer une, assurez-vous que la valeur que vous saisissez est identique la squence d'assemblage dfinie lors de la cration de la base de donnes. Pour en savoir davantage sur les squences d'assemblage, reportez-vous la documentation sur la base de donnes. Conseil : Pour vrifier si les paramtres sont corrects, cliquez sur le bouton Test de la connexion. 8. Cliquez sur Suivant. 9. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer. Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. 10. Slectionnez la nouvelle source de donnes puis cliquez sur Suivant. 11. Cliquez sur l'option Mettre niveau. L'assistant met niveau les schmas et autres informations de la base de donnes. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, reportez-vous au Guide d'administration et de scurit.
Dsinstallation d'IBM Cognos 8

Il est important d'utiliser les programmes de dsinstallation afin de supprimer totalement l'ensemble des fichiers et des modifications apportes aux fichiers systme. Pour dsinstaller IBM Cognos 8, vous devez dsinstaller les composants du serveur et les outils de modlisation.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Si vous excutez IBM Cognos 8 dans un environnement de serveur d'application, utilisez l'outil d'administration propos par le serveur d'application pour arrter l'application si elle est en cours d'excution et annuler la portion Java des composants d'IBM Cognos 8. De nombreux serveurs d'application ne suppriment pas intgralement les rpertoires ou les fichiers d'application dploys lors de l'annulation d'un dploiement ; par consquent, vous devrez peut-tre effectuer cette opration manuellement. Aprs avoir annul le dploiement des composants d'IBM Cognos 8, suivez la procdure dcrite dans le prsent chapitre pour procder la dsinstallation sous UNIX (p. 148) et sous Windows (p. 149).
Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux

Si vous n'avez plus besoin d'IBM Cognos 8 ou si vous procdez une mise niveau, dsinstallez IBM Cognos 8. Si vous procdez une mise niveau partir d'une version prcdente de ReportNet vers IBM Cognos 8, suivez la procdure de dsinstallation dcrite dans la documentation de l'ancienne version de ReportNet.
Procdure
1. Si la console connecte l'ordinateur ne prend pas en charge les interfaces graphiques utilisateur de type Java, dterminez le PID (numro d'identification de processus) du processus IBM Cognos 8 en saisissant la commande suivante : ps -ef | grep cogbootstrapservice 2. Arrtez le processus IBM Cognos 8 : Si vous utilisez XWindows, dmarrez IBM Cognos Configuration puis, dans le menu Oprations, cliquez sur l'option Arrter. Si vous n'utilisez pas X Windows, saisissez : kill -TERM numro_identification_processus 3. Pour dsinstaller IBM Cognos 8, accdez au rpertoire emplacement_c8/uninstall et saisissez la commande approprie : Si vous utilisez X Windows, saisissez : ./uninst -u Si vous n'utilisez pas X Windows, saisissez : ./uninstcc -u 4. Suivez les invites pour achever la dsinstallation. 5. Supprimez tous les fichiers Internet temporaires. La dsinstallation ne supprime pas tous les fichiers modifis depuis l'installation, tels que les fichiers de configuration et les fichiers de donnes utilisateur. L'emplacement d'installation reste sur l'ordinateur. Tant que vous ne supprimez pas ces fichiers manuellement, ils sont conservs. Important :
148
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur Ne supprimez pas les fichiers de configuration et de donnes si vous procdez une mise niveau de IBM Cognos 8 et voulez utiliser les donnes de configuration avec la nouvelle version. Si vous utilisez la base de donnes de contenu d'IBM Cognos, l'emplacement implicite des fichiers de la base de donnes est le rpertoire emplacement_c8/contentstore. Si vous voulez conserver votre base de donnes aprs la dsinstallation, ne supprimez pas ce rpertoire.
Dsinstallation d'IBM Cognos 8 sous Windows

Si vous n'avez plus besoin d'IBM Cognos 8 ou si vous procdez une mise niveau, dsinstallez tous les composants d'IBM Cognos 8 et le service IBM Cognos 8. Si vous avez install plusieurs composants dans le mme emplacement, l'assistant de dsinstallation vous permet de choisir les packs dsinstaller.Tous les composants du pack seront dsinstalls. Vous devez rpter le processus de dsinstallation sur chaque ordinateur contenant des composants d'IBM Cognos 8. Il n'est pas ncessaire de sauvegarder les fichiers de configuration et de donnes sous Windows. Ces fichiers sont conservs pendant la dsinstallation. Il est recommand de fermer tous les programmes avant de dsinstaller IBM Cognos 8. Dans le cas contraire, il est possible que certains fichiers ne soient pas supprims. La dsinstallation ne supprime pas tous les fichiers modifis depuis l'installation, tels que les fichiers de configuration et les fichiers de donnes utilisateur. L'emplacement d'installation reste sur l'ordinateur. Vous conservez ces fichiers aussi longtemps que vous ne les supprimez pas manuellement l'aide de l'Explorateur Windows. Important : Ne supprimez pas les fichiers de configuration et de donnes si vous procdez une mise niveau d'IBM Cognos 8 et voulez utiliser les donnes de configuration avec la nouvelle version.
Procdure
1. Dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Dsinstaller IBM Cognos 8. L'Assistant de dsinstallation s'affiche. Conseil : IBM Cognos 8 est le nom implicite du dossier de programme cr lors de l'installation. Si vous avez choisi un autre nom, ouvrez ce dossier pour trouver le programme. 2. Suivez les instructions de dsinstallation des composants. Le fichier cognos_uninst_log.htm enregistre les activits effectues par l'Assistant durant la dsinstallation des fichiers. Conseil : Pour trouver le fichier journal, cherchez dans le rpertoire Temp. 3. Supprimez tous les fichiers Internet temporaires. Pour en savoir davantage, reportez-vous la documentation sur le navigateur Web.
Dsinstallation de la base de donnes de contenu d'IBM Cognos

Si vous souhaitez dsinstaller uniquement la base de donnes de contenu d'IBM Cognos et laisser les autres composants IBM Cognos 8 sur votre ordinateur, procdez comme suit : Aprs avoir dsinstall la base de donnes de contenu d'IBM Cognos, vous devez configurer un nouveau Content Store avant de redmarrer le service IBM Cognos 8. Si vous avez install uniquement la base de donnes de contenu d'IBM Cognos, utilisez une autre procdure. Pour en savoir davantage sur cette procdure, reportez-vous la section "Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux" (p. 148) ou la section "Dsinstallation d'IBM Cognos 8 sous Windows" (p. 149).
Procdure
1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\bin et saisissez la commande suivante : Sous Windows, saisissez derby.bat uninstall Cette commande supprime le service de la base de donnes de contenu d'IBM Cognos. Sous UNIX, saisissez derby.sh stop Cette commande arrte le service de la base de donnes de contenu d'IBM Cognos. 2. Dans le rpertoire emplacement_c8, supprimez le rpertoire derby10.1.2.1. 3. Dans le rpertoire emplacement_c8\bin, supprimez les fichiers suivants : Sous Windows, derby.bat Sous UNIX, derby.sh et derbyenv.sh
4. Sous Windows, dans le rpertoire emplacement_c8\logs, supprimez le fichier derby.service. 5. Dans le rpertoire emplacement_c8, ouvrez le fichier cmplst.txt dans un diteur de texte. 6. Supprimez les lignes contenant des valeurs relatives la base de donnes de contenu d'IBM Cognos. Ces lignes contiennent les chanes CCD et CMDERBY. Par exemple :
C8BISRVRCCD_version= C8BISRVRCCD_name= CCD_version= CCD_name= CMDERBY_version= CMDERBY_name=
Conseil : Vous pouvez galement transformer les lignes en commentaires en insrant le caractre # au dbut de ces lignes. 7. Enregistrez le fichier. 150
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur 8. Dmarrez IBM Cognos Configuration. 9. Sous Accs aux donnes, Content Manager, procdez comme suit : Supprimez la base de donnes de contenu d'IBM Cognos. Configurez une nouvelle ressource de base de donnes afin de pointer vers une nouvelle base de donnes Content Store.
Pour en savoir davantage, reportez-vous la section "Dfinition des proprits de connexion la base de donnes Content Store" (p. 128). 10. Redmarrez IBM Cognos 8.
152
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
Utilisez l'Assistant d'installation pour slectionner les composants du serveur que vous souhaitez installer, ainsi que l'emplacement appropri sur votre ordinateur. Seuls les composants que vous dcidez d'installer sont copis du CD sur l'ordinateur. Pour installer plusieurs composants d'IBM Cognos 8 sur un mme ordinateur, nous vous conseillons de les installer au mme endroit, afin d'viter tout conflit entre ports ou autres paramtres implicites. Les composants serveur d'IBM Cognos 8 sont les suivants : Content Manager Composants d'application Passerelle
Vous pouvez installer chaque composant sur un ordinateur distinct ou bien sur le mme ordinateur. La passerelle doit tre installe sur un ordinateur excutant galement un serveur Web. Si vous installez IBM Cognos 8 Metrics Manager, vous devez crer la base de donnes de la bibliothque d'indicateurs (p. 185) et au moins un pack d'indicateurs (p. 189). Ensuite, vous devez installer les composants client (p. 197). Pour obtenir des instructions sur la dsinstallation, reportezvous la section "Dsinstallation d'IBM Cognos 8" (p. 192).
Squence d'installation
Dans un environnement rparti, l'ordre dans lequel vous configurez les ordinateurs est important. Configurez et dmarrez d'abord l'ordinateur avec le Content Manager actif. Puis configurez et dmarrez l'ordinateur avec le Content Manager en attente, suivi de l'ordinateur des composants d'application. Configurez l'ordinateur passerelle en dernier pour que les cls cryptographiques soient partages et que la communication scurise s'effectue entre les trois composants. Le serveur indiqu pour la proprit URI externe du distributeur sur l'ordinateur passerelle doit tre le dernier serveur que vous dmarrez.
Squence de l'arrt de services

La squence d'arrt des services est importante. Arrtez d'abord les composants d'application, puis le Content Manager en attente et enfin le Content Manager actif. Les exemples se trouvent sur un CD spar de votre produit IBM Cognos 8. Si vous souhaitez utiliser les exemples, vous devez les installer depuis le CD de la version 8.4 des exemples d'IBM Cognos 8 Business Intelligence.
Mise niveau de l'installation

Si vous effectuez une mise niveau partir d'une version prcdente des produits IBM Cognos, vous devez respecter la procdure de mise niveau. Pour en savoir davantage sur la mise niveau
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs partir de ReportNet ou de Metrics Manager, reportez-vous la section "Mise niveau vers IBM Cognos 8" (p. 79). Si vous procdez une mise niveau partir de ReportNet, tous les composants rpartis doivent correspondre la mme version d'IBM Cognos 8. Si vous installez IBM Cognos 8 dans de nouveaux emplacements, vous devez les mettre jour l'aide d'IBM Cognos Configuration. Si vous mettez niveau IBM Cognos 8 BI dans un environnement qui inclut des versions prcdentes d'autres produits IBM Cognos 8, tels qu'IBM Cognos 8 Controller 8.3, IBM Cognos 8 Planning 8.3 ou IBM Cognos 8 BI Analysis pour Excel 8.3, installez la nouvelle version d'IBM Cognos 8 BI dans un emplacement diffrent de celui de l'autre produit IBM Cognos 8 et configurer IBM Cognos 8 BI afin qu'il s'excute de faon indpendante. Une fois la mise niveau de l'autre produit effectue vers une version compatible avec IBM Cognos 8 BI, vous pourrez configurer les deux produits pour qu'ils fonctionnent ensemble.
Installations sous Windows

Pour les installations sous Windows, assurez-vous que vous disposez de droits d'administration sur l'ordinateur Windows o vous souhaitez effectuer l'installation. Assurez-vous galement que l'ordinateur dispose d'une variable systme TEMP pointant vers le rpertoire o vous voulez stocker les fichiers temporaires. Durant l'installation, les fichiers du CD sont copis temporairement dans ce rpertoire.
Installations sous UNIX

Pour les installations sous UNIX, vous pouvez installer les composants serveur l'aide d'une interface en texte intgral ou d'une interface graphique utilisateur. Pour une installation en mode graphique, la console connecte votre ordinateur UNIX doit prendre en charge les interfaces graphiques utilisateur de type Java. De plus, IBM Cognos 8 respecte le masque de cration de mode fichier (umask) du compte excutant le programme d'installation. Cela n'a une incidence que sur les rpertoires d'installation, et non sur les droits d'accs aux fichiers l'intrieur de ces rpertoires. Toutefois, les fichiers crs en cours d'excution, tels que les journaux, respectent le masque. Nous recommandons umask 022 pour le rpertoire d'installation.
Base de donnes de contenu d'IBM Cognos en tant que Content Store

Si vous utilisez la base de donnes de contenu d'IBM Cognos en tant que base de donnes Content Store, vous devez la slectionner avec l'Assistant d'installation. Si vous installez des composants sur plusieurs ordinateurs, vous n'avez besoin d'installer qu'une base de donnes de contenu d'IBM Cognos. Si vous installez la base de donnes de contenu d'IBM Cognos sur le mme ordinateur que Content Manager, et que vous dcidez ensuite d'utiliser une autre base de donnes pour votre Content Store, vous devez dsinstaller la base de donnes de contenu d'IBM Cognos.
Installation et configuration de Content Manager

Dans une installation rpartie, au moins un des ordinateurs sur lequel vous installez Content Manager doit tre configur, actif et accessible avant que vous ne configuriez d'autres ordinateurs
154
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs dans votre environnement IBM Cognos. Cela garantit que le service de l'autorit de certification install avec Content Manager est disponible pour mettre des certificats pour d'autres ordinateurs. Il est possible que votre installation comprenne plusieurs applications Content Manager, chacune sur un ordinateur diffrent. Un ordinateur Content Manager peut tre activ et un ou plusieurs autres en attente. Les ordinateurs Content Manager en attente sont destins la protection de reprise. Si l'ordinateur Content Manager actif n'est pas disponible cause d'une panne logicielle ou matrielle, un ordinateur Content Manager en attente est activ et les demandes sont diriges vers ce dernier. En cas de dfaillance du service Content Manager actif, les donnes de session non enregistres sont perdues. Lorsqu'un autre service Content Manager devient actif, les utilisateurs peuvent tre invits se connecter. Le premier ordinateur Content Manager dmarrer devient l'ordinateur Content Manager actif par dfaut. l'aide de l'outil Administration, vous pouvez dfinir un autre ordinateur Content Manager comme ordinateur actif par dfaut. Pour en savoir davantage sur l'activation d'un service Content Manager, reportez-vous au Guide d'administration et de scurit. Si vous utilisez la base de donnes de contenu d'IBM Cognos en tant que base de donnes Content Store, vous devez la slectionner avec l'Assistant d'installation. Si vous installez des composants sur plusieurs ordinateurs, vous n'avez besoin d'installer qu'une base de donnes de contenu d'IBM Cognos. Si vous installez la base de donnes de contenu d'IBM Cognos sur le mme ordinateur que Content Manager, et que vous dcidez ensuite d'utiliser une autre base de donnes pour votre Content Store, vous devez dsinstaller la base de donnes de contenu d'IBM Cognos. Si vous employez la passerelle CGI implicite, il est prfrable de configurer IBM Cognos 8 de faon qu'il utilise plutt une passerelle ISAPI. Si vous ne procdez pas ainsi, les performances risquent de diminuer aprs une opration de reprise. Si vous procdez une mise niveau partir de ReportNet, vous pouvez utiliser les donnes de configuration existantes. Toutefois, certaines fonctions d'IBM Cognos 8 sont nouvelles. Il est conseill de configurer ces nouvelles fonctions. Si vous prvoyez d'installer IBM Cognos 8 Transformer et d'utiliser des cubes scuriss partir d'un espace-noms IBM Cognos Series 7, vous devez installer Content Manager sur un ordinateur prenant en charge IBM Cognos Series 7. Effectuez les oprations suivantes pour installer et configurer Content Manager : Installation des composants de Content Manager Installation d'IBM Cognos 8 Metrics Manager, le cas chant Mise jour de l'environnement Java Dmarrez IBM Cognos Configuration. Dfinition des proprits de connexion la base de donnes Content Store Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification Configuration des proprits d'environnement pour les ordinateurs Content Manager Activation de la scurit Guide d'installation et de configuration 155
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Dmarrage de Content Manager Test de l'installation de Content Manager
Installation des composants de Content Manager

Pour installer Content Manager, servez-vous du CD correspondant votre systme d'exploitation. Si vous installez plusieurs instances de Content Manager, vous devez vous assurer que les horloges systme des ordinateurs Content Manager sont synchronises, afin de garantir le bon fonctionnement des reprises entre chaque instance.

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'emplacement d'installation de Java Runtime Environment (JRE). Voici un exemple d'emplacement d'installation de Java Runtime Environment : /directory/java/version_java/jre. IBM Cognos 8 ncessite que Sun Java soit excut sous Linux. 3. Sous HP-UX, dfinissez la variable d'environnement _M_ARENA_OPTS comme suit : _M_ARENA_OPTS 1:4 Cette opration augmente l'allocation de mmoire pour HP-UX afin qu'elle corresponde mieux celle des autres plates-formes UNIX. 4. Sous AIX, dfinissez la variable d'environnement AIXTHREAD_SCOPE comme suit : AIXTHREAD_SCOPE=S La porte de contention des processus utilisateur est ainsi dfinie l'chelle du systme, ce qui permet une programmation plus efficace de ces processus. 5. Montez le CD de votre produit IBM Cognos avec les extensions de fichier Rock Ridge. Important : Pour monter le CD IBM Cognos sous HP-UX, procdez comme suit : Ajoutez le rpertoire pfs_mount votre chemin d'installation. Par exemple : PATH=/usr/sbin/:$PATH export PATH Pour dmarrer les dmons NFS requis et les excuter en arrire-plan, saisissez bg pfs_mountd, puis bg pfsd. Pour monter le lecteur, saisissez : pfs_mount -t rrip <priphrique><rp_mont> -o xlat=unix Par exemple :
156
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix Vous pouvez prsent procder l'installation ou copier des fichiers en tant qu'utilisateur non-racine, en insrant un CD IBM Cognos dans ce lecteur. Une fois l'installation termine, saisissez pfs_umount /cdrom et arrtez les dmons pfsd et pfs_mountd pour dmonter le CD.
6. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. Pour Solaris, par exemple, accdez au rpertoire solaris. 7. Dmarrer l'Assistant d'installation ? Si vous utilisez X Windows, saisissez : ./issetup Remarque : Lorsque vous utilisez la commande issetup avec XWindows, les caractres japonais peuvent tre altrs. Lors d'une installation sous UNIX, utilisez l'cran de la console pour installer les composants et slectionnez l'anglais comme langue d'installation unique en paramtrant LANG=C et LC_ALL=C. Si vous n'utilisez pas X Windows, saisissez : ./issetupcc 8. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web UNIX et Linux ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous l'installez dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 9. Slectionnez la faon dont vous souhaitez poursuivre la procdure sur la page Terminer de l'Assistant d'installation : Il est dconseill de configurer IBM Cognos 8 immdiatement, car il convient d'abord d'effectuer d'autres tches pour s'assurer que l'environnement est correctement configur. Toutefois, si la console connecte l'ordinateur prend en charge les interfaces graphiques utilisateur de type Java, vous pouvez cliquer sur l'option Dmarrer IBM Cognos Configuration Si vous voulez prendre connaissance des informations les plus rcentes sur IBM Cognos 8, slectionnez Afficher le fichier Lisezmoi, puis cliquez sur le bouton Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q. Guide d'installation et de configuration 157
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si la console rattache votre ordinateur ne prend pas en charge une interface utilisateur graphique Java, cliquez sur le bouton Terminer. Vous pourrez configurer IBM Cognos 8 ultrieurement l'aide d'IBM Cognos Configuration en lanant la commande cogconfig.sh dans le rpertoire emplacement_c8/bin ou en modifiant le fichier cogstartup.xml dans le rpertoire emplacement_c8/configuration. 10. Ajoutez le rpertoire emplacement_c8/bin la variable d'environnement de chemin d'accs la bibliothque approprie : Pour Solaris et Linux, LD_LIBRARY_PATH Pour AIX, LIBPATH Pour HP-UX, SHLIB_PATH
11. Sous Linux, attribuez le nom de votre imprimante la variable d'environnement PRINTER

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Insrez le CD de votre produit IBM Cognos. La page Bienvenue de l'Assistant d'installation s'affiche. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 3. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web Windows ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 5. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration.
158
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi. 6. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis.
Installation d'IBM Cognos 8 Metrics Manager

Si vous installez IBM Cognos 8 Metrics Manager avec IBM Cognos 8 Business Intelligence, vous devez installer chaque composant d'IBM Cognos 8 Metrics Manager dans le mme emplacement que les composants IBM Cognos 8 Business Intelligence. Installez le composant Content Manager d'IBM Cognos 8 Metrics Manager dans le mme emplacement que celui o vous avez install le composant Content Manager d'IBM Cognos 8 Business Intelligence. Si vous le souhaitez, vous pouvez galement installer Metric Designer (p. 221).

Les services cryptographiques d'IBM Cognos 8 utilisent un fichier .jar (Java Archive) spcifique, appel bcprov-jdknn-nnn.jar, qui doit se trouver dans votre environnement JRE. Ce fichier fournit des sous-programmes supplmentaires de chiffrement et de dchiffrement qui ne sont pas disponibles dans l'installation implicite du JVM. Pour garantir la scurit, le fichier de chiffrement doit tre charg par l'environnement JVM l'aide du rpertoire d'extensions Java. Si vous souhaitez utiliser votre propre JRE et dfinir la variable JAVA_HOME sur l'emplacement correspondant sous Windows ou si vous effectuez l'installation sous UNIX, vous devrez peut-tre mettre jour l'environnement Java pour les services cryptographiques. Sous Windows, vous pouvez dfinir JAVA_HOME en tant que variable systme ou variable utilisateur. Si vous la dfinissez en tant que variable systme, vous devrez probablement redmarrer votre ordinateur pour qu'elle prenne effet. Si vous la dfinissez en tant que variable utilisateur, faites en sorte que l'environnement dans lequel s'excute Tomcat puisse y accder. Si vous ne disposez pas d'une variable JAVA_HOME dj dfinie sous Windows ou si celle-ci pointe vers une version de Java non compatible avec IBM Cognos 8, les fichiers JRE fournis avec l'installation seront utiliss et vous n'aurez pas besoin de mettre jour les fichiers de votre environnement.
Procdure
Dmarrez IBM Cognos Configuration.

Utilisez l'outil IBM Cognos Configuration pour configurer IBM Cognos 8 ou pour dmarrer et arrter les services IBM Cognos. Avant de dmarrer IBM Cognos Configuration, vrifiez que l'environnement d'exploitation est configur correctement. Ainsi, assurez-vous que toutes les variables ont t dfinies. Vous devez dmarrer IBM Cognos Configuration la dernire page de l'Assistant d'installation sous Windows, UNIX ou Linux si aucune configuration complmentaire n'est requise. Par exemple, si vous utilisez un serveur de base de donnes autre que Microsoft SQL comme base de donnes Content Store, nous vous conseillons de copier les pilotes JDBC vers l'emplacement appropri avant de dmarrer l'outil de configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur Windows : Dans le menu Dmarrer, cliquez sur Programmes, slectionnez IBM Cognos 8 et cliquez sur IBM Cognos Configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur UNIX ou Linux : Ouvrez le rpertoire emplacement_c8/bin et saisissez : ./cogconfig.sh Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Dfinition des proprits de connexion la base de donnes Content Store

Vous devez fournir des informations sur le serveur de base de donnes pour vous assurer que Content Manager peut se connecter la base de donnes Content Store. Content Manager utilise la connexion la base de donnes pour accder Content Store. Aprs avoir dfini les proprits de connexion la base de donnes, vous pouvez tester la connexion entre Content Manager et la base de donnes Content Store. Si vous avez install la base de donnes de contenu d'IBM Cognos sur un ordinateur diffrent de celui o vous avez install Content Manager, vous devez dfinir les proprits de connexion la base de donnes de contenu d'IBM Cognos. Si vous avez install la base de donnes de contenu d'IBM Cognos sur le mme ordinateur que Content Manager, ce dernier est configur pour utiliser la base de donnes de contenu d'IBM Cognos avec les valeurs implicites. Si vous installez la base de donnes de contenu d'IBM Cognos sur le mme ordinateur que Content Manager, et que vous dcidez ensuite d'utiliser une autre base de donnes pour votre Content Store, vous devez dsinstaller la base de donnes de contenu d'IBM Cognos. Assurez-vous que vous avez utilis l'un des serveurs de base de donnes pris en charge pour crer la base de donnes Content Store. Remarque : Certains serveurs de base de donnes sont disponibles avec des fonctions avances. Lorsque vous slectionnez une base de donnes avance, les composants d'IBM Cognos 8 utilisent les fonctions du serveur de base de donnes pour grer la connexion. Si vous slectionnez la base de donnes Oracle avance, par exemple, les composants d'IBM Cognos 8 utilisent les fonctions orientes entreprise d'Oracle pour slectionner un couteur, passer un autre couteur si le premier 160
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs choue, se reconnecter automatiquement la base de donnes si la connexion choue ou encore quilibrer les demandes de connexion parmi les couteurs et parmi les distributeurs. Les composants d'IBM Cognos 8 requirent le protocole TCP/IP pour accder aux donnes et la base de donnes Content Store. Assurez-vous que le protocole TCP/IP est dfini pour le serveur de base de donnes. Si vous utilisez Oracle, il n'est pas ncessaire d'installer un client Oracle sur le mme ordinateur que Content Manager. Toutefois, Content Manager requiert un pilote JDBC Oracle appel ojdbc14.jar (ou, pour Oracle 11g, ojdbc5.jar). Ce pilote est disponible dans le rpertoire d'installation du client ou serveur Oracle ; il peut galement tre tlcharg partir du site Web Oracle Technology Network (http://www.oracle.com/technology). Le fichier du pilote ojdbc14.jar ou ojdbc5.jar doit tre copi dans le rpertoire emplacement_c8\p2pd\WEB-INF\lib dans lequel est install Content Manager. Si le rpertoire contient le fichier classes12.jar, vous devez le supprimer avant d'installer le fichier ojdbc14.jar ou ojdbc5.jar. Si vous effectuez une mise niveau partir de ReportNet, configurez IBM Cognos 8 pour qu'il pointe vers la base de donnes Content Store existante. Aprs avoir enregistr la configuration et dmarr le service IBM Cognos 8, la base de donnes Content Store est automatiquement mise niveau et ne peut plus tre utilise par ReportNet. Si vous conservez ReportNet, vous devez configurer IBM Cognos 8 pour qu'il pointe vers une nouvelle base de donnes Content Store. Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Procdure pour la base de donnes de contenu d'IBM Cognos

1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Accs aux donnes, Content Manager, cliquez avec le bouton droit de la souris sur l'option Content Store, puis slectionnez Supprimer. Cliquez sur Oui pour confirmer la suppression. Cette opration supprime la base de donnes implicite. 3. Cliquez avec le bouton droit de la souris sur l'option Content Manager, puis cliquez sur Nouvelle ressource, Base de donnes. 4. Dans la fentre Proprits, configurez IBM Cognos 8 de faon utiliser la base de donnes de contenu d'IBM Cognos en tant que Content Store : Pour l'option Nom, saisissez cm. Pour Serveur de base de donnes et numro de port, saisissez le nom de l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos. Pour la proprit Code d'utilisateur et mot de passe, cliquez sur le bouton d'dition et indiquez cognos pour le code d'utilisateur et le mot de passe afin d'accder la base de donnes de contenu d'IBM Cognos.
Il est recommand de modifier le code d'utilisateur et le mot de passe implicites aprs avoir configur la nouvelle ressource. Pour en savoir davantage sur la modification des valeurs
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs implicites, reportez-vous la section "Modifier l'utilisateur et le mot de passe implicites pour la base de donnes de contenu d'IBM Cognos" (p. 307). 5. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les rfrences d'identification pour la connexion sont immdiatement chiffres. 6. Dans le menu Oprations, cliquez sur le bouton Tester pour tester la connexion entre Content Manager et le Content Store. Vous devez dmarrer le service de la base de donnes de contenu d'IBM Cognos sur l'ordinateur sur lequel vous l'avez install pour russir le test. Content Manager se connecte la base de donnes, vrifie les droits d'accs de celle-ci, puis cre une table et la complte. La table n'est pas supprime et est utilise chaque excution du test.

1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Accs aux donnes, Content Manager, cliquez avec le bouton droit de la souris sur l'option Content Store, puis slectionnez Supprimer. Cette opration supprime la ressource implicite. Content Manager doit tre configur de faon accder une seule base de donnes Content Store. 3. Cliquez avec le bouton droit de la souris sur l'option Content Manager, puis cliquez sur Nouvelle ressource et Base de donnes. 4. Dans la zone Nom, saisissez un nom pour la ressource. 5. Dans la zone Type, slectionnez le type de base de donnes, puis cliquez sur le bouton OK. Si vous procdez une mise niveau et que vous souhaitez utiliser une base de donnes Content Store existante, veillez slectionner le type de base de donnes utilis pour la version prcdente de ReportNet. Si vous avez install plusieurs versions d'IBM Cognos 8, vous devez utiliser une base de donnes Content Store diffrente pour chaque version. Lorsqu'une base de donnes Content Store est utilise par une nouvelle version d'IBM Cognos 8, elle ne peut pas tre utilise par une version antrieure de ReportNet. Conseil : Si vous utilisez la paire Net8 de type mot-cl et valeur d'Oracle pour grer la connexion la base de donnes, slectionnez Base de donnes Oracle (options avances). 6. Dans la fentre Proprits, fournissez des valeurs en fonction du type de base de donnes : Si vous utilisez une base de donnes Microsoft SQL Server, saisissez les valeurs appropries pour les proprits Serveur de base de donnes comportant un numro de port ou un nom d'instance et Nom de la base de donnes. Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance.
162
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre. Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire Si vous utilisez une base de donnes DB2, pour la proprit Nom de la base de donnes, saisissez le pseudonyme de la base de donnes. Si vous utilisez une base de donnes Oracle, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom du service. Si vous utilisez une base de donnes Oracle avance, pour la proprit Identificateur de base de donnes, saisissez la paire Net8 de type mot-cl et valeur d'Oracle pour la connexion. Voici un exemple : (description=(adresse=(hte=mon_hte)(protocole=tcp)(port=1521)(donnes_connexion= (sid=(orcl))))) Si vous utilisez une base de donnes Sybase, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom de la base de donnes. 7. Si vous souhaitez modifier les rfrences d'identification de connexion, prcisez un code d'utilisateur et un mot de passe : Cliquez sur la zone Valeur en regard de la proprit Code d'utilisateur et mot de passe, puis cliquez sur le bouton d'dition quand il s'affiche. Saisissez les valeurs appropries et cliquez sur OK.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les rfrences d'identification pour la connexion sont immdiatement chiffres. 9. Testez la connexion entre Content Manager et la base de donnes Content Store. Conseil : Dans le menu Oprations, cliquez sur Test pour tester la connexion entre Content Manager et la base de donnes Content Store. Content Manager se connecte la base de donnes, vrifie les droits d'accs de celle-ci, puis cre une table et la complte. La table n'est pas supprime et est utilise chaque excution du test. Content Manager peut dsormais crer les tables requises dans la base de donnes Content Store lors du premier dmarrage du service IBM Cognos 8. Si les proprits de connexion ne sont pas correctement dfinies, les tables ne sont pas cres et vous ne pouvez pas vous connecter IBM Cognos Connection.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si vous procdez une mise niveau partir de ReportNet, Content Manager peut dsormais accder aux tables requises dans la base de donnes Content Store utilise pour ReportNet.
Configuration des proprits d'environnement pour les ordinateurs Content Manager

Les ordinateurs Content Manager doivent connatre l'emplacement de la base de donnes Content Store, des autres ordinateurs Content Manager et de la base de donnes utilise pour la notification. Aprs avoir install Content Manager sur les ordinateurs que vous utilisez pour la protection de reprise, vous devez configurer Content Manager sur ces ordinateurs. Si vous avez install plusieurs ordinateurs Content Manager, vous devez rpertorier tous les URI de Content Manager sur chaque ordinateur Content Manager. Si vous procdez une mise niveau, vous devez galement ajouter les URI de Content Manager en attente l'ordinateur d'origine Content Manager. Une fois les tches de configuration requises effectues, le service de l'autorit de certification est disponible pour l'mission de certificats l'attention d'autres ordinateurs. Vous pouvez ensuite excuter les tches de configuration requises sur d'autres ordinateurs, tels que l'ordinateur des composants d'application et les ordinateurs passerelle. Vous pouvez par ailleurs continuer configurer les ordinateurs Content Manager en modifiant les paramtres de proprit implicites (p. 306) afin de les adapter votre environnement. Par exemple, vous pouvez configurer les composants d'IBM Cognos 8 pour qu'ils utilisent un fournisseur d'authentification (p. 261), activer et dsactiver des services (p. 317) sur les ordinateurs Content Manager ou modifier les paramtres globaux (p. 338). Important : Si vous modifiez les paramtres globaux sur l'un des ordinateurs Content Manager, vous devez effectuer les mmes modifications sur les autres ordinateurs Content Manager.
Procdure pour le premier ordinateur Content Manager

1. Sur l'ordinateur Content Manager que vous dsignez comme ordinateur actif par dfaut, dmarrez IBM Cognos Configuration. Conseil : Il est recommand d'utiliser l'ordinateur comportant le processeur le plus rapide en tant qu'ordinateur Content Manager actif par dfaut. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, cliquez sur la valeur de l'option URI de Content Manager, puis cliquez sur le bouton dition. 4. Indiquez les URI pour les autres ordinateurs Content Manager : Dans la bote de dialogue Valeur - URI de Content Manager, cliquez sur Ajouter. Dans la ligne vide de la table, cliquez et saisissez l'URI complet de l'ordinateur Content Manager. Ne supprimez pas la premire valeur de la table. Cette valeur est ncessaire et identifie l'ordinateur Content Manager local. Rptez les deux tapes prcdentes (indiques par des puces) pour chaque URI ajouter. Important : Vous devez inclure tous les URI de Content Manager dans la liste.
164
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Cliquez sur OK.
5. Dans la fentre Explorateur, dans la section Scurit, cliquez sur l'option Cryptographie. 6. Dans la fentre Proprits, dans la section Paramtres CSK, dfinissez l'option Stocker la cl symtrique localement sur la valeur Vrai. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Procdure pour les ordinateurs Content Manager en attente

1. Assurez-vous que les proprits d'environnement sont dj configures sur au moins un ordinateur Content Manager et que les composants d'IBM Cognos 8 sont actifs sur cet ordinateur. 2. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager en attente. 3. Dans la fentre Explorateur, cliquez sur Environnement. 4. Dans la fentre Proprits, cliquez sur la valeur de l'option URI de Content Manager, puis cliquez sur le bouton dition. 5. Indiquez les URI pour les autres ordinateurs Content Manager : Dans la bote de dialogue Valeur - URI de Content Manager, cliquez sur Ajouter. Dans la ligne vide de la table, cliquez et saisissez l'URI complet de l'ordinateur Content Manager. Ne supprimez pas la premire valeur de la table. Cette valeur est ncessaire et identifie l'ordinateur Content Manager local. Rptez les deux tapes prcdentes (indiques par des puces) pour chaque URI ajouter. Important : Vous devez inclure tous les URI de Content Manager dans la liste. Cliquez sur OK.
6. Dans la fentre Explorateur, dans la section Scurit, cliquez sur l'option Cryptographie. 7. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 8. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 9. Assurez-vous que tous les autres paramtres cryptographiques correspondent ceux que vous avez configurs dans l'ordinateur Content Manager actif par dfaut. 10. Dans la fentre Explorateur, dans la section Accs aux donnes, Content Manager, cliquez sur l'option Content Store. 11. Assurez-vous que toutes les autres proprits correspondent celles que vous avez configures dans l'ordinateur Content Manager actif par dfaut. 12. Dans le menu Fichier, cliquez sur l'option Enregistrer. Guide d'installation et de configuration 165
Dfinition d'un compte de serveur de messagerie et d'une base de donnes de notification

Si vous dsirez envoyer des rapports par courrier lectronique, vous devez configurer un compte de serveur de messagerie. Vous devez galement prciser l'emplacement de la base de donnes utilise par le serveur de notification pour stocker les donnes relatives aux travaux et aux calendriers. Si vous utilisez une installation rpartie (par exemple pour l'quilibrage de la charge), vous devez configurer tous les ordinateurs Content Manager et ceux des composants d'application pour qu'ils utilisent la mme base de donnes pour la notification. Par dfaut, le serveur de notification utilise la mme base de donnes que celle utilise par Content Manager comme base de donnes Content Store. Vous pouvez utiliser une base de donnes spare pour la notification lorsque vous excutez des volumes importants de production de rapports par lots et de courriers lectroniques. Si tel est le cas, assurez-vous que la base de donnes de notification existe et qu'aucune requte n'est en attente d'excution. Les requtes places en file d'attente ne sont pas supprimes. Tous les ordinateurs Content Manager doivent tre configurs de faon utiliser la mme base de donnes de notification. Une fois que vous avez fini de configurer un compte de serveur de messagerie et une base de donnes de notification, vous pouvez tester les connexions ces deux lments. Conseil : Pour tre en mesure d'ouvrir des rapports envoys par courrier lectronique, vous devez remplacer la partie correspondant au nom d'hte localhost dans l'URI de la passerelle par l'adresse IP ou par le nom de l'ordinateur. Sinon, l'adresse URL du courrier lectronique contiendra la chane localhost, ce qui empchera les utilisateurs distants d'ouvrir le rapport. Si vous procdez une mise niveau partir de ReportNet, IBM Cognos 8 utilise les paramtres et le compte de serveur de messagerie dfinis pour ReportNet.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur o est install Content Manager. 2. Dans la fentre Explorateur, dans la section Accs aux donnes, cliquez sur l'option Notification. 3. Dans la fentre Proprits, pour la proprit Serveur de messagerie SMTP, saisissez le nom d'hte et le port du serveur de messagerie SMTP (sortant). 4. Cliquez sur la zone Valeur ct de la proprit Code d'utilisateur et mot de passe, puis cliquez sur le bouton d'dition quand il s'affiche. 5. Saisissez les valeurs appropries dans la bote de dialogue Valeur - Compte et mot de passe, puis cliquez sur le bouton OK. Conseil : Si les rfrences d'identification de connexion ne sont pas requises pour le serveur SMTP, supprimez les informations implicites pour la proprit Code d'utilisateur et mot de passe. Lorsque vous tes invit confirmer que cette proprit reste vide, cliquez sur Oui. Assurez-vous que le nom d'utilisateur implicite a t supprim. Dans le cas contraire, le compte implicite est utilis et les notifications ne fonctionnent pas correctement. 6. Dans la fentre Proprits, saisissez les valeurs appropries pour le compte de l'expditeur implicite.
166
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Conseil : Si vous utilisez la base de donnes de notification implicite, vous n'avez pas besoin d'excuter les tapes suivantes. 7. Identifiez la base de donnes utilise pour la notification : Dans la fentre de l'Explorateur, cliquez avec le bouton droit de la souris sur l'option Notification, puis slectionnez Nouvelle ressource et Base de donnes. Saisissez un nom pour la ressource de base de donnes. Slectionnez le type de base de donnes dans le menu droulant. Cliquez sur OK.
8. Dans la fentre Proprits, saisissez les valeurs pour la ressource de base de donnes de notification. Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance. Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre. Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire 9. Dans le menu Fichier, cliquez sur l'option Enregistrer. 10. Testez les connexions aux serveurs de notification et de messagerie. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur Notification, puis cliquez sur l'option Tester. IBM Cognos 8 teste la connexion la base de donnes et la connexion au serveur de messagerie. Si vous avez l'habitude d'utiliser la base de donnes Content Store pour la notification, les calendriers sont rpliqus dans les tables de la nouvelle base de donnes de notification. Important : Veillez ce que les valeurs utilises pour identifier la ressource de base de donnes de notification soient les mmes sur tous les ordinateurs Content Manager. Pour utiliser la base de donnes de notification implicite, vous n'avez pas besoin de modifier les valeurs de la fentre Proprits.
Activation de la scurit
Par dfaut, IBM Cognos 8 permet un accs anonyme au portail Web. Si vous souhaitez appliquer un systme de scurit votre environnement IBM Cognos 8, vous devez dsactiver l'accs anonyme et configurer IBM Cognos 8 pour qu'il utilise un fournisseur d'authentification.
Procdure
1. Dans la fentre Explorateur de Cognos Configuration, cliquez sur Scurit, Authentification et IBM Cognos. 2. Cliquez sur la zone Valeur associe l'option Voulez-vous autoriser les connexions anonymes ?, puis slectionnez Faux. 3. Cliquez avec le bouton droit de la souris sur l'option Authentification, puis slectionnez Nouvelle ressource et Espace-noms. 4. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 5. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 6. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Pour en savoir davantage sur la configuration d'IBM Cognos 8 afin qu'il utilise un fournisseur d'authentification, reportez-vous la section "Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification" (p. 261). Pour en savoir davantage sur la configuration d'IBM Cognos 8 afin qu'il utilise un fournisseur d'authentification, reportez-vous la section Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification , dans le Guide d'installation et de configuration. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Dmarrage de Content Manager

Aprs avoir dfini les proprits de connexion la base de donnes Content Store, vous pouvez dmarrer l'ordinateur Content Manager. Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Procdure
Dans le menu Oprations, cliquez sur l'option Dmarrer. Le dmarrage du service IBM Cognos 8 peut prendre quelques minutes. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution. Si vous souhaitez dmarrer un service spcifique, slectionnez le nud du service dans la fentre Explorateur et cliquez sur Dmarrer dans le menu Oprations. 168
Test de l'installation de Content Manager

Vous pouvez tester l'installation l'aide d'un navigateur Web.
Procdure
1. Ouvrez un navigateur Web. 2. Vrifiez que Content Manager est en cours d'excution en saisissant la valeur URI de Content Manager depuis IBM Cognos Connection. Par exemple : http://nom_hte:numro_port/p2pd/servlet L'option tat doit afficher la valeur En cours d'excution.
Installation et configuration des composants d'application

Vous pouvez installer les composants d'application sur un ou plusieurs ordinateurs. Effectuez les oprations suivantes pour installer et configurer les composants d'application : Installation des composants d'application Installation des composants d'IBM Cognos 8 Metrics Manager, le cas chant Dmarrez IBM Cognos Configuration. Configuration des proprits d'environnement des composants d'application Dmarrage des composants d'application Test des composants d'application
Installation des composants d'application

Vous pouvez installer les composants d'application sur un ou plusieurs ordinateurs, en fonction de votre environnement. Si vous effectuez une mise niveau partir de ReportNet, IBM Cognos 8 applique les donnes de configuration existantes aux ordinateurs des composants d'application. Toutefois, si vous avez install les composants d'application dans un nouvel emplacement, vous devez configurer les proprits d'environnement. Assurez-vous que l'ordinateur sur lequel vous avez install le service Content Manager actif est configur et disponible avant de configurer les ordinateurs des composants d'application.

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'emplacement d'installation de Java Runtime Environment (JRE). Voici un exemple d'emplacement d'installation de Java Runtime Environment : /directory/java/version_java/jre. Guide d'installation et de configuration 169
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs IBM Cognos 8 ncessite que Sun Java soit excut sous Linux. 3. Sous HP-UX, dfinissez la variable d'environnement _M_ARENA_OPTS comme suit : _M_ARENA_OPTS 1:4 Cette opration augmente l'allocation de mmoire pour HP-UX afin qu'elle corresponde mieux celle des autres plates-formes UNIX. 4. Sous AIX, dfinissez la variable d'environnement AIXTHREAD_SCOPE comme suit : AIXTHREAD_SCOPE=S La porte de contention des processus utilisateur est ainsi dfinie l'chelle du systme, ce qui permet une programmation plus efficace de ces processus. 5. Montez le CD de votre produit IBM Cognos avec les extensions de fichier Rock Ridge. Important : Pour monter le CD IBM Cognos sous HP-UX, procdez comme suit : Ajoutez le rpertoire pfs_mount votre chemin d'installation. Par exemple : PATH=/usr/sbin/:$PATH export PATH Pour dmarrer les dmons NFS requis et les excuter en arrire-plan, saisissez bg pfs_mountd, puis bg pfsd. Pour monter le lecteur, saisissez : pfs_mount -t rrip <priphrique><rp_mont> -o xlat=unix Par exemple : pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix Vous pouvez prsent procder l'installation ou copier des fichiers en tant qu'utilisateur non-racine, en insrant un CD IBM Cognos dans ce lecteur. Une fois l'installation termine, saisissez pfs_umount /cdrom et arrtez les dmons pfsd et pfs_mountd pour dmonter le CD.
6. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. Pour Solaris, par exemple, accdez au rpertoire solaris. 7. Dmarrer l'Assistant d'installation ? Si vous utilisez X Windows, saisissez : ./issetup Remarque : Lorsque vous utilisez la commande issetup avec XWindows, les caractres japonais peuvent tre altrs. Lors d'une installation sous UNIX, utilisez l'cran de la console pour installer les composants et slectionnez l'anglais comme langue d'installation unique en paramtrant LANG=C et LC_ALL=C. 170 Si vous n'utilisez pas X Windows, saisissez :
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs ./issetupcc 8. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web UNIX et Linux ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous l'installez dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 9. Slectionnez la faon dont vous souhaitez poursuivre la procdure sur la page Terminer de l'Assistant d'installation : Il est dconseill de configurer IBM Cognos 8 immdiatement, car il convient d'abord d'effectuer d'autres tches pour s'assurer que l'environnement est correctement configur. Toutefois, si la console connecte l'ordinateur prend en charge les interfaces graphiques utilisateur de type Java, vous pouvez cliquer sur l'option Dmarrer IBM Cognos Configuration Si vous voulez prendre connaissance des informations les plus rcentes sur IBM Cognos 8, slectionnez Afficher le fichier Lisezmoi, puis cliquez sur le bouton Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q. Si la console rattache votre ordinateur ne prend pas en charge une interface utilisateur graphique Java, cliquez sur le bouton Terminer. Vous pourrez configurer IBM Cognos 8 ultrieurement l'aide d'IBM Cognos Configuration en lanant la commande cogconfig.sh dans le rpertoire emplacement_c8/bin ou en modifiant le fichier cogstartup.xml dans le rpertoire emplacement_c8/configuration. 10. Ajoutez le rpertoire emplacement_c8/bin la variable d'environnement de chemin d'accs la bibliothque approprie : Pour Solaris et Linux, LD_LIBRARY_PATH Pour AIX, LIBPATH Pour HP-UX, SHLIB_PATH

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs 2. Insrez le CD de votre produit IBM Cognos. La page Bienvenue de l'Assistant d'installation s'affiche. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 3. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web Windows ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 5. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration. Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi. 6. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis.

Si vous installez IBM Cognos 8 Metrics Manager avec IBM Cognos 8 Business Intelligence, vous devez installer chaque composant d'IBM Cognos 8 Metrics Manager dans le mme emplacement que les composants IBM Cognos 8 Business Intelligence. Installez le composant d'application IBM Cognos 8 Metrics Manager dans le mme emplacement que celui o vous avez install le composant d'application IBM Cognos 8 Business Intelligence. Si vous le souhaitez, vous pouvez galement installer Metric Designer (p. 221).

Utilisez l'outil IBM Cognos Configuration pour configurer IBM Cognos 8 ou pour dmarrer et arrter les services IBM Cognos.
172
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Avant de dmarrer IBM Cognos Configuration, vrifiez que l'environnement d'exploitation est configur correctement. Ainsi, assurez-vous que toutes les variables ont t dfinies. Vous devez dmarrer IBM Cognos Configuration la dernire page de l'Assistant d'installation sous Windows, UNIX ou Linux si aucune configuration complmentaire n'est requise. Par exemple, si vous utilisez un serveur de base de donnes autre que Microsoft SQL comme base de donnes Content Store, nous vous conseillons de copier les pilotes JDBC vers l'emplacement appropri avant de dmarrer l'outil de configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur Windows : Dans le menu Dmarrer, cliquez sur Programmes, slectionnez IBM Cognos 8 et cliquez sur IBM Cognos Configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur UNIX ou Linux : Ouvrez le rpertoire emplacement_c8/bin et saisissez : ./cogconfig.sh Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Configuration des proprits d'environnement des ordinateurs des composants d'application

Si vous installez les composants d'application sur un ordinateur autre que Content Manager, vous devez configurer l'ordinateur des composants d'application afin qu'il connaisse l'emplacement de Content Manager. Les composants rpartis peuvent ainsi communiquer entre eux. L'ordinateur des composants d'application doit connatre l'emplacement des ordinateurs Content Manager et de la base de donnes utiliser pour les donnes relatives aux travaux et aux calendriers. Si vous avez install plusieurs ordinateurs Content Manager, vous devez rpertorier tous les URI de Content Manager sur chaque serveur de rapports.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, modifiez la portion localhost de la proprit URI de Content Manager et attribuez-lui le nom d'un ordinateur de Content Manager. 4. Indiquez les URI des autres ordinateurs Content Manager : Dans la bote de dialogue Valeur - URI de Content Manager, cliquez sur Ajouter. Dans la ligne vide de la table, cliquez et saisissez l'URI complet de l'ordinateur Content Manager. Rptez les deux tapes prcdentes (indiques par des puces) pour chaque URI ajouter. Important : Vous devez inclure tous les URI de Content Manager dans la liste.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Cliquez sur OK.
5. Modifiez la localhost de la proprit URI de la passerelle et attribuez-lui le nom de l'ordinateur sur lequel vous prvoyez d'installer le composant passerelle. 6. Modifiez la portion localhost des proprits URI restantes et attribuez-lui le nom ou l'adresse IP de votre serveur IBM Cognos 8. 7. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 8. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 9. Assurez-vous que tous les autres paramtres cryptographiques correspondent ceux que vous avez dfinis sur l'ordinateur Content Manager actif par dfaut. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Dmarrage des composants d'application

Une fois que vous avez configur les proprits de l'environnement, vous pouvez dmarrer les services sur l'ordinateur des composants d'application. Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Test des composants d'application

Procdure
1. Ouvrez un navigateur Web. 2. Testez la disponibilit du distributeur en saisissant : http://nom_OrdinateurContentManager:port/p2pd/servlet Si la rponse comprend la chane tat : En cours d'excution, le distributeur est disponible.
Installation et configuration de la passerelle

Vous pouvez installer la passerelle sur un ou plusieurs ordinateurs, en fonction de votre environnement. Si vous effectuez une mise niveau partir de ReportNet, IBM Cognos 8 applique les donnes de configuration existantes aux ordinateurs passerelle. Toutefois, si vous avez install la passerelle dans un nouvel emplacement, vous devez la configurer.
174
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Assurez-vous que l'ordinateur sur lequel vous avez install le service Content Manager actif est configur et disponible avant de configurer les ordinateurs passerelle. Effectuez les oprations suivantes pour installer et configurer la passerelle : Installation des composants de la passerelle Installation des composants d'IBM Cognos 8 Metrics Manager, le cas chant Dmarrez IBM Cognos Configuration. configurer le serveur Web, Configuration des proprits d'environnement et de scurit de la passerelle Installation des prsentations rapides Test de l'installation de la passerelle
Installation des composants de la passerelle

Vous pouvez installer la passerelle sur un ou plusieurs serveurs Web.

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'emplacement d'installation de Java Runtime Environment (JRE). Voici un exemple d'emplacement d'installation de Java Runtime Environment : /directory/java/version_java/jre. IBM Cognos 8 ncessite que Sun Java soit excut sous Linux. 3. Sous HP-UX, dfinissez la variable d'environnement _M_ARENA_OPTS comme suit : _M_ARENA_OPTS 1:4 Cette opration augmente l'allocation de mmoire pour HP-UX afin qu'elle corresponde mieux celle des autres plates-formes UNIX. 4. Sous AIX, dfinissez la variable d'environnement AIXTHREAD_SCOPE comme suit : AIXTHREAD_SCOPE=S La porte de contention des processus utilisateur est ainsi dfinie l'chelle du systme, ce qui permet une programmation plus efficace de ces processus. 5. Montez le CD de votre produit IBM Cognos avec les extensions de fichier Rock Ridge. Important : Pour monter le CD IBM Cognos sous HP-UX, procdez comme suit : Ajoutez le rpertoire pfs_mount votre chemin d'installation. Par exemple : PATH=/usr/sbin/:$PATH
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs export PATH Pour dmarrer les dmons NFS requis et les excuter en arrire-plan, saisissez bg pfs_mountd, puis bg pfsd. Pour monter le lecteur, saisissez : pfs_mount -t rrip <priphrique><rp_mont> -o xlat=unix Par exemple : pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix Vous pouvez prsent procder l'installation ou copier des fichiers en tant qu'utilisateur non-racine, en insrant un CD IBM Cognos dans ce lecteur. Une fois l'installation termine, saisissez pfs_umount /cdrom et arrtez les dmons pfsd et pfs_mountd pour dmonter le CD.
6. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. Pour Solaris, par exemple, accdez au rpertoire solaris. 7. Dmarrer l'Assistant d'installation ? Si vous utilisez X Windows, saisissez : ./issetup Remarque : Lorsque vous utilisez la commande issetup avec XWindows, les caractres japonais peuvent tre altrs. Lors d'une installation sous UNIX, utilisez l'cran de la console pour installer les composants et slectionnez l'anglais comme langue d'installation unique en paramtrant LANG=C et LC_ALL=C. Si vous n'utilisez pas X Windows, saisissez : ./issetupcc 8. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web UNIX et Linux ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous l'installez dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 9. Slectionnez la faon dont vous souhaitez poursuivre la procdure sur la page Terminer de l'Assistant d'installation :
176
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Il est dconseill de configurer IBM Cognos 8 immdiatement, car il convient d'abord d'effectuer d'autres tches pour s'assurer que l'environnement est correctement configur. Toutefois, si la console connecte l'ordinateur prend en charge les interfaces graphiques utilisateur de type Java, vous pouvez cliquer sur l'option Dmarrer IBM Cognos Configuration Si vous voulez prendre connaissance des informations les plus rcentes sur IBM Cognos 8, slectionnez Afficher le fichier Lisezmoi, puis cliquez sur le bouton Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q. Si la console rattache votre ordinateur ne prend pas en charge une interface utilisateur graphique Java, cliquez sur le bouton Terminer. Vous pourrez configurer IBM Cognos 8 ultrieurement l'aide d'IBM Cognos Configuration en lanant la commande cogconfig.sh dans le rpertoire emplacement_c8/bin ou en modifiant le fichier cogstartup.xml dans le rpertoire emplacement_c8/configuration. 10. Ajoutez le rpertoire emplacement_c8/bin la variable d'environnement de chemin d'accs la bibliothque approprie : Pour Solaris et Linux, LD_LIBRARY_PATH Pour AIX, LIBPATH Pour HP-UX, SHLIB_PATH

1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Insrez le CD de votre produit IBM Cognos. La page Bienvenue de l'Assistant d'installation s'affiche. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 3. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Installez IBM Cognos 8 dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs Web Windows ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 5. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration. Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi. 6. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis.

Si vous installez IBM Cognos 8 Metrics Manager avec IBM Cognos 8 Business Intelligence, vous devez installer chaque composant d'IBM Cognos 8 Metrics Manager dans le mme emplacement que les composants IBM Cognos 8 Business Intelligence. Installez le composant de passerelle IBM Cognos 8 Metrics Manager dans le mme emplacement que celui o vous avez install le composant de passerelle IBM Cognos 8 Business Intelligence. Si vous le souhaitez, vous pouvez galement installer Metric Designer (p. 221).

Utilisez l'outil IBM Cognos Configuration pour configurer IBM Cognos 8 ou pour dmarrer et arrter les services IBM Cognos. Avant de dmarrer IBM Cognos Configuration, vrifiez que l'environnement d'exploitation est configur correctement. Ainsi, assurez-vous que toutes les variables ont t dfinies. Vous devez dmarrer IBM Cognos Configuration la dernire page de l'Assistant d'installation sous Windows, UNIX ou Linux si aucune configuration complmentaire n'est requise. Par exemple, si vous utilisez un serveur de base de donnes autre que Microsoft SQL comme base de donnes Content Store, nous vous conseillons de copier les pilotes JDBC vers l'emplacement appropri avant de dmarrer l'outil de configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur Windows : Dans le menu Dmarrer, cliquez sur Programmes, slectionnez IBM Cognos 8 et cliquez sur IBM Cognos Configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur UNIX ou Linux : Ouvrez le rpertoire emplacement_c8/bin et saisissez : ./cogconfig.sh 178
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Assurez-vous que le compte d'utilisateur ou de service est configur. Pour en savoir davantage, reportez-vous la section "Configuration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8" (p. 78).
Configuration des proprits d'environnement et de scurit des ordinateurs passerelle

Si vous installez la passerelle sur un ordinateur autre que Content Manager ou que celui des composants d'application, vous devez configurer la passerelle afin qu'elle connaisse l'emplacement d'un distributeur. Un distributeur est install sur chaque ordinateur Content Manager et des composants d'application. Il est recommand que la passerelle utilise le distributeur sur un ordinateur des composants d'application. Pour la protection de reprise, vous pouvez configurer plusieurs distributeurs pour un mme ordinateur passerelle. Lorsque plusieurs distributeurs sont configurs, les demandes sont normalement achemines vers le premier distributeur de la liste. Si le distributeur devient indisponible, la passerelle identifie le prochain distributeur oprationnel de la liste et lui adresse les demandes. L'tat du distributeur principal est contrl par la passerelle et les demandes sont rachemines vers ce composant lorsqu'il est remis en service. Une fois les tches de configuration effectues, la passerelle peut fonctionner dans votre environnement. Assurez-vous que les ordinateurs sur lesquels vous avez install Content Manager sont configurs et que l'ordinateur Content Manager actif par dfaut est disponible avant de configurer les ordinateurs passerelle.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la section Paramtres de la passerelle de la fentre Proprits, indiquez les valeurs correspondant URI du distributeur pour la passerelle : Cliquez dans la colonne des valeurs. Cliquez sur le bouton d'dition. Remplacez la chane localhost de l'URI par le nom ou l'adresse IP d'un ordinateur des composants d'application. Conseil : Si vous souhaitez envoyer des requtes au distributeur depuis une application SDK ou un outil de modlisation IBM Cognos 8 situ en dehors d'un pare-feu rseau, il est recommand de vous connecter une passerelle ddie configure de manire se connecter au distributeur l'aide de l'URI interne du distributeur correspondant votre environnement (par exemple, http://localhost:9300/p2pd/servlet/dispatch). Pour des raisons de scurit, le paramtre implicite de l'URI du distributeur pour la proprit de la passerelle empche le distributeur d'accepter des requtes pour une application SDK ou un outil de modlisation situs en dehors du pare-feu. Veillez configurer un niveau de scurit appropri pour cette passerelle ddie (par exemple, SSL) (p. 325). Ne modifiez pas votre passerelle principale
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs de manire utiliser l'URI interne du distributeur. Ceci rduirait le niveau de scurit des studios et du portail IBM Cognos 8. Pour en savoir davantage sur l'outil de modlisation et les pare-feu rseau, reportez-vous la section "Observations concernant le parefeu" (p. 37). Pour ajouter un autre URI, cliquez sur Ajouter et remplacez la chane localhost du nouvel URI par le nom ou l'adresse IP d'un autre ordinateur de composants d'application. Conseil : Pour utiliser le distributeur sur un ordinateur Content Manager en attente, veillez l'ajouter aprs avoir ajout les ordinateurs des composants d'application. Si vous ajoutez le distributeur partir de l'ordinateur Content Manager actif, vrifiez qu'il figure en dernier dans la liste. Une fois tous les URI dfinis, cliquez sur le bouton OK.
4. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 5. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 6. Assurez-vous que tous les autres paramtres cryptographiques correspondent ceux que vous avez dfinis sur l'ordinateur Content Manager actif par dfaut. 7. Testez l'extraction de la cl symtrique. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur Cryptographie, puis cliquez sur l'option Tester. Les composants d'IBM Cognos 8 vrifient la disponibilit des cls symtriques communes. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer.

Pour toutes les installations, avant d'utiliser des pages Web cres par IBM Cognos 8, vous devez configurer votre serveur pour permettre la connexion au portail IBM Cognos 8 et pour que les applications client puissent se connecter au serveur. Vous pouvez crer des rpertoires virtuels ou un pool d'applications. Pour la cration de rapports avec IBM Cognos 8, vous devez galement dfinir la date d'expiration applicable au contenu du rpertoire d'images de votre serveur Web pour que le navigateur ne contrle pas l'tat de ces dernires aprs le premier accs. Sous UNIX et Linux, le compte sous lequel le serveur Web s'excute doit disposer de droits de lecture sur le fichier cogstartup.xml qui se trouve dans le rpertoire emplacement_c8/configuration. Par dfaut, le fichier cogstartup.xml a des droits de lecture sur d'autres fichiers. Si vous excutez le serveur Web sous un groupe spcifique, vous pouvez modifier les droits du fichier cogstartup.xml pour tre certain qu'il appartienne au mme groupe que le serveur Web. Vous pouvez supprimer les droits de lecture sur d'autres fichiers.
180
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Pour en savoir davantage sur la cration d'un compte utilisateur ou d'un compte de service rseau pour IBM Cognos 8, reportez-vous la section (p. 78).
Procdure de cration des rpertoires virtuels

1. Crez les rpertoires virtuels suivants :
Alias
cognos8 cognos8/cgi-bin
Emplacement
emplacement_c8/webcontent emplacement_c8/cgi-bin
Autorisation
Lecture Excution
Vous pouvez utiliser un nom autre que cognos8 dans les alias. Cependant, vous devez utiliser cgi-bin en tant que deuxime partie de l'alias et vous devez modifier le rpertoire virtuel dans la proprit URI de la passerelle pour correspondre au nouvel alias d'IBM Cognos. Pour en savoir davantage, reportez-vous la section "Modification d'un URI" (p. 309). Si vous procdez une mise niveau partir de ReportNet, vous pouvez continuer utiliser les alias existants. Si vous installez les composants de cration de rapports d'IBM Cognos 8 dans un emplacement diffrent de celui de ReportNet, modifiez les alias existants pour inclure le nouvel emplacement. S'il existe plusieurs versions de ReportNet sur un ordinateur, vous devez utiliser des alias diffrents pour IBM Cognos 8. Pour le serveur Web Apache, dfinissez l'alias cognos8/cgi-bin avant l'alias cognos8 dans le fichier httpd.conf situ dans le rpertoire installation_Apache/conf. L'alias cognos8/cgi-bin doit tre dfini comme ScriptAlias. 2. Si vous souhaitez utiliser le navigateur d'images de Report Studio, activez le protocole WebDAV (Web Distributed Authoring and Versioning) sur votre serveur Web. Si vous utilisez un serveur Web Apache, dfinissez un rpertoire dans lequel activer WebDAV. Pour en savoir davantage sur la configuration du protocole WebDAV, reportez-vous la documentation sur le serveur Web. Si vous utilisez Microsoft Internet Information Services (IIS), activez les proprits de lecture et d'exploration des rpertoires pour l'adresse URL laquelle vous souhaitez accder : 3. Pour la cration de rapports avec IBM Cognos 8, dfinissez la date d'expiration du contenu dans le rpertoire virtuel emplacement_c8/pat/images du serveur Web. Chaque fois qu'un utilisateur ouvre Report Studio, son navigateur Web vrifie auprs du serveur Web si les images sont actualises. tant donn qu'il existe plus de 600 images, ce contrle peut engendrer un trafic rseau excessif. Vous pouvez le diffrer jusqu' une date dfinie au moyen de la fonction de spcification de la date d'expiration du contenu du serveur Web. Pour en savoir davantage sur la spcification de la date d'expiration du contenu, reportez-vous la documentation de votre serveur Web. Remarque : Lors de la mise niveau, les utilisateurs de Report Studio doivent vider l'antmmoire du navigateur Web pour obtenir les images les plus rcentes.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si vous utilisez des alias Web autres que cognos8, si votre serveur Web se trouve sur un autre ordinateur ou si vous utilisez Microsoft Internet Application Interface (ISAPI), apache_mod ou une passerelle de servlet, modifiez l'URI de la passerelle (p. 349) lors de la configuration des composants d'IBM Cognos.

1. Dans le menu Dmarrer, slectionnez Panneau de configuration, Systme et maintenance, puis cliquez deux fois sur Outils d'administration. 2. Lancez Gestionnaire des services Internet (IIS). Les options Outils d'administration Web et Services World Wide Web sont actives. 3. Dans la racine (le nom du systme et de l'utilisateur), slectionnez Affichage des fonctionnalits. 4. Dans la section IIS, lancez Restrictions ISAPI et CGI. 5. Slectionnez Modifier les paramtres de fonction et activez Autoriser les modules CGI non spcifis, puis cliquez sur OK. 6. Ajoutez vos alias. Par exemple, emplacement_c8,emplacement_c8/cgi-bin emplacement_c8/help. 7. Slectionnez votre alias cgi-bin et assurez-vous que l'option Affichage des fonctionnalits est slectionne. 8. Cliquez avec le bouton droit de la souris sur Pools d'application et slectionnez Ajouter. 9. Dans la bote de dialogue, saisissez un alias Web et le chemin d'accs correspondant vers le contenu Web d'IBM Cognos 8. 10. Cliquez avec le bouton droit de la souris sur l'application que vous venez de crer et ajoutez une autre application qui pointe sur le rpertoire cgi-bin d'IBM Cognos 8. 11. Slectionnez Site Web par dfaut. 12. Ouvrez Mappages de gestionnaires. 13. Slectionnez CGI-cgi mappings. 14. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 15. Dveloppez l'application qui pointe vers l'emplacement du contenu Web. 16. Dveloppez le nud d'application cgi-bin. 17. Ajoutez une mise en correspondance pointant vers *.cgi et nommez-la CGI-cgi. 18. Slectionnez les mises en correspondance CGI-cgi. 19. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 20. Redmarrez le serveur IIS. 21. Localisez le dossier qui contient cgi-bin (emplacement_c8/cgi-bin) et cliquez dessus avec le bouton droit de la souris.
182
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs 22. Cliquez sur l'onglet Scurit. 23. Ajoutez l'utilisateur Services rseau, en lui accordant tous les droits l'exception de Contrle total. 24. Cliquez avec le bouton droit de la souris sur Service Cognos8 et slectionnez Proprits. 25. Cliquez sur l'onglet Connexion. 26. Cliquez sur This account et indiquez Service rseau en tant qu'utilisateur. 27. Supprimez les valeurs Mot de passe et Confirmer le mot de passe. 28. Cliquez sur OK. 29. Redmarrez IBM Cognos 8.

1. Dans le menu Dmarrer, slectionnez Panneau de configuration, Systme et maintenance, puis cliquez deux fois sur Outils d'administration. 2. Lancez Gestionnaire des services Internet (IIS). Les options Outils d'administration Web et Services World Wide Web sont actives. 3. Dans la racine (le nom du systme et de l'utilisateur), slectionnez Affichage des fonctionnalits. 4. Dans la section IIS, lancez Restrictions ISAPI et CGI. 5. Slectionnez Modifier les paramtres de fonction et activez Autoriser les modules CGI non spcifis, puis cliquez sur OK. 6. Ajoutez vos alias. Par exemple, emplacement_c8,emplacement_c8/cgi-bin emplacement_c8/help. 7. Slectionnez votre alias cgi-bin et assurez-vous que l'option Affichage des fonctionnalits est slectionne. 8. Cliquez avec le bouton droit de la souris sur Pools d'application et slectionnez Ajouter. 9. Dans la bote de dialogue, saisissez un alias Web et le chemin d'accs correspondant vers le contenu Web d'IBM Cognos 8. 10. Cliquez avec le bouton droit de la souris sur l'application que vous venez de crer et ajoutez une autre application qui pointe sur le rpertoire cgi-bin d'IBM Cognos 8. 11. Slectionnez Site Web par dfaut. 12. Ouvrez Mappages de gestionnaires. 13. Slectionnez CGI-cgi mappings. 14. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 15. Dveloppez l'application qui pointe vers l'emplacement du contenu Web. 16. Dveloppez le nud d'application cgi-bin. Guide d'installation et de configuration 183
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs 17. Ajoutez une mise en correspondance pointant vers *.cgi et nommez-la CGI-cgi. 18. Slectionnez les mises en correspondance CGI-cgi. 19. Dans le volet droit, cliquez sur Rtablir la valeur hrite. 20. Redmarrez le serveur IIS. 21. Localisez le dossier qui contient cgi-bin (emplacement_c8/cgi-bin) et cliquez dessus avec le bouton droit de la souris. 22. Cliquez sur l'onglet Scurit. 23. Ajoutez l'utilisateur Services rseau, en lui accordant tous les droits l'exception de Contrle total. 24. Cliquez avec le bouton droit de la souris sur Service Cognos8 et slectionnez Proprits. 25. Cliquez sur l'onglet Connexion. 26. Cliquez sur This account et indiquez Service rseau en tant qu'utilisateur. 27. Supprimez les valeurs Mot de passe et Confirmer le mot de passe. 28. Cliquez sur OK. 29. Redmarrez IBM Cognos 8.
Installation des prsentations rapides

Vous devez tlcharger les prsentations rapides partir du site Web Cognos Software Services et les installer sur l'ordinateur de passerelle pour que les utilisateurs puissent y accder. Les prsentations rapides sont disponibles dans toutes les langues sur le site Web.
Procdure
1. Accdez la page http:/support.cognos.com/supported/en/support/downloads/cognos8/8,4/ index.html. 2. Sous Common Materials, slectionnez le lien de prsentations rapides d'IBM Cognos 8 Business Intelligence, puis cliquez sur Download Now. 3. Suivez les instructions de la fentre IBM Cognos Downloads pour tlcharger le pack et extraire son contenu.. 4. Excutez le fichier issetup, puis suivez les instructions de l'assistant pour installer les prsentations rapides dans les langues dont vous avez besoin sur l'ordinateur de passerelle IBM Cognos, dans le rpertoire emplacement_c8. En cas d'installation de plusieurs produits IBM Cognos 8 utilisant plusieurs passerelles IBM Cognos, installez les prsentations rapides sur une seule passerelle. 5. Si vous installez les prsentations rapides sur une mme passerelle dans une installation impliquant plusieurs passerelles IBM Cognos, modifiez le fichier emplacement_c8\webcontent\ documentation\tours\crntours.html sur les autres passerelles en remplaant la variable de chane 184
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs JavaScript sToursLocation par l'emplacement du rpertoire de la passerelle contenant les prsentations rapides.
Test de la passerelle
Procdure
1. Vrifiez que votre serveur Web est en cours d'excution. 2. Ouvrez un navigateur Web. 3. Dans la barre d'adresse, saisissez l'URI de la passerelle. Par exemple : http://nom_hte/cognos8 La page de Bienvenue d'IBM Cognos Connection s'affiche.
Cration de la base de donnes de bibliothque d'indicateurs

Une bibliothque d'indicateurs est une base de donnes contenant des donnes relatives aux packs d'indicateurs. Elle contient galement des paramtres d'application de tableaux de bord, tels que les prfrences de l'utilisateur. Vous devez crer une base de donnes pour la bibliothque d'indicateurs l'aide d'Oracle, de Microsoft SQL Server ou de DB2. Si vous avez install la base de donnes de contenu d'IBM Cognos, elle ne peut pas tre utilise en tant que base de donnes de bibliothque d'indicateurs. L'administrateur de base de donnes doit sauvegarder rgulirement les bases de donnes IBM Cognos 8 car elles contiennent toutes les donnes d'IBM Cognos. Pour garantir la scurit et l'intgrit des bases de donnes, il est galement important de les protger contre tout accs non autoris ou inappropri.
Procdure pour Microsoft SQL Server

1. Dans le rpertoire emplacement_c8/configuration/schemas/cmm/sqlserver, excutez le script cmm_create_db.cmd en saisissant la commande suivante : chemin_accs_script cmm_create_db nom_htenom_base_de_donnesnom_utilisateurmot_de_passe [utilisateur__crer] Utilisez les valeurs suivantes dans la commande :
Valeur
nom_hte nom_base_de_donnes
Paramtre
Nom de l'ordinateur sur lequel la base de donnes sera cre. Nom de la base de donnes qui sera cre.
Valeur
nom_utilisateur
Paramtre
Code d'utilisateur disposant des autorisations pour crer la base de donnes. Le code d'utilisateur doit disposer des autorisations pour crer la base de donnes, par exemple sa (administrateur). Mot de passe correspondant l'lment nom_utilisateur. Utilisateur cr par le script et auquel les droits de propritaire de la base de donnes sont attribus. Cette valeur est facultative.
mot de passe utilisateur__crer
2. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Le compte utilisateur doit tre le propritaire de la base de donnes ou un pseudonyme de ce dernier.
Procdure pour Oracle si la base de donnes n'existe pas

La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux.Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. 3. Depuis le rpertoire emplacement_c8/configuration/schemas/cmm/oracle, excutez le script cmm_create_db.cmd en saisissant la commande suivante : chemin_accs_script cmm_create_db sidchemin_accsversion_base_de_donnes [utilisateur__crer] Utilisez les valeurs suivantes dans la commande :
186
Valeur
chemin_accs_script
Paramtre
Chemin d'accs au script. Par exemple, emplacement_c8/ configuration/schemas/cmm/oracle/ SID de la base de donnes qui sera cre. Chemin d'accs aux fichiers de donnes qui seront crs. Version d'Oracle installe. Par exemple, oracle9 ou oracle10. Utilisateur cr par le script et auquel les droits de propritaire de la base de donnes sont attribus. Cette valeur est facultative.
sid chemin_accs version_base_de_donnes utilisateur__crer
4. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Si vous avez inclus l'utilisateur facultatif l'tape prcdente, il s'agit du compte que vous utiliserez pour accder la base de donnes. Si vous n'avez pas inclus d'utilisateur, vous devez ajouter un nom d'utilisateur de base de donnes Oracle valide disposant des autorisations suivantes : CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE TRIGGER, CREATE TYPE, CREATE SEQUENCE et CREATE SESSION EXECUTE sur les packs DBMS_LOCK et DBMS_UTILITY.
Procdure pour Oracle si la base de donnes existe

La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs 3. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Vous devez utiliser un nom d'utilisateur de base de donnes Oracle valide disposant des autorisations suivantes : CREATE TABLE, CREATE VIEW, CREATE PROCEDURE, CREATE TRIGGER, CREATE TYPE, CREATE SEQUENCE et CREATE SESSION EXECUTE sur les packs DBMS_LOCK et DBMS_UTILITY.
Procdure pour DB2

1. Dans le rpertoire emplacement_c8/configuration/schemas/cmm/db2, excutez le script cmm_create_db.cmd en saisissant la commande suivante : Sous Windows, saisissez cmm_create_db instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd Sous UNIX, saisissez cmm_create_db.sh instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd Utilisez les valeurs suivantes dans la commande :
Valeur
instance_bd
Paramtre
Nom de l'instance de DB2 sur laquelle la base de donnes sera cre. Code d'utilisateur disposant des autorisations pour crer la base de donnes. Le code d'utilisateur doit disposer des droits d'accs SYSADM ou SYSCTRL, ainsi que des droits d'accs DBADM pour crer le schma. Mot de passe correspondant l'lment nom_utilisateur. Nom de la base de donnes qui sera cre. Le nom doit compter un maximum de 8 caractres et ne peut pas commencer par un chiffre. Sous Windows, lecteur sur lequel les objets de la base de donnes seront crs. Sous UNIX, chemin d'accs aux objets de la base de donnes qui seront crs. Pseudonyme de la base de donnes. Cette valeur est facultative.
nom_utilisateur
mot de passe nom_bd
lecteur/chemin_accs
pseudonyme_bd
188
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Remarque : L'administrateur de base de donnes peut vrifier les scripts pour s'assurer qu'ils conviennent votre environnement. Le script initializedb.db2 est appel par le script cmm_create_db.cmd et dfinit les groupes de mmoire tampon et les espaces de table. 2. Indiquez quel compte utilisateur sera utilis par IBM Cognos 8 Metrics Manager pour accder la base de donnes. Le compte utilisateur doit disposer des droits d'accs suivants : CREATETAB BINDADD CONNECT IMPLICIT_SCHEMA LOAD
Cration d'un pack d'indicateurs

Pour permettre aux utilisateurs de se servir d'IBM Cognos 8 Metrics Manager, vous devez crer au moins un pack d'indicateurs l'aide de l'assistant Nouveau pack d'indicateurs. Un pack d'indicateurs est une reprsentation IBM Cognos Connection d'une application IBM Cognos 8 Metrics Manager. Un pack d'indicateurs contient des informations de connexion, des rapports et des tches de gestion des indicateurs pour cette application. Le contenu des packs d'indicateurs est stock dans une bibliothque d'indicateurs. Ouvrez l'assistant Nouveau pack d'indicateurs depuis la barre d'outils de Cognos Connection et crez un pack l'aide d'une nouvelle connexion la source de donnes vers une bibliothque d'indicateurs d'une connexion existante la source de donnes vers une bibliothque d'indicateurs d'une bibliothque d'indicateurs existante si la base de donnes tait utilise avec une version antrieure d'IBM Cognos 8 Metrics Manager 8.1 ou ultrieure
Il permet de dfinir le nom du pack d'indicateurs et la connexion entre la source de donnes et la bibliothque d'indicateurs. Dans le cas d'une nouvelle bibliothque d'indicateurs, vous fournissez galement les informations ncessaires l'initialisation de la base de donnes, notamment les dates de dbut et de fin de l'exercice fiscal. Si la base de donnes tait utilise avec une version antrieure IBM Cognos 8 Metrics Manager 8.1, vous pouvez mettre niveau la bibliothque d'indicateurs l'aide de l'assistant. Pour pouvoir utiliser l'assistant Nouveau pack d'indicateurs, vous devez disposer de droits d'accs une bibliothque d'indicateurs employe avec Metrics Manager version 2.0 ou ultrieure ou bien crer une base de donnes pour une nouvelle bibliothque d'indicateurs (p. 140).
Procdure d'utilisation d'une nouvelle connexion la source de donnes

1. Dmarrez IBM Cognos Connection.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs 2. Cliquez sur le bouton Nouveau pack d'indicateurs. 3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Cliquez sur l'option Nouvelle source de donnes. 5. Saisissez un nom et une description de la connexion entre la source de donnes et la bibliothque d'indicateurs renfermant le contenu de ce pack d'indicateurs, puis cliquez sur le bouton Suivant. 6. Dans la zone Type, cliquez sur le type de base de donnes. 7. Slectionnez le niveau d'isolement et cliquez sur Suivant. 8. Fournissez les renseignements ncessaires concernant le type de votre base de donnes : Pour une base de donnes Microsoft SQL Server, indiquez le nom du serveur de base de donnes et de la base de donnes elle-mme. Dans la section Codes d'accs, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes Oracle, saisissez la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes DB2, saisissez le nom de la base de donnes et la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Dans la plupart des cas, une squence d'assemblage n'est pas ncessaire. Pour en fournir une, assurez-vous que la valeur que vous saisissez est la mme que la squence d'assemblage indique lors de la cration de la base de donnes. Pour en savoir davantage sur les squences d'assemblage, reportez-vous la documentation de la base de donnes. Conseil : Pour vrifier si les paramtres sont corrects, cliquez sur le bouton Test de la connexion. 9. Slectionnez la nouvelle source de donnes puis cliquez sur Suivant. 10. Cliquez sur Suivant et suivez les instructions vous invitant fournir les informations ncessaires l'initialisation de la base de donnes. Lorsque vous atteignez la page rcapitulant les dtails de la source de donnes et les paramtres de la bibliothque d'indicateurs, cliquez sur l'option Initialiser. 11. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer.
190
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, et notamment sur la mthode de chargement des donnes, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8.
Procdure d'utilisation d'une connexion une source de donnes existante

1. Dmarrez IBM Cognos Connection. 2. Cliquez sur le bouton Nouveau pack d'indicateurs. 3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Slectionnez la Nouvelle source de donnes puis cliquez sur Suivant. 5. Cliquez sur Suivant et suivez les instructions vous invitant fournir les informations ncessaires l'initialisation de la base de donnes. Lorsque vous atteignez la page rcapitulant les dtails de la source de donnes et les paramtres de la bibliothque d'indicateurs, cliquez sur l'option Initialiser. 6. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer. Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, et notamment sur la mthode de chargement des donnes, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8.
Procdure avec une bibliothque d'indicateurs existante

1. Dmarrez IBM Cognos Connection. 2. Cliquez sur le bouton Nouveau pack d'indicateurs. 3. Saisissez le nom et la description reprsentant ce pack d'indicateurs pour l'application IBM Cognos 8 Metrics Manager, puis cliquez sur Suivant. 4. Cliquez sur l'option Nouvelle source de donnes. 5. Saisissez le nom et la description de la connexion la source de donnes correspondant la bibliothque d'indicateurs contenant les donnes de ce pack d'indicateurs, puis cliquez sur Suivant. 6. Dans la zone Type, slectionnez le type de base de donnes, puis cliquez sur Suivant. 7. Fournissez les renseignements ncessaires concernant le type de votre base de donnes : Pour une base de donnes Microsoft SQL Server, indiquez le nom du serveur de base de donnes et de la base de donnes elle-mme. Dans la section Codes d'accs, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Pour une base de donnes Oracle, saisissez la chane de connexion. Dans la section Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous',
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs puis saisissez le code d'utilisateur et le mot de passe du compte utilisateur ayant accs cette base de donnes. Pour une base de donnes DB2, saisissez le nom de la base de donnes et la chane de connexion. Slectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe associs au compte utilisateur ayant accs la base de donnes. Dans la plupart des cas, une squence d'assemblage n'est pas ncessaire. Pour en fournir une, assurez-vous que la valeur que vous saisissez est la mme que la squence d'assemblage indique lors de la cration de la base de donnes. Pour en savoir davantage sur les squences d'assemblage, reportez-vous la documentation de la base de donnes. Conseil : Pour vrifier si les paramtres sont corrects, cliquez sur le bouton Test de la connexion. 8. Cliquez sur Suivant. 9. Slectionnez l'option Ouvrir ce pack dans Metric Studio aprs la fermeture de l'assistant, puis cliquez sur Terminer. Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans IBM Cognos Connection. 10. Slectionnez la nouvelle source de donnes puis cliquez sur Suivant. 11. Cliquez sur l'option Mettre niveau. L'assistant met niveau les schmas et autres informations de la base de donnes. Pour en savoir davantage sur la gestion de la bibliothque d'indicateurs, reportez-vous au Guide d'administration et de scurit.
Dsinstallation d'IBM Cognos 8

Il est important d'utiliser les programmes de dsinstallation afin de supprimer totalement l'ensemble des fichiers et des modifications apportes aux fichiers systme. Pour dsinstaller IBM Cognos 8, vous devez dsinstaller les composants du serveur et les outils de modlisation. Si vous excutez IBM Cognos 8 dans un environnement de serveur d'application, utilisez l'outil d'administration fourni avec le serveur pour arrter l'application si elle est en cours d'excution et annuler le dploiement de la partie Java des composants d'IBM Cognos 8. De nombreux serveurs d'application ne suppriment pas intgralement les rpertoires ou les fichiers d'application dploys lors de l'annulation d'un dploiement ; par consquent, vous devrez peut-tre effectuer cette opration manuellement. Aprs avoir annul le dploiement des composants d'IBM Cognos 8, suivez la procdure dcrite dans le prsent chapitre pour procder la dsinstallation sous UNIX (p. 148) et sous Windows (p. 149).
Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux

Si vous n'avez plus besoin d'IBM Cognos 8 ou si vous procdez une mise niveau, dsinstallez IBM Cognos 8.
192
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Si vous procdez une mise niveau partir d'une version prcdente de ReportNet vers IBM Cognos 8, suivez la procdure de dsinstallation dcrite dans la documentation de l'ancienne version de ReportNet.
Procdure
1. Si la console connecte l'ordinateur ne prend pas en charge les interfaces graphiques utilisateur de type Java, dterminez le PID (numro d'identification de processus) du processus IBM Cognos 8 en saisissant la commande suivante : ps -ef | grep cogbootstrapservice 2. Arrtez le processus IBM Cognos 8 : Si vous utilisez XWindows, dmarrez IBM Cognos Configuration, puis dans le menu Oprations, cliquez sur l'option Arrter. Si vous n'utilisez pas X Windows, saisissez : kill -TERM numro_identification_processus 3. Pour dsinstaller IBM Cognos 8, accdez au rpertoire emplacement_c8/uninstall et saisissez la commande approprie : Si vous utilisez X Windows, saisissez : ./uninst -u Si vous n'utilisez pas X Windows, saisissez : ./uninstcc -u 4. Suivez les invites pour achever la dsinstallation. 5. Supprimez tous les fichiers Internet temporaires. La dsinstallation ne supprime pas tous les fichiers modifis depuis l'installation, tels que les fichiers de configuration et les fichiers de donnes utilisateur. L'emplacement d'installation reste sur l'ordinateur. Tant que vous ne supprimez pas ces fichiers manuellement, ils sont conservs. Important : Ne supprimez pas les fichiers de configuration et de donnes si vous procdez une mise niveau d'IBM Cognos 8 et voulez utiliser les donnes de configuration avec la nouvelle version. Si vous utilisez la base de donnes de contenu d'IBM Cognos, l'emplacement implicite des fichiers de la base de donnes est le rpertoire emplacement_c8/contentstore. Si vous voulez conserver votre base de donnes aprs la dsinstallation, ne supprimez pas ce rpertoire.
Dsinstallation d'IBM Cognos 8 sous Windows

Si vous n'avez plus besoin d'IBM Cognos 8 ou si vous procdez une mise niveau, dsinstallez tous les composants d'IBM Cognos 8 et le service IBM Cognos 8. Si vous avez install plusieurs composants dans le mme emplacement, l'assistant de dsinstallation vous permet de choisir les packs dsinstaller.Tous les composants du pack seront dsinstalls.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Vous devez rpter le processus de dsinstallation sur chaque ordinateur contenant des composants d'IBM Cognos 8. Il n'est pas ncessaire de sauvegarder les fichiers de configuration et de donnes sous Windows. Ces fichiers sont conservs pendant la dsinstallation. Il est recommand de fermer tous les programmes avant de dsinstaller IBM Cognos 8. Dans le cas contraire, il est possible que certains fichiers ne soient pas supprims. La dsinstallation ne supprime pas tous les fichiers modifis depuis l'installation, tels que les fichiers de configuration et les fichiers de donnes utilisateur. L'emplacement d'installation reste sur l'ordinateur. Vous conservez ces fichiers aussi longtemps que vous ne les supprimez pas manuellement l'aide de l'Explorateur Windows. Important : Ne supprimez pas les fichiers de configuration et de donnes si vous procdez une mise niveau d'IBM Cognos 8 et voulez utiliser des donnes de configuration avec la nouvelle version.
Procdure
1. Dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Dsinstaller IBM Cognos 8. L'Assistant de dsinstallation s'affiche. Conseil : IBM Cognos 8 est le nom implicite du dossier de programme cr lors de l'installation. Si vous avez choisi un autre nom, ouvrez ce dossier pour trouver le programme. 2. Suivez les instructions de dsinstallation des composants. Le fichier cognos_uninst_log.htm enregistre les activits effectues par l'Assistant durant la dsinstallation des fichiers. Conseil : Pour trouver le fichier journal, cherchez dans le rpertoire Temp. 3. Supprimez tous les fichiers Internet temporaires. Pour en savoir davantage, reportez-vous la documentation sur le navigateur Web.
Dsinstallation de la base de donnes de contenu d'IBM Cognos

Si vous souhaitez dsinstaller uniquement la base de donnes de contenu d'IBM Cognos et laisser les autres composants IBM Cognos 8 sur votre ordinateur, procdez comme suit : Aprs avoir dsinstall la base de donnes de contenu d'IBM Cognos, vous devez configurer un nouveau Content Store avant de redmarrer le service IBM Cognos 8. Si vous avez install uniquement la base de donnes de contenu d'IBM Cognos, utilisez une autre procdure. Pour en savoir davantage sur cette procdure, reportez-vous la section "Dsinstallation d'IBM Cognos 8 sous UNIX ou Linux" (p. 148) ou "Dsinstallation d'IBM Cognos 8 sous Windows" (p. 149).
Procdure
1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\bin et saisissez la commande suivante :
194
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs Sous Windows, saisissez derby.bat uninstall Cette commande supprime le service de la base de donnes de contenu d'IBM Cognos. Sous UNIX, saisissez derby.sh stop Cette commande arrte le service de la base de donnes de contenu d'IBM Cognos. 2. Dans le rpertoire emplacement_c8, supprimez le rpertoire derby10.1.2.1. 3. Dans le rpertoire emplacement_c8\bin, supprimez les fichiers suivants : Sous Windows, derby.bat Sous UNIX, derby.sh et derbyenv.sh
4. Sous Windows, dans le rpertoire emplacement_c8\logs, supprimez le fichier derby.service. 5. Dans le rpertoire emplacement_c8, ouvrez le fichier cmplst.txt dans un diteur de texte. 6. Supprimez les lignes contenant des valeurs relatives la base de donnes de contenu d'IBM Cognos. Ces lignes contiennent les chanes CCD et CMDERBY. Par exemple :
C8BISRVRCCD_version= C8BISRVRCCD_name= CCD_version= CCD_name= CMDERBY_version= CMDERBY_name=
Conseil : Vous pouvez galement transformer les lignes en commentaires en insrant le caractre # au dbut de ces lignes. 7. Enregistrez le fichier. 8. Dmarrez IBM Cognos Configuration. 9. Sous Accs aux donnes, Content Manager, procdez comme suit : Supprimez la base de donnes de contenu d'IBM Cognos. Configurez une nouvelle ressource de base de donnes afin de pointer vers une nouvelle base de donnes Content Store.
Pour en savoir davantage, reportez-vous la section "Dfinition des proprits de connexion la base de donnes Content Store" (p. 128). 10. Redmarrez IBM Cognos 8.
196
Chapitre 8: Installation des composants d'IBM Cognos 8

Si vous installez IBM Cognos 8 dans un environnement rparti, aprs avoir effectu l'installation et la configuration des composants serveur (p. 153), vous pouvez faire de mme avec les composants client. Utilisez la liste de contrle suivante pour vous guider dans le processus d'installation des composants client d'IBM Cognos 8 : Installation et configuration de Framework Manager Installation et configuration d'IBM Cognos 8 Transformer Installation et configuration des composants de Metric Designer Configuration et dploiement de client d'IBM Cognos 8 Go ! Office
Installation et configuration de Framework Manager

Vous pouvez installer Framework Manager (l'outil de modlisation de mtadonnes d'IBM Cognos 8 pour la cration de rapports) sur le mme ordinateur que celui sur lequel les composants d'IBM Cognos 8 sont installs ou sur un autre ordinateur. Tous les fichiers requis sont copis sur un mme ordinateur. Les paramtres implicites sont utiliss pour la configuration. Vous pouvez modifier ces paramtres implicites s'il y a lieu ou si vous installez Framework Manager sur un ordinateur distinct de celui o figure IBM Cognos 8. Si vous procdez une mise niveau depuis une version prcdente de Framework Manager, vous pouvez utiliser les mmes modles et projets que vous avez utiliss avec la version prcdente. Pour mettre niveau des projets existants, vous devez les ouvrir dans la nouvelle version de Framework Manager. Si vous effectuez une mise niveau de Framework Manager partir d'une version prcdente, vous devez d'abord dsinstaller la version prcdente de Framework Manager (p. 149). Avant d'installer Framework Manager, il est recommand de fermer tous les programmes en cours d'excution pour s'assurer que le programme d'installation copie tous les fichiers requis sur l'ordinateur. Assurez-vous que vous disposez de droits d'administration sur l'ordinateur Windows o vous souhaitez faire l'installation. Si vous n'tes pas administrateur, demandez votre administrateur systme de vous ajouter au groupe Administrateurs sur votre ordinateur. Les droits d'administration sont galement requis pour le compte qui est utilis pour l'excution de Framework Manager. Il est recommand d'installer et de configurer tous les composants du serveur IBM Cognos 8 avant d'installer Framework Manager.
Chapitre 8: Installation des composants d'IBM Cognos 8 Installez les composants dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. L'installation de Framework Manager dans un rpertoire dont le nom de chemin contient une apostrophe peut entraner une ouverture incorrecte de l'aide. Si vous installez l'outil de modlisation dans le mme rpertoire qu'IBM Cognos 8 sans arrter les services IBM Cognos 8, vous tes invit le faire pendant l'installation.
Configuration requise pour Framework Manager

Avant d'installer Framework Manager, assurez-vous que l'ordinateur Windows prsente les configurations matrielles et logicielles requises pour IBM Cognos 8. La taille de vos modles dtermine la configuration matrielle requise, telle que l'espace disque ncessaire. Le tableau ci-dessous rpertorie les configurations matrielle et logicielle minimales requises pour excuter Framework Manager.
Systme d'exploitation RAM
Spcifications
Windows
Minimum : 512 Mo Recommand : 1 Go
Espace disque
Minimum : 500 Mo d'espace libre sur le lecteur contenant le rpertoire temporaire utilis par IBM Cognos 8 Logiciel client de base de donnes install sur le mme ordinateur que Framework Manager (Oracle, DB2 ou Sybase uniquement, Microsoft SQL tant install par dfaut avec IBM Cognos 8) Connectivit aux bases de donnes
Base de donnes
Autre
Microsoft Data Access Component (MDAC), version 2.6 ou ultrieure, utiliser avec les exemples de produits.
Pour installer et configurer Framework Manager, effectuez les oprations suivantes : Installation de Framework Manager Mise jour de l'environnement Java Configuration de l'environnement de sources de donnes pour Framework Manager Configuration des proprits d'environnement pour Framework Manager. Test de l'installation de Framework Manager
198
Chapitre 8: Installation des composants d'IBM Cognos 8 Si vous installez Framework Manager sur un ordinateur autre que celui des composants d'IBM Cognos 8 ne servant pas la modlisation, vous pouvez galement effectuer les oprations suivantes : Configurer un systme de contrle de la source. Mise jour des proprits d'emplacement des fichiers
Paramtres implicites de Framework Manager

Le tableau ci-dessous prsente les paramtres implicites des ports et URI d'IBM Cognos 8 utiliss par Framework Manager. Aprs installation, vous pouvez utiliser l'outil de configuration pour modifier ces lments. Vous pouvez galement les modifier en ditant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8\configuration.
Composant
Passerelle
Implicite
Description
Indique l'URI de la passerelle IBM Cognos 8. Indique l'URI du distributeur. Indique le port utilis par le serveur de journalisation local.
URI du distributeur des http://localhost:9300/p2pd/servlet/dispatch applications externes Port du serveur de journalisation 9362
Installation de Framework Manager

Pour installer Framework Manager, utilisez le CD-ROM IBM Cognos 8 Business Intelligence Modeling. Lorsque vous recevez une invite Slection des composants, installez tous les composants slectionns par dfaut.
Procdure
1. Si vous utilisez une base de donnes Oracle comme source de donnes pour vos rapports, dfinissez la variable d'environnement NLS_LANG en saisissant la commande suivante sur chaque ordinateur o Framework Manager et les composants d'application sont installs : NLS_LANG = language_territory.character_set Par exemple, NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. Si les composants d'application sont installs sur un ordinateur UNIX, la variable NLS_LANG doit tre dfinie pour l'utilisateur qui est propritaire du service IBM Cognos 8 et qui le dmarre.
Chapitre 8: Installation des composants d'IBM Cognos 8 2. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 3. Insrez le CD de Framework Manager. La page Bienvenue de l'Assistant d'installation doit s'afficher. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 4. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 5. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 6. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration. Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi d'IBM Cognos. 7. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.

Les services cryptographiques d'IBM Cognos 8 utilisent un fichier .jar (Java Archive) spcifique, appel bcprov-jdknn-nnn.jar, qui doit se trouver dans votre environnement JRE. Ce fichier fournit des sous-programmes supplmentaires de chiffrement et de dchiffrement qui ne sont pas disponibles dans l'installation implicite du JVM. Pour garantir la scurit, le fichier de chiffrement doit tre charg par l'environnement JVM l'aide du rpertoire d'extensions Java. Si vous souhaitez utiliser votre propre JRE et dfinir la variable JAVA_HOME sur l'emplacement correspondant sous Windows ou si vous effectuez l'installation sous UNIX, vous devrez peut-tre mettre jour l'environnement Java pour les services cryptographiques.
200
Chapitre 8: Installation des composants d'IBM Cognos 8 Sous Windows, vous pouvez dfinir JAVA_HOME en tant que variable systme ou variable utilisateur. Si vous la dfinissez en tant que variable systme, vous devrez probablement redmarrer votre ordinateur pour qu'elle prenne effet. Si vous la dfinissez en tant que variable utilisateur, faites en sorte que l'environnement dans lequel s'excute Tomcat puisse y accder. Si vous ne disposez pas d'une variable JAVA_HOME dj dfinie sous Windows ou si celle-ci pointe vers une version de Java non compatible avec IBM Cognos 8, les fichiers JRE fournis avec l'installation seront utiliss et vous n'aurez pas besoin de mettre jour les fichiers de votre environnement.
Procdure
Configuration des proprits d'environnement pour les ordinateurs Framework Manager

Si vous installez Framework Manager sur un ordinateur autre que celui des composants d'IBM Cognos 8 ne servant pas la modlisation, vous devez le configurer pour qu'il communique avec les autres composants. Il est recommand d'installer et de configurer les composants d'IBM Cognos 8 avant de configurer Framework Manager. Vous devez d'abord installer et configurer Content Manager, puis dmarrer le service IBM Cognos 8 sur au moins un ordinateur Content Manager avant de configurer Framework Manager. Cela garantit que le service d'autorit de certification met un certificat pour l'ordinateur Framework Manager. Important : Si IBM Cognos 8 est install dans plusieurs emplacements, vrifiez que tous les URI pointent vers la version correcte de ce produit. Framework Manager doit tre configur pour la mme version d'IBM Cognos 8.
Installations avec un pare-feu

Lorsque l'outil de modlisation est situ en dehors du pare-feu rseau qui protge les composants d'application, des problmes de communication peuvent se poser au niveau du distributeur. Pour viter ces problmes de communication, vous pouvez installer l'outil de modlisation dans le mme niveau architectural que les composants d'application ou bien installer et configurer une passerelle ddie aux communications de l'outil de modlisation. Pour en savoir davantage sur l'outil de modlisation et les pare-feu rseau, reportez-vous la section "Observations concernant le parefeu" (p. 37). La procdure dcrite dans cette rubrique explique comment configurer l'ordinateur de l'outil de modlisation. Si vous utilisez une passerelle ddie l'outil de modlisation, vous devez aussi configurer l'ordinateur de cette passerelle (p. 174).
Conditions pralables
Vrifiez que le serveur Web est configur et actif (p. 133). Vous devez galement configurer les sources de donnes (p. 137) avant de configurer Framework Manager.
Procdure
1. Sur l'ordinateur o vous avez install Framework Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur l'option Environnement. 3. Dans la zone URI de la passerelle de la fentre Proprits, saisissez la valeur approprie. Pour utiliser ISAPI, remplacez cognos.cgi par cognosisapi.dll. Pour faire appel un serveur Web Apache, utilisez la syntaxe suivante : Pour le module Apache 1,3, http://nom_hte:port/cognos8/cgi-bin/mod_cognos.dll Pour le module Apache 2.0, http://nom_hte:port/cognos8/cgi-bin/mod2_cognos.dll Pour le module Apache 2.2.x, http://nom_hte:port/cognos8/cgi-bin/mod2_2_cognos.dll Remarque : Vrifiez que vous avez configur le serveur Web Apache (p. 350). Pour utiliser une passerelle de servlet, saisissez la syntaxe suivante : http[s]://nom_hte:port/racine_contexte/servlet/Gateway o racine_contexte est la valeur que vous avez attribue l'application Web ServletGateway lors de son dploiement. Remarque : Vrifiez que vous avez configur le serveur Web afin qu'il prenne en charge la passerelle servlet (p. 352). Si vous n'utilisez pas de serveur Web, saisissez la syntaxe suivante pour utiliser le distributeur en tant que passerelle : http[s]://nom_hte:port/p2pd/servlet/dispatch 4. Remplacez la chane de nom d'hte localhost de l'URI de la passerelle par l'adresse IP ou le nom de l'ordinateur. 5. Indiquez la valeur de l'option URI du distributeur pour des applications externes : Si votre serveur Web est configur pour ne pas autoriser l'accs anonyme, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si votre serveur Web prend en charge l'encodage de transfert par bloc et que Framework Manager se trouve l'intrieur du pare-feu, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI.
202
Chapitre 8: Installation des composants d'IBM Cognos 8 Si vous utilisez une passerelle ddie pour les communications de l'outil de modlisation, saisissez l'URI du distributeur.
6. Dans la section Cryptographie de la fentre Explorateur, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 7. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. Framework Manager est configur pour communiquer avec les autres composants d'IBM Cognos 8. Vous pouvez configurer un systme de contrle de la source.
Configuration de l'environnement de sources de donnes pour Framework Manager

Les outils de modlisation d'IBM Cognos 8 permettent de crer et de grer des mtadonnes. Framework Manager cre et gre les mtadonnes associes aux fonctions de cration de rapports. tant donn que les mtadonnes sont drives de sources de donnes d'environnements multilingues ou plusieurs plates-formes, vous devez prendre en compte plusieurs points ou effectuer diffrentes oprations lorsque vous configurez l'environnement de sources de donnes pour Framework Manager. Gnralement, ces oprations dpendent de l'autre technologie utilise pour votre source de donnes ou d'importation. Si vous utilisez une source de donnes Sybase, ces tapes ne sont pas ncessaires. Si vous avez procd une mise niveau partir d'une version antrieure de Framework Manager, aucun lment n'a besoin d'tre configur dans l'environnement de sources de donnes. Vous devez configurer l'environnement de sources de donnes uniquement si vous avez install Framework Manager dans un emplacement diffrent de celui de la version prcdente. Si des utilisateurs travaillant dans diffrentes langues doivent se connecter une source de donnes Microsoft Analysis Services (MSAS) 2000, vous devez crer une instance IBM Cognos 8 spare pour chaque langue. Les utilisateurs qui travaillent avec des langues diffrentes peuvent se connecter une source de donnes MSAS 2005 depuis la mme instance d'IBM Cognos 8. Les modlisateurs doivent crer un pack distinct pour chaque langue. Les utilisateurs peuvent excuter les rapports dans n'importe quelle langue. Pour en savoir davantage sur les connexions aux sources de donnes, reportez-vous au Guide d'administration et de scurit. Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres et des symboles montaires que vous utilisez. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Paramtrez la variable d'environnement pour une prise en charge multilingue :
Chapitre 8: Installation des composants d'IBM Cognos 8 Pour Oracle, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur chaque ordinateur o est install Framework Manager, en saisissant la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. Pour DB2, attribuez la valeur 1252 la variable d'environnement DB2CODEPAGE. Pour en savoir davantage sur l'usage de cette variable d'environnement facultative, reportezvous la documentation sur DB2. Aucun paramtre n'est requis pour SAP BW. SAP prend en charge une seule page de codes sur les systmes SAP BW non-Unicode. 2. Pour Oracle, ajoutez $ORACLE_HOME/lib au chemin d'accs LD_LIBRARY_PATH. Lors de la dfinition des chemins d'accs la bibliothque de chargement, assurez-vous que les bibliothques Oracle 32 bits se trouvent sur le chemin d'accs la bibliothque (gnralement le rpertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle 64 bits). 3. Pour Oracle, copiez le fichier ojdbc14.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Pour Oracle 11 g, copiez le fichier ojdbc5.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar. 4. Pour SAP BW, configurez les objets d'autorisation ci-dessous de faon ce que l'outil de modlisation puisse extraire les mtadonnes. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
S_RFC
Zone
Valeur
204
Zone
Valeur
Nom (identificateur) des com- * posants de cration de rapports
Zone
Valeur
Type des composants de cra- * tion de rapports Propritaire (personne respon- * sable) S_RS_HIER Activit Nom de hirarchie InfoObject Version S_RS_ICUBE Activit Sous-objet d'InfoCube 71 Nom de hirarchie Nom technique InfoObject Version de hirarchie 03 DATA DFINITION InfoArea InfoCube Nom technique InfoArea Nom technique InfoCube
&NC& reprsente toute table n'ayant pas de groupe d'autorisation. Pour plus de scurit, crez un nouveau groupe d'autorisation et attribuez-lui la table RSHIEDIR. Le nouveau groupe d'autorisation empche l'utilisateur d'accder uniquement la table ci-dessus, ncessaire l'outil de modlisation.Crez le nouveau groupe d'autorisation en tant que personnalisation dans le systme SAP. Pour en savoir davantage sur les objets d'autorisation SAP BW, reportez-vous Transaction SU03.
Configuration des proprits d'environnement pour les ordinateurs Framework Manager

Lorsque vous installez Framework Manager sur un ordinateur autre que celui sur lequel les composants d'IBM Cognos 8 ne servant pas la modlisation sont installs, vous devez le configurer pour qu'il communique avec les autres composants. Si vous installez Framework Manager sur le mme ordinateur que les composants d'IBM Cognos 8 ne servant pas la modlisation, aucune configuration n'est ncessaire lorsque vous : configurez votre serveur Web en utilisant les rpertoires virtuels implicites, utilisez les ports implicites,
206
Chapitre 8: Installation des composants d'IBM Cognos 8 utilisez les ressources implicites, utilisez les paramtres cryptographiques implicites.
Important : Si IBM Cognos 8 est install dans plusieurs emplacements, vrifiez que tous les URI pointent vers la version correcte de ce produit. Framework Manager doit tre configur pour la mme version d'IBM Cognos 8.

Assurez-vous que le service IBM Cognos 8 est excut sur au moins un ordinateur Content Manager. Cela garantit que le service d'autorit de certification met un certificat pour l'ordinateur Framework Manager. Vrifiez que le serveur Web est configur et actif (p. 180). Vous devez galement configurer les sources de donnes (p. 203) avant de configurer Framework Manager.
Procdure
1. Sur l'ordinateur o vous avez install Framework Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur l'option Environnement. 3. Dans la zone URI de la passerelle de la fentre Proprits, saisissez la valeur approprie. Pour utiliser ISAPI, remplacez cognos.cgi par cognosisapi.dll. Pour faire appel un serveur Web Apache, utilisez la syntaxe suivante : Pour le module Apache 1,3, http://nom_hte:port/cognos8/cgi-bin/mod_cognos.dll Pour le module Apache 2.0, http://nom_hte:port/cognos8/cgi-bin/mod2_cognos.dll Pour le module Apache 2.2.x, http://nom_hte:port/cognos8/cgi-bin/mod2_2_cognos.dll
Chapitre 8: Installation des composants d'IBM Cognos 8 Remarque : Vrifiez que vous avez configur le serveur Web Apache (p. 350). Pour utiliser une passerelle de servlet, saisissez la syntaxe suivante : http[s]://nom_hte:port/racine_contexte/servlet/Gateway o racine_contexte est la valeur que vous avez attribue l'application Web ServletGateway lors de son dploiement. Remarque : Vrifiez que vous avez configur le serveur Web afin qu'il prenne en charge la passerelle servlet (p. 352). Si vous n'utilisez pas de serveur Web, saisissez la syntaxe suivante pour utiliser le distributeur en tant que passerelle : http[s]://nom_hte:port/p2pd/servlet/dispatch 4. Remplacez la chane de nom d'hte localhost de l'URI de la passerelle par l'adresse IP ou le nom de l'ordinateur. 5. Indiquez la valeur de l'option URI du distributeur pour des applications externes : Si votre serveur Web est configur pour ne pas autoriser l'accs anonyme, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si votre serveur Web prend en charge l'encodage de transfert par bloc et que Framework Manager se trouve l'intrieur du pare-feu, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si vous utilisez une passerelle ddie pour les communications de l'outil de modlisation, saisissez l'URI du distributeur.
6. Dans la section Cryptographie de la fentre Explorateur, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 7. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. Framework Manager est configur pour communiquer avec les autres composants d'IBM Cognos 8. Si vous avez install Framework Manager sur un ordinateur Windows Vista, vous pouvez y mettre jour les proprits d'emplacement des fichiers (p. 355).

Pour tester votre configuration, dmarrez l'application et crez un projet.
Procdure
Pour dmarrer Framework Manager, dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Framework Manager.
208
Chapitre 8: Installation des composants d'IBM Cognos 8 Si la version du schma de modle est antrieure celle actuellement prise en charge, vous serez probablement invit effectuer une mise niveau. Si la page Bienvenue de Framework Manager s'affiche, cela signifie que l'installation fonctionne.
Installation et configuration d'IBM Cognos 8 Transformer

Vous pouvez installer IBM Cognos 8 Transformer, outil de modlisation de mtadonnes permettant de crer des cubes utilisables avec IBM Cognos 8, sur le mme ordinateur que les autres composants d'IBM Cognos 8 ou sur un autre ordinateur. IBM Cognos 8 Transformer peut tre install sur le mme ordinateur qu'IBM Cognos Series 7 Transformer. Transformer peut dsormais tre mis plus facilement la disposition des spcialistes mtier qui souhaitent concevoir des modles et crer des cubes pour leur usage personnel. Ainsi, les dpartements informatiques peuvent fournir aux spcialistes mtier ou aux modlisateurs Transformer un programme d'installation Web tlchargeable partir d'un portail professionnel ou scuris, de faon faciliter la distribution des fichiers d'installation. Pour en savoir davantage, reportez-vous aux sections "Cration d'un emplacement d'installation rseau pour les modlisateurs Transformer" (p. 360) et "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362). Les paramtres implicites sont utiliss pour la configuration. Vous pouvez modifier ces paramtres implicites s'il y a lieu ou si vous installez IBM Cognos 8 Transformer sur un ordinateur distinct de celui o figure IBM Cognos 8. Si vous prvoyez d'utiliser des cubes scuriss partir d'un espace-noms IBM Cognos Series 7, Content Manager doit tre install sur un ordinateur prenant en charge IBM Cognos Series 7. Pour installer et configurer IBM Cognos 8 Transformer, effectuez les oprations suivantes : Installation d'IBM Cognos 8 Transformer Vrification des paramtres implicites Configuration d'IBM Cognos 8 Transformer Configuration de l'environnement de sources de donnes pour Transformer Test de l'installation d'IBM Cognos 8 Transformer
Installation d'IBM Cognos 8 Transformer

Vous installez Transformer si vous prvoyez de crer PowerCubes pour l'utiliser avec IBM Cognos 8. La langue que vous slectionnez dans l'Assistant d'installation dtermine celle de l'interface utilisateur. Seule cette langue est installe. Vous ne pouvez pas modifier les proprits de langue aprs l'installation. Pour changer la langue de l'interface utilisateur, vous devez rinstaller IBM Cognos 8 Transformer. Pour effectuer une installation UNIX ou Linux complte d'IBM Cognos 8 Transformer, vous devez installer les composants client sur un ordinateur Windows et les composants serveur sur des ordinateurs UNIX ou Linux. Le client IBM Cognos 8 Transformer fournit une interface graphique utilisateur exploitable sur des ordinateurs Windows. Vous pouvez ensuite crer des cubes sur votre ordinateur UNIX ou Linux. Sous Linux, les modles doivent contenir une requte de pack IBM Guide d'installation et de configuration 209
Chapitre 8: Installation des composants d'IBM Cognos 8 Cognos 8 en tant que source de donnes. Les modles contenant une source de donnes IBM Cognos Series 7 ne sont pas pris en charge sous Linux. Installez les composants dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Avant d'installer IBM Cognos 8 Transformer, il est recommand de fermer tous les programmes en cours d'excution pour s'assurer que le programme d'installation copie tous les fichiers requis sur l'ordinateur. Dans le cas d'une installation sous Windows, assurez-vous que vous disposez de droits d'administration sur l'ordinateur Windows o vous effectuez l'installation. Si vous n'tes pas administrateur, demandez votre administrateur systme de vous ajouter au groupe Administrateurs sur votre ordinateur. Remarque : Lorsque Transformer 8,4 est install sous Windows Vista, si vous ne disposez pas de droits d'administrateur sur l'ordinateur et effectuez des modifications dans le fichier cogtr.xml, le fichier mis jour est enregistr par dfaut dans un rpertoire de type Magasin virtuel, et non dans le rpertoire emplacement_c8/configuration. Vous devez installer et configurer tous les composants du serveur IBM Cognos 8 avant d'installer IBM Cognos 8 Transformer.
Configuration requise pour IBM Cognos 8 Transformer

Avant d'installer IBM Cognos 8 Transformer, vrifiez que l'ordinateur dispose des configurations matrielle et logicielle requises pour IBM Cognos 8. La taille de vos cubes dtermine la configuration matrielle requise, telle que l'espace disque ncessaire. Le tableau ci-dessous prsente les configurations matrielle et logicielle minimales requises pour excuter IBM Cognos 8 Transformer.
Spcifications
Systme d'exploitation Windows UNIX : Sun Solaris, HP-UX, IBM AIX Linux RAM Minimum : 512 Mo Recommand : 1 Go Espace disque Minimum : 500 Mo d'espace libre sur le lecteur contenant le rpertoire temporaire utilis par IBM Cognos 8 Logiciel client de base de donnes install sur le mme ordinateur qu'IBM Cognos 8 Transformer Connectivit aux bases de donnes
Source de donnes
210
Autre
Spcifications
Microsoft Data Access Component (MDAC), version 2.6 ou ultrieure, utiliser avec les exemples de produits.
Procdure pour UNIX ou Linux

1. Insrez le CD d'IBM Cognos 8 Transformer dans l'ordinateur UNIX ou Linux. 2. Pour dmarrer l'installation, saisissez ./issetup 3. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Conseil : Le composant Series 7 IQD Bridge n'est pas pris en charge sous Linux et HP-UX Itanium. 4. Slectionnez la faon dont vous souhaitez poursuivre la procdure sur la page Terminer de l'Assistant d'installation : Il est dconseill de configurer IBM Cognos 8 Transformer immdiatement, car il convient d'abord d'effectuer d'autres tches pour s'assurer que l'environnement est correctement configur. Toutefois, si vous souhaitez commencer la configuration immdiatement et que la console connecte l'ordinateur prend en charge les interfaces graphiques utilisateur de type Java, vous pouvez cliquer sur l'option Dmarrer IBM Cognos Configuration Si vous voulez prendre connaissance des informations de dernire minute sur IBM Cognos 8 Transformer, slectionnez Affichage du fichier Lisezmoi, puis cliquez sur Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q. Si la console connecte l'ordinateur ne prend pas en charge les interfaces graphiques utilisateur de type Java ou si vous souhaitez configurer IBM Cognos 8 Transformer ultrieurement, cliquez sur le bouton Terminer. Vous pourrez configurer IBM Cognos 8 Transformer ultrieurement l'aide d'IBM Cognos Configuration en lanant la commande cogconfig.sh dans le rpertoire emplacement_c8/bin ou en modifiant le fichier cogstartup.xml dans le rpertoire emplacement_c8/configuration. 5. Crez une variable d'environnement MANPATH et configurez-la pour qu'elle pointe vers le fichier cogtr.1 du rpertoire emplacement_c8/webcontent/documentation/en. Le fichier cogtr.1 fournit la syntaxe des options de ligne de commande UNIX qui sont prises en charge par IBM Cognos 8 Transformer. Vous pouvez accder la page de manuel correspondante sous UNIX en tapant man.
Chapitre 8: Installation des composants d'IBM Cognos 8 Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.

1. Insrez le CD du produit de modlisation IBM Cognos 8 Transformer. La page Bienvenue de l'Assistant d'installation doit s'afficher. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 2. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous ne pouvez pas changer la langue aprs l'installation car seule la langue slectionne est installe. 3. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Si vous installez IBM Cognos 8 sur un ordinateur o ReportNet est dj install et que vous souhaitez continuer excuter ce dernier, vous devez installer IBM Cognos 8 dans un autre rpertoire. Si vous effectuez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, le systme vous demande de prciser l'emplacement d'un rpertoire dans lequel seront stockes les copies de sauvegarde des fichiers remplacs. 4. Sur la page Terminer de l'Assistant d'installation, si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration. Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi d'IBM Cognos. 5. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.
Paramtres implicites d'IBM Cognos 8 Transformer

Le tableau ci-dessous prsente les paramtres implicites des ports et URI d'IBM Cognos 8 qui sont utiliss par IBM Cognos 8 Transformer. Aprs installation, vous pouvez utiliser l'outil de configuration pour modifier ces lments. Vous pouvez galement les modifier en ditant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8\configuration.
212
Composant
Passerelle
Implicite
Description
Indique l'URI de la passerelle IBM Cognos 8. Indique l'URI du distributeur.
URI du distributeur des http://localhost:9300/p2pd/servlet/dispatch applications externes
Configuration des ordinateurs IBM Cognos 8 Transformer

Vous devez configurer IBM Cognos 8 Transformer pour qu'il communique avec les autres composants d'IBM Cognos 8. Les instructions de cette rubrique sont destines l'installateur ou l'administrateur. Si vous tes un spcialiste mtier ou un modlisateur Transformer et que vous souhaitez tlcharger et utiliser Transformer, reportez-vous la section "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362). Si vous installez IBM Cognos 8 Transformer sur le mme ordinateur que les composants d'IBM Cognos 8 ne servant pas la modlisation, aucune configuration n'est ncessaire lorsque vous : configurez votre serveur Web en utilisant les rpertoires virtuels implicites, utilisez les ports implicites, utilisez les ressources implicites, utilisez les paramtres cryptographiques implicites.
Vous avez la possibilit de mettre niveau des modles des versions Series 7.x de Transformer si vous les avez enregistrs sous forme de fichiers MDL. Vous pouvez continuer utiliser des cubes crs avec Series 7.3 et des versions ultrieures de Transformer dans IBM Cognos 8. Toutefois, pour employer des fournisseurs d'authentification IBM Cognos 8, vous devez mettre niveau les cubes. Pour mettre niveau des cubes vers IBM Cognos 8, vous devez : ouvrir le fichier MDL du modle Series 7.x Transformer dans IBM Cognos 8 Transformer, crer nouveau le cube dans IBM Cognos 8 Transformer.
Pour en savoir davantage sur la mise niveau des cubes Series 7, reportez-vous la section "Mise niveau des modles et des cubes Transformer" (p. 116). Important : Si IBM Cognos 8 est install dans plusieurs emplacements, vrifiez que tous les URI pointent vers la version correcte de ce produit. Transformer doit tre configur pour la mme version d'IBM Cognos 8.

Lorsque l'outil de modlisation est situ en dehors du pare-feu rseau qui protge les composants d'application, des problmes de communication peuvent se poser au niveau du distributeur. Pour viter ces problmes de communication, vous pouvez installer l'outil de modlisation dans le mme Guide d'installation et de configuration 213
Chapitre 8: Installation des composants d'IBM Cognos 8 niveau architectural que les composants d'application ou bien installer et configurer une passerelle ddie aux communications de l'outil de modlisation. Pour en savoir davantage sur l'outil de modlisation et les pare-feu rseau, reportez-vous la section "Observations concernant le parefeu" (p. 40). La procdure dcrite dans cette rubrique explique comment configurer l'ordinateur de l'outil de modlisation. Si vous utilisez une passerelle ddie l'outil de modlisation, vous devez aussi configurer l'ordinateur de cette passerelle (p. 174).
Il est recommand d'installer et de configurer les composants d'IBM Cognos 8 avant de configurer IBM Cognos 8 Transformer. Vous devez d'abord installer et configurer Content Manager, puis dmarrer le service IBM Cognos 8 sur au moins un ordinateur Content Manager avant de configurer IBM Cognos 8 Transformer. Cela garantit que le service d'autorit de certification met un certificat pour l'ordinateur IBM Cognos 8 Transformer. Vrifiez que le serveur Web est configur et actif (p. 133). Pour prendre en charge l'utilisation de sources de donnes IBM Cognos 8 (y compris les packs et rapports) dans Transformer, veillez ce que le client de base de donnes soit install sur l'ordinateur Transformer (p. 69).
Procdure
1. Sur l'ordinateur o vous avez install IBM Cognos 8 Transformer, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur l'option Environnement. 3. Dans la zone URI de la passerelle de la fentre Proprits, saisissez la valeur approprie. Pour utiliser ISAPI, remplacez cognos.cgi par cognosisapi.dll. Pour faire appel un serveur Web Apache, utilisez la syntaxe suivante : Pour le module Apache 1,3, http://nom_hte:port/cognos8/cgi-bin/mod_cognos.dll Pour le module Apache 2.0, http://nom_hte:port/cognos8/cgi-bin/mod2_cognos.dll Pour le module Apache 2.2.x, http://nom_hte:port/cognos8/cgi-bin/mod2_2_cognos.dll Remarque : Vrifiez que vous avez configur le serveur Web Apache (p. 350). Pour utiliser une passerelle de servlet, saisissez la syntaxe suivante : http[s]://nom_hte:port/racine_contexte/servlet/Gateway o racine_contexte est la valeur que vous avez attribue l'application Web ServletGateway lors de son dploiement.
214
Chapitre 8: Installation des composants d'IBM Cognos 8 Remarque : Vrifiez que vous avez configur le serveur Web afin qu'il prenne en charge la passerelle servlet (p. 352). Si vous n'utilisez pas de serveur Web, saisissez la syntaxe suivante pour utiliser le distributeur en tant que passerelle : http[s]://nom_hte:port/p2pd/servlet/dispatch 4. Remplacez la chane de nom d'hte localhost de l'URI de la passerelle par l'adresse IP ou le nom de l'ordinateur. 5. Indiquez la valeur de l'option URI du distributeur pour des applications externes : Si votre serveur Web est configur pour ne pas autoriser l'accs anonyme, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si votre serveur Web prend en charge l'encodage de transfert par bloc et qu'IBM Cognos 8 Transformer se trouve l'intrieur du pare-feu, saisissez l'URI du distributeur en veillant modifier le nom d'hte localhost dans l'URI. Si vous utilisez une passerelle ddie pour les communications de l'outil de modlisation, saisissez l'URI du distributeur.
6. Dans la section Cryptographie de la fentre Explorateur, cliquez sur l'option IBM Cognos, fournisseur cryptographique implicite. 7. Dans le groupe de proprits Paramtres de l'autorit de certification, dfinissez la proprit Mot de passe de telle sorte qu'elle corresponde celle configure sur l'ordinateur Content Manager actif par dfaut. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. IBM Cognos 8 Transformer est configur pour communiquer avec les autres composants d'IBM Cognos 8. 9. Si vous avez install Transformer sur un ordinateur Windows Vista ou si un composant IBM Cognos 8 BI est install sur un ordinateur Windows Vista, mettez jour les proprits d'emplacements des fichiers : Connectez-vous en tant qu'administrateur. Dans le rpertoire emplacement_c8\configuration, ouvrez le fichier cogtr.xml.sample dans un diteur de texte. Recherchez toutes les valeurs utilisant un chemin relatif, tel que ..\rpertoire . Remplacez l'lment de chemin relatif .. par la variable d'environnement et le rpertoire racine que vous utilisez pour les emplacements de fichiers sur les autres ordinateurs IBM Cognos 8. Enregistrez le fichier sous le nom cogtr.xml. Dans le rpertoire emplacement_c8\CS7Gateways\bin, ouvrez le fichier cs7g.ini dans un diteur de texte.
Chapitre 8: Installation des composants d'IBM Cognos 8 Ajoutez les emplacements de vos sources de donnes IBM Cognos Series 7 dans le fichier. Enregistrez le fichier.
Les modifications sont appliques la prochaine ouverture de Transformer.
Configuration de l'environnement de sources de donnes pour Transformer

Les outils de modlisation d'IBM Cognos 8 permettent de crer et de grer des mtadonnes. IBM Cognos 8 Transformer cre et gre les mtadonnes associes aux cubes. tant donn que les mtadonnes sont drives de sources de donnes d'environnements multilingues ou plusieurs plates-formes, vous devez prendre en compte plusieurs points ou effectuer diffrentes oprations lorsque vous configurez l'environnement de sources de donnes pour IBM Cognos 8 Transformer. Gnralement, ces oprations dpendent de l'autre technologie utilise pour votre source de donnes ou d'importation. Si vous utilisez une source de donnes Sybase, ces tapes ne sont pas ncessaires. Si des utilisateurs travaillant dans diffrentes langues doivent se connecter une source de donnes Microsoft Analysis Services (MSAS) 2000, vous devez crer une instance IBM Cognos 8 spare pour chaque langue. Les utilisateurs qui travaillent avec des langues diffrentes peuvent se connecter une source de donnes MSAS 2005 depuis la mme instance d'IBM Cognos 8. Les modlisateurs doivent crer un pack distinct pour chaque langue. Les utilisateurs peuvent excuter les rapports dans n'importe quelle langue. Pour en savoir davantage sur les connexions aux sources de donnes, reportez-vous au Guide d'administration et de scurit. Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres et des symboles montaires que vous utilisez. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Paramtrez la variable d'environnement pour une prise en charge multilingue : Pour Oracle, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur chaque ordinateur sur lequel Framework Manager ou Metric Designer et le serveur IBM Cognos 8 sont installs, l'aide de la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux.
216
Chapitre 8: Installation des composants d'IBM Cognos 8 Pour DB2, attribuez la valeur 1252 la variable d'environnement DB2CODEPAGE. Pour en savoir davantage sur l'usage de cette variable d'environnement facultative, reportezvous la documentation sur DB2. Aucun paramtre n'est requis pour SAP BW. SAP prend en charge une seule page de codes sur les systmes SAP BW non-Unicode. 2. Pour Oracle, ajoutez $ORACLE_HOME/lib au chemin d'accs LD_LIBRARY_PATH. Lors de la dfinition des chemins d'accs la bibliothque de chargement, assurez-vous que les bibliothques Oracle 32 bits se trouvent sur le chemin d'accs la bibliothque (gnralement le rpertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle 64 bits). 3. Pour Oracle, copiez le fichier ojdbc14.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Pour Oracle 11g, copiez le fichier ojdbc5.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar. 4. Pour SAP BW, configurez les objets d'autorisation ci-dessous de faon ce que l'outil de modlisation puisse extraire les mtadonnes. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
S_RFC
Zone
Valeur
Type d'objet RFC protger FUGR
S_TABU_DIS
Zone
Valeur
Activit Groupes d'autorisation
03 &NC& 03, 05 *
S_USER_GRP
Activit Groupe d'utilisateurs pour maintenance principale des utilisateurs
S_RS_COMP
Activit InfoArea InfoCube
Nom (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports Propritaire (personne respon- * sable) S_RS_HIER Activit Nom de hirarchie InfoObject Version 71 Nom de hirarchie Nom technique InfoObject Version de hirarchie
218
S_RS_ICUBE
Zone
Valeur
Activit Sous-objet d'InfoCube
03 DATA DFINITION
InfoArea InfoCube
Nom technique InfoArea Nom technique InfoCube

Procdure pour IBM Cognos 8 Transformer

Pour dmarrer IBM Cognos 8 Transformer, dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Transformer. Pour dmarrer manuellement IBM Cognos 8 Transformer, cliquez deux fois sur le fichier suivant dans le rpertoire emplacement_c8\bin : Pour Windows, cogtr.exe Pour UNIX ou Linux, cogtr.sh
Si la fentre Transformer s'affiche, votre installation fonctionne.
Installation et configuration de Metric Designer

Vous pouvez installer Metric Designer, l'outil de modlisation de mtadonnes d'IBM Cognos 8 Metrics Manager, sur le mme ordinateur ou sur un ordinateur diffrent de celui sur lequel sont installs les composants d'IBM Cognos 8. Tous les fichiers requis sont copis sur un mme ordinateur. Les paramtres implicites sont utiliss pour la configuration. Toutefois, vous pouvez les modifier si les conditions rendent les choix implicites inadquats ou si vous avez install IBM Cognos 8 sur un autre ordinateur.
Chapitre 8: Installation des composants d'IBM Cognos 8 Avant d'installer Metric Designer, il est recommand de fermer tous les programmes en cours d'excution pour s'assurer que le programme d'installation copie tous les fichiers requis sur l'ordinateur. Assurez-vous que vous disposez de droits d'administration sur l'ordinateur Windows o vous souhaitez faire l'installation. Si vous n'tes pas administrateur, demandez votre administrateur systme de vous ajouter au groupe Administrateurs sur votre ordinateur. Il est recommand d'installer et de configurer tous les composants du serveur IBM Cognos 8 avant d'installer Metric Designer. Si vous installez l'outil de modlisation dans le mme rpertoire qu'IBM Cognos 8 sans arrter les services IBM Cognos 8, vous tes invit le faire pendant l'installation. Installez les composants dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires. Il est galement conseill d'installer et de configurer l'application cible sur laquelle vous chargerez les donnes et mtadonnes.
Configuration requise pour Metric Designer

Avant d'installer Metric Designer, assurez-vous que l'ordinateur Windows dispose des configurations matrielle et logicielle requises pour IBM Cognos 8. La taille de vos modles dtermine la configuration matrielle requise, telle que l'espace disque ncessaire. Le tableau ci-dessous prsente les configurations matrielles et logicielles minimales requises pour excuter Metric Designer.
Spcifications
Windows (interface et moteur de conception) UNIX (moteur uniquement) : Sun Solaris HP-UX IBM AIX
RAM
Minimum : 512 Mo Recommand : 1 Go
Espace disque
Minimum : 500 Mo d'espace libre sur le lecteur contenant le rpertoire temporaire Microsoft Data Access Component (MDAC), version 2.6 ou ultrieure, utiliser avec les exemples de produits.
Autre
Si vous avez procd une mise niveau depuis Metrics Manager 2.0 ou une version ultrieure, vous pouvez utiliser les mmes extraits et projets que vous avez utiliss avec la version prcdente. Pour mettre niveau des projets existants, vous devez les ouvrir dans la nouvelle version de Metric Designer et redfinir les connexions aux sources de donnes et les autres rfrences.
220
Chapitre 8: Installation des composants d'IBM Cognos 8 Avant de procder la configuration de Metric Designer, les autres composants d'IBM Cognos 8 doivent tre installs et configurs, et Metric Designer doit tre install. Pour installer et configurer Metric Designer, effectuez les oprations suivantes : Installation des composants de Metric Designer Configuration des proprits d'environnement pour Metric Designer Configuration de l'environnement de sources d'importation pour Metric Designer Test de l'installation de Metric Designer
Paramtres implicites de Metric Designer

Le tableau ci-dessous prsente les paramtres implicites des ports et URI utiliss par Metric Designer. Aprs installation, vous pouvez utiliser IBM Cognos Configuration pour modifier ces paramtres. Vous pouvez galement les modifier en ditant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8\configuration.
Composant
Passerelle
Implicite
Description
Indique l'URI de la passerelle. Indique l'URI du distributeur.
URI du distributeur des applications externes
Installation de Metric Designer

Suivez la procdure ci-dessous pour installer Metric Designer.
Procdure
1. Si vous procdez l'installation dans un rpertoire contenant d'autres composants d'IBM Cognos 8, arrtez le service IBM Cognos 8. 2. Insrez le CD de Metric Designer. La page Bienvenue de l'Assistant d'installation doit s'afficher. Si la page Bienvenue ne s'affiche pas, dans le rpertoire win32 du CD, cliquez deux fois sur le fichier issetup.exe. 3. Slectionnez la langue utiliser pour excuter lAssistant d'installation. 4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. 5. Sur la page Terminer de l'Assistant d'installation, procdez comme suit :
Chapitre 8: Installation des composants d'IBM Cognos 8 si vous souhaitez configurer les composants d'IBM Cognos immdiatement, cliquez sur l'option Dmarrer IBM Cognos Configuration, Si vous voulez prendre connaissance des informations les plus rcentes sur les composants d'IBM Cognos, cliquez sur l'option Afficher le fichier Lisezmoi. 6. Cliquez sur le bouton Terminer. Utilisez le menu Dmarrer de Windows pour dmarrer IBM Cognos Configuration depuis le dossier des raccourcis. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, il est important de protger le rpertoire d'installation contre tout accs non autoris ou inappropri.
Configuration des proprits d'environnement des ordinateurs Metric Designer

Si vous installez Metric Designer sur un ordinateur diffrent de celui des autres composants d'IBM Cognos 8, vous devez le configurer pour qu'il communique avec les ordinateurs o la passerelle et Content Manager sont installs. Il est recommand d'installer et de configurer les composants d'IBM Cognos 8 avant de configurer Metric Designer. Vous devez d'abord installer et configurer Content Manager, puis dmarrer le service IBM Cognos 8 sur au moins un ordinateur Content Manager avant de configurer Metric Designer. Cela garantit que le service d'autorit de certification met un certificat pour l'ordinateur Metric Designer. Avant de configurer Metric Designer, vrifiez que le serveur Web est configur et en cours d'excution et que le service IBM Cognos 8 fonctionne. Si vous utilisez un serveur Web Apache, assurez-vous d'abord qu'il est configur (p. 350).

Procdure
1. Sur l'ordinateur o vous avez install Metric Designer, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur l'option Environnement. 3. Dans la zone URI de la passerelle de la fentre Proprits, saisissez la valeur approprie :
222
Chapitre 8: Installation des composants d'IBM Cognos 8 Remplacez la chane de nom d'hte localhost de l'URI de la passerelle par l'adresse IP ou le nom de l'ordinateur. Pour utiliser ISAPI, remplacez cognos.cgi par cognosisapi.dll. Pour utiliser apache_mod, saisissez la syntaxe suivante : http://nom_hte:port/cognos8/cgi-bin/module o module correspond :
Systme d'exploi- Module tation Apache 1,3

Windows Solaris, AIX HP-UX PA-RISC HP-UX IA, Linux mod_cognos.dll mod_cognos.so mod_cognos.sl (non pris en charge)
Module Apache 2.0 Module Apache 2,2
mod2_cognos.dll mod2_cognos.so mod2_cognos.sl mod2_cognos.s0
mod2_2_cognos.dll mod2_2_cognos.so mod2_2_cognos.sl mod2_2_cognos.so
4. Indiquez la valeur de l'option URI du distributeur pour des applications externes : Si votre serveur Web est configur pour ne pas autoriser l'accs anonyme, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si votre serveur Web prend en charge l'encodage de transfert par bloc et que Metric Designer se trouve l'intrieur du pare-feu, saisissez l'URI du distributeur, en veillant modifier le nom d'hte localhost dans l'URI. Si vous utilisez une passerelle ddie pour les communications de l'outil de modlisation, saisissez l'URI du distributeur.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer. Metric Designer est configur pour communiquer avec les autres composants d'IBM Cognos 8.
Configuration de l'environnement de sources d'importation pour Metric Designer

Les outils de modlisation d'IBM Cognos 8 permettent de crer et de grer des mtadonnes. Metric Designer cre et gre les mtadonnes requises pour les fonctions de cration de tableaux de bord. tant donn que les mtadonnes sont drives de sources de donnes d'environnements multilingues ou plusieurs plates-formes, vous devez prendre en compte plusieurs points ou effectuer diffrentes oprations lorsque vous configurez l'environnement de sources d'importation pour Metric Designer. Gnralement, ces oprations dpendent de l'autre technologie utilise pour votre source de donnes ou d'importation. Si vous utilisez une source de donnes Sybase, ces tapes ne sont pas ncessaires. Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres et des symboles montaires que vous utilisez. Pour en savoir davantage sur l'installation de packs Guide d'installation et de configuration 223
Chapitre 8: Installation des composants d'IBM Cognos 8 linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Paramtrez la variable d'environnement pour une prise en charge multilingue : Pour Oracle, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) sur chaque ordinateur sur lequel Framework Manager ou Metric Designer et le serveur IBM Cognos 8 sont installs, l'aide de la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples : NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux. Pour DB2, attribuez la valeur 1252 la variable d'environnement DB2CODEPAGE. Pour en savoir davantage sur l'usage de cette variable d'environnement facultative, reportezvous la documentation sur DB2. Aucun paramtre n'est requis pour SAP BW. SAP prend en charge une seule page de codes sur les systmes SAP BW non-Unicode. 2. Pour Oracle, ajoutez $ORACLE_HOME/lib au chemin d'accs LD_LIBRARY_PATH. Lors de la dfinition des chemins d'accs la bibliothque de chargement, assurez-vous que les bibliothques Oracle 32 bits se trouvent sur le chemin d'accs la bibliothque (gnralement le rpertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle 64 bits). 3. Pour Oracle, copiez le fichier ojdbc14.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Pour Oracle 11g, copiez le fichier ojdbc5.jar situ dans l'emplacement ORACLE_HOME/jdbc/lib dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar. 4. Pour SAP BW, configurez les objets d'autorisation ci-dessous de faon ce que l'outil de modlisation puisse extraire les mtadonnes. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
224
S_RFC
Zone
Valeur
Zone
Valeur
Nom (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports Propritaire (personne respon- * sable) S_RS_HIER Activit Nom de hirarchie InfoObject Version S_RS_ICUBE Activit Sous-objet d'InfoCube 71 Nom de hirarchie Nom technique InfoObject Version de hirarchie 03 DATA DFINITION InfoArea InfoCube Nom technique InfoArea Nom technique InfoCube
Procdure pour Oracle sur l'ordinateur des composants d'application

Pour Oracle, sur l'ordinateur sur lequel sont installs les composants d'application, dfinissez la variable d'environnement NLS_LANG (prise en charge de la langue nationale) en saisissant la commande suivante : NLS_LANG = language_territory.character_set Quelques exemples :
226
Chapitre 8: Installation des composants d'IBM Cognos 8 NLS_LANG = AMERICAN_AMERICA.UTF8 NLS_LANG = JAPANESE_JAPAN.UTF8 La valeur de la variable dtermine le comportement d'IBM Cognos 8 par rapport aux paramtres rgionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les donnes numriques et les conventions de calendrier peuvent en effet s'adapter automatiquement la langue et aux paramtres rgionaux.

Procdure pour Metric Designer

Pour dmarrer Metric Designer, dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Metric Designer. Si la page d'accueil de Metric Designer s'affiche, cela signifie que l'installation fonctionne.
Configuration et dploiement de client d'IBM Cognos 8 Go ! Office

IBM Cognos 8 Go ! Office est disponible avec tous les produits IBM Cognos 8, l'exception d'IBM Cognos 8 Metrics Manager. Pour configurer et dployer IBM Cognos 8 Go ! Office, vous pouvez mettre les fichiers client la disposition des utilisateurs pour qu'ils l'installent ou installer le client sur les ordinateurs des utilisateurs, en fonction de l'environnement. Pour dployer IBM Cognos 8 Go ! Office avec PowerPlay, vous pouvez configurer les mises en correspondance des passerelles de faon ce que les utilisateurs d'IBM Cognos 8 Go ! Office puissent accder aux rapports PowerPlay figurant sur un serveur PowerPlay. Vous pouvez galement configurer la taille des rapports pouvant tre imports dans IBM Cognos 8 Go ! Office depuis IBM Cognos 8. Pour en savoir davantage sur les mises en correspondance de passerelles, reportez-vous au Guide d'administration et de scurit. Utilisez la liste de contrle suivante pour configurer IBM Cognos 8 Go ! Office : Copie des fichiers IBM Cognos 8 Go! Office sur le rseau local en vue du dploiement, s'il y a lieu. Activation du support SSL (Secure Socket Layer), s'il y a lieu. Dsactivation de l'accs anonyme, s'il y a lieu. Dploiement d'IBM Cognos 8 Go ! Office dans les environnements clients.
Copie des fichiers client d'IBM Cognos 8 Go! Office dans un emplacement rseau central
Avant que les utilisateurs puissent dployer IBM Cognos 8 Go! Office sur leur ordinateur, ils doivent accder aux fichiers d'installation. Vous pouvez donner aux utilisateurs le CD d'installation inclus avec IBM Cognos 8 PowerPlay ou bien copier les fichiers du CD vers un emplacement central sur le rseau local ou le site Web.
Procdure
Copier les composants suivants du CD d'IBM Cognos 8 Go ! Office vers l'emplacement du rseau local : Dossier KB908002 Fichier setup.exe Fichier CognosOfficeSetup.msi
Les utilisateurs peuvent alors excuter le fichier setup.exe depuis l'emplacement rseau, afin de dployer IBM Cognos 8 Go! Office.
Activation du support SSL pour l'interface HTTPS de PowerPlay

Si votre environnement contient IBM Cognos Series 7 PowerPlay Enterprise Server et si vous utilisez l'interface HTTPS pour accder PowerPlay, vous devez activer le support SSL (Secure Socket Layer). Pour activer le support SSL pour la passerelle PowerPlay et le distributeur IBM Cognos 8, vous devez dfinir un mot de passe pour la bibliothque de cls IBM Cognos 8 puis crer et enregistrer le certificat de l'autorit de certification du serveur Web dans cette bibliothque de cls.
Procdure d'activation du support SSL

1. Enregistrez le certificat de l'autorit de certification en tant que fichier ca.cer dans le rpertoire emplacement_c8\bin. 2. Si vous n'avez pas encore dfini de mot de passe pour la bibliothque de cls IBM Cognos 8, faites-le maintenant dans IBM Cognos Configuration. Dans la fentre Explorateur, cliquez sur Cryptographie, IBM Cognos. Dans la section Paramtres de l'autorit de certification de la fentre Proprits, dfinissez l'option Mot de passe de la bibliothque de cls de l'autorit de certification. Dans le menu Fichier, cliquez sur l'option Enregistrer. Dans le menu Oprations, cliquez sur l'option Redmarrer.
3. partir de la ligne de commande, accdez au rpertoire emplacement_c8\bin. 4. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'emplacement JRE utilis par le serveur d'application excutant IBM Cognos 8. Les exemples ci-aprs prsupposent que le serveur d'application Tomcat implicite est utilis : 228 Pour Microsoft Windows, saisissez
Chapitre 8: Installation des composants d'IBM Cognos 8 set JAVA_HOME=emplacement_c8\bin\jre\version Pour UNIX Cshell, saisissez setenv JAVA_HOME emplacement_c8/bin/jre/version 5. Depuis la mme ligne de commande, excutez l'outil de certification : Pour Microsoft Windows, saisissez ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ..\configuration\signkeypair\jCAKeystore -p mot de passe de la bibliothque de cls Pour UNIX, saisissez ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystorep Vous pouvez maintenant installer un certificat d'autorit sur tous les ordinateurs clients ou le mettre la disposition des utilisateurs pour installation avec le client IBM Cognos 8 Go ! Office.
Procdure d'installation du certificat de l'autorit de certification sur le poste de travail client

1. Extrayez le certificat d'authentification de l'autorit de certification. Le fichier possde une extension .cer. Il ne s'agit pas du certificat utilis par le serveur Web. Il s'agit plutt du certificat de l'autorit de certification. 2. Cliquez deux fois sur le fichier .cer, cliquez sur Installer le certificat, puis cliquez sur Suivant. 3. Cliquez sur Placer tous les certificats dans le magasin suivant. 4. Cliquez sur Parcourir, Organismes de certification des sources sres, puis sur Suivant. 5. Cliquez sur Terminer.
Procdure de mise du certificat d'autorit la disposition des utilisateurs

Copie du certificat d'autorit vers un emplacement central sur le rseau local.
Activation de l'accs anonyme pour PowerPlay

Lorsque vous utilisez le code d'accs unique avec Microsoft Internet Information Services (IIS), l'accs anonyme doit tre activ pour que les utilisateurs du portail puissent accder aux documents IBM Cognos 8 Go ! Office bass sur des rapports PowerPlay. Au besoin, une seconde passerelle PowerPlay peut tre utilise pour permettre l'accs anonyme IBM Cognos 8 Go ! Office. Pour en savoir davantage, reportez-vous la rubrique relative la dfinition des mises en correspondance de passerelles du Guide d'administration et de scurit.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur o est install Content Manager.
Chapitre 8: Installation des composants d'IBM Cognos 8 2. Dans la fentre Explorateur, dans la section Scurit, Authentification, cliquez sur l'option IBM Cognos. 3. Dans la fentre Proprits, cochez la case situe en regard de la proprit Autoriser les connexions anonymes, puis cliquez sur l'option Vrai. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Dploiement du client IBM Cognos 8 Go! Office

IBM Cognos 8 Go! Office est disponible avec les composants IBM Cognos 8. Une fois qu'IBM Cognos 8 est install et configur, vous pouvez installer IBM Cognos 8 Go! Office sur les postes de travail client.
Dploiement d'IBM Cognos 8 Go! Office sur les ordinateurs clients

IBM Cognos 8 Go! Office utilise Microsoft .NET Framework pour permettre aux utilisateurs d'interagir avec les composants du serveur. Microsoft .NET Framework et les mises jour ncessaires sont tlcharges et installes par le fichier de configuration lorsque vous installez IBM Cognos 8 Go! Office. Ce fichier de configuration doit tre excut sur les ordinateurs de tous les utilisateurs. Pour obtenir la liste des versions prises en charge de Microsoft .NET Framework, reportez-vous au site Web Cognos Software Services (http://support.cognos.com). Utilisez la liste de contrle suivante comme guide de dploiement : Installation de .NET Framework et d'IBM Cognos 8 Go! Office. Dfinition du niveau de scurit des macros pour Microsoft Office XP, si ncessaire. Installation du certificat dlivr par l'autorit de certification pour la prise en charge du protocole SSL (Secure Socket Layer), si ncessaire. Test d'IBM Cognos 8 Go! Office.
Installation de .NET Framework et d'IBM Cognos 8 Go! Office

Pour installer Microsoft .NET Framework et IBM Cognos 8 pour Microsoft Office, vous devez excuter un fichier setup.exe partir d'un emplacement rseau central. Ce fichier installe et met jour Microsoft .NET Framework, installe les Primary Interop Assemblies (PIA) requis par Microsoft Office, puis installe les composants d'IBM Cognos 8 pour Microsoft Office. Lorsque vous installez Microsoft .NET Framework sur un systme d'exploitation qui n'est pas en anglais, les messages d'erreur, les raccourcis et les utilitaires Microsoft .NET s'affichent quand mme en anglais. Pour les langues autres que l'anglais, vous pouvez appliquer le pack linguistique Microsoft .NET pour voir les messages d'erreurs, raccourcis et utilitaires dans votre langue. Par exemple, si votre systme d'exploitation est franais et que vous avez install Microsoft .NET Framework, vous devez galement appliquer le pack linguistique Microsoft .NET franais. Vous pouvez tlcharger le pack linguistique de .NET Framework Version 2.0 l'adresse http://www.microsoft.com/downloads/. Si vous effectuez l'installation sur un ordinateur quip de Windows Vista, il est recommand de ne pas installer dans le rpertoire Program Files. Les amliorations apportes la scurit dans 230
Chapitre 8: Installation des composants d'IBM Cognos 8 Windows Vista empchent les applications d'crire dans le rpertoire Program Files lors des oprations du programme. Avant de mettre jour et d'installer les composants, vrifiez que vous avez : des droits d'administrateur sur l'ordinateur, dsinstall la version prcdente d'IBM Cognos 8 Go! Office, si ncessaire, la licence approprie pour utiliser IBM Cognos 8 Go! Office.
Procdure
1. Excutez le fichier setup.exe depuis l'emplacement rseau ou le CD d'IBM Cognos 8 Go! Office. L'assistant d'installation vrifie si Microsoft .NET Framework est install. 2. Si la bote de dialogue IBM Cognos 8 for Microsoft Office Setup affiche la page de contrat de licence de Microsoft .NET Framework 2.0, cliquez sur Accept. 3. Dans la bote de dialogue IBM Cognos 8 for Microsoft Office Setup, cliquez sur Install. Si Microsoft .NET Framework est en cours d'installation, une bote de dialogue de progression s'affiche pendant le tlchargement des fichiers partir du site Web de tlchargement de Microsoft. Cela peut prendre plusieurs minutes. Une barre de progression s'affiche pendant l'installation de la mise jour de la prise en charge du module d'extension partag pour Microsoft .NET Framework. Lorsque la mise jour est termine, l'assistant d'installation d'IBM Cognos 8 pour Microsoft Office s'affiche. 4. Dans la page Welcome to the IBM Cognos 8 for Microsoft Office Setup Wizard de la fentre IBM Cognos 8 pour Microsoft Office, cliquez sur Next. 5. Dans la page License Agreement, slectionnez I Agree et cliquez sur Next. 6. Dans la bote de dialogue Select Installation Folder, procdez comme suit : Si vous aviez une version prcdente, slectionnez le rpertoire d'installation utilis pour l'ancienne version, tel que C:\Program Files\Cognos\Cognos Office\. Si vous installez IBM Cognos 8 Go! Office pour la premire fois, acceptez l'emplacement implicite dfinissez-en nouveau. Si vous installez sous Windows Vista, dfinissez un emplacement situ hors du rpertoire Program Files. Slectionnez Everyone. Lorsque vous slectionnez Everyone, tous les utilisateurs qui se connectent l'ordinateur voient IBM Cognos 8 dans la barre d'outils des produits Microsoft Office. Si vous slectionnez Just Me, seuls les utilisateurs qui ont install IBM Cognos 8 pour Microsoft Office peuvent voir IBM Cognos 8 dans la barre d'outils. Cliquez sur Next.
Si une bote de dialogue vous invite dsinstaller une version antrieure, suivez les consignes de dsinstallation de l'ancienne version et reprenez l'installation. 7. Dans la page Confirm Installation, cliquez sur Next. Guide d'installation et de configuration 231
Chapitre 8: Installation des composants d'IBM Cognos 8 L'assistant installe les composants d'IBM Cognos 8 Go! Office. 8. Dans la page Installation Complete, cliquez sur Close.
Dfinition du niveau de scurit des macros pour Microsoft Office XP

Pour les applications Microsoft Office XP qui excutent IBM Cognos 8 Go! Office, vous devez dfinir le niveau de scurit des macros de faon approprie. Dfinissez cette option pour Microsoft Office Excel, Microsoft Office Word et Microsoft Office PowerPoint.
Procdure
1. Ouvrez votre application Microsoft Office XP. 2. Dans le menu Outils, cliquez sur Macros, puis sur Scurit. 3. Indiquez si vous souhaitez modifier le niveau de scurit ou les publications scurises. Dans l'onglet Niveau de scurit, cliquez sur Moyen ou sur Faible, puis cliquez sur OK Dans l'onglet diteurs approuvs, slectionnez Faire confiance tous les modles et complments installs et cliquez sur le bouton OK.
Installation du certificat de l'autorit de certification de l'interface HTTPS dans Series 7 PowerPlay

Si votre environnement inclut IBM Cognos Series 7 PowerPlay Enterprise Server et que vous utilisez l'interface HTTPS (https://) pour accder Series 7 PowerPlay, vous devez installer un certificat dlivr par une autorit de certification Le certificat dlivr par l'autorit de certification est obligatoire pour la prise en charge du protocole SSL (Secure Socket Layer).
Procdure
1. Adresse-vous votre administrateur pour obtenir le certificat de l'autorit de certification. Le fichier possde une extension .cer. 2. Cliquez deux fois sur le fichier .cer, cliquez sur Installer le certificat, puis cliquez sur Suivant. 3. Cliquez sur Placer tous les certificats dans le magasin suivant. 4. Cliquez sur Parcourir, Organismes de certification des sources sres, puis sur Suivant. 5. Cliquez sur Terminer.
Test d'IBM Cognos 8 Go! Office

Vous pouvez tester l'installation des composants client en dmarrant IBM Cognos 8 Go! Office. IBM Cognos 8 Go! Office dmarre automatiquement quand les utilisateurs dmarrent Microsoft Office Word, Microsoft Office Excel ou Microsoft Office PowerPoint, ou ouvrent un fichier ou un modle Microsoft Office.
Procdure
1. Dmarrez Microsoft Office Excel, Microsoft Office Word ou Microsoft Office PowerPoint ou ouvrez un document, un classeur ou ne prsentation Microsoft Office.
232
Chapitre 8: Installation des composants d'IBM Cognos 8 2. Vrifiez qu'IBM Cognos 8 apparat dans la barre d'outils. Si IBM Cognos 8 ne figure pas dans la barre d'outils, dans le menu Affichage, cliquez sur Barre d'outils, puis sur IBM Cognos 8 pour Microsoft Office. 3. Pour afficher le volet Opration, cliquez sur IBM Cognos 8 dans la barre d'outils. Le volet IBM Cognos 8 pour Office apparat dans la partie droite de la fentre. Il contient un lien vers l'application IBM Cognos 8 Go! Office.
234
Chapitre 9: Exemples
Cette section indique la fonction, le contenu et l'emplacement des exemples IBM Cognos 8. Elle prsente galement l'exemple de socit, Vacances et aventure, sa structure, ainsi que les bases de donnes, le modle et les packs associs. Pour en savoir davantage sur l'installation et la configuration des exemples de bases de donnes, reportez-vous aux sections "Installation des exemples IBM Cognos 8" (p. 242) et "Configuration des exemples" (p. 244).
Exemples pour la socit Vacances et aventure

Les exemples pour la socit Vacances et aventure illustrent les fonctions du produit, ainsi que les meilleures pratiques en termes techniques et professionnels. Vous pouvez aussi les utiliser pour tester et partager des techniques de conception de rapports, ainsi que pour le dpannage. Pour obtenir des exemples relatifs diffrents types d'activits, consultez les modles relatifs aux produits sur le site http://www.cognos.com. Pour en savoir davantage sur les options et les environnements d'installation spcifiques, reportez-vous au manuel Architecture and Deployment Guide ou aux conseils prouvs et aux mthodologies d'implmentation IBM Cognos sur le site Web Cognos Software Services Services (http://support.cognos.com). Pour en savoir davantage sur les exemples d'analyses, reportez-vous au Guide d'administration et de scurit.
Emplacement des exemples

Les exemples sont fournis avec le produit et les exemples relatifs chaque studio sont dcrits dans le guide de l'utilisateur et l'aide en ligne connexes. Pour utiliser les exemples, vous devez les dfinir et les configurer ou contacter votre administrateur pour savoir o ils sont installs. Pour obtenir des instructions sur la faon d'installer et de configurer les exemples, reportez-vous au Guide d'installation et de configuration ou au Guide d'administration et de scurit.
Types d'exemples
Les exemples incluent ce qui suit : Deux bases de donnes contenant toutes les donnes d'entreprise, les exemples de modles associs pour les requtes et l'analyse, ainsi que des exemples de rapports, de requtes, de modles de requtes et de tableaux de bord. Une base de donnes d'indicateurs et les indicateurs associs, y compris une carte stratgique pour la compagnie consolide. Remarque : Vous devez avoir install Metric Studio pour utiliser ces exemples. Des rapports qui contiennent des conseils dtaills pour expliquer comment et pourquoi ils ont t crs. Remarque : Ces rapports sont stocks dans un dossier nomm Exemples pratiques l'intrieur du dossier d'exemples de l'installation IBM Cognos 8. Guide d'installation et de configuration 235
Scurit
Vous pouvez dfinir un niveau de scurit sur les exemples en utilisant une liste d'employs incluse avec le produit. La liste se prsente sous la forme d'un fichier LDIF qui peut tre import dans un serveur de rpertoires, tel que Sun Java System Directory Server. Remarque : Vous pouvez tlcharger une version de Sun Java System Directory Server depuis le site Web de Sun (http://www.sun.com/download/). Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration. Pour en savoir davantage sur la conformit, visitez le site Web Cognos Software Services (http://support.cognos.com).
Le groupe de socits Vacances et aventure

Pour faciliter la cration d'exemples, notamment les exemples financiers, certaines informations gnrales relatives la socit fictive Vacances et aventure sont utiles. Pour rechercher des exemples qui utilisent des fonctions de produits spcifiques, reportez-vous aux descriptions de chaque exemple de cette annexe. Les revenus de Vacances et Aventure proviennent de magasins d'entreprise et d'oprations de franchise. Les revenus sont consolids depuis les filiales en proprit exclusive. Il existe six organisations distinctes, chacune disposant de ses propres dpartements et succursales. Cinq d'entre elles sont des socits rgionales. La sixime, Accessoires VA : dispose de sa propre collection de produits, qui se dmarque des autres socits VA par la marque, le nom, le prix, la couleur et la taille ; ralise des ventes depuis une succursale unique vers toutes les rgions et tous les dtaillants ; fonctionne la fois comme une socit d'exploitation base Genve et comme copropritaire des trois filiales VA en Europe.
Le diagramme ci-dessous illustre la structure d'organisation consolide, y compris les pourcentages de croissance en termes de proprit pour VA - Europe centrale, et affiche la monnaie dans laquelle les rapports ont t crs, ainsi que le prfixe de journal comptable pour chaque filiale.
236
Vacances et aventure - Valeurs consolides (socit de portefeuille) USD
VA - Amriques (AMX 1099) USD
VA - Asie-Pacifique (EAX 4199) YEN
VA - Accessoires (EUX 8199) EURO
Anne1 60% Anne3 50%
Anne1 40% Anne3 50%
VA - Europe centrale (CEU 6199) EURO
VA - Europe du Sud (SEU 7199) EURO
VA - Europe du Nord (NEU 5199) EURO
Chaque socit utilise la mme structure de dpartements et de journal comptable, comme illustr par le tableau suivant. Il est possible que les divisions n'utilisent pas la mme monnaie pour crer des rapports. Par exemple, la filiale Amriques cre des rapports en dollars amricains, mais la monnaie locale utilise par le sige social est le dollar canadien et celle de la division Oprations est le peso.
Division (journal comptable)

Sige social (1700)
Dpartement (journal comptable)

Ventes 1720 Marketing (1750) Informatique (1760) Ressources humaines (1730) Finances (1740) Approvisionnement (1710)
Oprations (1800)
Production et distribution (1820) Service la clientle (1820)
Chaque socit dispose d'un plan de comptes exhaustif. La plupart des comptes, tels que ceux relatifs aux frais qui ne sont pas lis au personnel, se situent au niveau du dpartement et ne comportent que des montants rcapitulatifs. Par exemple, mme si chaque dpartement marketing a Guide d'installation et de configuration 237
Chapitre 9: Exemples des frais, ce cot n'est pas spcifi au niveau des transactions, auquel se situent les promotions marketing.
Employs
Les donnes Vacances et Aventure contiennent une liste complte des employs de l'ensemble des divisions, dpartements et emplacements. Des donnes sont disponibles pour les rapports sur les primes (Rapport de primes de rendement globales) et les commissions sur les ventes (rapport Ventes - Commissions pour l'Europe centrale), la formation (rapport Formation des employs par anne), les valuations des performances et les enqutes sur le taux de satisfaction des employs (Niveau de satisfaction des employs - 2006). Si vous utilisez Metric Studio, les exemples d'indicateurs pour les ressources humaines sont aussi disponibles. Dans le pack Entrept de donnes VA (analyse), les groupes de mesures et les dimensions connexes sont rpartis dans des dossiers. Les employs sont classs en hirarchies en fonction de la rgion, du directeur, du poste ou du dpartement et de l'entreprise, afin de faciliter la cration de rapports sur diffrents types d'agrgation. L'agrgation a t dfinie pour les mesures Description sommaire du poste de l'employ, de faon ce que les lments Nombre de postes et Nombre prvu de postes s'agrgent correctement chaque niveau de temps : mensuel, trimestriel ou annuel. Par exemple, reportez-vous au rapport Effectifs prvus. Les employs sont galement rpertoris dans un exemple de fichier LDIF (p. 236). Ce rpertoire d'authentification est ncessaire pour les cubes de Transformer 8 et les exemples d'IBM Cognos Planning. Les autres exemples ne dpendent pas de profils de scurit. Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration.
Ventes et marketing
Les donnes relatives aux ventes et au marketing sont disponibles pour toutes les socits du groupe Vacances et Aventure. Accessoires VA dispose de dtails plus fournis pour prendre en charge les exemples d'analyse. Par exemple, consultez l'analyse Revenus par rapport au % de profit brut par marque, base sur le cube Ventes et marketing. Le marketing et les campagnes de ventes sont lis aux socits rgionales Vacances et Aventure. Globalement, les socits VA ont connu une croissance solide sur l'ensemble de leurs lignes de produits (Croissance des ventes anne aprs anne), dans toutes les rgions (Revenus par filiale VA, 2005), en raison de facteurs tels qu'une augmentation de l'activit commerciale continue et des produits nouveaux ou amliors, comme la ligne de produits de lunettes de soleil forte marge. Dans les lignes de produits vendues par les cinq socits rgionales (toutes l'exception d'Accessoires VA), les promotions ont connu un succs mitig (Succs des promotions par campagne, ensemble et trimestre). Si vous utilisez Metric Studio, vous voyez la mme chose dans les exemples d'indicateurs.
Sondages auprs des clients

Les donnes contiennent galement des informations sur les sondages auprs des clients. Par exemple, la ligne de produits qui inclut des arosols contre les insectes, de l'cran solaire, etc. n'a pas fait recette (Satisfaction relative aux produits - Articles de protection 2005) et le mcontentement du
238
Chapitre 9: Exemples dtaillant peut provenir de la qualit du service la clientle et non des retours (Retours et satisfaction des clients). Si vous utilisez Metric Studio, ces informations peuvent aussi tre surveilles l'aide d'indicateurs.
Points de vente
Les revenus des points de vente d'entreprise sont disponibles au niveau des transactions. Les revenus des points de vente de franchise sont disponibles au niveau consolid uniquement (cube Ventes et marketing). Les indicateurs relatifs aux dtaillants montrent que le nombre de points de vente de dtail a diminu sur la priode que couvrent ces donnes. Accessoires VA vend dans le monde entier, uniquement des accessoires. Les donnes de transaction des Accessoires VA constituent la principale source d'analyse des produits par marque, couleur et taille. Les cinq autres filiales du groupe d'entreprises sont rgionales et vendent toutes les lignes de produits pour les dtaillants de leur rgion. Par exemple, le rapport intitul Les 10 meilleurs dtaillants de 2005 utilise des graphiques de type clat et des donnes de liste pour tudier les revenus au niveau des dtaillants.
Base de donnes, modles et packs de la socit Vacances et aventure

Les modles de la socit Vacances et aventure illustrent les techniques de modlisation et prennent en charge les exemples. Les modles sont bass sur l'entrept de donnes VA et la base de donnes transactionnelles de ventes VA et constituent le fondement des exemples de rapports et de requtes. Chaque modle contient deux packs pour l'analyse de publication (dimensionnelle) et les vues de requte des donnes. Une description de chaque exemple de rapport ou de requte figure dans le guide de l'utilisateur du studio dans lequel vous ouvrez l'exemple. Pour en savoir davantage sur les techniques de modlisation, reportez-vous au Guide de modlisation des mtadonnes ou au manuel User Guide de Framework Manager. Vous devez avoir accs Framework Manager, l'outil de modlisation d'IBM Cognos 8, pour consulter les exemples de modles. Vous pouvez aussi tre amen dfinir les exemples de bases de donnes et de connexions. Pour obtenir des instructions, reportez-vous au Guide d'administration et de scurit ou au Guide d'installation et de configuration.
Entrept de donnes VA
Le modle Entrept de donnes VA, great_outdoors_data_warehouse.cpf, repose sur la base de donnes GOSALESDW. Il contient des donnes sur les ressources humaines, les ventes et le marketing, ainsi que les finances, groupes en domaines d'activit. Dans la vue Base de donnes, les trois domaines d'activit sont groups en espaces-noms distincts. La vue Base de donnes contient un quatrime espace-noms (Donnes VA) pour les informations communes. La vue Base de donnes est trs similaire la structure de la base de donnes sous-jacente. Toutes les tables (sujets de requte de base de donnes) sont inchanges. IBM Cognos 8 peut ainsi extraire des mtadonnes directement depuis le pack dans la plupart des cas, au lieu d'utiliser un appel de mtadonnes vers la base de donnes. Les modifications et les ajouts suivants ont t effectus dans la vue Base de donnes : Guide d'installation et de configuration 239
Chapitre 9: Exemples Des jointures ont t ajoutes selon les besoins. Pour permettre l'agrgation diffrents niveaux de granularit, certains sujets de requte de modle ont t crs. Par exemple, voir les relations entre Time et Sales ou Sales fact. Pour permettre la cration de jointures simples entre les tables de correspondance et chaque niveau d'une dimension, ces tables ont t copies. Par exemple, voir les tables de correspondance des produits.
La vue commerciale contient uniquement des sujets de requte de modle, sans jointures. Les modifications et les ajouts suivants ont t effectus dans la vue mtier : Des calculs ont t ajouts aux sujets de requte de modle. Par exemple, la dimension de date contient des calculs relatifs aux langues. Quand la base de donnes a plusieurs hirarchies, de nouvelles dimensions ont t cres pour les organiser. Par exemple, les hirarchies d'employs o ces derniers sont classs par directeur, entreprise, rgion et poste.
La base de donnes transactionnelles Ventes VA

Le modles Ventes VA, great_outdoors_sales.cpf, repose sur la base de donnes GOSALES, qui est structure en tant que base de donnes transactionnelles. Il contient principalement des donnes de vente. La vue Base de donnes est trs similaire la structure de la base de donnes sous-jacente. Les modifications et les ajouts suivants ont t effectus dans la vue Base de donnes : Pour qu'il soit possible de joindre les tables de fait la dimension de temps, des sujets de requte de modle et des jointures multiparties ont t utiliss.
240
Chapitre 9: Exemples D'autres jointures ont t ajoutes selon les besoins.
La vue commerciale contient uniquement des sujets de requte de modle, sans jointures. Les modifications et les ajouts suivants ont t effectus dans la vue mtier : Des calculs ont t ajouts aux sujets de requte de modle. Les sujets de requte de modle qui ont t crs dans la vue de la base de donnes afin de permettre la cration de jointures sur la dimension de temps ont t lis en tant que raccourcis de rfrences. Quand la base de donnes a plusieurs hirarchies, de nouvelles dimensions ont t cres pour les organiser. Personnel de vente est un sous-ensemble de la dimension volution progressive Employ. tant donn qu'il n'existe pas de cl d'employ unique dans Ventes VA, un filtre extrait uniquement l'enregistrement en cours. Ce modle n'utilise pas de donnes historiques.
Exemples de cubes
Les cubes suivants sont fournis avec les exemples pour la socit Vacances et aventure en anglais, franais, allemand, japonais et chinois : sales_and_marketing.mdc employee_expenses.mdc go_accessories.mdc go_americas.mdc go_asia_pacific.mdc great_outdoor_sales.mdc
Exemples de packs
Les exemples pour la socit Vacances et aventure comprennent sept packs. Vous trouverez ci-dessous une brve description de chaque pack disponible. Entrept de donnes VA (analyse) est une vue dimensionnelle de la base de donnes GOSALESDW. Ce pack peut tre utilis dans tous les studios, y compris Analysis Studio. Il vous permet d'accder aux niveaux suprieurs et infrieurs. Ventes VA (analyse) est une vue dimensionnelle de la base de donnes GOSALES. Ce pack peut tre utilis dans tous les studios, y compris Analysis Studio. Il vous permet d'accder aux niveaux suprieurs et infrieurs. Entrept de donnes VA (requte) est une vue non dimensionnelle de la base de donnes GOSALESDW. Ce pack peut tre utilis dans tous les studios, l'exception d'Analysis Studio. Il s'avre utile pour crer des rapports lorsqu'il n'est pas ncessaire de pouvoir accder aux niveaux suprieurs et infrieurs.
Chapitre 9: Exemples Ventes VA (requte) est une vue non dimensionnelle de la base de donnes GOSALES. Ce pack peut tre utilis dans tous les studios, l'exception d'Analysis Studio. Il s'avre utile pour crer des rapports lorsqu'il n'est pas ncessaire de pouvoir accder aux niveaux suprieurs et infrieurs. Ventes et marketing (conforme) repose sur la base de donnes GOSALESDW. Les dimensions sont conformes celles qui se trouvent dans le pack Ventes et marketing (cube), afin qu'il soit possible d'accder au dtail du pack dimensionnel partir du pack de cubes. Ventes et marketing (cube) est un pack OLAP qui repose sur le cube sales_and_marketing.mdc. Ventes Vacances et Aventure (cube) est un pack OLAP qui repose sur le cube great_outdoor_sales. mdc. Remarque : Les packs OLAP Ventes Vacances et aventure (cube) et Ventes et marketing (cube) ne sont pas multilingues. Le fichier d'archive Cognos_PowerCube.zip contient cinq versions de chaque pack, en anglais, franais, allemand, japonais et chinois.
Installation des exemples IBM Cognos 8

Les exemples IBM Cognos 8 illustrent les fonctions du produit, ainsi que les meilleures pratiques en termes techniques et professionnels. Vous pouvez aussi les utiliser pour tester et partager des techniques de conception de rapports, ainsi que pour le dpannage. Si vous souhaitez utiliser les exemples, installez-les depuis le CD d'exemples d'IBM Cognos 8 Business Intelligence. Installez les composants dans un rpertoire dont le nom du chemin d'accs contient uniquement des caractres ASCII. Certains serveurs ne prennent pas en charge les caractres non ASCII dans les noms de rpertoires.

1. Montez le CD l'aide des extensions de fichiers Rock Ridge. Important : Pour monter le CD d'IBM Cognos sous HP-UX, procdez comme suit : Ajoutez le rpertoire pfs_mount votre chemin d'installation. Par exemple : PATH=/usr/sbin/:$PATH export PATH Pour dmarrer les dmons NFS requis et les excuter en arrire-plan, saisissez bg pfs_mountd, puis bg pfsd. Pour monter le lecteur, saisissez : pfs_mount -t rrip <priphrique><rp_mont> -o xlat=unix Par exemple : pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix Vous pouvez prsent procder l'installation ou copier des fichiers en tant qu'utilisateur non-racine, en insrant un CD d'IBM Cognos dans ce lecteur.
242
Chapitre 9: Exemples Une fois l'installation termine, saisissez pfs_umount /cdrom et arrtez les dmons pfsd et pfs_mountd pour dmonter le CD.
2. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. 3. Dmarrer l'Assistant d'installation ? Si vous utilisez X Windows, saisissez : ./issetup Remarque : Lorsque vous utilisez la commande issetup avec XWindows, les caractres japonais peuvent tre altrs. Lors d'une installation sous UNIX, utilisez l'cran de la console pour installer les composants et slectionnez l'anglais comme langue d'installation unique en paramtrant LANG=C et LC_ALL=C. Si vous n'utilisez pas X Windows, saisissez : ./issetupcc 4. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Installez les exemples dans le mme emplacement que les composants du serveur. 5. Sur la page Terminer de l'Assistant d'installation, cliquez sur Terminer. Pour installer et configurer les exemples d'IBM Cognos 8, reportez-vous la section "Configuration des exemples" (p. 244).

1. Insrez le CD. 2. Accdez au rpertoire du CD-ROM correspondant votre systme d'exploitation. 3. Dmarrez l'Assistant d'installation en cliquant sur issetup.exe. La page Bienvenue de l'Assistant d'installation doit s'afficher. 4. Slectionnez la langue d'installation. La langue slectionne dtermine la langue de l'interface utilisateur. Vous pouvez redfinir la langue sur l'une des langues installes aprs l'installation. 5. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers ncessaires sur votre ordinateur. Installez les exemples dans le mme emplacement que les composants du serveur. 6. Sur la page Terminer de l'Assistant d'installation, cliquez sur Terminer. 7. Cliquez sur Terminer. Utilisez le menu Dmarrer de Windows pour lancer IBM Cognos Configuration depuis le dossier des raccourcis.
Configuration des exemples

Vous pouvez utiliser les exemples IBM Cognos pour apprendre utiliser IBM Cognos 8, notamment Framework Manager, Metric Studio, Metric Designer et Event Studio. IBM Cognos 8 fournit des exemples de bases de donnes contenant des informations sur les ventes, le marketing et les finances d'une socit fictive nomme Vacances et Aventure, qui vend du matriel sportif. Pour que vous puissiez utiliser les exemples de bases de donnes, IBM Cognos 8 doit tre install, configur et en cours d'excution. Pour les rapports et analyses d'IBM Cognos 8, Framework Manager doit aussi tre install, configur et en cours d'excution. Pour utiliser l'exemple de contenu de Metric Designer, l'outil de modlisation optionnel de Metric Studio, Metric Designer doit galement tre install, configur et en cours d'excution. Pour configurer les exemples, procdez comme suit : Restaurez les exemples de bases de donnes. Crez les connexions entre la source de donnes et les exemples de bases de donnes. Si vous envisagez d'utiliser des exemples de sources de donnes OLAP, dfinissez les exemples de cubes, si cela est ncessaire, et crez les connexions entre la source de donnes et les sources de donnes OLAP que vous souhaitez utiliser. Les tches de configuration sont ncessaires uniquement pour les cubes Microsoft Analysis Services et les cubes Essbase. Si vous envisagez d'utiliser l'exemple de Metric Studio, dfinissez l'exemple de Metric Studio. Si vous envisagez d'utiliser l'exemple de Metric Designer, configurez une connexion la source de donnes pour celui-ci, configurez l'exemple de Metric Studio, puis importez les archives de dploiement Cognos_Samples et GO_Metrics. Importez les exemples de contenu (packs) dans Content Store. Si vous souhaitez tester l'exemple d'agent ELM Returns Agent l'aide d'Event Studio, excutez l'exemple d'agent avec les donnes modifies.
Une fois ces tches effectues, utilisez IBM Cognos 8 pour excuter les exemples de rapports ou de tableaux de bord. Vous pourrez supprimer les exemples d'IBM Cognos 8 ultrieurement.
Restauration des fichiers de sauvegarde des exemples de bases de donnes

Pour utiliser les exemples, vous devez restaurer les fichiers de sauvegarde des exemples de base de donnes. Cette opration cre nouveau des versions multilingues des bases de donnes Vacances et Aventure. L'exemple de bases de donnes ci-dessous et les fichiers associs sont fournis avec IBM Cognos 8. Pour SQL Server et Oracle, chaque base de donnes est fournie sous la forme d'un fichier de sauvegarde de Microsoft SQL Server, d'un fichier d'exportation d'Oracle (.dmp). Pour DB2, les schmas de bases de donnes sont fournis dans un fichier move de DB2. Les fichiers sont compresss et vous devez les extraire pour pouvoir restaurer les bases de donnes ou les schmas.
244
Fichiers et bases de donnes SQL Server Description de base de donnes ou de schma

Ventes de Vacances et Aventure Dtaillants de Vacances et Aventure Entrept de donnes de Vacances et Aventure tude de march de Vacances et Aventure Ressources humaines de Vacances et Aventure
Nom de fichier
GOSALES.zip GOSALES.zip GOSALESDW. zip GOSALES.zip GOSALES.zip
Fichiers et bases de donnes Oracle Description de base de donnes ou de schma

Ventes de Vacances et Aventure Dtaillants de Vacances et Aventure Entrept de donnes de Vacances et Aventure tude de march de Vacances et Aventure Ressources humaines de Vacances et Aventure
Nom de fichier
GOSALES.dmp.gz GOSALESRT.dmp.gz GOSALESDW. dmp.gz GOSALESDW. dmp.gz GOSALESHR. dmp.gz
Fichiers et bases de donnes DB2 Description de base de donnes ou Nom de fichier de schma
Ventes de Vacances et Aventure Dtaillants de Vacances et Aventure Entrept de donnes de Vacances et Aventure GS_DB.tar.gz GS_DB.tar.gz GS_DB.tar.gz
tude de march de Vacances et Aven- GS_DB.tar.gz ture Ressources humaines de Vacances et Aventure GS_DB.tar.gz
Chapitre 9: Exemples Lors de la restauration d'exemples de bases de donnes, assurez-vous de procder comme suit : Attribuez les mmes noms aux bases de donnes restaures et aux fichiers de sauvegarde ou d'exportation. Les noms prennent en compte la distinction minuscules/majuscules. Crez des utilisateurs disposant de droits de slection pour les tableaux dans plusieurs schmas. L'installation des packs Entrept de donnes VA spcifie un objet connexion et un accs utilisateur uniques. Cela ncessite un utilisateur unique appel GOSALESDW qui possde le droit de slection sur les tableaux dans un schma unique appel GOSALESDW. L'installation des packs Ventes VA spcifie un objet connexion et un accs utilisateur uniques. Cela ncessite un utilisateur unique appel GOSALES qui possde le droit de slection sur les tableaux dans quatre schmas : GOSALES, GOSALESHR, GOSALESMR et GOSALESRT. Utilisez le jeu de caractres UTF-8. Vous devez disposer de suffisamment d'espace disque dans l'emplacement cible. Rservez 150 Mo pour les donnes Ventes VA (quatre schmas) et 200 Mo pour les donnes d'entrept Ventes VA (un schma).
Observations concernant Oracle

Pour crer des contraintes de cls trangres dans des tables faisant rfrence diffrents schmas, vous devez excuter gs_or_modify.sql, qui figure dans le mme dossier que les fichiers .dmp.
Observations concernant SQL Server

Si vous restaurez les fichiers de sauvegarde de SQL Server, vous devez utiliser Microsoft SQL Server 2000 ou Microsoft SQL Server 2005. Assurez-vous que la connectivit TCP/IP est utilise pour le serveur SQL.
Observations concernant DB2

Avant de restaurer les schmas de Vacances et Aventure contenus dans le fichier move de DB2 sous Unix ou Windows, procdez sa dcompression. Sous UNIX, extrayez le fichier move de DB2 l'aide des commandes gnutar -xcvf DB2_move_filename ou tar -xcvf DB2_move_filename. Si vous utilisez WinZip pour extraire le fichier move de DB2 sous Windows, veillez dsactiver l'option TAR file smart CR/LF conversion. Aprs l'extraction du fichier move de DB2, restaurez les schmas dans une base de donnes nomme GS_DB. Pour ajouter des vues, des contraintes, des droits d'utilisateur et des procdures stockes GS_DB, prparez et excutez les fichiers gs_db_modify inclus avec les exemples dans l'ordre suivant : Mettez jour le nom d'utilisateur et le mot de passe dans la partie suprieure du fichier gs_db_modify.sql et enregistrez-le.
246
Chapitre 9: Exemples Excutez gs_db_modify.bat
Procdure
1. Sur l'ordinateur o IBM Cognos 8 est install, accdez au rpertoire sql server, oracle ou db2 qui se trouve dans emplacement_c8/webcontent/samples/datasources. 2. Au besoin, copiez les fichiers de sauvegarde des exemples de bases de donnes vers le rpertoire de sauvegarde de base de donnes. Pour garantir la scurit et l'intgrit d'IBM Cognos 8, copiez les fichiers dans le rpertoire protg contre tout accs non autoris ou inappropri. 3. Restaurez les exemples de bases de donnes l'aide de votre outil de gestion de base de donnes. Conseils : Pour les fichiers de sauvegarde SQL, restaurez la base de donnes partir d'un priphrique et assurez-vous que les emplacements de restauration sont adquats pour les fichiers de base de donnes .ldf et .mdf. Pour en savoir davantage, reportez-vous la documentation de Microsoft SQL Server ou la base de connaissances d'IBM Cognos (http://support. cognos.com/kb-app/knowledgebase). Pour DB2, lorsque vous crez la base de donnes GS_DB, crez un groupe de mmoire tampon de 16 Ko et un espace de table associ.
4. Pour chaque base de donnes, crez au moins un utilisateur disposant de droits de slection sur toutes les tables des bases de donnes restaures. Vous pouvez prsent crer les connexions la source de donnes dans le portail.
Cration de connexions entre la source de donnes et les exemples de bases de donnes

Vous devez crer des connexions la source de donnes pour les exemples de bases de donnes restaurs. IBM Cognos 8 utilise ces informations pour se connecter aux exemples de bases de donnes et excuter les exemples de rapports ou utiliser l'exemple de pack. Le nom de la base de donnes DB2 que vous saisissez doit tre en majuscules. En outre, dans Framework Manager, les noms de schmas que vous saisissez pour les sources de donnes DB2 doivent tre en majuscules. Avant de crer les connexions la source de donnes, vous devez restaurer les fichiers de sauvegarde pour les exemples de bases de donnes. Assurez-vous galement que le service IBM Cognos 8 est en cours d'excution. Pour crer des sources de donnes, vous devez disposer des droits d'excution sur la fonctionnalit protge Connexions aux sources de donnes et des droits de passage sur la fonction protge Administration.
Procdure
1. Ouvrez IBM Cognos Connection.
Chapitre 9: Exemples 2. Dans le coin suprieur droit de l'cran, cliquez sur Lancez, puis sur IBM Cognos Administration. 3. Cliquez sur l'onglet Configuration. 4. Chaque sur le bouton Nouvelle source de donnes .
5. Dans la zone Nom, saisissez ventes_vacances_aventure, puis cliquez sur le bouton Suivant. 6. Dans la page de connexion, cliquez sur le type de la base de donnes restaure et laquelle vous souhaitez vous connecter, slectionnez un niveau d'isolement, puis cliquez sur le bouton Suivant. La page de chane de connexion relative la base de donnes slectionne s'affiche. Conseil : L'utilisateur dfini dans la source de donnes great_outdoors_sales doit disposer de droits de slection pour les tables des schmas GOSALES, GOSALESRT, GOSALESMR et GOSALESHR (p. 244). 7. Effectuez l'une des oprations suivantes : Si vous avez restaur les exemples de bases de donnes dans SQL Server, dans la zone Nom du serveur, saisissez le nom du serveur o se trouvent les bases restaures. Dans la zone Nom de la base de donnes, saisissez GOSALES. Les exemples d'IBM Cognos 8 requirent une connectivit TCP/IP avec le serveur SQL. Veillez ce que la scurit SQL Server soit dfinie sur SQL Server et Windows, et non sur Windows uniquement. Pour l'authentification, les exemples font appel la scurit SQL Server. Si vous avez restaur les exemples de bases de donnes dans Oracle, dans la zone Chane de connexion SQL*Net, saisissez la chane de connexion Oracle. Si vous avez restaur les exemples de base de donnes dans DB2, dans la zone Nom de base de donnes DB2, saisissez GS_DB en majuscules. Dans la zone Chane de connexion DB2, saisissez la chane de connexion DB2. 8. Dans la section Codes d'accs, cochez les cases Mot de passe et Crer un code d'accs pour le groupe 'Tous', saisissez le code d'utilisateur et le mot de passe pour l'utilisateur que vous avez cr lors de la restauration des bases de donnes, puis cliquez sur Terminer. Conseil : Pour vrifier si les paramtres sont corrects, cliquez sur le bouton Test de la connexion.... 9. Cliquez sur Terminer. 10. Rptez les tapes 4 9 pour les exemples de schma ou de base de donnes GOSALESDW et tapez great_outdoors_warehouse l'tape 5. 11. Si le modle GOSALES doit tre utilis par des modlisateurs dans IBM Cognos 8 Transformer, la chane de connexion doit tre ajoute manuellement au fichier cs7g.ini. Pour en savoir davantage, reportez-vous la section "Ajout de sources de donnes IBM Cognos Series 7 Transformer" (p. 359).
248
Chapitre 9: Exemples Les connexions aux sources de donnes Vacances et Aventure apparaissent en tant qu'entres dans Connexions aux sources de donnes. Vous pouvez prsent importer les exemples, moins qu'il n'y ait un paramtre incorrect ou une erreur de syntaxe dans la chane de connexion.
Configuration des exemples de cubes de Microsoft Analysis Services

IBM Cognos Connection ou Framework Manager fournissent des exemples de cubes pour Microsoft Analysis Services (MSAS). Avec les donnes financires, utilisez le cube Donnes financires VA tir de la base de donnes GOSALESDW. Ce cube contient les donnes financires mensuelles et de l'anne en cours pour tous les comptes, ce qui vous permet de crer des tats financiers dans Analysis Studio, Query Studio et Report Studio. Les donnes sont bases sur des phases exprimes en dollars amricains pour 2004, 2005, 2006 ou 2007 (donnes relles sur 7 mois seulement). La version MSAS2000 du cube financier et de la base de donnes se trouve dans le fichier GOFinanceFact_XX.cab. La version MSAS2005 se trouve dans le fichier GOFinanceFact_XX.abf. XX reprsente la langue. Par exemple, XX est remplac par EN, ce qui indique l'anglais (English). Pour les donnes de ventes, utilisez le cube GOSalesFact de la base de donnes GOSalesFact_XX Analysis Services, base sur la base de donnes GOSALESDW SQLSERVER. Le cube contient des mesures telles que le cot unitaire, le prix unitaire, la quantit et le profit brut. Les dimensions comprennent l'heure, le produit et les dtaillants. La version MSAS2000 du cube ventes et de la base de donnes est archive dans le fichier GOSalesFact_XX.cab. La version MSAS2005 se trouve dans le fichier de sauvegarde restaurable GOSalesFact_XX.abf. Les fichiers de sauvegarde se trouvent dans le rpertoire c8_location/webcontent/samples/datasources/ cubes/MSAS. Les fichiers doivent tre restaurs dans une base de donnes Microsoft SQL Server qui excute la version applicable de Microsoft Analysis Services (p. 244) et qui hberge la base de donnes GOSALESDW. Remarque : L'analyseur syntaxique Microsoft XML 6.0 et le fournisseur OLEDB Microsoft SQL 2005 Analysis Services 9.00 doivent tre installs sur le client local pour que des connexions puissent tre tablies entre la source de donnes et les cubes MSAS.
Procdure
1. Sur l'ordinateur sur lequel IBM Cognos 8 est install, accdez au rpertoire emplacement_c8/ webcontent/samples/datasources/cubes/MSAS/en. 2. Copiez les fichiers GOSALESDW.cab et GOSALESDW.abf dans un rpertoire auquel vous pouvez accder partir de la console Analysis Manager des serveurs Analysis Server de Microsoft SQL Server. 3. Utilisez Microsoft Analysis Services Analysis Manager pour restaurer la base de donnes partir des fichiers GOSALESDW.cab et GOSALESDW.abf. Vous pouvez maintenant crer les connexions la source des donnes l'aide des cubes GOSalesFact_XX ou GOFinanceFact_XX (p. 251).
Configuration de l'exemple de cube Essbase

Pour configurer l'exemple de cube Essbase, vous devez avoir install Hyperion Essbase et la console des services d'intgration et d'analyse Essbase. Vous pouvez galement configurer le petit cube Essbase GODBReduced.zip qui constitue une version filtre de la version complte, GODWENU. Pour configurer la version plus petite, dcompressez GODBReduced.zip, chargez le fichier OTL et txt dans l'environnement Essbase et excutez la procdure ci-dessous.
Procdure
1. Accdez au rpertoire emplacement_c8\webcontent\samples\datasources\cubes\Essbase\Outlines_ and_Raw_Data. Ce rpertoire contient les fichiers zip des diffrentes langues, tels que EN.zip pour l'anglais ou JA.zip pour le japonais. 2. Dcompressez le fichier correspondant votre langue. Chaque fichier zip contient les deux fichiers suivants : langueU_Data.txt, tel que ENU_Data.txt ou JAU_Data.txt. GODWlangueU.otl, tel que GODWENU.otl ou GODWJAU.otl.
3. l'aide d'un stockage en bloc dans Essbase, crez une application Unicode. 4. Dans l'application, crez une base de donnes. Vous pouvez utiliser GODWlangueU, tel que GODWENU ou GODWJAU, en tant que nom de votre base de donnes ou utiliser le nom de votre choix. 5. Copiez et collez le fichier GODWlangueU.otl dans le rpertoire de votre base de donnes. 6. Si le nom de la base de donnes dfinie l'tape 4 n'est pas GODWlangueU, renommez le fichier GODWlangueU.otl pour faire correspondre le nom de la base de donnes que vous avez cre. Confirmez le remplacement du fichier .otl. 7. Dans la console Essbase Administration Services, ouvrez le profil de la base de donnes et enregistrez-le. Confirmez que vous souhaitez enregistrer le profil mme s'il n'a pas t modifi. 8. Copiez le fichier langueU_Data.txt et collez-le dans le mme rpertoire que le fichier .otl. 9. Dans la console Essbase Administration Services, cliquez avec le bouton droit de la souris sur la base de donnes que vous avez cre et slectionnez Load Data. 10. Accdez au fichier langueU_Data.txt dans le rpertoire de votre base de donnes, slectionnez le fichier, puis cliquez sur OK. 11. Une fois les donnes charges, cliquez avec le bouton droit de la souris sur la base de donnes et slectionnez Execute Calculation.
250
Chapitre 9: Exemples 12. Slectionnez le calcul implicite et cliquez sur OK. Le processus de calcul peut prendre jusqu' 5 heures, selon l'ordinateur sur lequel Essbase OLAP Server est install. Vous pouvez prsent crer une connexion entre la source de donnes et le cube.
Cration de connexions la source de donnes vers des sources de donnes OLAP

IBM Cognos 8 fournit les exemples OLAP suivants : Cubes Microsoft Analysis Services GO Sales Fact et Donnes financires VA Cube Socit Vacances et aventure Cube DB2 Vacances et Aventure
Vous devez crer des connexions la source de donnes pour les cubes avant d'utiliser les exemples. Vous devez configurer l'exemple de cube Microsoft Analysis Services ou configurer l'exemple de cube Essbase, si vous les utilisez, avant de crer les connexions la source de donnes. Vous pouvez augmenter la taille de l'antmmoire de lecture pour amliorer les performances des requtes, bien que ce paramtre n'ait aucune incidence sur le dlai initial ncessaire pour ouvrir un cube. Pour crer des sources de donnes, vous devez disposer des droits d'excution pour la fonction scurise Connexions aux sources de donnes et des droits de passage pour la fonction scurise Administration.
Procdure pour les cubes

1. Ouvrez IBM Cognos Connection. 2. Dans le coin suprieur droit de l'cran, cliquez sur Lancez, puis sur IBM Cognos Administration. 3. Dans l'onglet Configuration, cliquez sur Connexions aux sources de donnes. 4. Cliquez sur le bouton Nouvelle source de donnes. Remarque : Vous devez ajouter une connexion la source de donnes pour chaque cube. 5. Pour crer une connexion la source de donnes pour le cube Ventes et marketing, saisissez ventes_et_marketing dans la zone Nom, puis cliquez sur Suivant. Vous pouvez dfinir un chemin d'accs Windows ou UNIX. Si vous dfinissez un chemin d'accs UNIX et que vous envisagez d'utiliser Framework Manager, vous devez galement dfinir le chemin d'accs Windows et vrifier que le cube est disponible dans l'emplacement Windows. Framework Manager ne peut accder qu' des cubes qui se trouvent dans des emplacements Windows. 6. Sur la page de connexion, sous Type cliquez sur Cube IBM Cognos. La page de chane de connexion relative la base de donnes slectionne s'affiche. 7. Dans la zone Taille de l'antmmoire (Mo), saisissez la taille de l'antmmoire du cube en mgaoctets. Guide d'installation et de configuration 251
Chapitre 9: Exemples Si vous laissez ce champ vide ou saisissez 0, IBM Cognos Connection utilise la valeur par dfaut dans le fichier ppds_cfg.xml du dossier de configuration. 8. Dans la zone Emplacement sous Windows, indiquez l'emplacement et le nom du fichier Sales_ and_Marketing.mdc pour la connexion la source de donnes. Par exemple, saisissez : emplacement_c8/webcontent/samples/datasources/cubes/PowerCubes/En/Sales_and_Marketing. mdc 9. Pour tester si les paramtres sont corrects, cliquez sur le bouton Test. 10. Cliquez sur Terminer. Vous pouvez prsent importer l'exemple de pack pour le cube afin d'utiliser cette source de donnes.
Procdure pour les cubes Essbase/DB2

1. Ouvrez Framework Manager. 2. Cliquez sur Create a new project. 3. Dans la page New project, indiquez le nom et l'emplacement du projet. 4. Dans la page Select Language, cliquez sur la langue de conception du projet. 5. Cliquez sur OK. L'Assistant de d'importation s'affiche. 6. Dans la page de connexion, sous type, cliquez sur Serveur Hyperion Essbase/IBM DB2 OLAP, slectionnez un niveau d'isolement, puis cliquez sur Suivant. La page de chane de connexion relative la base de donnes slectionne s'affiche. 7. Dans la zone Server name, saisissez le nom du serveur. 8. Pour tester si les paramtres sont corrects, cliquez sur le bouton Test. 9. Cliquez sur Terminer. Pour pouvoir utiliser cette source de donnes, vous devez crer, puis publier un pack l'aide de cette source de donnes dans Framework Manager.
Procdure pour les cubes Microsoft Analysis Service

1. Ouvrez IBM Cognos Connection. 2. Dans le coin suprieur droit de l'cran, cliquez sur Lancez, puis sur IBM Cognos Administration. 3. Dans l'onglet Configuration, cliquez sur Nouvelle source de donnes. 4. Dans la zone Nom, tapez le nom de la connexion la source de donnes, puis cliquez sur Suivant. Avec le cube GOFinanceFact, saisissez GOFinanceFact_XX_MSAS2005. Avec le cube GOSalesFact, saisissez GOSalesFact_XX_MSAS2005.
252
Chapitre 9: Exemples 5. Dans la page Dfinition d'une connexion de l'Assistant Nouvelle source de donnes, cliquez sur Microsoft Analysis Services 2005 ou sur Microsoft Analysis Services (par l'entremise de ODBO) selon le cube auquel vous accdez. 6. Cliquez sur Suivant. 7. Dans la zone Nom du serveur, saisissez le nom du serveur sur lequel se trouvent les bases de donnes restaures. Les barres obliques inverses ne sont pas requises. 8. Sous Code d'accs, cochez la case Mot de passe puis la case Crer un code d'accs pour le groupe 'Tous'. Saisissez le code d'utilisateur et le mot de passe de la base de donnes MSAS. Avec MSAS2005, il s'agit d'un code d'accs au rseau. 9. Cliquez sur Test de la connexion, puis sur le bouton Tester. Cliquez sur Fermer. 10. Cliquez sur Terminer. Vous tes invit crer un pack. Vous pouvez galement dployer un pack existant partir d'un exemple d'archive de dploiement. Les noms des archives de dploiement correspondent aux noms de la connexion la source de donnes spcifie l'tape 4. Ces archives contiennent des exemples de rapports qui fonctionnent avec les cubes associs. Dans Content Administration sur l'onglet Configuration dans IBM Cognos Administration, cliquez sur Nouvelle importation. L'Assistant Nouvelle importation vous invite choisir une archive de dploiement. Lorsque vous slectionnez une archive de dploiement, il est important de cliquer sur Modifier et d'indiquer un nom cible pour le pack afin d'viter qu'un pack existant soit remplac. 11. Pour crer un pack, cochez Crer un pack, puis cliquez sur OK. 12. Saisissez le nom d'un pack, puis cliquez sur OK. Avec le cube GO Finance Fact, saisissez GOFinanceFact_XX_MSAS2005. Avec le cube GO Sales Fact, saisissez GOSalesFact_XX_MSAS2005.
13. Indiquez la base de donnes Analysis Services que vous avez restaure, soit GOFinanceFact_XX ou GoSalesFact_XX : Avec le cube GOFinanceFact ou les cubes GOSalesFact, saisissez GOSALESDW. Avec le cube GO Sales Fact, saisissez GO Sales Fact.
14. Cliquez sur le cube applicable la base de donnes. 15. Cliquez sur Terminer.
Configuration de l'exemple de Metric Studio

Pour configurer l'exemple de Metric Studio, procdez comme suit : Crez une bibliothque d'indicateurs appele GOMETRICS. Crez un pack d'indicateurs appel GO Metrics qui utilise la bibliothque d'indicateurs GOMETRICS. Guide d'installation et de configuration 253
Chapitre 9: Exemples Pour le nom de la source de donnes, saisissez go_metrics. Lorsque l'assistant vous y invite, slectionnez le calendrier grgorien standard et acceptez les valeurs implicites pour les annes, les trimestres et les mois. Dfinissez le 1er janvier 2004 en tant que date de dbut pour une priode incluant l'anne en cours. Par exemple, pour l'anne 2008, utilisez une priode d'au moins 5 ans. Pour en savoir davantage, reportez-vous la section sur les indicateurs dans le Guide d'administration et de scurit. Dfinissez la source d'importation. Importez les donnes et les fichiers relatifs aux indicateurs dans la bibliothque d'indicateurs.
Procdure de dfinition de la source d'importation

1. Copiez tous les fichiers texte du dossier appropri vers le dossier emplacement_c8/deployment/cmm : Pour SQL Server ou Oracle, copiez les fichiers du rpertoire emplacement_c8/webcontent/ samples/datasources/metricsdata/GO_Metrics_Unicode Pour DB2, copiez les fichiers du rpertoire emplacement_c8/webcontent/samples/datasources/ metricsdata/GOMetrics_UTF8
Conseil : Vous serez peut-tre amen crer le dossier cmm. 2. Dans Dossiers publics, cliquez sur Indicateurs VA. 3. Dans la liste Outils de Metric Studio, cliquez sur Sources d'importation. 4. Cliquez sur l'icne Dfinir les proprits dans la colonne Oprations en regard de la source d'importation implicite. 5. Sous Emplacement de dploiement des indicateurs, cliquez sur le dossier cmm. Il s'agit de l'emplacement de dploiement implicite. 6. Cliquez sur Inclure les sous-rpertoires. 7. Dans la zone Format de fichier, cliquez sur 8.4.1. 8. Sous Encodage du jeu de caractres, slectionnez l'encodage appropri et cliquez sur OK. Pour SQL Server ou Oracle, slectionnez Unicode (UTF-16). Pour DB2, slectionnez Unicode (UTF-8).
Vous pouvez prsent utiliser le pack GO Metrics dans Metric Studio.
Procdure d'importation des donnes et des fichiers d'indicateurs dans la bibliothque d'indicateurs.
1. Vous pouvez importer les fichiers dans la bibliothque d'indicateurs l'aide d'IBM Cognos Connection ou de Metric Studio :
254
Chapitre 9: Exemples Avec IBM Cognos Connection, dans Dossiers publics ou Mes dossiers, ouvrez le pack GO Metrics en cliquant sur l'icne d'affichage du contenu du pack d'indicateurs dans la colonne Oprations. Cliquez sur Mise jour des indicateurs. Avec Metric Studio, dans la liste Outils, cliquez sur Mise jour des indicateurs.
2. Cliquez sur la tche relie aux indicateurs Importer et transfrer les donnes des fichiers dans la bibliothque d'indicateurs. Conseil : Si une erreur survient, cliquez sur Supprimer les journaux de donnes rejets de la zone d'activation, Supprimer les donnes d'historique de l'indicateur seulement et Supprimer l'historique de l'indicateur et les donnes du calendrier. Vous pouvez prsent utiliser le pack GO Metrics dans Metric Studio.
Importation des exemples

Pour utiliser l'exemple de pack et d'autres contenus, vous devez les importer partir de l'exemple d'archive de dploiement. Avant d'importer les archives de dploiement Cognos_Samples.zip et GO_Metrics.zip, vous devez restaurer les bases de donnes (p. 244). Vous devez galement crer des connexions entre la source de donnes et les exemples de bases de donnes (p. 247). Avant d'importer l'archive de dploiement Cognos_PowerCube.zip ou Cognos_PowerCube_Financial. zip, vous devez connecter la base de donnes au cube appropri (p. 251) et slectionner la langue que vous souhaitez utiliser. La langue choisie doit tre prise en charge par vos paramtres rgionaux.
Procdure
1. Copiez le fichier compress du rpertoire emplacement_c8/webcontent/samples/content vers le rpertoire o sont enregistres les archives de dploiement. L'emplacement implicite est emplacement_c8/deployment. L'emplacement est dfini dans l'outil de configuration. Pour en savoir davantage sur la modification de l'emplacement, reportez-vous l'aide en ligne sur l'outil de configuration. 2. Ouvrez IBM Cognos Connection. 3. Dans le coin suprieur droit de l'cran, cliquez sur Lancez, puis sur IBM Cognos Administration. 4. Dans l'onglet Configuration, cliquez sur Administration du contenu. Remarque : Pour accder cette zone dans l'application IBM Cognos Administration, vous devez disposer des droits d'accs requis pour la fonctionnalit protge Tches d'administration. 5. Dans la barre d'outils, cliquez sur le bouton Nouvelle importation. L'Assistant Nouvelle importation s'affiche. 6. Dans la zone Archive de dploiement, slectionnez IBM Cognos_Samples, IBM Cognos_PowerCubes, GO_Metrics ou GO_Audit. 7. Cliquez sur Suivant.
Chapitre 9: Exemples 8. Saisissez un nom unique ainsi qu'une infobulle et une description facultatives pour l'archive de dploiement, slectionnez le dossier o vous souhaitez l'enregistrer, puis cliquez sur le bouton Suivant. 9. Dans la zone Contenu des dossiers publics, slectionnez les packs et les dossiers que vous souhaitez importer. L'archive de dploiement Cognos_Samples contient les packs et les dossiers suivants : Entrept de donnes VA (analyse), Entrept de donnes VA (requte), Ventes VA (analyse), Ventes VA (requte), Ventes et marketing (conforme) Dossier de tableau de bord dynamique, Objets de tableau de bord dynamique, Exemple de modle, Exemples pratiques L'archive de dploiement Cognos_PowerCube contient des packs ou des dossiers pour les langues suivantes : Anglais Franais Allemand Japonais Chinois simplifi
L'archive de dploiement GO_Metrics contient les packs et les dossiers suivants : GO Metrics
10. Slectionnez les options souhaites, ainsi que les rgles de rsolution des conflits choisies pour les options slectionnes, puis cliquez sur Suivant. 11. Dans la page Dfinition des options gnrales, indiquez s'il convient d'inclure des droits d'accs et des rfrences des espaces-noms externes et qui doit tre propritaire des entres aprs leur importation. 12. Cliquez sur Suivant. Les informations rcapitulatives s'affichent. 13. Examinez les informations rcapitulatives et cliquez sur Suivant. 14. Slectionnez une action : Pour procder une excution unique immdiatement ou ultrieurement, cliquez sur Enregistrer et excuter une fois . Cliquez sur Terminer, indiquez la date et l'heure de l'excution et cliquez sur Excuter. Vrifiez l'heure d'excution et cliquez sur OK. Pour programmer une excution intervalles rguliers, cliquez sur Programmer l'excution pour qu'elle se rpte de faon rgulire. Cliquez sur Terminer et slectionnez ensuite la frquence, ainsi que les dates de dbut et de fin. Cliquez sur OK.
256
Chapitre 9: Exemples Conseil : Pour dsactiver temporairement le calendrier, cochez la case Dsactiver le calendrier de production. Pour enregistrer sans programmation ni excution, cliquez sur Enregistrer seulement, puis sur Terminer. 15. Une fois l'importation soumise, cliquez sur Terminer. Vous pouvez maintenant utiliser les exemples de packs pour crer des rapports et des analyses dans Report Studio, Query Studio et Analysis Studio, consulter des extractions dans Metric Designer ou crer des agents dans Event Studio. Vous pouvez galement excuter les exemples de rapports disponibles dans l'onglet Dossiers publics du portail.
Exemples de modles de bases de donnes

Les exemples de modles ci-dessous fournissent des informations pour la socit fictive Vacances et aventure et sont fournis avec IBM Cognos 8 : great_outdoors_sales, qui fait rfrence aux exemples de base de donnes GOSALES great_outdoors_warehouse, qui fait rfrence la base de donnes GOSALESDW gosales_scriptplayer, qui fait rfrence aux exemples de bases de donnes GOSALES
Vous pouvez utiliser des modles d'exemples de bases de donnes sur diffrentes plates-formes. Pour en savoir davantage sur le dplacement des modles d'une plate-forme vers une autre, reportezvous au manuel Framework Manager User Guide. Remarque : Transformer 8 utilise certains rapports des packs Entrept de donnes VA (requte) et Ventes VA (requte) comme donnes source pour divers cubes. Ces rapports sont conus comme des rapports de type liste simples, sans mise en forme. La description des rapports indique s'ils ont t labors pour servir de donnes source pour Transformer 8.
Modle GO Sales
Ce modle contient des informations sur l'analyse des ventes de la socit fictive Vacances et Aventure. Il comporte galement les lments de requte requis par les exemples Event Studio. Le modle accde trois schmas et comprend deux packs. L'un des packs est bas sur la vue dimensionnelle, tandis que l'autre s'appuie sur la vue de requte (relationnelle).
Modle GO Data Warehouse

Ce modle contient des informations sur la situation financire, les ressources humaines, les ventes et les activits marketing de la socit fictive Vacances et aventure. Ce modle accde une source de donnes relationnelle dimensionnelle. Il comprend deux packs. L'un des packs est bas sur la vue dimensionnelle et l'autre s'appuie sur la vue de requte (relationnelle).
GO Sales Scriptplayer
Ces fichiers peuvent servir excuter squentiellement les journaux des oprations. Cette opration cre un modle nomm gosales_scriptplayer et publie un pack destination de la base de donnes Content Store.
Exemple - Excution de l'exemple d'agent ELM Returns Agent avec des donnes modifies
Vous pouvez modifier des donnes dans la base de donnes GOSALES si un utilisateur d'Event Studio souhaite tester l'exemple d'agent Agent des retours ELM. L'utilisateur d'Event Studio peut excuter l'exemple d'agent deux fois et dtecter un nouvel vnement. Pour en savoir davantage, consultez le manuel Event Studio - Guide de l'utilisateur. L'excution de l'exemple d'agent avec des donnes modifies s'effectue de la faon suivante : L'utilisateur d'Event Studio excute l'exemple d'agent sur les donnes implicites et vous demande ensuite de modifier les donnes. Vous simulez certains lments dclencheurs d'vnements initiaux, puis vous demandez l'utilisateur d'Event Studio d'excuter l'exemple d'agent une seconde fois. L'utilisateur d'Event Studio excute l'exemple d'agent sur les donnes modifies. Il vous avertit lorsque l'excution de l'agent est termine. Vous simulez le passage du temps et la rsolution de certains vnements, puis vous demandez l'utilisateur d'Event Studio d'excuter l'exemple d'agent une troisime fois. L'utilisateur d'Event Studio excute l'exemple d'agent pour la dernire fois. Il vous avertit lorsque l'excution de l'agent est termine. Vous modifiez les donnes afin que l'agent ELM Returns Agent ne dtecte pas d'vnements.
Exemple - Simulation de la survenance d'vnements initiaux

Excutez une partie du script Event_Studio_ELM_Agent_Modify_GOSALES.sql pour simuler les modifications de donnes suivantes : Remplacez la date par celle du jour. Remplacez le code de suivi par -1 dans quatre enregistrements. La valeur -1 indique que le suivi est requis.
Procdure
1. Dans SQL Query Analyzer, ouvrez le menu Fichier, puis cliquez sur Ouvrir. 2. Accdez emplacement_c8/webcontent/samples/datasources/sqlserver et cliquez deux fois sur le fichier Event_Studio_ELM_Agent_Modify_GOSALES.sql. 3. Dans la barre d'outils, partir de la liste des bases de donnes, cliquez sur GOSALES. 4. Dans la fentre Requte, slectionnez les 16 lignes de code prsentes dans Part 1. 5. Dans le menu Requte, cliquez sur Excution. Les modifications sont appliques la base de donnes.
258
Exemple - Simulation du passage du temps et rsolution de quelques vnements

Excutez une partie du script Event_Studio_ELM_Agent_Modify_GOSALES.sql afin de simuler les modifications de donnes. D'abord, modifiez-les en indiquant que deux jours se sont couls depuis la dernire excution de l'exemple d'Agent Retours ELM. Ensuite, modifiez le code de suivi de trois des quatre vnements dtects lors de cette excution en remplaant la valeur -1 par +1. Cette modification signifie qu'un seul vnement requiert encore un suivi et que les autres cas ont t rsolus.
Procdure
1. Dans SQL Query Analyzer, ouvrez le menu Fichier, puis cliquez sur Ouvrir. 2. Accdez emplacement_c8/webcontent/samples/datasources/sqlserver et cliquez deux fois sur le fichier Event_Studio_ELM_Agent_Modify_GOSALES.sql. 3. Dans la barre d'outils, cliquez sur GOSALES dans la liste des bases de donnes. 4. Dans la fentre Requte, slectionnez l'ensemble des lignes de code figurant aprs les commentaires dans Part 2. 5. Dans le menu Requte, cliquez sur Excution. Les modifications sont appliques la base de donnes.
Exemple - Modification des donnes afin que l'agent ELM Returns Agent ne dtecte aucun vnement
Lorsque l'utilisateur Event Studio finit d'excuter l'exemple d'agent ELM Returns Agent avec les donnes modifies, vous devez recevoir une notification. Vous pouvez ensuite modifier la base de donnes GOSALES afin que l'agent ne dtecte plus aucune instance d'vnement.
Procdure
Excutez les commandes sql suivantes : UPDATE GOSALES.RETURNED_ITEM SET FOLLOW_UP_CODE = 0 UPDATE GOSALES.RETURNED_ITEM SET ASSIGNED_TO = 0 UPDATE GOSALES.RETURNED_ITEM SET DATE_ADVISED = NULL Les donnes sont modifies. L'exemple d'agent ELM Returns Agent est prt tre utilis par un autre utilisateur Event Studio.
Suppression des exemples de bases de donnes d'IBM Cognos 8

Lorsque vous n'avez plus besoin des exemples de rapports pour apprendre utiliser IBM Cognos 8, notamment son composant Framework Manager, vous pouvez supprimer les packs sur lesquels reposent les exemples. Cette opration supprime dfinitivement les exemples du Content Store.
Procdure
1. Ouvrez IBM Cognos Connection. 2. Cliquez sur l'onglet Dossiers publics.
Chapitre 9: Exemples 3. Cochez la case correspondant l'exemple de pack que vous souhaitez supprimer. 4. Dans la barre d'outils, cliquez sur le bouton de suppression, puis sur le bouton OK. Pour rutiliser les exemples, vous devez configurer ces exemples.
260
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
Les composants d'IBM Cognos 8 s'excutent avec deux niveaux de connexion : anonyme et authentifie. Par dfaut, l'accs anonyme est activ. Vous pouvez utiliser deux types de connexion dans votre installation. Si vous souhaitez utiliser uniquement la connexion authentifie, vous pouvez dsactiver l'accs anonyme. Pour une connexion authentifie, vous devez configurer les composants d'IBM Cognos 8 avec un espace-noms appropri pour le type de fournisseur d'authentification de votre environnement. Vous pouvez configurer plusieurs espaces-noms pour l'authentification, puis slectionner, en cours d'excution, celui que vous voulez utiliser. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Si vous procdez une mise niveau partir de ReportNet et qu'IBM Cognos 8 dtecte un espacenoms auparavant configur, mais qui ne l'est plus, cet espace-noms s'affiche dans la liste des fournisseurs d'authentification, dans le portail d'administration. Vous pouvez configurer l'espace-noms si vous avez toujours besoin des informations de compte d'utilisateur. Dans le cas contraire, vous pouvez supprimer l'espace-noms. Pour en savoir davantage sur la suppression de l'espace-noms, reportez-vous au Guide d'administration et de scurit. Par ailleurs, lors de la mise niveau d'une version vers une autre, vous devez utiliser le mme espacenoms d'authentification pour les deux versions. Si tel n'est pas le cas, la nouvelle version risque de ne pas contenir les mmes polices, utilisateurs, rles et groupes. Les composants d'IBM Cognos 8 prennent en charge les types de serveurs suivants en tant que sources d'authentification : Active Directory Server IBM Cognos Series 7 Fournisseur d'authentification personnalis LDAP eTrust SiteMinder NTLM SAP
Si vous utilisez plusieurs ordinateurs Content Manager, vous devez configurer des fournisseurs d'authentification identiques sur chaque ordinateur Content Manager. De fait, le type de fournisseur d'authentification que vous slectionnez et la manire dont vous le configurez doivent tre les mmes sur tous les ordinateurs de toutes les plates-formes. La configuration doit contenir des informations auxquelles tous les ordinateurs Content Manager peuvent accder.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Si IBM Cognos 8 est install sur un seul ordinateur Linux ou que Content Manager est install sur un ordinateur Linux, IBM Cognos 8 peut tre configur de faon n'utiliser comme sources d'authentification que des serveurs d'annuaire compatibles avec la version 3 de LDAP et des fournisseurs personnaliss. Certains fournisseurs d'authentification requirent que les bibliothques externes l'environnement IBM Cognos 8 soient disponibles. Si tel n'est pas le cas sous Linux, le fournisseur d'authentification ne peut tre initialis. Pour configurer l'un des lments suivants en tant que source d'authentification, vous devez installer Content Manager sur un ordinateur ne fonctionnant pas sous Linux. Espace-noms IBM Cognos Series 7 Active Directory Server NTLM eTrust SiteMinder SAP BW.
Si vous activez la scurit, vous devez configurer des paramtres de scurit ds que vous avez termin le processus d'installation et de configuration. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Important : Une fois la scurit active, il est fortement dconseill de la dsactiver. Lorsque vous supprimez un espace-noms, les entres des dossiers Mes dossiers et Mes pages sont dfinitivement perdues. Les paramtres d'autorisation existants continuent faire rfrence des utilisateurs, des groupes et des rles qui n'existent plus. Si cela n'affecte pas le fonctionnement des autorisations, un utilisateur administrant les paramtres d'autorisation risque de voir des entres inconnues . tant donn que ces entres font rfrence des utilisateurs, des groupes et des rles qui n'existent plus, vous pouvez les supprimer en toute scurit. Aprs avoir configur un fournisseur d'authentification pour les composants d'IBM Cognos 8, vous pouvez activer le code d'accs unique entre votre environnement de fournisseur d'authentification et les composants d'IBM Cognos 8. Ainsi, un utilisateur se connecte une seule fois et peut passer d'une application une autre sans se reconnecter. Les utilisateurs peuvent slectionner des espaces-noms lorsqu'ils se connectent au portail IBM Cognos 8. Vous pouvez masquer les espaces-noms Java personnaliss (p. 276) et les espaces-noms eTrust SiteMinder (p. 297) de la vue des utilisateurs. Pour utiliser un fournisseur d'authentification et exiger des utilisateurs qu'ils s'authentifient : Dsactivez l'accs anonyme, le cas chant. Configurez les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un fournisseur d'authentification.
262
Dsactivation de l'accs anonyme

Par dfaut, les composants d'IBM Cognos 8 n'exigent pas d'authentification de l'utilisateur. Les utilisateurs peuvent ouvrir une session anonyme. Si vous souhaitez utiliser une connexion authentifie uniquement, vous pouvez utiliser IBM Cognos Configuration pour dsactiver l'accs anonyme.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans la fentre Explorateur, dans la section Scurit, Authentification, cliquez sur l'option IBM Cognos. La ressource IBM Cognos reprsente l'espace-noms IBM Cognos. L'espace-noms d'IBM Cognos stocke des informations sur les groupes d'IBM Cognos, tels que l'utilisateur anonyme, les contacts et les listes de diffusion, et fait rfrence des objets figurant dans d'autres espacesnoms de scurit. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. 3. Dans la fentre Proprits, cliquez sur la zone situe en regard de la proprit Autoriser les connexions anonymes, puis cliquez sur l'option Faux. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les utilisateurs doivent dsormais fournir des rfrences d'identification de connexion pour accder aux ressources IBM Cognos.
Restriction de l'accs l'espace-noms IBM Cognos

L'accs peut tre limit aux utilisateurs appartenant un groupe ou un rle dfini dans l'espacenoms intgr IBM Cognos. Par dfaut, tous les utilisateurs appartiennent plusieurs groupes ou rles intgrs. Pour restreindre l'accs, vous devez : activer la proprit permettant de restreindre l'accs, supprimer le groupe Tous des groupes et rles IBM Cognos intgrs, vous assurer que les utilisateurs autoriss appartiennent au moins un groupe ou rle IBM Cognos.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans la section Scurit de la fentre Explorateur, cliquez sur l'option Authentification. 3. Dans la fentre Proprits, affectez la valeur Vrai l'option Voulez-vous limiter l'accs aux membres de l'espace-noms prdfini ? 4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Vous devez maintenant avoir recours au portail pour supprimer le groupe Tous des rles et groupes IBM Cognos intgrs, puis vous assurer que les utilisateurs autoriss appartiennent au moins un groupe ou rle IBM Cognos intgr. Pour en savoir davantage sur l'ajout ou la suppression de membres d'un groupe ou rle IBM Cognos, reportez-vous au Guide d'administration et de scurit.
Configuration des composants d'IBM Cognos 8 pour Active Directory Server

Si vous installez Content Manager sur un ordinateur Windows, vous pouvez configurer Active Directory comme source d'authentification utilisant un espace-noms Active Directory. Si vous installez Content Manager sur un ordinateur UNIX, vous devez utiliser un espace-noms LDAP pour configurer Active Directory en tant que source d'authentification. Si vous installez Content Manager sur des ordinateurs UNIX et Windows, vous devez utiliser un espace-noms LDAP pour configurer Active Directory sur tous les ordinateurs Content Manager. Lorsque vous employez un espace-noms LDAP pour vous authentifier auprs d'Active Directory Server, vous avez uniquement accs aux fonctions LDAP. Vous ne pouvez pas accder aux fonctions Active Directory, telles que les proprits avances des domaines (p. 267) et la connexion unique l'aide de la dlgation Kerberos (p. 269). Si vous installez Content Manager sur un ordinateur quip de Linux, les restrictions qui s'appliquent sont les mmes que pour UNIX. Vous devez utiliser un espace-noms LDAP pour configurer Active Directory comme source d'authentification. Pour en savoir davantage, reportez-vous la section "Configuration d'un espace-noms LDAP pour Active Directory Server" (p. 279). Si vous souhaitez utiliser Microsoft SQL Server ou Microsoft Analysis Server en tant que source de donnes et utiliser un code d'accs unique pour l'authentification, vous devez utiliser Active Directory en tant que source d'authentification. Vous ne pouvez pas vous connecter au catalogue global Active Directory, qui est un serveur de mise en mmoire cache pour Active Directory Server. Si la connexion utilise le port 3268, vous devez en dfinir un autre. Par dfaut, Active Directory Server utilise le port 389. Pour utiliser un espace-noms Active Directory Server et pour configurer le code d'accs unique, procdez comme suit : Configurez les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espace-noms Active Directory Server. Activez la communication scurise pour Active Directory Server, le cas chant. Activez le code d'accs unique entre Active Directory Server et les composants d'IBM Cognos 8.
Configuration d'un espace-noms Active Directory

Vous pouvez utiliser Active Directory Server en tant que fournisseur d'authentification.
264
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Vous avez galement la possibilit de rendre disponibles des proprits d'utilisateur personnalises d'Active Directory Server dans les composants d'IBM Cognos 8. Pour qu'IBM Cognos 8 fonctionne correctement avec Active Directory Server, vous devez vous assurer que le groupe Utilisateurs authentifis dispose de droits de lecture sur le dossier Active Directory o sont stocks ces utilisateurs. Si vous configurez un espace-noms Active Directory pour prendre en charge un code d'accs unique avec une source de donnes Microsoft SQL Server ou Microsoft Analysis Server, vous devez utiliser la configuration suivante : La passerelle IBM Cognos 8 doit tre installe sur un serveur Web IIS, configur pour l'authentification intgre de Windows. La passerelle doit tre affecte au site Web intranet local dans votre navigateur Web. Content Manager doit tre install sur un serveur Windows 2000 ou Windows 2003. Content Manager, le serveur de rapports (composants d'application), le serveur Web IIS et le serveur de source de donnes (Microsoft SQL Server ou Microsoft Analysis Server) doivent appartenir au domaine Active Directory. La connexion la source de donnes pour Microsoft SQL Server ou Microsoft Analysis Server doit tre configure pour un espace-noms externe et celui-ci doit tre un espace-noms Active Directory. Pour en savoir davantage sur les sources de donnes, reportez-vous au Guide d'administration et de scurit.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. 7. Indiquez les valeurs de la proprit Hte et port.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Pour permettre la prise en charge de la reprise Active Directory Server, vous pouvez indiquer le nom de domaine au lieu d'un contrleur de domaine spcifique. Par exemple, utilisez mon_domaine.com:389 au lieu de dc1.mon_domaine.com:389. 8. Si vous voulez rechercher des dtails lorsque l'authentification choue, indiquez le code d'utilisateur et le mot de passe pour la proprit Rfrences d'identification pour la liaison. Utilisez les rfrences d'identification pour l'utilisateur d'Active Directory Server qui possde des droits de recherche et de lecture pour ce serveur. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer. 10. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.
Mise disposition des proprits d'utilisateur personnalises d'Active Directory pour les composants d'IBM Cognos 8
Vous pouvez utiliser des attributs d'utilisateur arbitraires d'Active Directory Server dans les composants d'IBM Cognos 8. Pour procder cette configuration, vous devez ajouter ces attributs en tant que proprits personnalises pour l'espace-noms Active Directory. Les proprits personnalises sont disponibles en tant que paramtres de session par le biais de Framework Manager. Pour en savoir davantage sur les paramtres de session, reportez-vous au manuel Framework Manager User Guide. Les proprits personnalises peuvent galement tre utilises l'intrieur de blocs de commande servant configurer les sessions et les connexions Oracle. Les blocs de commande peuvent tre utiliss avec les connexions Oracle lgres et les bases de donnes prives virtuelles. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit, Authentification de la fentre Explorateur, cliquez sur l'espace-noms Active Directory. 3. Dans la fentre Proprits, cliquez sur la colonne Valeur situe ct de la proprit Proprits personnalises, puis sur le bouton d'dition. 4. Dans la fentre Valeur - Proprits personnalises, cliquez sur l'option Ajouter. 5. Cliquez sur la colonne Nom et saisissez le nom que les composants d'IBM Cognos 8 doivent utiliser pour le paramtre de session. 6. Cliquez sur la colonne Valeur et saisissez le nom du paramtre de compte dans Active Directory Server. 266
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 7. Rptez les tapes 4 6 pour chaque paramtre personnalis. 8. Cliquez sur OK. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Activation de la communication scurise pour Active Directory Server

Si vous utilisez une connexion SSL pour Active Directory Server, vous devez copier le certificat d'Active Directory Server sur l'ordinateur Content Manager.
Procdure
1. Sur tous les ordinateurs Content Manager, utilisez le navigateur Web pour vous connecter Active Directory Server et copiez le certificat de la racine de l'autorit de certification sur l'ordinateur Content Manager. 2. Ajoutez ce certificat la bibliothque de certificat du compte que vous utilisez pour la session IBM Cognos en cours : Si vous excutez la session IBM Cognos avec un compte d'utilisateur, utilisez le mme navigateur Web que celui utilis l'tape 1 pour importer le certificat de racine de l'autorit de certification dans la bibliothque de certificats de votre compte d'utilisateur. Pour en savoir davantage, reportez-vous la documentation de votre navigateur Web. Si vous excutez la session d'IBM Cognos avec un compte d'ordinateur local, utilisez la console MMC (Microsoft Management Console) pour importer le certificat de racine de l'autorit de certification dans la bibliothque de certificats de l'ordinateur local. Pour en savoir davantage, reportez-vous la documentation de MMC. 3. Dans IBM Cognos Configuration, redmarrez le service comme suit : Dans la fentre Explorateur, cliquez sur Service IBM Cognos 8, puis sur IBM Cognos 8. Dans le menu Oprations, cliquez sur l'option Redmarrer.
Inclusion ou exclusion de domaines l'aide des proprits avances

Lorsque vous configurez un espace-noms d'authentification pour IBM Cognos 8, les utilisateurs d'un seul domaine peuvent se connecter. l'aide des proprits avances d'Active Directory Server, les utilisateurs des domaines (parent-enfant) associs et des arborescences de domaines non connexes du mme groupe de serveurs ont galement la possibilit de se connecter.
Authentification dans une arborescence de domaines

Si vous dfinissez le paramtre chaseReferrals sur true, les utilisateurs du domaine authentifi d'origine et tous les domaines enfants de l'arborescence de domaines peuvent se connecter IBM Cognos 8. Les utilisateurs situs au-dessus du domaine authentifi d'origine ou dans une arborescence de domaines diffrente ne peuvent pas se connecter.
Authentification dans toutes les arborescences de domaines du groupe de serveurs

Si vous dfinissez le paramtre MultiDomainTrees sur true, les utilisateurs de toutes les arborescences de domaines du groupe de serveurs peuvent se connecter IBM Cognos 8.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit, Authentification de la fentre Explorateur, cliquez sur l'espace-noms Active Directory. 3. Dans la fentre Proprits, indiquez la proprit Hte et port : Pour les utilisateurs d'un domaine, indiquez l'hte et le port d'un contrleur de ce domaine. Pour les utilisateurs d'une arborescence de domaines, indiquez l'hte et le port du contrleur de niveau suprieur de l'arborescence. Pour les utilisateurs de toutes les arborescences de domaines du groupe de serveurs, indiquez l'hte et le port de n'importe quel contrleur de domaine du groupe de serveurs.
4. Cliquez dans la colonne Valeur des Proprits avances, puis sur le bouton Modifier. 5. Dans la fentre Valeur - Proprits avances, cliquez sur l'option Ajouter. 6. Dfinissez deux nouvelles proprits, chaseReferrals et MultiDomainTrees, ayant les valeurs suivantes :
Authentification pour
Un domaine Une arborescence de domaines
chaseReferrals
False True
MultiDomainTrees
False False True
Toutes les arborescences de domaines du True groupe de serveurs
7. Cliquez sur OK. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Activation du code d'accs unique entre Active Directory Server et les composants d'IBM Cognos 8
Par dfaut, le fournisseur Active Directory utilise la dlgation Kerberos et s'intgre au serveur Web IIS pour la connexion unique si l'authentification intgre de Windows (auparavant appele stimulation/rponse de Windows NT) est active sur le serveur Web IIS.
268
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Si l'authentification intgre de Windows est active, vous n'tes pas invit saisir nouveau les informations d'authentification lorsque vous accdez au contenu d'IBM Cognos scuris par l'espacenoms Active Directory. Si vous ne souhaitez pas utiliser la dlgation Kerberos, le fournisseur peut tre configur de faon accder la variable d'environnement REMOTE_USER pour obtenir le code d'accs unique. Vous devez dfinir la proprit avance singleSignOnOption sur la valeur IdentityMapping. Vous devez galement indiquer les rfrences d'identification de liaison pour l'espace-noms Active Directory. Microsoft dfinit REMOTE_USER par dfaut lorsque vous activez l'authentification intgre de Windows. Si l'authentification Kerberos est vite, le code d'accs unique aux sources de donnes Microsoft OLAP (MSAS) est impossible.
Procdure de connexion unique l'aide de la dlgation Kerberos

1. Configurez l'authentification intgre de Windows sur le serveur Web IIS. 2. Installez Content Manager sur un ordinateur qui fait partie du domaine, pour les ordinateurs Content Manager actifs et en attente. 3. Configurez les ordinateurs ou le compte d'utilisateur sous lequel Content Manager opre, afin qu'il soit scuris pour la dlgation. Lors de la configuration des ordinateurs l'aide de l'outil Active Directory, ne slectionnez pas l'attribut Compte qui est sensible la casse et ne peut tre dlgu.
Procdure de connexion unique l'aide de REMOTE_USER

1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit, Authentification de la fentre Explorateur, cliquez sur l'espace-noms Active Directory. 3. Cliquez dans la colonne Valeur des Proprits avances, puis sur le bouton Modifier. 4. Dans la bote de dialogue Valeur - Proprits avances, cliquez sur l'option Ajouter. 5. Dans la colonne Nom, saisissez singleSignOnOption 6. Dans la colonne Valeur, saisissez IdentityMapping 7. Cliquez sur OK. 8. Cliquez dans la colonne Valeur de l'option Rfrences d'identification pour la liaison, puis sur le bouton Modifier. 9. Dans la bote de dialogue Valeur - Rfrences d'identification pour la liaison, indiquez un code d'utilisateur et un mot de passe, puis cliquez sur OK. Le fournisseur Active Directory utilise maintenant REMOTE_USER pour la connexion unique. Conseil : Pour utiliser de nouveau la dlgation Kerberos, modifiez les Proprits avances et, dans la colonne Valeur, saisissez KerberosAuthentication.
Configuration d'IBM Cognos 8 pour l'espace-noms IBM Cognos Series 7

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms IBM Cognos Series 7 en tant que fournisseur d'authentification. Les utilisateurs seront authentifis selon la configuration d'authentification et de connexion de l'espace-noms IBM Cognos Series 7. Un espace-noms IBM Cognos Series 7 est requis si vous souhaitez utiliser des cubes IBM Cognos Series 7 et des modles Transformer dans IBM Cognos 8. L'espace-noms doit tre configur avant que vous chargiez les modles Transformer. Pour configurer un espace-noms IBM Cognos Series 7 en tant que source d'authentification, vous devez installer Content Manager sur un ordinateur prenant en charge IBM Cognos Series 7. Remarque : Vous ne pouvez pas utiliser le fichier LAE (exportation d'authentification locale) d'IBM Cognos Series 7 pour l'authentification avec les composants d'IBM Cognos 8. Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent plusieurs fournisseurs d'authentification d'IBM Cognos Series 7. Il est prfrable que tous les espaces-noms IBM Cognos Series 7 utilisent le mme Ticket Server principal d'IBM Cognos Series 7. Dans le cas contraire, vous risquez de voir des messages d'erreur s'afficher ou d'tre invit vous authentifier plusieurs fois. Pour maintenir les performances vrifiez aussi que Ticket Server est en cours d'excution. Si vous modifiez les informations de configuration stockes dans le serveur d'annuaire utilis pour IBM Cognos Series 7, vous devez redmarrer le service IBM Cognos 8 pour que les modifications soient prises en compte dans l'installation d'IBM Cognos. L'utilisateur doit faire partie d'au moins une classe d'utilisateurs Access Manager pour pouvoir se connecter aux composants d'IBM Cognos 8. Pour utiliser un espace-noms IBM Cognos Series 7 et pour configurer le code d'accs unique, procdez comme suit : Configurez IBM Cognos 8 de faon ce qu'il utilise un espace-noms IBM Cognos Series 7. Activez la communication scurise pour le serveur d'annuaire utilis par l'espace-noms IBM Cognos Series 7, le cas chant. Activez le code d'accs unique entre IBM Cognos Series 7 et IBM Cognos 8.
Configuration d'un espace-noms IBM Cognos Series 7

Vous pouvez configurer IBM Cognos 8 de faon ce qu'il utilise un ou plusieurs espaces-noms IBM Cognos Series 7 pour l'authentification.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration.
270
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. Si vous disposez d'un espace-noms IBM Cognos Series 7 version 16.0, vrifiez que la proprit Encodage des donnes est dfinie sur UTF-8. En outre, les ordinateurs sur lesquels Content Manager est install doivent utiliser les mmes paramtres rgionaux que les donnes de l'espacenoms IBM Cognos Series 7. La valeur de l'hte peut tre un nom d'ordinateur ou une adresse IP. Si vous publiez de PowerPlay Enterprise Server vers IBM Cognos 8, vous devez utiliser le mme format de valeurs que celui utilis dans IBM Cognos Series 7 Configuration Manager pour l'emplacement du serveur d'annuaire. Par exemple, si le nom de l'ordinateur est utilis dans IBM Cognos Series 7 Configuration Manager, c'est galement le nom de l'ordinateur qui doit tre utilis dans IBM Cognos Configuration pour IBM Cognos 8. 7. Si votre environnement d'espaces-noms contient l'espace-noms IBM Cognos Series 7 version 15.2, vous devez dsactiver le paramtre Series7NamespacesAreUnicode. Dans la zone Proprits avances de la fentre Proprits, cliquez sur le bouton Modifier. Dans la fentre Valeur - Proprits avances, cliquez sur l'option Ajouter. Dans la zone Nom, saisissez Series7NamespacesAreUnicode. Dans la zone Valeur, saisissez False, puis cliquez sur OK.
8. Dans la section Paramtres de tmoin (cookie) de la fentre Proprits, assurez-vous que les proprits Chemin d'accs, Domaine et Indicateur de scurit activ ? correspondent aux paramtres configurs pour IBM Cognos Series 7. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer. 10. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester.
Activation de la communication scurise pour le serveur d'annuaire utilis par l'espace-noms IBM Cognos Series 7
Si vous utilisez une connexion SSL pour le Directory Server utilis par l'espace-noms IBM Cognos Series 7, vous devez copier le certificat de Directory Server sur chaque ordinateur Content Manager. Pour en savoir davantage, reportez-vous au manuel IBM Cognos Access Manager Administrator Guide et la documentation de Directory Server.
Activation du code d'accs unique entre IBM Cognos Series 7 et IBM Cognos 8
Si votre espace-noms IBM Cognos Series 7 a t configur pour intgrer les mcanismes d'authentification externe associs la connexion unique, le fournisseur d'IBM Cognos Series 7 utilise automatiquement cette configuration. En configurant le code d'accs unique, vous n'tes pas invit saisir nouveau les informations d'authentification lorsque vous accdez au contenu IBM Cognos scuris par l'espace-noms IBM Cognos Series 7.
Procdure
1. Veillez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms IBM Cognos Series 7 en tant que fournisseur d'authentification (p. 270). 2. Pour IBM Cognos Series 7, dmarrez Configuration Manager. 3. Cliquez sur Ouvrir la configuration actuelle. 4. Dans la fentre Explorateur de l'onglet Composants, dveloppez le dossier Services, Access Manager - Excution, puis cliquez sur l'option Paramtres de tmoin (cookie). 5. Dans la fentre Proprits, assurez-vous que les proprits Chemin d'accs, Domaine et Indicateur de scurit activ ? correspondent aux paramtres configurs pour IBM Cognos 8. 6. Enregistrez et fermez Configuration Manager. 7. Si l'espace-noms IBM Cognos Series 7 utilise le module d'extension Trusted Signon pour la connexion unique, vous devez ds maintenant dfinir la fonction SaferAPIGetTrustedSignonWithEnv. Vous pouvez maintenant ajouter des classeurs IBM Cognos Upfront Series 7 aux pages du portail Web IBM Cognos Connection.
Espaces-noms IBM Cognos Series 7 et module d'extension IBM Cognos Series 7 Trusted Signon
Si l'espace-noms IBM Cognos Series 7 utilise le module d'extension Trusted Signon pour la connexion unique, vous devez dfinir la fonction SaferAPIGetTrustedSignonWithEnv dans votre module d'extension. Vous devez ensuite recompiler et redployer la bibliothque pour que la connexion unique prenne effet entre les composants d'IBM Cognos Series 8 et votre mcanisme d'authentification.
272
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification La fonction SaferAPIGetTrustedSignonWithEnv est une version mise jour de la fonction SaferAPIGetTrustedSignon. Cette mise jour est requise car la connexion IBM Cognos 8 n'est pas effectue sur le serveur Web, comme c'est le cas avec les applications IBM Cognos Series 7. Par consquent, il n'est pas possible pour le module d'extension d'effectuer un appel API getenv( ) pour extraire les variables de l'environnement du serveur Web. Le module d'extension peut exiger que des variables d'environnement spcifiques soient supprimes du serveur Web l'aide de la fonction SaferAPIGetTrustedSignonWithEnv. Si vous excutez les produits IBM Cognos Series 7 et IBM Cognos 8 l'aide du mme module d'extension, les fonctions SaferAPIGetTrustedSignonWithEnv et SaferAPIGetTrustedSignon sont requises. Pour en savoir davantage sur la fonction SaferAPIGetTrustedSignon, reportez-vous la documentation IBM Cognos Series 7.
Fonction SaferAPIGetTrustedSignonWithEnv
Pour que les utilisateurs soient authentifis correctement par Access Manager, les codes d'accs au SE doivent exister et tre activs dans l'espace-noms en cours. La mmoire pour les noms trustedSignonName et trustedDomainName renvoys est alloue dans cet API. Si la fonction renvoie SAFER_SUCCESS, Access Manager appelle la fonction SaferAIFreeTrustedSignon pour librer la mmoire alloue. La mmoire de la fonction reqEnvVarList renvoye est alloue dans cet API. Si la fonction renvoie SAFER_INFO_REQUIRED, Access Manager appelle la fonction SaferAPIFreeBuffer() pour librer la mmoire alloue. Les fonctions SaferAPIGetTrustedSignon et SaferAPIFreeBuffer doivent tre mises en uvre pour enregistrer correctement la bibliothque lorsque la fonction SaferAPIGetTrustedSignonWithEnv est mise en uvre. La fonction SaferAPIGetError est ncessaire uniquement si vous voulez que des messages d'erreur prcis soient renvoys partir du module d'extension.
Syntaxe
SaferAPIGetTrustedSignonWithEnv( EnvVar char void unsigned long void unsigned long SAFER_USER_TYPE void envVar[], **reqEnvVarList, **trustedSignonName, *trustedSignonNameLength, **trustedDomainName, *trustedDomainNameLength, *userType, **implementerData); /*[IN]*/ /*[OUT]*/ /*[OUT]*/ /*[OUT]*/ /*[OUT]*/ /*[OUT]*/ /*[OUT]*/ /*[IN/OUT]*/
Paramtre
[in] envVar
Description
Tableau de noms de variable d'environnement et de valeurs extraits du serveur Web. La fin du tableau est reprsente par une entre dote d'un nom envVar Name nul et d'une valeur envVarValue nulle. Notez que la premire fois que cet API est appel, le groupe envVar contient uniquement la fin du repre de tableau. Chane contenant une liste de noms de variable d'environnement spars par une virgule et requis par la mise en uvre Safer. La fin de la liste doit se terminer par une valeur nulle. Squence d'octets identifiant l'utilisateur actuellement authentifi. Cette valeur ne doit pas ncessairement tre nulle. Cette valeur est obligatoire.
[in] reqEnvVarList
[out] trustedSignonName
[out] trustedSignonNameLength Valeur d'entier indiquant la longueur de la fonction trustedSignonName. Cette longueur doit exclure la marque de fin nulle, si elle est prsente. Cette valeur est obligatoire. [out] trustedDomainName Squence d'octets identifiant le domaine de l'utilisateur actuellement authentifi. Cette valeur ne doit pas ncessairement tre nulle. S'il n'y a pas de nom trusted DomainName, le renvoi est nul. Cette valeur est facultative.
[out] trustedDomainNameLength Valeur d'entier indiquant la longueur du nom trustedDomainName. Cette longueur doit exclure la marque de fin nulle, si elle est prsente. Cette valeur est obligatoire et doit tre rgle sur zro s'il n'existe pas de nom trustedDomain Name. [out] userType Valeur indiquant le type d'utilisateur qu'Access Manager doit authentifier. Cette valeur est obligatoire. Les valeurs renvoyes suivantes sont ncessaires pour qu'Access Manager authentifie les utilisateurs correctement : SAFER_NORMAL_USER Utilisateur nomm. Les codes d'accs au SE doivent exister et tre activs dans l'espace-noms actuel. SAFER_GUEST_USER Invit. Un compte d'invit doit exister et tre activ dans l'espace-noms actuel. SAFER_ANONYMOUS_USER Utilisateur anonyme. Le compte d'un utilisateur anonyme doit exister et tre activ dans l'espace-noms actuel.
274
Paramtre
[in/out] implementerData
Description
Pointeur utilis pour conserver les donnes spcifiques la mise en uvre entre les appels. Un appel se produit chaque fois qu'Access Manager sollicite le module d'extension Trusted Signon. Cette valeur est valide uniquement si le module d'extension Trusted Signon est appel et qu'une valeur lui est attribue.
Configuration d'IBM Cognos 8 pour l'utilisation d'un fournisseur d'authentification personnalis

Si vous avez mis en oeuvre un fournisseur d'authentification Java personnalis avec votre infrastructure de scurit existante, vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils l'utilisent. Vous pouvez utiliser un fournisseur d'authentification personnalis pour accder des utilisateurs d'une autre source d'authentification et les authentifier. Vous pouvez galement l'utiliser comme mthode de connexion unique pour intgrer les composants d'IBM Cognos 8 votre infrastructure de scurit. Vous pouvez masquer cet espace-noms de la vue des utilisateurs durant la connexion. Pour en savoir davantage, reportez-vous au manuel Custom Authentication Provider Developer Guide.
Configuration d'un espace-noms d'authentification personnalis

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms d'authentification personnalis. Toute configuration supplmentaire pour l'accs une source d'authentification, le code d'accs unique ou des attributs personnaliss dpend de l'implmentation du fournisseur d'authentification personnalis.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez avec le bouton droit sur l'option Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'option Fournisseur Java personnalis, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:).
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 6. Dfinissez les valeurs de toutes les autres proprits requises pour vous assurer qu'IBM Cognos 8 pourra localiser et utiliser le fournisseur d'authentification existant. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer. 8. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.

Vous pouvez masquer des espaces-noms de la vue des utilisateurs durant la connexion. Vous pouvez disposer d'espaces-noms de codes d'accs scuriss sans qu'ils soient affichs dans la liste de slection des espaces-noms prsente lorsque les utilisateurs se connectent. Par exemple, vous pouvez souhaiter intgrer un code d'accs unique au niveau des systmes, mais conserver la possibilit pour les clients de s'authentifier directement auprs d'IBM Cognos 8 sans tre invit choisir un espace-noms.
Procdure
1. Sur chaque ordinateur o a t configur un fournisseur d'authentification Java personnalis, ouvrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, Authentification, cliquez sur le fournisseur d'authentification Java personnalis. 3. Dans la fentre Proprits, cliquez sur la zone situe en regard de Slectionnable pour authentification, puis cliquez sur l'option Faux. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. L'espace-noms n'est pas affich sur la liste de slection prsente durant la connexion.
Configuration des composants d'IBM Cognos 8 pour LDAP

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms LDAP en tant que fournisseur d'authentification. Vous pouvez utiliser un espace-noms LDAP pour les utilisateurs qui sont stocks dans un annuaire d'utilisateurs LDAP, dans Active Directory Server, IBM Directory Server, Novell Directory Server ou dans Sun Java System Directory Server. Vous pouvez galement utiliser l'authentification LDAP avec des sources de donnes DB2 et Essbase OLAP en indiquant l'espace-noms LDAP lors de la configuration de la connexion la source de donnes. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Vous avez galement la possibilit de rendre disponibles des proprits d'utilisateur personnalises de l'espace-noms LDAP dans les composants d'IBM Cognos 8. Pour lier un utilisateur au serveur LDAP, le fournisseur d'authentification LDAP doit construire le nom unique (DN). Si la proprit Voulez-vous utiliser une identit externe ? a la valeur Vrai, elle 276
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification utilise la proprit Correspondance des identits externes pour tenter de rsoudre le nom unique de l'utilisateur. S'il ne trouve pas la variable d'environnement ou le nom unique dans le serveur LDAP, il essaie d'utiliser la proprit Fichier de rfrence d'utilisateur pour crer le DN. Si les utilisateurs occupent diffrents niveaux hirarchiques dans le serveur d'annuaire, vous pouvez configurer les proprits Fichier de rfrence d'utilisateur et Correspondance des identits externes de faon ce qu'elles utilisent des filtres de recherche. Lorsque le fournisseur d'authentification LDAP effectue des recherches, il utilise les filtres que vous spcifiez pour les proprits Fichier de rfrence d'utilisateur et Correspondance des identits externes. Par ailleurs, il tablit une liaison avec le serveur d'annuaire au moyen de la valeur que vous indiquez pour la proprit Lier le nom unique et le mot de passe de l'utilisateur ou de faon anonyme si aucune valeur n'est prcise. Si un espace-noms LDAP a t configur pour utiliser la proprit Correspondance des identits externes pour l'authentification, le fournisseur LDAP tablit une liaison avec le serveur d'annuaire l'aide de la proprit Lier le nom unique et le mot de passe de l'utilisateur ou de faon anonyme si aucune valeur n'est indique. Tous les utilisateurs qui se connectent IBM Cognos 8 l'aide d'une correspondance des identits externes voient les mmes utilisateurs, groupes et dossiers que l'utilisateur li. Si vous n'utilisez pas la mise en correspondance des identits externes, vous pouvez indiquer si des rfrences d'identification de liaison doivent tre utilises pour rechercher le serveur d'annuaire LDAP en configurant la proprit Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ?. Lorsque cette proprit est active, les recherches sont effectues l'aide des rfrences d'identification de l'utilisateur de liaison ou d'un accs anonyme si aucune valeur n'est indique. Lorsque cette proprit est dsactive (ce qui correspond au paramtre implicite), les recherches sont effectues l'aide des rfrences d'identification de l'utilisateur connect. L'utilisation de rfrences d'identification de liaison prsente l'avantage de pouvoir modifier uniquement les droits d'administration de l'utilisateur de liaison, au lieu de devoir modifier ces droits pour plusieurs utilisateurs. Important : Si vous employez une syntaxe de nom unique (DN), telle que id_unique=${id_utilisateur}, ou=ma_socit.com, pour les proprits Fichier de rfrence d'utilisateur, Correspondance des identits externes ou Lier le nom unique et le mot de passe de l'utilisateur, vous devez protger par chappement tous les caractres spciaux utiliss dans le nom unique. Si vous employez une syntaxe de recherche, telle que (id_unique=${id_utilisateur}, pour les proprits Fichier de rfrence d'utilisateur ou Correspondance des identits externes, vous ne devez pas protger par chappement les caractres spciaux utiliss dans le nom unique. Pour utiliser un espace-noms LDAP et configurer le code d'accs unique, procdez comme suit : Configurez les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espace-noms LDAP. Mettez la disposition des composants d'IBM Cognos 8 les proprits d'utilisateur personnalises, le cas chant. Activez la communication scurise pour le serveur LDAP, le cas chant. Activez le code d'accs unique entre LDAP et les composants d'IBM Cognos 8, le cas chant.
Configuration d'un espace-noms LDAP

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms LDAP lorsque les utilisateurs sont stocks dans un annuaire d'utilisateurs LDAP. Il est possible d'accder l'annuaire d'utilisateurs LDAP partir d'un autre environnement serveur tel qu'Active Directory Server ou eTrust SiteMinder. Si vous configurez un espace-noms LDAP pour un serveur d'annuaire non LDAP, reportez-vous la section approprie : Pour Active Directory Server, reportez-vous la section Configuration d'un espace-noms LDAP pour Active Directory Server. Pour IBM Directory Server, reportez-vous la section Configuration d'un espace-noms LDAP pour IBM Directory Server. Pour Novell Directory Server, reportez-vous la section Configuration d'un espace-noms LDAP pour Novell Directory Server. Pour Sun Java System Directory Server, reportez-vous la section Configuration d'un espacenoms LDAP pour Sun Java System Directory Server
Vous pouvez galement utiliser l'authentification LDAP avec des sources de donnes DB2 et Essbase OLAP en indiquant l'espace-noms LDAP lors de la configuration de la connexion la source de donnes. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. 7. Si, lors de recherches, le fournisseur d'authentification LDAP doit tablir une liaison avec le serveur d'annuaire l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur spcifique, indiquez ces valeurs. Si aucune valeur n'est indique, le fournisseur d'authentification LDAP se lie en tant qu'anonyme.
278
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Si la correspondance des identits externes est active, la proprit Lier le nom unique et le mot de passe de l'utilisateur est utilise pour tous les accs LDAP. Si la correspondance des identits externes n'est pas active, la proprit Lier le nom unique et le mot de passe de l'utilisateur est utilise uniquement lorsqu'un filtre de recherche est indiqu pour la proprit Fichier de rfrence d'utilisateur. Dans ce cas, lorsque le nom unique de l'utilisateur est dfini, les demandes envoyes ultrieurement au serveur LDAP sont excutes dans le contexte d'authentification de l'utilisateur. 8. Si vous n'utilisez pas la mise en correspondance des identits externes, faites appel aux rfrences d'identification de liaison pour effectuer des recherches sur le serveur d'annuaire LDAP. Pour cela, procdez comme suit : Vrifiez que l'option Voulez-vous utiliser une identit externe ? est dfinie sur Faux. Dfinissez l'option Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ? sur Vrai. Indiquez le code d'utilisateur et le mot de passe correspondant l'option Lier le nom unique et le mot de passe de l'utilisateur. Si vous n'indiquez pas de code d'utilisateur et de mot de passe et que l'accs anonyme et activ, la recherche est effectue de faon anonyme. 9. Vrifiez les paramtres de mise en correspondance des objets et attributs requis. En fonction de la configuration LDAP, vous devrez peut-tre modifier certaines valeurs implicites pour garantir une communication correcte entre les composants d'IBM Cognos 8 et le serveur LDAP. Les attributs LDAP qui sont mis en correspondance avec la proprit Nom dans Mise en correspondance des dossiers, Mise en correspondance de groupes et Mise en correspondance de comptes doivent tre accessibles tous les utilisateurs authentifis. En outre, la proprit Nom ne doit pas tre vide. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer. 11. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.
Configuration d'un espace-noms LDAP pour Active Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec Active Directory Server, vous devez modifier les paramtres ncessaires et modifier les valeurs de toutes les proprits des objets Active Directory.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'espace-noms appropri, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. Voici des exemples de paramtres : Pour Fichier de rfrence d'utilisateur, indiquez (sAMAccountName=${ID_utilisateur}) Si vous utilisez un code d'accs unique, pour Voulez-vous utiliser une identit externe ?, dfinissez la valeur sur Vrai. Si vous utilisez un code d'accs unique, pour Correspondance des identits externes, indiquez (sAMAccountName=${environment("REMOTE_USER")}) Si vous souhaitez supprimer le nom de domaine de la variable REMOTE_USER, indiquez (sAMAccountName=${replace(${environment("REMOTE_USER")}, "domain\\","")}). Pour Lier le nom unique et le mot de passe de l'utilisateur, indiquez utilisateur@domaine Pour Identificateur unique, prcisez objectGUID
7. Si, lors de recherches, le fournisseur d'authentification LDAP doit tablir une liaison avec le serveur d'annuaire l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur spcifique, indiquez ces valeurs. Si aucune valeur n'est indique, le fournisseur d'authentification LDAP se lie en tant qu'anonyme. 8. Si vous n'utilisez pas la mise en correspondance des identits externes, faites appel aux rfrences d'identification de liaison pour effectuer des recherches sur le serveur d'annuaire LDAP. Pour cela, procdez comme suit : Vrifiez que l'option Voulez-vous utiliser une identit externe ? est dfinie sur Faux. Dfinissez l'option Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ? sur Vrai. Indiquez le code d'utilisateur et le mot de passe correspondant l'option Lier le nom unique et le mot de passe de l'utilisateur.
280
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 9. Pour configurer les proprits de mise en correspondance avance LDAP utiliser avec les objets Active Directory Server, utilisez les valeurs spcifies dans le tableau ci-dessous. Les attributs LDAP qui sont mis en correspondance avec la proprit Nom dans Mise en correspondance des dossiers, Mise en correspondance de groupes et Mise en correspondance de comptes doivent tre accessibles tous les utilisateurs authentifis. En outre, la proprit Nom ne doit pas tre vide.
Mises en corres- Proprit LDAP pondance

Dossier Classe d'objets Description Nom Groupement Classe d'objets Description Membre Nom Compte Classe d'objets
Valeur LDAP
organizationalUnit,organization,container description ou,o,cn group description member cn user
Tlphone professionnel telephonenumber Paramtres rgionaux du (ne pas saisir de valeur) contenu Description Courrier lectronique Tlcopieur/tlphone Prnom Tlphone priv Tlphone mobile Nom Rcepteur d'appels description mail facsimiletelephonenumber givenname homephone mobile displayName pager

Mot de passe Adresse postale Langue du produit Prnom Nom d'utilisateur
Valeur LDAP
unicodePwd postaladdress (ne pas saisir de valeur) sn sAMAccountName
Ces proprits de correspondances reprsentent des modifications bases sur une installation implicite de Active Directory Server. Si vous avez modifi le schma, vous devrez peut-tre apporter d'autres modifications aux correspondances. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer. 11. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.
Configuration d'un espace-noms LDAP pour IBM Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec IBM Directory Server, vous devez modifier les paramtres ncessaires et modifier les valeurs de toutes les proprits des objets IBM Directory.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur LDAP, puis sur le bouton OK. Le nouvel espace-noms d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms.
282
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les autres proprits requises pour vous assurer qu'IBM Cognos 8 pourra localiser et utiliser l'espace-noms d'authentification existant. Pour Fichier de rfrence d'utilisateur, indiquez (cn=${ID_utilisateur}) Pour Lier le nom unique et le mot de passe de l'utilisateur, prcisez cn=root
7. Si, lors de recherches, le fournisseur d'authentification LDAP doit tablir une liaison avec le serveur d'annuaire l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur spcifique, indiquez ces valeurs. Si aucune valeur n'est indique, l'espace-noms d'authentification LDAP se lie en tant qu'anonyme. 8. Si vous n'utilisez pas la mise en correspondance des identits externes, faites appel aux rfrences d'identification de liaison pour effectuer des recherches sur le serveur d'annuaire LDAP. Pour cela, procdez comme suit : Vrifiez que l'option Voulez-vous utiliser une identit externe ? est dfinie sur Faux. Dfinissez l'option Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ? sur Vrai. Indiquez le code d'utilisateur et le mot de passe correspondant l'option Lier le nom unique et le mot de passe de l'utilisateur. 9. Pour configurer les proprits de mise en correspondance avance LDAP utiliser avec les objets IBM Directory Server, utilisez les valeurs spcifies dans le tableau ci-dessous. Les attributs LDAP qui sont mis en correspondance avec la proprit Nom dans Mise en correspondance des dossiers, Mise en correspondance de groupes et Mise en correspondance de comptes doivent tre accessibles tous les utilisateurs authentifis. En outre, la proprit Nom ne doit pas tre vide.

Dossier Classe d'objets Description Nom Groupement Classe d'objets Description Membre
Valeur LDAP
organizationalunit,organization,container description ou,o,cn groupofnames description member

Nom Compte Classe d'objets Tlphone professionnel
Valeur LDAP
cn inetorgperson telephonenumber
Paramtres rgionaux du (ne pas saisir de valeur) contenu Description Courrier lectronique Tlcopieur/tlphone Prnom Tlphone priv Tlphone mobile Nom Rcepteur d'appels Mot de passe Adresse postale Langue du produit Prnom Nom d'utilisateur description mail facsimiletelephonenumber givenname homephone mobile cn pager userPassword postaladdress (ne pas saisir de valeur) sn uid
Ces proprits de correspondances reprsentent des modifications bases sur une installation implicite de IBM Directory Server. Si vous avez modifi le schma, vous devrez peut-tre apporter d'autres modifications aux correspondances. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
284
Configuration d'un espace-noms LDAP pour Novell Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec Novell Directory Server, vous devez modifier les paramtres ncessaires ainsi que les valeurs de toutes les proprits des objets Novell Directory.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur LDAP, puis sur le bouton OK. Le nouvel espace-noms d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateurd'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les autres proprits requises pour vous assurer qu'IBM Cognos 8 pourra localiser et utiliser l'espace-noms d'authentification existant. Pour Fichier de rfrence d'utilisateur, indiquez (cn=${ID_utilisateur}) Pour Lier le nom unique et le mot de passe de l'utilisateur, indiquez le nom unique de base d'un administrateur, comme cn=Admin,0=COGNOS 7. Si, lors de recherches, le fournisseur d'authentification LDAP doit tablir une liaison avec le serveur d'annuaire l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur spcifique, indiquez ces valeurs. Si aucune valeur n'est indique, l'espace-noms d'authentification LDAP se lie en tant qu'anonyme. 8. Si vous n'utilisez pas la mise en correspondance des identits externes, faites appel aux rfrences d'identification de liaison pour effectuer des recherches sur le serveur d'annuaire LDAP. Pour cela, procdez comme suit : Vrifiez que l'option Voulez-vous utiliser une identit externe ? est dfinie sur Faux. Dfinissez l'option Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ? sur Vrai. Indiquez le code d'utilisateur et le mot de passe correspondant l'option Lier le nom unique et le mot de passe de l'utilisateur.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 9. Pour configurer les proprits de mise en correspondance avance LDAP employer avec les objets Novell Directory Server, utilisez les valeurs indiques dans le tableau ci-dessous. Les attributs LDAP qui sont mis en correspondance avec la proprit Nom dans Mise en correspondance des dossiers, Mise en correspondance de groupes et Mise en correspondance de comptes doivent tre accessibles tous les utilisateurs authentifis. En outre, la proprit Nom ne doit pas tre vide. Pour pouvoir se connecter IBM Cognos Connection, les utilisateurs doivent disposer de droits leur permettant de lire les attributs ou et o.

Dossier Classe d'objets Description Nom Groupement Classe d'objets Description Membre Nom Compte Classe d'objets Tlphone professionnel
Valeur LDAP
organizationalunit,organization,container description ou,o,cn groupofnames description member cn inetOrgPerson telephonenumber
Paramtres rgionaux du Langue contenu Description Courrier lectronique Tlcopieur/tlphone Prnom Tlphone priv Tlphone mobile Nom description mail facsimiletelephonenumber givenname homephone mobile cn
286

Rcepteur d'appels Mot de passe Adresse postale Langue du produit Prnom Nom d'utilisateur
Valeur LDAP
pager (ne pas saisir de valeur) postaladdress Langue sn uid
Ces proprits de correspondances reprsentent des modifications apportes par rapport une installation implicite de Novell Directory Server. Si vous avez modifi le schma, vous devrez peut-tre apporter d'autres modifications aux correspondances. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration d'un espace-noms LDAP pour Sun Java System Directory Server
Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec Sun Java System Directory Server, vous devez modifier les paramtres ncessaires, ainsi que les valeurs de toutes les proprits des objets Sun Java System Directory.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur LDAP, puis sur le bouton OK. Le nouvel espace-noms d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateurd'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les autres proprits requises pour vous assurer qu'IBM Cognos 8 pourra localiser et utiliser l'espace-noms d'authentification existant. Guide d'installation et de configuration 287
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Voici des exemples de paramtres : Pour Fichier de rfrence d'utilisateur, indiquez (uid=${userID}). Si vous utilisez un code d'accs unique, pour Voulez-vous utiliser une identit externe ?, dfinissez la valeur sur Vrai. Si vous utilisez un code d'accs unique, pour Correspondance des identits externes, dfinissez un attribut, tel que l'identifiant de domaine utilisateur NT ou le code d'utilisateur : (ntuserdomainid=$environment("REMOTE_USER")}) (uid=${environment("REMOTE_USER")}) Pour Identificateur unique, saisissez nsuniqueid
7. Si, lors de recherches, le fournisseur d'authentification LDAP doit tablir une liaison avec le serveur d'annuaire l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur spcifique, indiquez ces valeurs. Si aucune valeur n'est indique, l'espace-noms d'authentification LDAP se lie en tant qu'anonyme. 8. Si vous n'utilisez pas la mise en correspondance des identits externes, faites appel aux rfrences d'identification de liaison pour effectuer des recherches sur le serveur d'annuaire LDAP. Pour cela, procdez comme suit : Vrifiez que l'option Voulez-vous utiliser une identit externe ? est dfinie sur Faux. Dfinissez l'option Voulez-vous utiliser des rfrences d'identification de liaison pour la recherche ? sur Vrai. Indiquez le code d'utilisateur et le mot de passe correspondant l'option Lier le nom unique et le mot de passe de l'utilisateur. 9. Pour configurer les proprits de mise en correspondance avance LDAP utiliser avec les objets Sun Java System Directory Server, employez les valeurs indiques dans le tableau cidessous. Les attributs LDAP qui sont mis en correspondance avec la proprit Nom dans Mise en correspondance des dossiers, Mise en correspondance de groupes et Mise en correspondance de comptes doivent tre accessibles tous les utilisateurs authentifis. En outre, la proprit Nom ne doit pas tre vide.
Mises en correspo- Proprit LDAP ndance

Dossier Classe d'objets Description Nom Groupement Classe d'objets
Valeur LDAP
organizationalUnit,organization description ou,o groupofuniquenames
288
Mises en correspo- Proprit LDAP ndance

Description Membre Nom Compte Classe d'objets Tlphone professionnel Paramtres rgionaux du contenu Description Courrier lectronique Tlcopieur/tlphone Prnom Tlphone priv Tlphone mobile Nom Rcepteur d'appels Mot de passe Adresse postale Langue du produit Prnom Nom d'utilisateur
Valeur LDAP
description uniquemember cn inetorgperson telephonenumber preferredlanguage
description mail facsimiletelephonenumber givenname homephone mobile cn pager userPassword postaladdress preferredlanguage sn uid
Ces proprits de mise en correspondance reprsentent des modifications bases sur une installation implicite de Sun Java System Directory Server. Si vous avez modifi le schma, vous devrez peut-tre apporter d'autres modifications aux correspondances. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer. Guide d'installation et de configuration 289
Mise disposition des proprits d'utilisateur personnalises de LDAP pour les composants d'IBM Cognos 8
Vous pouvez utiliser des attributs d'utilisateur arbitraires de votre fournisseur d'authentification LDAP dans les composants d'IBM Cognos 8. Pour procder cette configuration, vous devez ajouter ces attributs en tant que proprits personnalises pour l'espace-noms LDAP. Les proprits personnalises sont disponibles en tant que paramtres de session par le biais de Framework Manager. Pour en savoir davantage sur les paramtres de session, reportez-vous au manuel Framework Manager User Guide. Les proprits personnalises peuvent galement tre utilises l'intrieur de blocs de commande servant configurer les sessions et les connexions Oracle. Les blocs de commande peuvent tre utiliss avec les connexions Oracle lgres et les bases de donnes prives virtuelles. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Procdure
1. Sur chaque ordinateur sur lequel vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit, de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez sur l'espace-noms LDAP. 3. Dans la fentre Proprits, cliquez sur la colonne Valeur situe ct de la proprit Proprits personnalises, puis sur le bouton d'dition. 4. Dans la fentre Valeur - Proprits personnalises, cliquez sur l'option Ajouter. 5. Cliquez sur la colonne Nom et saisissez le nom que les composants d'IBM Cognos 8 doivent utiliser pour le paramtre de session. 6. Cliquez sur la colonne Valeur et saisissez le nom du paramtre de compte dans votre fournisseur d'authentification LDAP. 7. Rptez les deux tapes prcdentes (indiques par des puces) pour chaque paramtre personnalis. 8. Cliquez sur OK. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Activation de la communication scurise pour le serveur LDAP

Le protocole LDAP scuris (LDAPS) chiffre les communications entre le composant Access Manager de Content Manager et le serveur d'annuaire. LDAPS empche l'envoi des informations confidentielles du serveur d'annuaire et des rfrences d'identification LDAP sous forme de texte en clair. Pour activer LDAPS, installez un certificat de serveur sign par une autorit de certification sur le serveur d'annuaire. Crez ensuite une base de donnes de certificats contenant les certificats. Configurez enfin le serveur d'annuaire et l'espace-noms LDAP IBM Cognos 8 pour LDAPS. Le certificat du serveur doit tre une copie d'un des lments suivants : 290
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification le certificat racine approuv et tous les autres certificats composant la chane d'approbation du certificat du serveur d'annuaire. Le certificat racine approuv est celui de l'autorit de certification racine ayant sign le certificat du serveur d'annuaire. le certificat du serveur d'annuaire uniquement.
Ces certificats doivent tre au format Base64 encod en ASCII (PEM). Hormis le certificat racine approuv, les certificats ne doivent pas tre auto-signs. Vous devez utiliser l'outil certutil de la bote outils Netscape OpenSource NSS_3_3_2_RTM pour crer la base de donnes de certificats. IBM Cognos 8 n'accepte pas les autres versions des fichiers cert7.db, y compris celles associes l'outil certutil fourni avec Microsoft Active Directory. L'outil certutil appropri est disponible l'adresse ftp://ftp.mozilla.org/pub/mozilla.org/security/nss/releases/ NSS_3_3_2_RTM. Pour UNIX et Linux, vous devez galement utiliser la bibliothque NSPR, qui est disponible sur le site ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases/v4.1.2.
Procdure
1. Crez un rpertoire pour la base de donnes de certificats. 2. Crez la base de donnes de certificats en saisissant certutil -N -d rpertoire_certificats o rpertoire_certificats est le rpertoire cr l'tape 1. Cette commande cre un fichier cert7.db et un fichier key3.db dans le nouveau rpertoire. 3. Ajoutez le certificat de l'autorit de certification ou le certificat du serveur d'annuaire la base de donnes de certificats en saisissant la commande correspondant au type de certificat : Pour un certificat d'autorit de certification, saisissez certutil -A -n nom_certificat -d rpertoire_certificats -i CA.cert -t C,C,C Pour un certificat de serveur d'annuaire, saisissez certutil -A -n nom_certificat -d rpertoire_certificats -i certificat_serveur.cert -t P o nom_certificat est un alias que vous attribuez, tel que le nom d'hte ou le nom de l'autorit de certification; et certificat_serveur est le prfixe du fichier de certificat du serveur d'annuaire. 4. Copiez le rpertoire de la base de donnes de certificats dans le rpertoire emplacement_c8/configuration sur chaque ordinateur o Content Manager est install. 5. Configurez le serveur d'annuaire pour LDAPS et redmarrez-le. Pour en savoir davantage, reportez-vous la documentation du serveur d'annuaire. 6. Sur l'ordinateur Content Manager o vous avez configur l'espace-noms LDAP pour le serveur d'annuaire, dmarrez IBM Cognos Configuration. 7. Dans la section Scurit, de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez sur l'espace-noms LDAP. Guide d'installation et de configuration 291
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 8. Dans la fentre Proprits, pour la proprit Hte et port, remplacez le port en cours par le port LDAPS scuris. Pour la proprit Base de donnes de certificats SSL, indiquez le chemin d'accs au fichier cert7.db. 9. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'espace-noms LDAP, puis cliquez sur Tester. Si le test choue, rexaminez les proprits pour vrifier que le certificat appropri est utilis. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer. 11. Dans le menu Oprations, cliquez sur l'option Redmarrer. 12. Rptez les tapes 6 11 pour tout autre ordinateur o Content Manager est install.
Activation du code d'accs unique entre LDAP et les composants d'IBM Cognos 8
Pour bnficier de la connexion unique aux composants d'IBM Cognos 8, vous devez configurer la proprit Correspondance des identits externes. La correspondance des identits externes peut faire rfrence une variable d'environnement CGI ou un en-tte HTTP variable. Dans le cas d'une entre de passerelle ou de distributeur de serveur d'application pointant vers les composants d'IBM Cognos 8, la correspondance des identits externes peut faire rfrence la variable de session userPrincipalName. La valeur rsolue de la proprit de correspondance des identits externes en excution doit tre un nom de domaine d'utilisateur valide. Si un espace-noms LDAP est configur pour utiliser la proprit Correspondance des identits externes pour l'authentification, le fournisseur LDAP se lie au serveur d'annuaire l'aide de la proprit Lier le nom unique et le mot de passe de l'utilisateur ou de faon anonyme si aucune valeur n'est indique. Tous les utilisateurs qui se connectent IBM Cognos 8 l'aide d'une correspondance des identits externes voient les mmes utilisateurs, groupes et dossiers que l'utilisateur li. Si vous voulez qu'IBM Cognos 8 fonctionne avec des applications utilisant la scurit du serveur d'application ou Java, vous pouvez configurer la proprit Correspondance des identits externes pour obtenir le code d'utilisateur partir de l'identificateur principal de l'utilisateur Java. Ajoutez la valeur token ${environment("USER_PRINCIPAL")} la valeur de la proprit. Pour en savoir davantage, reportez-vous l'aide en ligne d'IBM Cognos Configuration. Vous pouvez appliquer une modification limite de l'expression la proprit Correspondance des identits externes l'aide de l'opration de remplacement.
Opration de remplacement
L'opration de remplacement renvoie une copie de la chane avec toutes les occurrences de la souschane prcdente remplaces par la nouvelle sous-chane. Les rgles suivantes s'appliquent : Le caractre \ est utilis comme caractre d'chappement dans les paramtres de la fonction. Les caractres \ et " doivent tre utiliss pour l'chappement.
292
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Les appels de fonction imbrique ne sont pas pris en charge. Les caractres spciaux ne sont pas pris en charge.
Syntaxe
${replace(chane , ancienne , nouvelle)}
Paramtre
chane ancienne nouvelle
Description
Chane rechercher. Sous-chane remplacer par la nouvelle sous-chane. Sous-chane remplaant l'ancienne sous-chane.
Exemples
${replace(${environment("REMOTE_USER")},"NAMERICA\\",)} ${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}
Configuration des composants d'IBM Cognos 8 pour eTrust SiteMinder

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent l'espace-noms SiteMinder de Netegrity en tant que source d'authentification, condition que Content Manager soit install sur un ordinateur ne fonctionnant pas sous Linux. Pour configurer un fournisseur d'authentification dans un environnement eTrust SiteMinder, vous devez configurer un espace-noms LDAP, NTLM ou Netegrity SiteMinder en fonction de la configuration de votre solution eTrust SiteMinder. Les configurations eTrust SiteMinder prises en charge sont les annuaires d'utilisateurs LDAP, Active Directory Server et NTLM. Remarque : Le fournisseur d'authentification utilise un SDK eTrust SiteMinder pour mettre en uvre un agent personnalis ; en outre, le dploiement de cet agent personnalis exige que les proprits d'agent dfinies dans la console d'administration du serveur de stratgies eTrust SiteMinder soient configures de faon prendre en charge des agents 4.x.
Si eTrust SiteMinder est configur pour plusieurs annuaires d'utilisateurs

Si vous avez configur eTrust SiteMinder pour plusieurs annuaires d'utilisateurs, vous devez utiliser l'espace-noms Netegrity SiteMinder. Aprs avoir configur l'espace-noms Netegrity SiteMinder dans IBM Cognos 8, vous devez galement ajouter un espace-noms LDAP, Active Directory Server ou NTLM correspondant la configuration IBM Cognos, pour chaque annuaire d'utilisateurs dfini dans eTrust SiteMinder. Lorsque vous configurez un espace-noms LDAP correspondant, vous devez veiller activer la proprit Correspondance des identits externes et inclure l'unit syntaxique REMOTE_USER dans la valeur de la proprit. Cela ne veut pas dire que la solution eTrust SiteMinder doit tre configure
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification pour dfinir REMOTE_USER. Dans IBM Cognos, l'espace-noms Netegrity SiteMinder communique en interne les informations sur l'utilisateur l'espace-noms LDAP correspondant lorsqu'il reoit un code d'utilisateur correct en provenance de l'environnement eTrust SiteMinder. Lorsque vous configurez un espace-noms Active Directory correspondant, vous devez vous assurer que la proprit singleSignOnOption est dfinie sur IdentityMapping. L'espace-noms Netegrity SiteMinder d'IBM Cognos communique en interne les informations sur l'utilisateur l'espace-noms LDAP correspondant l'aide de la variable d'environnement REMOTE_USER lorsqu'il reoit un code d'utilisateur correct en provenance de l'environnement eTrust SiteMinder. Pour en savoir davantage, reportez-vous la section "Activation du code d'accs unique entre Active Directory Server et les composants d'IBM Cognos 8" (p. 268).
Si eTrust SiteMinder est configur avec un seul annuaire d'utilisateurs

Lorsque la solution eTrust SiteMinder est configure avec un seul annuaire d'utilisateurs, l'espacenoms Netegrity SiteMinder n'est pas requis. Vous pouvez utiliser l'annuaire d'utilisateurs en tant que source d'authentification en configurant l'espace-noms appropri ou bien configurer le fournisseur eTrust SiteMinder avec un annuaire d'utilisateurs. Par exemple, lorsque l'annuaire d'utilisateurs eTrust SiteMinder est NTML, vous pouvez configurer les composants d'IBM Cognos 8 avec un espace-noms NTLM ou avec un espace-noms Netegrity SiteMinder, en faisant rfrence un annuaire d'utilisateurs constituant un espace-noms NTLM. Si l'annuaire d'utilisateurs de la solution eTrust SiteMinder est Active Directory, vous pouvez utiliser un espace-noms Active Directory ou LDAP configur pour Active Directory. Si vous voulez directement employer l'annuaire d'utilisateurs en tant que source d'authentification au lieu de configurer un espace-noms Netegrity SiteMinder, configurez l'espace-noms LDAP (p. 278), Active Directory (p. 279) ou NTLM (p. 297) appropri. Dans ce cas, vous devez vrifier les proprits d'objet de configuration d'agent sur le serveur de stratgies eTrust SiteMinder. Assurez-vous que SetRemoteUser est activ. Lorsque vous configurez l'espace-noms LDAP, vous devez veiller activer la proprit Correspondance des identits externes et inclure l'unit syntaxique REMOTE_USER dans la valeur de la proprit. Lorsque vous configurez l'espace-noms Active Directory, vous devez vous assurer que la proprit singleSignOnOption est dfinie sur IdentityMapping. Pour en savoir davantage, reportez-vous la section "Activation du code d'accs unique entre Active Directory Server et les composants d'IBM Cognos 8" (p. 268). Pour utiliser un espace-noms eTrust SiteMinder et configurer le code d'accs unique, procdez comme suit : Configurez les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espace-noms Netegrity SiteMinder. Activez la communication scurise pour l'annuaire d'utilisateurs de la solution eTrust SiteMinder, le cas chant. Activez le code d'accs unique entre eTrust SiteMinder et IBM Cognos 8. Protgez l'alias Web IBM Cognos.
294
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Vous pouvez masquer cet espace-noms de la vue des utilisateurs durant la connexion.(p. 276)
Configuration d'un espace-noms Netegrity SiteMinder

Si vous avez configur eTrust SiteMinder pour plusieurs annuaires d'utilisateurs, vous devez utiliser l'espace-noms Netegrity SiteMinder. Aprs avoir ajout l'espace-noms Netegrity SiteMinder, vous devez galement ajouter un espace-noms LDAP ou NTLM adquat pour chaque annuaire d'utilisateurs. Vous pouvez galement configurer un espace-noms Netegrity SiteMinder si les utilisateurs sont stocks dans : un serveur LDAP, un serveur NTLM, un serveur Active Directory.
Procdure
1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez avec le bouton droit sur l'option Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'espace-noms SiteMinder de Netegrity, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. 7. Dans la section Scurit, puis Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'espace-noms, puis cliquez sur les options Nouvelle ressource et Serveur de stratgies SiteMinder. 8. Dans la zone Nom, saisissez un nom pour le serveur de stratgies, puis cliquez sur le bouton OK. 9. Dans la fentre Proprits, dfinissez la proprit Hte et modifiez les valeurs de proprit de votre choix. 10. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur le nouveau serveur de stratgies SiteMinder, puis cliquez sur les options Nouvelle ressource et Annuaire d'utilisateurs.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Conseil : Configurez un annuaire d'utilisateurs pour chaque annuaire d'utilisateurs du serveur de stratgies SiteMinder. 11. Dans la zone Nom, saisissez un nom pour l'annuaire d'utilisateurs, puis cliquez sur le bouton OK. Important : Le nom de l'annuaire d'utilisateurs doit correspondre au nom apparaissant sur le serveur de stratgies. 12. Dans la fentre Proprits, saisissez une valeur pour la proprit Rfrence d'identification de l'espace-noms. 13. Dans le menu Fichier, cliquez sur l'option Enregistrer. 14. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. 15. Configurez un espace-noms LDAP, Active Directory ou NTLM correspondant pour chaque annuaire d'utilisateurs LDAP, Active Directory ou NTLM. Important : Veillez utiliser la mme valeur pour la proprit Identificateur d'espace-noms que pour la proprit Identificateur d'espace-noms de l'espace-noms Netegrity SiteMinder.
Activation de la communication scurise pour l'annuaire d'utilisateurs eTrust SiteMinder

Si vous utilisez une connexion SSL pour le serveur d'annuaire, vous devez configurer correctement l'espace-noms IBM Cognos pour l'annuaire d'utilisateurs. Pour en savoir davantage, reportez-vous la section "Configuration d'un espace-noms LDAP" (p. 278).
Activation du code d'accs unique entre eTrust SiteMinder et IBM Cognos 8

En configurant le code d'accs unique, vous n'tes pas invit saisir de nouveau les informations d'authentification. Les composants d'IBM Cognos 8 font automatiquement rfrence au tmoin de session eTrust SiteMinder pour les donnes de session de l'utilisateur. Lorsque l'annuaire d'utilisateurs eTrust SiteMinder est LDAP ou Active Directory, vous devez le configurer de faon ce qu'il utilise la correspondance des identits externes avec la variable d'environnement REMOTE_USER. Si l'annuaire d'utilisateurs eTrust SiteMinder est NTLM, l'authentification intgre de Windows est utilise pour la connexion unique et aucune configuration supplmentaire n'est requise.
Protection de l'alias Web IBM Cognos

eTrust SiteMinder doit tre configur correctement pour protger l'alias Web IBM Cognos.
296
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification Utilisez l'outil de test fourni avec eTrust SiteMinder pour vrifier si la ressource est protge, authentifie et autorise. Pour en savoir davantage, reportez-vous la documentation sur eTrust SiteMinder.

Vous pouvez masquer des espaces-noms de la vue des utilisateurs durant la connexion. Vous pouvez disposer d'espaces-noms de codes d'accs scuriss sans qu'ils soient affichs dans la liste de slection des espaces-noms prsente lorsque les utilisateurs se connectent. Par exemple, vous pouvez souhaiter intgrer un code d'accs unique au niveau des systmes, mais conserver la possibilit pour les clients de s'authentifier directement auprs d'IBM Cognos 8 sans tre invit choisir un espace-noms.
Procdure
1. Sur chaque ordinateur o a t configur un fournisseur d'authentification eTrust SiteMinder, ouvrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, Authentification, cliquez sur le fournisseur d'authentification Netegrity Siteminder. 3. Dans la fentre Proprits, cliquez sur la zone situe en regard de Slectionnable pour authentification, puis cliquez sur l'option Faux. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. L'espace-noms n'est pas affich sur la liste de slection prsente durant la connexion.
Configuration des composants d'IBM Cognos 8 pour un espacenoms NTLM

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent la scurit native Windows, NT LAN Manager (NTLM), en tant que source d'authentification. Si vous n'utilisez pas NTLM dans votre environnement IS, vous ne pouvez pas utiliser un espacenoms NTLM. Si vous souhaitez utiliser un annuaire d'utilisateurs NTLM en tant que source d'authentification avec eTrust SiteMinder, vous devez vrifier les proprits d'objet de configuration d'agent sur le serveur de stratgies eTrust SiteMinder. Assurez-vous que SetRemoteUser est activ. Pour utiliser NTLM et configurer le code d'accs unique, procdez comme suit : configurez un espace-noms NTLM, Activez le code d'accs unique entre NTLM et les composants d'IBM Cognos 8.
Configuration d'un espace-noms NTLM

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espacenoms NTLM lorsque les utilisateurs sont stocks dans un annuaire d'utilisateurs NTLM. Vous
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification pouvez galement avoir accs l'annuaire d'utilisateurs NTLM en utilisant un fournisseur d'authentification eTrust SiteMinder.
Procdure
1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez avec le bouton droit sur l'option Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification. 4. Dans la liste Type, cliquez sur l'option NTLM, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer. 8. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.
Activation du code d'accs unique entre NTLM et les composants d'IBM Cognos 8
Par dfaut, le fournisseur NTLM IBM Cognos s'intgre au serveur Web IIS pour la connexion unique si l'authentification intgre de Windows (auparavant nomme stimulation/rponse de Windows NT) est active sur le serveur Web IIS. Si l'authentification intgre de Windows est active, vous n'tes pas invit saisir nouveau les informations d'authentification lorsque vous accdez au contenu IBM Cognos scuris par l'espacenoms NTLM.
Procdure
1. Configurez l'authentification intgre de Windows sur le serveur Web IIS. 2. Installez Content Manager sur un ordinateur qui fait partie du domaine, pour les ordinateurs Content Manager actifs et en attente. 3. Configurez les ordinateurs ou le compte d'utilisateur sous lequel Content Manager opre, afin qu'il soit scuris pour la dlgation.
298
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 4. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. IBM Cognos 8 charge, initialise et configure les bibliothques du fournisseur de l'espace-noms concern.
Configuration d'IBM Cognos 8 pour l'utilisation de SAP

Pour utiliser un serveur SAP en tant que fournisseur d'authentification, vous devez employer une version prise en charge de SAP BW. Pour consulter une liste jour des environnements pris en charge par les produits IBM Cognos, tels que les systmes d'exploitation, les correctifs, les navigateurs, les serveurs Web, d'annuaire, de bases de donnes et d'applications, consultez le site Web Cognos Software Services (http://support.cognos.com). En outre, Content Manager doit tre install sur un ordinateur non-Linux. Dans SAP BW, vous pouvez affecter des utilisateurs des groupes d'utilisateurs, des rles ou les deux. Le fournisseur d'authentification SAP n'utilise que des rles. Les droits d'autorisation requis par l'utilisateur SAP dpendent du statut de la personne qui emploie les composants d'IBM Cognos 8 (utilisateur ou administrateur).
Paramtres d'autorisation SAP pour les utilisateurs d'IBM Cognos 8

Les objets d'autorisation suivants sont requis pour tous les utilisateurs d'IBM Cognos. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
S_RFC Contrle d'autorisation pour l'accs RFC
Zone
Activit
Valeur
Nom de RFC prot- RFC1 RS_UNIFICATION, SDTX, ger SH3A, SU_USER, SYST, SUSO Type de RFC prot- FUGR ger S_USER_GRP Maintenance principale des utilisateurs : Groupe d'utilisateurs Nom du groupe d'utilisateurs * Activit 03
Paramtres d'autorisation SAP pour les administrateurs d'IBM Cognos

Si des utilisateurs souhaitent effectuer des tches d'administration et rechercher des utilisateurs ou des rles, les valeurs suivantes doivent tre ajoutes l'objet d'autorisation S_RFC, en plus des valeurs cites ci-dessus pour les utilisateurs d'IBM Cognos 8. Certaines valeurs affiches, telles que * sont les valeurs implicites que vous pouvez modifier pour votre environnement.
S_RFC Contrle d'autorisation pour l'accs RFC
Zone
Activit
Valeur
16
RFC_NAME Type d'objet RFC protger
PRGN_J2EE, SHSS, SOA3 FUGR
Connectivit entre SAP BW et IBM Cognos 8 sous UNIX

Pour configurer la connectivit entre SAP BW et les composants d'IBM Cognos 8 sur un systme d'exploitation UNIX, veillez installer le fichier de bibliothque partage SAP (fourni par SAP) et l'ajouter la variable d'environnement de chemin d'accs aux bibliothques, comme suit : Solaris LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<rpertoire_librfccm.so> HP-UX SHLIB_PATH=$SHLIB_PATH :<rpertoire_librfccm.sl> AIX LIBPATH=$LIBPATH :<rpertoire_librfc.a> Pour utiliser SAP et configurer le code d'accs unique, procdez comme suit : Configurez les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un espace-noms SAP. Activez le code d'accs unique entre SAP et les composants d'IBM Cognos 8.
Configuration d'un espace-noms SAP

Vous pouvez configurer les composants d'IBM Cognos 8 de faon ce qu'ils utilisent un serveur SAP en tant que source d'authentification.
Procdure
1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification.
300
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 4. Dans la liste Type, cliquez sur SAP, puis sur le bouton OK. Le nouveau fournisseur d'authentification s'affiche dans la fentre Explorateur, sous le composant Authentification. 5. Dans la fentre Proprits, pour la proprit Identificateur d'espace-noms, indiquez un identificateur unique pour l'espace-noms. Conseil : La proprit Identificateur d'espace-noms ne doit pas contenir de signe deux-points (:). 6. Dfinissez les valeurs de toutes les proprits requises pour vous assurer que les composants d'IBM Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant. En fonction de votre environnement, pour la proprit Hte, vous devrez peut-tre ajouter la chane du routeur SAP au nom d'hte SAP. 7. Si le systme SAP code le contenu des paramtres de tmoin (cookie), activez la fonction de dcodage des permis : Dans la fentre Proprits, pour l'option Proprits avances, cliquez sur la valeur puis sur le bouton Modifier. Cliquez sur Ajouter. Saisissez le nom URLDecodeTickets et indiquez la valeur true Cliquez sur OK.
Tous les permis de connexion SAP seront dcods par l'espace-noms SAP avant l'tablissement de la connexion. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. 9. Testez la connexion un nouvel espace-noms. Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester.
Activation du code d'accs unique entre SAP et IBM Cognos 8

Vous pouvez activer le code d'accs unique entre SAP Enterprise Portal et les composants d'IBM Cognos 8, ainsi qu'utiliser la fonction d'espace-noms externe des connexions la source de donnes SAP BW. Pour ce faire, veillez dfinir les paramtres systme suivants sur le serveur SAP BW : login/accept_sso2_ticket = 1 login/create_sso2_ticket = 1 login/ticket_expiration_time = 200
Test des espaces-noms

Aprs avoir configur un ou plusieurs espaces-noms pour les composants d'IBM Cognos 8, vous pouvez les tester. Ce test peut avoir lieu avant ou aprs le dmarrage du service IBM Cognos 8. Les espaces-noms peuvent tre tests simultanment ou individuellement.
Procdure permettant de tester l'ensemble des espaces-noms

Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur Authentification, puis cliquez sur l'option Tester. Les composants d'IBM Cognos 8 chargent, initialisent et configurent les bibliothques du fournisseur d'un espace-noms avant de passer au suivant. Conseil : Pour annuler le test d'un espace-noms, cliquez sur Annuler. Le test s'arrte lorsque l'espace-noms en cours a entirement t test.
Procdure pour un seul espace-noms

Dans la section Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester. Les composants d'IBM Cognos 8 chargent, initialisent et configurent les bibliothques du fournisseur de l'espace-noms concern.
Suppression d'un fournisseur d'authentification

Vous pouvez supprimer des espaces-noms que vous avez ajouts ou des espaces-noms non configurs que les composants d'IBM Cognos 8 ont dtects, si ceux-ci ne sont plus requis. Important : Vous ne devez pas supprimer l'espace-noms IBM Cognos. Il contient des donnes d'authentification qui appartiennent tous les utilisateurs et il est ncessaire pour l'enregistrement de la configuration. Lorsque vous supprimez un espace-noms, vous ne pouvez plus vous y connecter. Les donnes de scurit de l'espace-noms sont conserves dans Content Manager jusqu' ce que vous les supprimiez dfinitivement du portail. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Une fois l'espace-noms supprim, il apparat comme inactif dans le portail.
Procdure
1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la section Scurit, Authentification de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'espace-noms et slectionnez Supprimer. 3. Cliquez sur le bouton Oui pour confirmer. L'espace-noms disparat de la fentre Explorateur et vous ne pouvez plus vous connecter l'espace-noms sur cet ordinateur. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. 302
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification 5. Rptez les tapes 1 4 pour chaque ordinateur sur lequel vous avez install Content Manager. Vous devez dsormais vous connecter au portail et supprimer les donnes de l'espace-noms de manire permanente. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
304
Chapitre 11: Options de configuration

Aprs avoir install et configur IBM Cognos 8, vous pouvez modifier la configuration en fonction de votre environnement. Initialement, les paramtres de proprit implicites servent configurer les composants. Toutefois, vous pouvez modifier ces paramtres implicites si les conditions rendent les choix implicites inadquats ou si vous souhaitez qu'ils soient plus adapts votre environnement. Par exemple, vous pouvez configurer les fonctions d'IBM Cognos Application Firewall ou indiquer la quantit de ressources utilises par IBM Cognos 8. Vous pouvez galement afficher le contenu d'IBM Cognos l'aide d'un autre portail en configurant Portal Services. Vous pouvez configurer IBM Cognos 8 pour l'utilisation d'autres ressources, telles que l'emploi d'un fournisseur d'authentification et l'activation du code d'accs unique pour les utilisateurs et la connexion la base de donnes. Si vous utilisez un systme d'quilibrage de charge dans votre environnement, vous pouvez modifier les paramtres pour amliorer les performances. Par exemple, vous pouvez quilibrer des demandes parmi les distributeurs en modifiant leur capacit de traitement ou en dfinissant le nombre maximal et minimal de processus et de connexions. Pour en savoir davantage sur l'optimisation des performances des serveurs, reportez-vous au Guide d'administration et de scurit. Si vous effectuez une mise niveau partir de ReportNet, vous avez le choix entre plusieurs options de configuration, selon que vous souhaitez continuer utiliser votre installation existante. Pour en savoir davantage sur les options de mise niveau, reportez-vous la section "Mise niveau depuis ReportNet, Metrics Manager ou des versions antrieures d'IBM Cognos 8" (p. 85). Pour toutes les installations sous Windows et la plupart des installations sous UNIX et Linux, utilisez IBM Cognos Configuration pour configurer les paramtres. Toutefois, si la console rattache l'ordinateur UNIX ou Linux sur lequel vous installez les composants d'IBM Cognos 8 ne prend pas en charge une interface utilisateur graphique Java, vous devez modifier manuellement le fichier cogstartup.xml qui se trouve dans le rpertoire emplacement_c8\configuration et excuter IBM Cognos Configuration en mode silencieux. Utilisez ces tches facultatives pour personnaliser votre configuration afin qu'IBM Cognos 8 s'intgre aisment l'environnement existant. Modification des paramtres de configuration implicites. Configuration du protocole SSL. Configuration des messages de journalisation. Modification des paramtres globaux. Modification de la passerelle. Modification de la version de l'adresse IP. Configuration d'IBM Cognos 8 pour qu'il fonctionne avec d'autres produits IBM Cognos. Mise jour des proprits d'emplacement des fichiers sous Windows Vista. Guide d'installation et de configuration 305
Chapitre 11: Options de configuration Configuration d'un systme de contrle de la source. Configuration d'IBM Cognos 8 Transformer.
Dmarrez IBM Cognos Configuration

Utilisez l'outil IBM Cognos Configuration pour configurer IBM Cognos 8 ou pour dmarrer et arrter les services IBM Cognos. Avant de dmarrer IBM Cognos Configuration, vrifiez que l'environnement d'exploitation est configur correctement. Ainsi, assurez-vous que toutes les variables ont t dfinies. Vous devez dmarrer IBM Cognos Configuration la dernire page de l'Assistant d'installation sous Windows, UNIX ou Linux si aucune configuration complmentaire n'est requise. Par exemple, si vous utilisez un serveur de base de donnes autre que Microsoft SQL comme base de donnes Content Store, nous vous conseillons de copier les pilotes JDBC vers l'emplacement appropri avant de dmarrer l'outil de configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur Windows : Dans le menu Dmarrer, cliquez sur Programmes, slectionnez IBM Cognos 8 et cliquez sur IBM Cognos Configuration. Pour dmarrer IBM Cognos Configuration sur un ordinateur UNIX ou Linux : Ouvrez le rpertoire emplacement_c8/bin et saisissez : ./cogconfig.sh
Modification des paramtres de configuration implicites

Lorsque vous installez des composants d'IBM Cognos 8, l'installation utilise des paramtres de configuration implicites. Si vous avez une raison de rejeter ces valeurs implicites, par exemple, si un port est galement utilis par un autre processus, IBM Cognos Configuration vous permet de les modifier. Si vous modifiez la valeur d'une proprit, vous devez enregistrer la configuration et redmarrer le service IBM Cognos 8 pour appliquer les nouveaux paramtres votre ordinateur. Pour les installations rparties, assurez vous d'avoir configur tous les ordinateurs sur lesquels vous avez install Content Manager avant de modifier les paramtres de configuration implicites sur les autres ordinateurs IBM Cognos. Par exemple, vous pouvez : modifier l'utilisateur et le mot de passe implicites pour la base de donnes de contenu d'IBM Cognos, modifier un URI, configurer les paramtres cryptographiques, configurer les composants d'IBM Cognos 8 afin qu'ils utilisent IBM Cognos Application Firewall, configurer des proprits de fichier temporaire,
306
Chapitre 11: Options de configuration configurer la passerelle pour un espace-noms, activer et dsactiver des services, indiquer la quantit de ressources utilise par le service IBM Cognos 8, configurer des polices, modifier la police implicite pour des rapports, enregistrer la version de rapport dans un systme de fichiers, modifier l'emplacement des graphiques de type Carte pour Report Studio.
Aprs avoir modifi le comportement implicite d'IBM Cognos 8 afin qu'il s'adapte mieux votre environnement IBM Cognos, vous pouvez configurer Portal Services, configurer un fournisseur d'authentification ou encore tester l'installation(p. 136). Pour BM Cognos 8, vous pouvez installer et configurer Framework Manager. Pour Metric Studio, vous pouvez installer et configurer Metric Designer.
Modifier l'utilisateur et le mot de passe implicites pour la base de donnes de contenu d'IBM Cognos
Si vous installez la base de donnes de contenu d'IBM Cognos, un code d'utilisateur et un mot de passe sont associs la base de donnes implicite qui est cre. Il est conseill de changer cet utilisateur et ce mot de passe implicites. Les tches d'administration de la base de donnes de contenu d'IBM Cognos s'effectuent l'aide d'un utilitaire appel ij. Pour en savoir davantage sur cet utilitaire, reportez-vous la documentation Apache Derby. Cette documentation est disponible dans le rpertoire emplacement_c8\derby10.1.2.1\docs o vous avez install votre base de donnes de contenu d'IBM Cognos.
Procdure pour modifier le mot de passe utilisateur implicite

1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\derby10.1.2.1\bin. 2. Dmarrez l'utilitaire ij avec le fichier de script ij.bat ou ij.ksh. L'utilitaire ij est un utilitaire de ligne de commande destin crer et grer la base de donnes de contenu d'IBM Cognos. 3. Connectez-vous la base de donnes implicite en saisissant la commande suivante dans l'utilitaire ij : connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos'; Si vous avez modifi le numro de port implicite 1527, utilisez le port appropri pour votre base de donnes de contenu d'IBM Cognos. La base de donnes implicite s'appelle cm. Le nom de la base de donnes est sensible la casse. 4. Modifiez le mot de passe implicite de l'utilisateur cognos en saisissant la commande suivante dans l'utilitaire ij :
Chapitre 11: Options de configuration CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos', 'NewPassword'); Ce nouveau mot de passe doit tre utilis pour la prochaine connexion la base de donnes. 5. Fermez l'utilitaire ij en saisissant la commande suivante : disconnect;
Procdure pour crer un utilisateur et un mot de passe

1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\derby10.1.2.1\bin. 2. Dmarrez l'utilitaire ij avec le fichier de script ij.bat ou ij.ksh. 3. Connectez-vous la base de donnes implicite en saisissant la commande suivante dans l'utilitaire ij : connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos'; Si vous avez modifi le numro de port implicite 1527, utilisez le port appropri pour votre base de donnes de contenu d'IBM Cognos. La base de donnes implicite s'appelle cm. Le nom de la base de donnes est sensible la casse. 4. Crez un utilisateur en saisissant la commande suivante dans l'utilitaire ij : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.NewUser', 'NewUserPassword'); 5. Donnez l'utilisateur un accs complet la base de donnes en saisissant la commande suivante dans l'utilitaire ij : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.fullAccessUsers','cognos, NewUser'); La proprit que vous modifiez (la liste des utilisateurs) est une zone dont les valeurs sont spares par des virgules. cette tape vous ajoutez le nouvel utilisateur la liste des utilisateurs disposant d'un accs complet. L'utilisateur implicite, cognos, fait encore partie de la liste des utilisateurs disposant d'un accs complet. Vous pouvez supprimer l'utilisateur cognos. 6. Fermez l'utilitaire ij en saisissant la commande suivante : disconnect;
Procdure de suppression d'un utilisateur

1. Sur l'ordinateur sur lequel vous avez install la base de donnes de contenu d'IBM Cognos, ouvrez le rpertoire emplacement_c8\derby10.1.2.1\bin. 2. Dmarrez l'utilitaire ij avec le fichier de script ij.bat ou ij.ksh. 3. Connectez-vous la base de donnes implicite en saisissant la commande suivante dans l'utilitaire ij : connect 'jdbc:derby://localhost:1527/cm;user=NewUser; password=NewUserPassword';
308
Chapitre 11: Options de configuration 4. Choisissez le type d'utilisateur que vous voulez supprimer : Pour supprimer un utilisateur de la liste des utilisateurs disposant d'un accs complet, saisissez la commande suivante dans l'utilitaire ij : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.fullAccessUsers', 'NewUser'); Vous omettez le nom d'utilisateur dans la liste des utilisateurs disposant d'un accs complet. Par exemple, la commande ci-dessus supprime l'utilisateur cognos implicite et conserve le nouvel utilisateur que vous venez de crer. Pour supprimer un utilisateur de la base de donnes, saisissez la commande suivante dans l'utilitaire ij et omettez le mot de passe de l'utilisateur : CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos', ''); Cette commande supprime le mot de passe de l'utilisateur cognos implicite, ce qui supprime galement l'utilisateur de la base de donnes. 5. Fermez l'utilitaire ij en saisissant la commande suivante : disconnect;
Modification d'un URI

Vous pouvez modifier certains lments d'un URI selon votre environnement. Un URI d'IBM Cognos contient les lments suivants : Pour un URI de Content Manager, un URI du distributeur destin aux applications externes ou un URI du distributeur protocole://nom_hte_ou_adresse_IP:port/racine_contexte/chemin_alias Pour un URI de passerelle ou un URI de contenu Web protocole://nom_hte_ou_adresse_IP:port/rpertoire_virtuel/application_passerelle OU protocole://nom_hte_ou_adresse_IP:port/racine_contexte/chemin_alias
lment Exemples
protocole http ou https
Description
Indique le protocole utilis pour demander et transmettre les informations ; il s'agit de HTTP (Hyper Text Transfer Protocol) ou de HTTPS (Hyper Text Transfer Protocol Scuris).
lment Exemples
nom localhost ou 192.168.0.1 ou [2001: d'hte ou 0db8:0000:0000:0000:148:57ab]:80 adresse IP
Description
Indique l'identit de l'hte sur le rseau. Vous pouvez utiliser une adresse IP, un nom d'ordinateur ou un nom de domaine qualifi complet. Dans le cadre d'une installation rpartie, vous devez modifier l'lment localhost d'un URI. Dans un environnement mixte de serveurs UNIX et Windows, assurez-vous que les noms d'htes peuvent tre convertis en adresses IP par tous les serveurs prsents dans l'environnement.
port
9300 ou 80
Indique le port sur lequel le systme hte coute les demandes. Le port implicite de Tomcat est 9300. Le port implicite d'un serveur Web est 80.
racine de p2pd contexte
Utilise par Tomcat ou par un serveur d'application pour dterminer le contexte de l'application afin que la demande puisse tre achemine vers l'application Web approprie en vue de son traitement. Utilis par le serveur d'application pour acheminer une demande vers le composant appropri dans une application Web. Le chemin d'alias ne doit pas tre modifi, sinon les composants d'IBM Cognos 8 ne fonctionneront pas correctement.
chemin d'alias
servlet/ dispatch
rpertoire cognos8/ virtuel
Utilis par le serveur Web pour mettre en correspondance un rpertoire virtuel ou un alias avec un emplacement physique. Par exemple, dans l'URI de passerelle implicite http://localhost:80/cognos8/cgibin/cognos.cgi, le rpertoire virtuel est cognos8/cgi-bin.
310
lment Exemples
applica- cognos.cgi tion passerelle
Description
Indique le nom de l'application passerelle IBM Cognos utilise. Par exemple, si vous accdez aux composants d'IBM Cognos 8 l'aide d'une interface CGI (Common Gateway Interface), l'application passerelle implicite correspondra cognos.cgi.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur le groupe ou le composant appropri : Pour changer un lment du distributeur, cliquez sur l'option Environnement. Pour changer un lment du serveur de journalisation local, dans la section Environnement, cliquez sur l'option Journalisation. 3. Dans la fentre Proprits, cliquez sur la zone Valeur ct de la proprit d'URI que vous voulez modifier. 4. Slectionnez l'lment et saisissez les nouvelles informations. Conseil : Pour changer le port utilis par le distributeur local, vous devez modifier la valeur de la proprit URI interne du distributeur. tant donn que le changement a une incidence sur tous les URI dfinis en fonction du distributeur local, vous devez modifier ceux de tous les composants locaux. Conseil : Si vous changez le port du distributeur dans son URI, veillez indiquer le nouveau numro de port lorsque vous configurez des ordinateurs distants utilisant les services du distributeur, de Content Manager et du kit SDK sur ce systme. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration des paramtres cryptographiques

Les composants d'IBM Cognos 8 ont besoin d'un fournisseur cryptographique, sans lequel ils ne peuvent pas fonctionner. Si vous supprimez le fournisseur cryptographique implicite, vous devez en configurer un autre pour le remplacer. Vous pouvez configurer le chiffrement et les paramtres du fournisseur cryptographique, notamment comme suit : Algorithmes avancs. Il s'agit d'algorithmes de signature et de prtraitement. Proprits de la bibliothque de cls symtriques communes (CSK). IBM Cognos 8 utilise la CSK pour chiffrer et dchiffrer des donnes. Guide d'installation et de configuration 311
Chapitre 11: Options de configuration Proprits de la bibliothque de cls de signature. La paire de cls de signature comprend la cl prive utilise pour crer la signature numrique et la cl publique utilise pour vrifier l'authenticit. Proprits de la bibliothque de cls de chiffrement. La paire de cls de chiffrement comprend la cl prive utilise pour chiffrer les donnes et la cl publique utilise pour les dchiffrer. Le fournisseur cryptographique implicite utilise des cls d'une longueur allant jusqu' 56 bits pour le chiffrement de donnes et le protocole SSL (Secure Socket Layer). Vous pouvez configurer d'autres fournisseurs cryptographiques utilisant des tailles de cl suprieures 56 bits, tels que Enhanced Encryption Module for OpenSSL. Pour plus d'informations, reportez-vous au manuel Enhanced Encryption Module for Entrust Installation and Configuration Guide. Important : Dans une installation rpartie, les ordinateurs IBM Cognos communiquent avec Content Manager pour tablir l'approbation et obtenir certaines cls cryptographiques de Content Manager. Si vous modifiez les cls cryptographiques dans Content Manager, en modifiant par exemple des serveurs d'application ou en installant de nouveau Content Manager, vous devez supprimer les cls cryptographiques des autres ordinateurs IBM Cognos. Enregistrez ensuite la configuration de tous les ordinateurs afin qu'ils obtiennent les nouvelles cls cryptographiques de Content Manager. Par ailleurs, tous les composants d'IBM Cognos 8 dans une installation rpartie doivent tre configurs avec les mmes paramtres de fournisseur cryptographique. En outre, dans une installation rpartie, la cl symtrique ne doit tre stocke que sur les ordinateurs sur lesquels Content Manager a t install.
Procdure relative aux paramtres cryptographiques

1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez sur l'option Cryptographie. 3. Dans la fentre Proprits, modifiez les valeurs implicites en cliquant sur la zone Valeur, puis en slectionnant la valeur approprie : Sur des ordinateurs dpourvus de Content Manager, si vous ne voulez pas conserver les CSK localement, dans la section Paramtres CSK, dfinissez l'option Stocker la cl symtrique localement sur Faux. Lorsque l'option Stocker la cl symtrique localement est dfinie sur la valeur Faux, la cl doit tre obtenue auprs de Content Manager s'il y a lieu. La proprit Emplacement de la bibliothque de cls symtriques communes est ignore. Si vous souhaitez que les ordinateurs chaque extrmit d'une transmission prouvent leur identit, dans la section Paramtres SSL, remplacez la valeur de Utilisation de l'authentification mutuelle par Vrai. Nous vous recommandons de ne pas modifier le paramtre Utilisation de la confidentialit. Si vous souhaitez modifier l'algorithme de prtraitement, slectionnez une autre valeur pour la proprit Algorithme de prtraitement.
312
Chapitre 11: Options de configuration 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. 5. Le test du fournisseur cryptographique doit tre effectu sur une passerelle uniquement. Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur Cryptographie, puis cliquez sur l'option Tester. Les composants d'IBM Cognos 8 vrifient la disponibilit de la cl symtrique. Aprs avoir configur le fournisseur cryptographique, les mots de passe de votre configuration et toutes les donnes que vous crez sont chiffrs.
Procdure relative au fournisseur cryptographique

1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos. Si vous souhaitez modifier l'emplacement des cls de signature, dans la section Paramtres de cl de signature, dfinissez la proprit Emplacement de la bibliothque de cls de signature au nouvel emplacement. Si vous souhaitez modifier l'emplacement des cls de chiffrement, dans la section Paramtres de cl de chiffrement, dfinissez l'option Emplacement de la bibliothque de cls de chiffrement sur le nouvel emplacement. Si vous souhaitez utiliser une autre autorit de certification, dans la section Paramtres de l'autorit de certification, dfinissez l'option Voulez-vous utiliser une autorit de certification de tierce partie ? sur Vrai. Vous devez galement veiller utiliser pour le paramtre -k les valeurs employes pour les proprits Emplacement de la bibliothque de cls de signature et Emplacement de la bibliothque de cls de chiffrement. Pour en savoir davantage, reportez-vous la section "Configuration des composants d'IBM Cognos 8 pour l'utilisation d'une autre autorit de certification" (p. 405). Important : La valeur du paramtre Algorithme de confidentialit dtermine le mode de chiffrement des donnes employ par les composants d'IBM Cognos 8. Par exemple, les mots de passe de base de donnes saisis dans IBM Cognos Configuration sont chiffrs lors de l'enregistrement de la configuration. L'algorithme slectionn lors du chiffrement des donnes doit galement tre disponible pour que ces mmes donnes puissent par la suite tre dchiffres. La disponibilit des algorithmes de confidentialit peut varier en cas de modifications apportes votre environnement. C'est par exemple le cas si votre environnement JRE (Java Runtime Environment) a chang ou si vous avez install un autre logiciel cryptographique sur l'ordinateur. Si vous avez apport des modifications un ordinateur, telles qu'une mise niveau de l'environnement JRE ou l'installation d'un logiciel ayant entran la mise niveau du JRE, cela peut avoir une incidence sur les algorithmes de confidentialit. Vous devez vous assurer que le paramtre Algorithme de confidentialit slectionn lors du chiffrement des donnes est galement disponible lorsque vous souhaitez accder ces donnes. 3. Dans le menu Fichier, cliquez sur l'option Enregistrer. Guide d'installation et de configuration 313
Chapitre 11: Options de configuration Si vous utilisez un autre serveur d'autorit de certification, vous devez prsent configurer les composants d'IBM Cognos 8 en consquence.
Configuration des composants d'IBM Cognos 8 pour IBM Cognos Application Firewall
IBM Cognos Application Firewall (CAF) analyse et valide les demandes HTTP et XML avant qu'elles ne soient traites par les serveurs IBM Cognos. Il est possible qu'IBM Cognos Application Firewall modifie ces demandes. IBM Cognos Application Firewall protge les produits Web d'IBM Cognos des donnes malveillantes. Les formes les plus courantes de donnes malveillantes sont les dbordements de tampon et les attaques de scripts intersites (XSS), par insertion de script dans des pages valides ou racheminement vers un autre site Web. IBM Cognos Configuration vous permet galement de modifier les paramtres de prise en charge des autres outils XXS et d'ajouter des noms d'hte et de domaine la liste des noms valides d'IBM Cognos. Vous pouvez effectuer un suivi des activits du pare-feu en consultant le fichier journal, qui contient les demandes rejetes. Par dfaut, les messages de journalisation sont stocks dans le fichier situ l'emplacement suivant : emplacement_c8\logs\cogserver.log. Important : Tous les paramtres de CAF doivent tre identiques sur tous les ordinateurs sur lesquels les composants d'application IBM Cognos 8 sont installs dans un environnement distribu. Par exemple, si CAF est dsactiv sur certains ordinateurs et activ sur d'autres, un comportement inattendu et des erreurs peuvent se produire. Les types d'URL suivants sont accepts par la validation CAF : Adresses URL compltes (absolues) Format : protocole://hte:port/chemin_accs, o protocole est http ou https et o l'lment hte est vrifi par rapport la liste de domaines valides. Adresses URL relatives au rpertoire d'installation Web Format : /racine_installation_Web/.*, o racine_installation_Web correspond au rpertoire Web de la passerelle bas sur l'alias cognos8 configur sur votre serveur Web. Pour en savoir davantage, reportez-vous la section (p. 180). Par exemple : /cognos8/ps/portal/images/action_delete.gif Adresses URL autorises spcifiques, telles que (toutes sont sensibles la casse) : about:blank JavaScript:window.close( ) JavaScript:parent.close( ) JavaScript:history.back( ) parent.cancelErrorPage( )
314
Chapitre 11: Options de configuration doCancel( )
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur sur lequel des composants d'application IBM Cognos 8 ont t installs. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez sur l'option IBM Cognos Application Firewall. 3. Dans la fentre Proprits, dfinissez les valeurs adquates pour la proprit Activer l'option de validation du module CAF. IBM Cognos Application Firewall est actif par dfaut. Important : IBM Cognos Application Firewall est un composant essentiel de scurit d'IBM Cognos contribuant la protection contre les intrusions. La dsactivation d'IBM Cognos Application Firewall supprime cette protection. Dans des circonstances normales, nous vous conseillons de ne pas dsactiver IBM Cognos Application Firewall. 4. Si vous utilisez un autre outil XSS qui vrifie des caractres spcifiques dans les paramtres de requte GET, ouvrez la fentre Proprits et procdez comme suit : Choisissez Vrai comme valeur de la proprit Vrification XSS de tierce partie active. Pour la proprit Caractres XSS de tierce partie, ajoutez les caractres supplmentaires interdits par l'autre outil XSS. Les caractres implicites sont >, < et '.
5. Ajoutez les noms d'hte et de domaine la liste de noms valides d'IBM Cognos : Pour la proprit Domaines ou htes valides, cliquez sur la valeur, puis sur le bouton dition. Dans la bote de dialogue Valeur - Domaines ou htes valides, cliquez sur Ajouter. Vous devez inclure les domaines de tous les hyperliens ajouts dans IBM Cognos Connection. Pour en savoir davantage, reportez-vous la rubrique traitant de la cration d'adresses URL dans le Guide d'administration et de scurit. Conseil : Si, partir d'IBM Cognos Series 7, vous utilisez l'accs au dtail des rapports sous IBM Cognos 8, ajoutez les noms d'hte des serveurs de passerelles d'IBM Cognos Series 7 la liste. Dans la ligne blanche de la table, cliquez et saisissez le nom d'hte ou de domaine. Rptez les deux tapes prcdentes (indiques par des puces) pour chaque nom ajouter. Cliquez sur OK.
IBM Cognos Application Firewall valide des noms d'hte et de domaine pour protger les URL cres. Par dfaut, IBM Cognos Application Firewall considre les noms de domaine issus des proprits de configuration de l'environnement comme tant des noms de domaine scuriss. Il est utile d'ajouter des noms la liste des noms et htes valides si vous devez rediriger des demandes vers des ordinateurs non IBM Cognos l'aide des fonctions Prcdent ou Annuler ou bien lorsque vous utilisez l'accs au dtail vers d'autres installations de produits IBM Cognos.
Chapitre 11: Options de configuration 6. Enregistrez la configuration. 7. Redmarrez les services.
Configuration des proprits des fichiers temporaires

Vous pouvez modifier l'emplacement o les composants d'IBM Cognos 8 conservent les rapports consults rcemment et dcider de chiffrer leur contenu. Par dfaut, les composants d'IBM Cognos 8 conservent les fichiers temporaires dans le rpertoire emplacement_c8\temp, sans les chiffrer. Il est conseill d'interdire tout accs au rpertoire temp, sauf pour le compte du service utilis pour dmarrer le service IBM Cognos 8. Des droits en lecture et en criture sont requis pour le compte du service.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, pour la proprit Emplacement des fichiers temporaires, indiquez le nouvel emplacement. 4. Si vous souhaitez que le contenu des fichiers temporaires soit chiffr, dfinissez la proprit Chiffrement des fichiers temporaires sur Vrai. 5. Assurez-vous que le compte d'utilisateur sous lequel les composants d'IBM Cognos 8 fonctionnent dispose des droits appropris sur l'emplacement des fichiers temporaires. Par exemple : sous Windows, tous les droits de contrle, sous UNIX ou Linux, les droits de lecture et d'criture.
Configuration de la passerelle pour l'utilisation d'un espace-noms

Si les composants d'IBM Cognos 8 utilisent plusieurs espaces noms ou si l'accs anonyme est activ et que les composants d'IBM Cognos 8 n'utilisent qu'un seul espace noms, vous pouvez configurer la passerelle pour qu'elle se connecte un seul espace noms. Les utilisateurs connects au serveur Web sur lequel se trouve la passerelle ne sont pas invits slectionner une source d'authentification. Par exemple, si vous disposez de deux serveurs Web, vous pouvez les configurer Web afin qu'ils utilisent un espace-noms diffrent.
Procdure
1. Sur l'ordinateur o se trouve la passerelle, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, dans la zone Valeur situe ct de la proprit Espace-noms de la passerelle, saisissez l'identificateur de l'espace-noms que vous voulez utiliser. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
316
Chapitre 11: Options de configuration 5. Redmarrez votre serveur Web.
Activation et dsactivation de services

Dans une installation rpartie, vous pouvez envoyer certains types de demande des ordinateurs spcifiques en activant ou en dsactivant les services installs. Par exemple, pour ddier un ordinateur l'excution et la diffusion de rapports, vous pouvez dsactiver le service de prsentation sur un serveur de rapports. Pour rserver un ordinateur d'une installation rpartie au traitement des demandes de l'application Metric Studio, dsactivez le service d'intgration des donnes de l'ordinateur. Remarque : Les valeurs implicites des services de distribution et de prsentation sont dfinies sur faux sur les ordinateurs o seul Content Manager est install. Pour tous les autres types d'installations, les valeurs implicites sont dfinies sur vrai . Si vous avez install tous les composants sur plusieurs ordinateurs, vous pouvez dsactiver les services appropris sur chacun d'eux afin d'obtenir la configuration rpartie requise. Les demandes sont envoyes uniquement aux distributeurs sur lesquels un service donn est activ. La dsactivation d'un service empche son chargement en mmoire. Une fois dsactivs, les services ne dmarrent plus et ne consomment donc plus de ressources. Le service ne s'excute pas tant que vous ne l'activez pas. Si vous dsactivez le service du distributeur, tous les services qui s'excutent sous ce dernier sont galement dsactivs. Seuls les services de distributeur activs peuvent traiter des demandes.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la section Environnement de la fentre Explorateur, cliquez sur l'option Service IBM Cognos 8. 3. Dans la fentre Proprits, cliquez sur l'option Valeur en regard du service que vous souhaitez activer ou dsactiver. Par dfaut, tous les services sont activs. 4. Cliquez sur l'tat appropri pour les services : Pour dsactiver le service, cliquez sur l'option Faux. Pour l'activer, cliquez sur l'option Vrai.
Par exemple : Pour un serveur de travail de Cognos Planning, vous devez activer le service du distributeur, le service de suivi et le service de travail de Cognos Planning. Vous pouvez dsactiver tous les autres services. Pour un serveur de donnes de Cognos Planning, vous devez activer le service du distributeur, le service de suivi et le service de donnes de Cognos Planning.
Chapitre 11: Options de configuration Pour un serveur d'administration de Cognos Planning, vous devez activer le service du distributeur, le service de suivi et le service de console d'administration de Cognos Planning. Pour un serveur Web de Cognos Planning, vous devez activer le service du distributeur, le service de suivi et le service Web de Cognos Planning.
Si vous configurez des serveurs IBM Cognos Planning bass sur des rles, vous devez aussi faire en sorte qu'au moins un serveur IBM Cognos Planning excute tous les autres services IBM Cognos 8. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Dfinition des ressources du service IBM Cognos 8

Pour amliorer les performances dans un environnement rparti, vous pouvez modifier la quantit de ressources utilise par le service IBM Cognos 8 en slectionnant un modle de configuration. Par dfaut, le service IBM Cognos 8 est configur pour utiliser un minimum de ressources mmoire afin d'optimiser le temps de dmarrage. Les paramtres du modle de configuration s'appliquent uniquement Tomcat, le serveur d'application utilis par dfaut par IBM Cognos 8. Si vous souhaitez configurer IBM Cognos 8 pour qu'il s'excute sur un autre serveur d'application, n'utilisez pas IBM Cognos Configuration pour configurer les ressources. Configurez-les directement au sein de l'environnement du serveur d'application en question. Pour en savoir davantage, reportez-vous la section "Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat" (p. 379). Le service IBM Cognos 8 n'est disponible que sur les ordinateurs sur lesquels vous avez install Content Manager ou les composants d'application.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans les sections Environnement, Service IBM Cognos 8 de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option IBM Cognos 8, puis cliquez sur le bouton Supprimer. Cette opration supprime le modle de configuration implicite pour le service. 3. Cliquez avec le bouton droit de la souris sur l'option Service IBM Cognos 8, puis cliquez sur les options Nouvelle ressource et Configuration. 4. Saisissez un nom pour le service. Sous Windows, le nom que vous choisissez est utilis pour l'inscription du service dans le registre. Vous voyez ce nom dans la liste des services actifs sur l'ordinateur. 5. Dans la zone Type, cliquez sur le modle de configuration utiliser : Si vous avez pralablement modifi le paramtrage implicite et que vous souhaitez rduire le temps de dmarrage ainsi que l'utilisation de la mmoire et des ressources, cliquez sur l'option Configuration compacte.
318
Chapitre 11: Options de configuration Si vous souhaitez un compromis entre la rapidit de dmarrage et la vitesse de fonctionnement, cliquez sur l'option Configuration moyenne. Si vous souhaitez optimiser la vitesse de fonctionnement, si les performances ont plus d'importance que la rapidit du dmarrage et si votre ordinateur dispose de davantage de ressources, cliquez sur l'option Configuration complte. 6. Dans la fentre Proprits, modifiez les valeurs des proprits afin de les adapter votre environnement. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration des polices

Les composants d'IBM Cognos 8 emploient les polices pour afficher les rapports PDF sur le serveur IBM Cognos. Ils en utilisent galement pour afficher les graphiques utiliss dans les rapports au format PDF ou HTML. Pour afficher correctement une version de rapport, les polices doivent tre disponibles l'endroit o le rapport ou le graphique est affich. Dans le cas des graphiques et des rapports au format PDF, les polices doivent tre installes sur le serveur IBM Cognos. Si une police n'est pas disponible, les composants d'IBM Cognos 8 la remplacent par une autre. tant donn que les rapports au format HTML s'affichent dans un navigateur, les polices requises doivent tre installes sur l'ordinateur de chaque utilisateur d'IBM Cognos appel lire le rapport au format HTML. Si une police n'est pas disponible, le navigateur la remplace par une autre. Si vous souhaitez utiliser une nouvelle police dans vos rapports, vous devez : ajouter la police la liste de celles prises en charge, indiquer l'emplacement du fichier de la nouvelle police, faire correspondre la nouvelle police avec le nom de police physique, le cas chant.
Ajout de polices l'environnement IBM Cognos

Si vous souhaitez crer des rapports utilisant des polices indisponibles, vous pouvez ajouter ces polices la liste de celles prises en charge dans votre environnement IBM Cognos. Vous pouvez galement supprimer des polices. Par dfaut, les composants d'IBM Cognos 8 utilisent un jeu de polices universelles, disponible sur tous les serveurs IBM Cognos.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Polices. 4. Cliquez sur Ajouter.
Chapitre 11: Options de configuration Conseil : Pour supprimer une police de la liste de celles prises en charge, cliquez sur la zone ct du nom de la police, puis cliquez sur le bouton Supprimer. 5. Dans la zone Nom de police prise en charge, saisissez le nom de la police, puis cliquez sur le bouton OK. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer. Toutes les polices universelles, y comprises les nouvelles polices ajoutes, doivent tre installes sur tous les ordinateurs IBM Cognos prsents dans votre environnement. Si une police universelle n'est pas installe sur tous les ordinateurs IBM Cognos, vous devez mettre en correspondance la police universelle avec une police physique installe.
Indication de l'emplacement des polices disponibles

Vous devez indiquer l'emplacement d'installation de toutes les polices, y compris celles que vous ajoutez la liste des polices prises en charge. La liste des polices englobe par dfaut celles installes dans le rpertoire emplacement_c8\bin\fonts de l'ordinateur IBM Cognos. Si les composants d'IBM Cognos 8 sont installs sur un ordinateur Windows, ils utilisent galement les polices installes dans le rpertoire des polices de Windows. Vous devez indiquer l'emplacement des polices sur tous les ordinateurs sur lesquels les composants d'application sont installs.
Procdure
1. Sur chaque ordinateur des composants d'application, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, pour la proprit Emplacements des polices physiques, indiquez l'emplacement des polices. S'il existe plusieurs chemins d'accs aux polices, sparez-les par un point-virgule (;). Si vous utilisez un serveur d'application autre que Tomcat, saisissez le chemin d'accs complet vers l'emplacement des polices. Par exemple : emplacement_c8/bin/fonts. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Mise en correspondance des polices prises en charge avec les polices installes
Vous pouvez remplacer des polices universelles qui ne sont pas installes sur l'ordinateur par des polices physiques. Vous mettez en correspondance les polices sur tous les ordinateurs o est install le serveur de rapports. Par exemple, vous ajoutez la liste des polices prises en charge une police qui n'est pas installe sur l'ordinateur IBM Cognos. Vous pouvez indiquer la police utiliser pour la remplacer. Pour imprimer des rapports plus rapidement l'aide des polices PDF intgres, vous pouvez mettre en correspondance l'une des polices globales (Arial, par exemple) avec l'une des polices PDF intgres (Helvetica-PDF, par exemple), en suivant la procdure ci-aprs. Vous pouvez galement slectionner
320
Chapitre 11: Options de configuration l'une des polices PDF intgres pour un objet texte dans Report Studio ou Query Studio. Pour en savoir davantage, reportez-vous au Guide de l'utilisateur de Query Studio ou au Guide de l'utilisateur de Report Studio - Cration de rapports professionnelle. Aucune mise en correspondance n'est requise si vous ajoutez une police la liste des polices prises en charge installes sur les ordinateurs IBM Cognos. En revanche, vous devez indiquer l'emplacement de la police.
Procdure
1. Sur chaque ordinateur des composants d'application, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, cliquez sur la zone Valeur ct de la proprit Correspondance des polices physiques, puis sur le bouton d'dition. La bote de dialogue Valeur - Correspondance des polices physiques s'affiche. 4. Cliquez sur Ajouter. Conseil : Pour supprimer une police, cochez la case situe en regard de celle-ci, puis cliquez sur l'option Supprimer. 5. Dans la zone Nom de police universelle, saisissez le nom de la police que vous avez ajoute la liste des polices prises en charge. 6. Cochez la case Nom de police physique. 7. Si vous connaissez le nom de la police physique, saisissez-le. Dans le cas contraire, cliquez sur le bouton d'dition. Dans la bote de dialogue Nom de police physique, cliquez sur le bouton Rechercher maintenant, puis sur le nom d'une police dans les rsultats. 8. Rptez les tapes 4 7 pour chaque police universelle ncessitant une mise en correspondance. 9. Cliquez sur OK. 10. Dans le menu Fichier, cliquez sur l'option Enregistrer. prsent, vous devez, le cas chant, indiquer l'emplacement d'installation des polices.
Modification de la police implicite pour les rapports PDF

Vous pouvez modifier la police implicite que les composants d'IBM Cognos 8 utilisent pour les rapports PDF. La police implicite est celle que vous voyez lorsque vous ouvrez un rapport. Vous pouvez modifier la police implicite sur l'ordinateur o Content Manager est install. Cela fait, cette police devient la police implicite pour tous les ordinateurs de votre installation. Vous modifiez la police utilise pour les rapports PDF l'aide d'IBM Cognos Configuration. Veillez ce que la police implicite soit installe sur tous les ordinateurs de l'installation d'IBM Cognos.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. Guide d'installation et de configuration 321
Chapitre 11: Options de configuration 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Gnral. 4. Dans la zone Valeur, saisissez la police que vous voulez utiliser par dfaut pour les rapports dans Police par dfaut. 5. Cliquez sur OK. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer. 7. Sur tous les ordinateurs des composants d'application, assurez-vous que l'emplacement d'installation de la police implicite est prcis dans la proprit Emplacements des polices physiques (sous Environnement dans la fentre Explorateur) ou que la police se trouve dans le rpertoire des polices de Windows.
Configuration des polices incorpores pour les rapports PDF

Lors de l'ouverture d'un rapport PDF dans Adobe Reader, toutes les polices utilises dans ce rapport doivent tre disponibles. Les polices doivent tre soit incorpores dans le rapport, soit installes sur l'ordinateur de l'utilisateur.Si une police ne se trouve ni dans le rapport, ni sur l'ordinateur, Adobe Reader tente de la remplacer par une autre. Ce remplacement peut engendrer des modifications de la prsentation du rapport ou empcher l'affichage de certains caractres. Pour garantir que les rapports au format PDF s'affichent correctement dans Adobe Reader, IBM Cognos 8 imbrique par dfaut les polices requises dans les rapports. Afin de rduire la taille des fichiers, IBM Cognos 8 imbrique uniquement les caractres (galement appels glyphes) utiliss dans le rapport, et non l'intgralit des caractres du jeu de polices. IBM Cognos 8 n'imbrique que les polices disposant d'une licence pour l'imbrication. Les informations relatives cette licence se trouvent dans la police elle-mme et sont lues par IBM Cognos 8. Si vous tes sr que les polices employes dans les rapports sont disponibles sur les ordinateurs des utilisateurs, vous pouvez liminer les polices imbriques ou restreindre leur nombre afin de rduire la taille des rapports PDF. Si vous optez pour la restriction du nombre de polices, vous devez indiquer si une police est systmatiquement imbrique ou si au contraire elle ne l'est jamais, l'aide d'une liste des polices imbriques tablie dans IBM Cognos Configuration.
Procdure
1. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, sous Paramtres des polices, slectionnez la valeur correspondant Polices incorporer (Service de production de rapports par lots) ou Polices incorporer (Service de production de rapports), puis cliquez sur le bouton Modifier. 4. Si vous n'utilisez pas le rpertoire de polices implicite ou souhaitez ajouter un chemin d'accs un autre rpertoire, indiquez le nouveau chemin dans la zone des chemins d'accs aux polices de la bote de dialogue Polices incorporer dans les rapports PDF.
322
Chapitre 11: Options de configuration Conseil : Cliquez sur Rechercher maintenant pour obtenir la liste des polices disponibles dans le ou les chemins d'accs indiqus. 5. Pour une police devant tre toujours disponible sur les ordinateurs des utilisateurs, faites dfiler la liste jusqu'au nom de la police, puis cochez la case Jamais. IBM Cognos 8 n'incorpore cette police dans aucun rapport. Adobe Reader la slectionne sur l'ordinateur de l'utilisateur lorsque celui-ci ouvre le rapport. 6. Pour une police qui ne sera peut-tre pas toujours disponible sur les ordinateurs des utilisateurs, faites dfiler la liste jusqu'au nom de la police, puis cochez la case Toujours. IBM Cognos 8 incorpore la police dans tous les rapports qui l'utilisent. Adobe Reader utilise la police incorpore l'ouverture du rapport. 7. Cliquez sur OK.
Enregistrement d'une version de rapport

Par dfaut, les fichiers de sortie de rapport sont enregistrs dans la base de donnes Content Store. Vous avez la possibilit d'enregistrer une copie de la version de rapport dans un autre emplacement, dans ou en dehors d'IBM Cognos 8. Si vous utilisez cette option, un fichier descripteur dot de l'extension _descr est galement enregistr. Les fichiers enregistrs ne sont pas grs par IBM Cognos 8.
Enregistrement de versions de rapports en dehors d'IBM Cognos 8

Si vous configurez un emplacement de fichiers systme situ en dehors d'IBM Cognos 8, vous pouvez partager vos versions de rapports avec des applications externes ou des personnes ne possdant pas IBM Cognos 8.C'est de cette faon que la plupart des fichiers de sortie de rapport sont enregistrs. Pour utiliser cette fonctionnalit, vous devez d'abord configurer un rpertoire racine dans IBM Cognos Configuration. Un administrateur doit ensuite dfinir l'emplacement des fichiers dans l'outil Administration d'IBM Cognos. Pour en savoir davantage, reportez-vous la rubrique traitant de la dfinition d'un emplacement de fichiers pour les versions de rapports enregistres en dehors d'IBM Cognos 8, dans le Guide d'administration et de scurit.
Procdure
1. Crez un rpertoire pour votre systme de fichiers. Conseil : Assurez-vous que le rpertoire est accessible pour les utilisateurs et qu'il est distinct du rpertoire d'installation. Par exemple, dans une installation rpartie, un fichier archive tel que \\nom_serveur\rpertoire peut tre utilis. 2. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager. 3. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 4. Dans la fentre Configuration globale, cliquez sur l'onglet Gnral. 5. Pour Racine du systme de fichiers d'emplacement d'archives, saisissez un URI au format suivant :
Chapitre 11: Options de configuration file://rpertoire o rpertoire est le rpertoire cr l'tape 1. La section file:// de l'URI est requise. Les noms UNC Windows, tels que \\nom_serveur\rpertoire, peuvent tre utiliss. Dans ce cas, l'URI doit avoir le format suivant : file://\\nom_serveur\rpertoire 6. Pour vrifier que l'emplacement appropri va tre utilis, cliquez sur Tester. 7. Cliquez sur OK. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. L'administrateur doit maintenant configurer l'emplacement des fichiers. Pour en savoir davantage, reportez-vous la rubrique traitant de la dfinition d'un emplacement de fichier pour les versions de rapports enregistres en dehors d'IBM Cognos 8, dans le Guide d'administration et de scurit.
Enregistrement de versions de rapports dans IBM Cognos 8

Si vous configurez un emplacement de fichiers systme dans IBM Cognos 8, cela vous permet d'utiliser nouveau la version de rapport. Cela peut galement s'avrer utile des fins d'archivage, tant donn que les fichiers enregistrs dans la base de donnes Content Store peuvent tre rgulirement supprims en raison des rgles de rtention. Pour utiliser cette fonctionnalit, vous devez d'abord activer la proprit Enregistrer les versions du rapport dans un systme de fichiers ? dans IBM Cognos Configuration. Un administrateur doit ensuite configurer l'emplacement de fichiers l'aide du paramtre CM.OutPutLocation dans IBM Cognos Administration. Pour en savoir davantage, reportez-vous la rubrique traitant de la dfinition d'un emplacement de fichiers pour les versions de rapports enregistres dans IBM Cognos 8, dans le Guide d'administration et de scurit.
Procdure
1. Crez un rpertoire pour votre systme de fichiers. Conseil : Assurez-vous que le rpertoire n'est accessible qu'aux utilisateurs autoriss. 2. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager. 3. Dans la fentre Explorateur, cliquez sur Accs aux donnes, puis sur Content Manager. 4. Dans la zone Enregistrer les versions du rapport dans un systme de fichiers, cliquez sur Vrai. 5. Pour tester la connexion au rpertoire des versions de rapports, cliquez sur Tester dans le menu Oprations. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer. L'administrateur doit maintenant configurer l'emplacement des fichiers l'aide du paramtre CM.OutPutLocation. Pour en savoir davantage, reportez-vous la rubrique traitant de la dfinition d'un emplacement de fichier pour les versions de rapports enregistres dans IBM Cognos 8, dans le Guide d'administration et de scurit.
324
Modification de l'emplacement des graphiques type Carte pour Report Studio

IBM Cognos 8 est livr avec un ensemble de graphiques de type Carte que vous pouvez utiliser comme exemples dans Report Studio. Par dfaut, les graphiques de type Carte sont stocks dans le rpertoire emplacement_c8\maps sur l'ordinateur des composants d'application. Vous pouvez modifier l'emplacement des graphiques de type Carte l'aide d'IBM Cognos Configuration. Pour en savoir davantage sur l'utilisation des graphiques de type Carte, reportez-vous au Guide de l'utilisateur de Report Studio. Pour en savoir davantage sur l'utilisation des graphiques de type Carte personnaliss provenant d'autres sources, reportez-vous au manuel Map Manager Installation and User Guide.
Procdure
1. Sur l'ordinateur des composants d'application, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, cliquez sur la valeur de la proprit Emplacement des fichiers de correspondances. 4. Cliquez sur le bouton d'dition. 5. Dans la fentre Slection d'un dossier, pointez sur le rpertoire de votre choix et cliquez sur Slectionner. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration du protocole SSL

Le protocole SSL (Secure Socket Layer) sert scuriser les communications entre les composants d'IBM Cognos installs sur le mme ordinateur ou sur diffrents ordinateurs. En outre, vous pouvez configurer des connexions SSL entre les composants d'IBM Cognos et d'autres serveurs. Vous devez vous assurer que le protocole SSL est configur pour les autres serveurs, puis configurer une scurit partage entre les composants d'IBM Cognos et ces autres serveurs. Aprs avoir configur le protocole SSL, vous pouvez slectionner et classer les algorithmes de chiffrement (ciphersuites) qui contrlent la qualit de la protection utilise dans le cadre de la connexion SSL. Pour configurer le protocole SSL, procdez comme suit : configurez le protocole SSL pour les composants d'IBM Cognos (p. 326), configurez la scurit partage entre les composants d'IBM Cognos et les autres serveurs, le cas chant (p. 328), slectionnez et classez les algorithmes de chiffrement (ciphersuites) utiliser dans une connexion SSL, le cas chant (p. 329), activez le protocole SSL sur votre serveur Web (p. 330).
Configuration du protocole SSL pour IBM Cognos 8

Vous pouvez configurer les composants d'IBM Cognos afin qu'ils utilisent le protocole SSL pour : les connexions internes uniquement, les connexions externes uniquement, les connexions internes et externes, les connexions aux serveurs de journaux locaux et distants.
Si vous configurez le protocole SSL uniquement pour les connexions internes, les composants d'IBM Cognos sur l'ordinateur local communiquent l'aide de ce protocole. Le distributeur coute les connexions scurises sur un port distinct de celui utilis pour les demandes http distantes. Vous devez donc configurer deux URI de distributeur. Si vous configurez le protocole SSL uniquement pour les connexions externes, les communications entre des composants d'IBM Cognos distants et l'ordinateur local utilisent ce protocole. Vous devez configurer le distributeur afin qu'il coute les demandes scurises distantes sur un port distinct de celui utilis pour les demandes HTTP locales. Vous devez galement configurer les URI de Content Manager et l'URI du distributeur pour les applications externes de faon ce qu'ils utilisent le mme protocole et le mme port que le distributeur externe. Si vous configurez le protocole SSL pour toutes les connexions, le distributeur peut utiliser le mme port pour les connexions internes et externes. Si vous n'utilisez pas le protocole SSL pour les communications locales ou distantes, le distributeur peut utiliser le mme port pour toutes les communications. Au besoin, vous devez galement mettre jour les URI de Content Manager, l'URI du distributeur des applications externes et l'URI de la passerelle, afin qu'ils utilisent le protocole SSL.
Connecteurs Tomcat
Si l'URI interne du distributeur porte le prfixe http, alors que l'URI externe porte le prfixe https, ou l'inverse, les deux connecteurs, non-SSL Coyote HTTP/1.1 et SSL Coyote HTTP/1.1, sont activs dans le fichier server.xml. Si les URI des distributeurs interne et externe utilisent un protocole ou des ports diffrents, le port du distributeur interne n'est accessible que pour les composants situs sur l'ordinateur local. L'URI interne du distributeur doit galement prciser le nom d'hte localhost.
Installations sur un seul ordinateur

Dans le cadre d'une installation sur un seul ordinateur, si vous excutez IBM Cognos 8 sans SSL, vous devez arrter le service avant d'ajouter le protocole SSL votre configuration. Une fois que vous aurez enregistr la configuration avec les paramtres SSL, vous pourrez redmarrer le service.
Installations rparties
Dans les installations rparties, si vous utilisez le service de l'autorit de certification d'IBM Cognos, vous devez commencer par configurer tous les ordinateurs IBM Cognos pour qu'ils utilisent le protocole non scuris (http) avant de configurer les composants d'IBM Cognos pour l'utilisation
326
Chapitre 11: Options de configuration du protocole SSL. Cette tape est ncessaire car vous ne pouvez pas configurer le protocole SSL sans avoir pralablement tabli une approbation. Dans un environnement rparti, vous devez galement veiller respecter l'ordre de configuration des ordinateurs. Cela signifie que vous devez d'abord configurer l'ordinateur sur lequel le service Content Manager actif par dfaut est install, puis dmarrer les services sur cet ordinateur avant de configurer d'autres ordinateurs ou de dmarrer des services sur d'autres ordinateurs. En configurant d'abord l'ordinateur Content Manager, puis en dmarrant les services, vous vous assurez que le service de l'autorit de certification sur l'ordinateur Content Manager peut mettre des certificats pour d'autres ordinateurs dans l'environnement d'IBM Cognos. Aprs avoir configur tous les ordinateurs de l'installation rpartie afin qu'ils utilisent le protocole non scuris implicite, il est conseill de tester l'installation pour s'assurer que les composants d'IBM Cognos fonctionnent correctement. Aprs avoir test l'installation, vous pouvez configurer le protocole SSL. Lorsque vous configurez IBM Cognos 8 de faon ce qu'il utilise le protocole SSL, configurez d'abord l'ordinateur Content Manager actif par dfaut pour l'utilisation du protocole, puis dmarrez les services sur cet ordinateur Content Manager. Cela fait, vous pouvez configurer le protocole SSL sur d'autres ordinateurs IBM Cognos dans votre environnement.
Ajout d'un ordinateur une installation

Si vous ajoutez un ordinateur un environnement compatible SSL, vous tes invit accepter provisoirement un certificat lorsque vous enregistrez la configuration. L'acceptation de ce certificat provisoire permet la mise en place d'une accrditation permanente pour l'ordinateur Content Manager.
Ajout d'un composant un ordinateur

Vous pouvez ultrieurement ajouter un composant l'emplacement d'autres composants d'IBM Cognos. Si vous ajoutez ce composant dans un emplacement de l'ordinateur diffrent de celui des autres composants IBM Cognos, vous tes invits accepter provisoirement un certificat lorsque vous enregistrez la configuration. L'acceptation de ce certificat provisoire permet la mise en place d'une accrditation permanente entre le nouveau composant et l'ordinateur Content Manager.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, saisissez les valeurs appropries pour les proprits URI interne du distributeur et URI externe du distributeur : Afin de configurer le protocole SSL uniquement pour les connexions internes, pour la proprit URI interne du distributeur, saisissez https, ainsi qu'un port pour la communication SSL. Pour la proprit URI externe du distributeur, saisissez http et utilisez le port implicite ou tout autre port disponible. Si vous utilisez Tomcat, la proprit URI interne du distributeur doit galement prciser le nom d'hte localhost.
Chapitre 11: Options de configuration Les ports des deux URI du distributeur doivent tre diffrents. Pour configurer le protocole SSL uniquement pour les connexions externes, pour la proprit URI externe du distributeur, saisissez https et un port scuris. Pour la proprit URI interne du distributeur, saisissez http et utilisez le port implicite ou tout autre port disponible. Si vous utilisez Tomcat, la proprit URI interne du distributeur doit galement prciser le nom d'hte localhost. Les ports des deux URI du distributeur doivent tre diffrents. Pour configurer le protocole SSL pour toutes les connexions, saisissez le mme URI pour les deux proprits URI interne du distributeur et URI externe du distributeur. Saisissez https et un numro de port scuris, tel que 9343. Remarque : Vous ne devez pas ncessairement utiliser le port 9343, port SSL implicite. Vous pouvez choisir n'importe quel port disponible. 4. Configurez le protocole SSL pour les autres URI de l'environnement, notamment les URI de Content Manager, l'URI du distributeur pour des applications externes et l'URI de la passerelle. Pour les connexions internes uniquement, saisissez https dans les URI contenant la chane localhost. Pour les connexions externes uniquement, saisissez https dans les URI ne contenant pas la chane localhost. Pour toutes les connexions, saisissez https dans tous les URI.
5. Dans la fentre Explorateur, cliquez sur Scurit, Cryptographie. 6. Pour utiliser le protocole SSL, vous devez indiquer des mots de passe pour les bibliothques de cls de chiffrement d'IBM Cognos 8. D'autres paramtres sont disponibles dans la section Scurit, Cryptographie, IBM Cognos. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration de la scurit partage entre les serveurs IBM Cognos et d'autres serveurs
Si vous souhaitez utiliser l'autorit de certification implicite d'IBM Cognos et employer le protocole SSL pour des connexions d'autres serveurs des serveurs IBM Cognos, vous devez ajouter le certificat d'IBM Cognos la bibliothque d'approbations des autres serveurs. Remarque : Si vous employez des navigateurs pour vous connecter aux composants d'IBM Cognos, ils invitent automatiquement les utilisateurs mettre jour leurs bibliothques d'approbations. Si vous souhaitez que la connexion entre les serveurs IBM Cognos et l'autre serveur soit mutuellement authentifie, vous devez galement copier le certificat de votre autorit de certification dans la bibliothque d'approbations pour les serveurs IBM Cognos.
328
Chapitre 11: Options de configuration Lorsque vous avez configur les composants d'IBM Cognos pour l'utilisation d'une autre autorit de certification (CA), il n'est pas ncessaire de configurer de scurit partage entre le serveur IBM Cognos et les autres serveurs.
Procdure de copie du certificat d'IBM Cognos sur un autre serveur

1. Accdez au rpertoire emplacement_c8\bin. 2. Procdez l'extraction du certificat d'IBM Cognos en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -E -T -r fichier_destination -k emplacement_c8/configuration/ signkeypair/jCAKeystore -p mot_de_passe Sous Windows, saisissez ThirdPartyCertificateTool.bat -E -T -r fichier_destination -k emplacement_c8\configuration\ signkeypair\jCAKeystore -p mot_de_passe 3. Importez le certificat dans la bibliothque d'approbations de votre serveur. Pour en savoir davantage sur la mise jour de la bibliothque d'approbations du serveur, reportez-vous la documentation du serveur.
Procdure de copie du certificat de l'autorit de certification sur les serveurs IBM Cognos
1. Copiez le certificat de l'autorit de certification dans un emplacement scuris sur le serveur IBM Cognos. Assurez-vous que le certificat de l'autorit de certification utilise l'encodage Base-64, format X.509. 2. Importez le certificat de l'autorit de certification en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -T -i -r fichier_certificat_autorit_de_certification -k emplacement_c8/configuration/signkeypair/jCAKeystore -p mot_de_passe Sous Windows, saisissez ThirdPartyCertificateTool.bat -T -i -r fichier_certificat_autorit_de_certification -k emplacement_c8\configuration\signkeypair\jCAKeystore -p mot_de_passe
Slection et classement des algorithmes de chiffrement (ciphersuites) pour SSL

Une connexion SSL commence par une ngociation au cours de laquelle le client et le serveur prsentent une liste des algorithmes de chiffrement (ciphersuites) pris en charge, par ordre de priorit. Un algorithme de chiffrement (ciphersuite) garantit la qualit de la protection pour la connexion. Il contient des algorithmes cryptographiques, d'authentification, de hachage et d'change de cls. Le protocole SSL slectionne la suite de priorits les plus leves que le client et le serveur prennent en charge.
Chapitre 11: Options de configuration Une liste d'algorithmes de chiffrement pris en charge pour SSL est fournie. Vous pouvez liminer les algorithmes de chiffrement (ciphersuites) qui ne correspondent pas vos exigences, puis attribuer une priorit ou une prfrence aux algorithmes de chiffrement restants. Les algorithmes de chiffrement (ciphersuites) slectionns sont prsents par ordre de priorit pour les cts client et serveur de la ngociation. Au moins l'un des algorithmes de chiffrement (ciphersuites) entre les plates-formes client et serveur doit correspondre. La liste des algorithmes de chiffrement pris en charge est cre de faon dynamique sur chaque ordinateur et dpend de l'environnement JRE (Java Runtime Environment) ou de la prsence d'autres logiciels cryptographiques installs sur l'ordinateur. Si vous avez apport des modifications un ordinateur, telles qu'une mise niveau de l'environnement JRE ou l'installation d'un logiciel ayant entran la mise niveau du JRE, cela peut avoir une incidence sur les algorithmes de chiffrement pris en charge sur l'ordinateur en question. Si vous ne disposez plus d'aucun algorithme de chiffrement correspondant aux autres ordinateurs de votre environnement, vous devrez peut-tre changer de JRE sur l'ordinateur afin qu'il corresponde celui des autres ordinateurs de l'environnement.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Cryptographie, IBM Cognos. 3. Dans la fentre Proprits, cliquez sur la colonne Valeur situe ct de la proprit Algorithmes de chiffrement (ciphersuites) pris en charge. 4. Cliquez sur le bouton d'dition. Pour dplacer un algorithme de chiffrement (ciphersuite) dans la liste Valeurs actuelles, cochez la case dans la liste Valeurs disponibles, puis cliquez sur Ajouter. Pour dplacer un algorithme de chiffrement (ciphersuite) vers le haut ou vers le bas dans la liste Valeurs actuelles, cochez la case correspondante, puis cliquez sur les flches de dplacement vers le haut et vers le bas. Pour supprimer un algorithme de chiffrement (ciphersuite) de la liste Valeurs actuelles, cliquez sur la case cocher, puis sur Supprimer. 5. Cliquez sur OK. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Activation du protocole SSL sur le serveur Web

Activez le protocole SSL (Secure Socket Layer) pour chiffrer la communication d'un utilisateur avec le serveur Web. Pour activer le protocole SSL sur votre serveur Web, vous devez obtenir un certificat du serveur Web sign par une autorit de certification et l'installer sur votre serveur Web. Ce certificat ne doit pas tre auto-sign, car ce type de certificat n'est pas approuv par les composants IBM Cognos. Pour permettre aux composants IBM Cognos d'utiliser un serveur Web avec scurit SSL active, vous devez disposer de copies du certificat racine approuv (le certificat de l'autorit de certification
330
Chapitre 11: Options de configuration racine qui a sign le certificat du serveur Web) et de tous les autres certificats constituant la chane d'approbation du certificat du serveur Web.Ces certificats doivent tre au format Base64 encod en ASCII (PEM) ou DER et ne doivent pas tre auto-signs. Les certificats doivent tre installs sur chaque ordinateur sur lesquels vous avez install des composants d'application. Pour en savoir davantage sur l'installation des certificats sur votre serveur Web, reportez-vous la documentation de votre serveur Web.
Procdure
1. Configurez le serveur Web pour le protocole SSL et dmarrez le serveur Web. Pour en savoir davantage, reportez-vous la documentation de votre serveur Web. 2. Sur chaque ordinateur des composants d'application pointant sur la passerelle du serveur Web, modifiez l'URI de la passerelle de HTTP en HTTPS dans IBM Cognos Configuration, puis enregistrez la configuration. Important : Ne dmarrez pas encore le service IBM Cognos 8. 3. Sur chaque ordinateur sur lequel est install le serveur de planification et qui pointe sur la passerelle, redfinissez l'URI de la passerelle HTTP sur HTTPS dans IBM Cognos Configuration, puis enregistrez la configuration. Important : Ne dmarrez pas encore le service IBM Cognos 8. 4. Sur chaque ordinateur des composants d'application, accdez au rpertoire emplacement_c8/bin et importez tous les certificats composant la chane d'approbation, en commenant par le certificat racine de l'autorit d'accrditation, vers la bibliothque d'approbations d'IBM Cognos. Importez les certificats en saisissant la commande suivante : Sous UNIX ou LINUX, saisissez ThirdPartyCertificateTool.sh -T -i -r nomFichier_certificat -D ../configuration/signkeypair -p mot_de_passe Sous Windows, saisissez ThirdPartyCertificateTool.bat -T -i -r nomFichier_certificat -D ../configuration/signkeypair -p mot_de_passe Remarque : Le mot de passe doit dj avoir t dfini. Dans le cas contraire, le mot de passe implicite est NoPassWordSet. 5. Sur chaque ordinateur o est install le serveur de planification, accdez au rpertoire emplacement_c8/bin et importez tous les certificats composant la chane d'approbation, en commenant par le certificat racine de l'autorit de certification, dans la bibliothque de cls d'IBM Cognos. Importez les certificats en saisissant la commande suivante : ThirdPartyCertificateTool.bat -T -i -r nomFichier_certificat -D ../configuration/signkeypair -p mot_de_passe Remarque : Le mot de passe doit dj avoir t dfini. Dans le cas contraire, le mot de passe implicite est NoPassWordSet.
Chapitre 11: Options de configuration 6. Sur chaque ordinateur des composants d'application, dmarrez le service IBM Cognos 8 dans IBM Cognos Configuration. 7. Sur chaque ordinateur o est install le serveur de planification, dmarrez le service IBM Cognos 8 dans IBM Cognos Configuration. Vous pouvez vrifier l'approbation en crant et en excutant un rapport PDF contenant des images qui ne sont pas stockes en local, et que la passerelle doit rcuprer partir d'un ordinateur distant. Si les images s'affichent, l'approbation est tablie. Pour viter de recevoir une alerte de scurit chaque nouvelle session, installez le certificat dans l'une des bibliothques de certificats de votre navigateur Web. En outre, vous pouvez configurer des connexions SSL entre les composants d'IBM Cognos et d'autres serveurs. Vous devez vous assurer que le protocole SSL est configur pour les autres serveurs, puis configurer une scurit partage entre les composants d'IBM Cognos et ces autres serveurs. Pour en savoir davantage, reportez-vous la section "Configuration du protocole SSL" (p. 325).
Configuration des messages de journalisation

Les messages de journalisation constituent un outil de diagnostic important pour l'tude du comportement d'IBM Cognos 8. Outre les messages d'erreur, les messages de journalisation fournissent des informations sur l'tat des composants et une vue de niveau suprieur des vnements essentiels. Par exemple, les messages de journalisation peuvent donner des informations sur les tentatives de dmarrage et d'arrt des services, la fin du traitement des requtes et les indicateurs d'erreurs irrcuprables. Les journaux d'analyse, disponibles depuis une base de donnes de journalisation, fournit des informations sur l'activit des utilisateurs et des rapports. Les services IBM Cognos 8 de chaque ordinateur envoient des informations sur les erreurs et les vnements vers un serveur de journalisation local. Un serveur de journalisation local est install dans le dossier emplacement_c8/logs de tous les ordinateurs IBM Cognos 8 sur lesquels Content Manager ou les composants d'application sont installs. Comme le serveur de journalisation utilise un port diffrent de celui des autres composants d'IBM Cognos 8, il continue traiter les vnements mme si d'autres services de l'ordinateur local, tels que le distributeur, sont dsactivs. Le flux de travail suivant affiche les tches requises pour prparer la journalisation.
Planification du traitement des messages de journaux
Configuration de la journalisation
Dfinition de la journalisation
Lors de la planification, dterminez la configuration de journalisation qui convient votre environnement. Par exemple, valuez diffrentes destinations de messages de journalisation, telles que les fichiers journaux et les serveurs de journalisation distants (par exemple, le journal systme UNIX ou Linux, ou le journal des vnements Windows NT), en plus du fichier journal local. Vous pouvez galement envoyer uniquement les informations des messages d'analyse une base de donnes. Tenez compte de la scurit, notamment des mthodes disponibles pour protger les fichiers journaux contre les pannes systme ou l'altration par les utilisateurs. Pour
332
Chapitre 11: Options de configuration en savoir davantage sur la planification, reportez-vous au manuel Architecture and Deployment Guide. Lors de la configuration, dfinissez les proprits de dmarrage pour la journalisation, notamment les paramtres de connexion des bases de donnes. Vous devez aussi crer une base de donnes de journalisation si vous prvoyez de conserver les journaux d'analyse. Si la communication entre un serveur de journalisation local et un serveur de journalisation distant doit tre scurise, modifiez la configuration de faon approprie sur les deux ordinateurs IBM Cognos 8. Pour en savoir davantage sur la configuration de la journalisation, reportez-vous au Guide d'installation et de configuration. Lors de la configuration de la journalisation, dfinissez le niveau de dtail enregistrer dans le journal pour cibler les messages sur les informations pertinentes par rapport votre entreprise. Les rapports d'analyse peuvent galement tre configurs de manire effectuer le suivi de l'activit des utilisateurs et des rapports. Pour en savoir davantage sur la configuration de la journalisation, reportez-vous au Guide d'administration et de scurit.
Pour en savoir davantage sur l'utilisation des messages de journalisation pour le dpannage et la rsolution des problmes lis la journalisation, reportez-vous la section Dpannage du Guide d'administration et de scurit.
Destination des messages de journalisation

Un serveur de journalisation local est automatiquement install lors de l'installation de Content Manager ou des composants d'application. Vous pouvez dfinir une ou plusieurs destinations vers lesquelles le serveur de journalisation local envoie les messages de journalisation : un serveur de journalisation distant, un fichier, une base de donnes, le journal systme UNIX ou Linux, ou le journal des vnements Windows NT.
Pour en savoir davantage sur les messages de journalisation, reportez-vous au manuel Architecture and Deployment Guide. Pour configurer les messages de journalisation : Si vous envoyez des messages une base de donnes, crez la base de donnes de journalisation en suivant la mme procdure que pour la cration de la base de donnes Content Store (p. 63). Important : Pour DB2, vous devez dfinir un autre espace de table utilisateur standard avec une taille de page de 8 ko pour les composants d'IBM Cognos 8 afin de crer la base de donnes de journalisation. Configurez le client de base de donnes, le cas chant. Indiquez la destination des messages de journalisation.
Serveur de journalisation distant

Dans une installation rpartie, vous pouvez configurer le serveur de journalisation de chaque ordinateur IBM Cognos 8 de faon envoyer des messages de journalisation vers un seul serveur de journalisation distant, lequel agit tel un serveur de journalisation partag. Vous pouvez ensuite configurer le serveur de journalisation partag pour envoyer les messages de journalisation vers un fichier ou une base de donnes en local sur un mme ordinateur ou un ordinateur diffrent. Si le serveur de journalisation distant devient indisponible, les messages de journalisation sont redirigs vers les fichiers de rcupration de l'ordinateur local situs dans le rpertoire emplacement_c8\logs\recovery\remote. Les noms de ces fichiers de rcupration contiennent des informations de date-heure. Ces fichiers ne sont pas lisibles comme des fichiers de journalisation ordinaires. Lorsque le serveur de journalisation est disponible, un processus de rcupration automatique transfre toutes les informations de journalisation vers le serveur de journalisation distant et supprime les fichiers de journalisation locaux.
Fichier
Le serveur de journalisation est configur par dfaut pour envoyer les messages de journalisation vers le fichier emplacement_c8\logs\cogserver.log. Si le fichier journal implicite n'existe pas lorsque le service IBM Cognos 8 dmarre, il est automatiquement cr. Vous pouvez configurer le serveur de journalisation de faon envoyer les messages de journalisation vers un autre fichier. Si vous configurez un fichier journal diffrent, IBM Cognos 8 tente automatiquement de crer ce fichier au dmarrage, en plus du fichier journal implicite. Si l'emplacement du fichier journal configur est diffrent du rpertoire emplacement_c8/logs, vous devez vous assurer que le chemin d'accs au fichier journal existe avant de dmarrer le service IBM Cognos 8. Par exemple, si vous configurez le serveur de journalisation de faon envoyer les messages vers le fichier c:/log_files/cognos.log, IBM Cognos 8 tente automatiquement de crer le fichier cognos.log dans le dossier c:/log_files. Si ce dossier n'existe pas, IBM Cognos 8 ne cre pas le fichier cognos.log et aucun message de journalisation ne peut y tre consign. Notez que ces messages de journalisation ne sont pas consigns dans le fichier journal implicite. Bien qu'IBM Cognos 8 cre automatiquement le fichier journal implicite mme si un autre fichier journal est configur, le fichier journal implicite n'est pas utilis comme sauvegarde.
Base de donnes
Le serveur de journalisation peut galement envoyer des journaux d'analyse vers le mme ordinateur ou sur un ordinateur diffrent. Les journaux d'analyse fournissent des informations sur l'activit des utilisateurs et des rapports. La base de donnes de journalisation prsente les mmes exigences de configuration et de compte d'utilisateur que la base de donnes Content Store. Aprs avoir configur les composants d'IBM Cognos 8 pour qu'ils envoient des messages une base de donnes de journalisation, puis aprs avoir redmarr le service IBM Cognos 8, les composants d'IBM Cognos 8 crent les tables et les zones de table requises. Vous pouvez tester la connexion la base de donnes de journalisation avant de redmarrer le service IBM Cognos 8.
334
Configuration du client de base de donnes pour une base de donnes de journalisation

Aprs avoir cr une base de donnes pour les journaux d'analyse, la configuration du client de base de donnes requiert des tapes supplmentaires si vous utilisez Oracle, DB2 ou Sybase en tant que serveur de base de donnes. Si vous utilisez une base de donnes Microsoft SQL Server, le fichier JSQLConnect.jar est install par dfaut dans l'emplacement appropri. La seule autre procdure consiste s'assurer que Microsoft SQL Server utilise la connectivit TCP/IP. Remarque : Vous ne pouvez pas utiliser la base de donnes de contenu d'IBM Cognos en tant que base de donnes de journalisation. Si vous utilisez une base de donne Oracle ou Sybase, vous devez configurer le pilote JDBC sur tous les ordinateurs des composants d'application avec une connexion la base de donnes de journalisation. Vous devez aussi configurer le pilote JDBC sur l'ordinateur Content Manager, sauf si vous utilisez le mme type de base de donnes que Content Store pour les messages de journalisation. Si vous utilisez une base de donnes DB2, vous devez configurer le logiciel du client de base de donnes et le pilote JDBC 2.0 sur tous les ordinateurs des composants d'application avec une connexion la base de donnes de journalisation. Vous devez aussi configurer le logiciel du client de base de donnes et le pilote JDBC 2.0 sur l'ordinateur Content Manager, sauf si vous utilisez le mme type de base de donnes que Content Store pour les messages de journalisation. Remarque : Dans un environnement rparti, le serveur de journalisation local d'un ordinateur de composants d'application peut envoyer des messages de journalisation vers un serveur de journalisation distant, lequel envoie ensuite des messages la base de donnes de journalisation. Pour Oracle, Sybase et DB2, le pilote JDBC appropri et le logiciel de client de base de donnes (DB2 uniquement) ne sont requis que sur l'ordinateur des composants d'application avec le serveur de journalisation distant qui se connecte la base de donnes de journalisation.

1. Sur l'ordinateur o Oracle est install, accdez au rpertoire ORACLE_HOME/jdbc/lib. 2. Copiez le fichier ojdbc14.jar dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib des ordinateurs Content Manager ou de composants d'application appropris. Pour Oracle 11g, copiez le fichier ojdbc5.jar dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/ lib des ordinateurs Content Manager ou de composants d'application appropris. Si le rpertoire contient le fichier classes12.jar, supprimez-le avant d'installer le fichier ojdbc14.jar ou le fichier ojdbc5.jar.
Procdure pour DB2

1. Installez le logiciel de client DB2 sur les ordinateurs Content Manager ou de composants d'application appropris. 2. Si la base de donnes de journalisation ne se trouve pas sur le mme ordinateur que le serveur de journalisation, configurez un pseudonyme de base de donnes pour la base de donnes de journalisation : Sous Windows, excutez l'Assistant de configuration du client DB2.
Chapitre 11: Options de configuration Sous UNIX ou Linux, utilisez l'interface de ligne de commande DB2.
Remarque : Si la base de donnes de journalisation et le serveur de journalisation se trouvent sur le mme ordinateur, le nom de la base de donnes de journalisation est automatiquement utilis pour crer un pseudonyme. 3. Sous Windows, arrtez les services DB2 et le serveur de recherche HTML. 4. Pour copier le pilote JDBC2, copiez le fichier installation_DB2/sqllib/java/db2java.zip dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib. 5. Renommez le fichier db2java.zip en db2java.jar. 6. Sous Windows, redmarrez les services DB2 et le serveur de recherche HTML. 7. Rptez l'intgralit de cette procdure sur les ordinateurs Content Manager ou de composants d'application appropris.
Procdure pour Sybase

1. Sur l'ordinateur sur lequel Sybase est install, activez le pilote JDBC l'aide du script suivant : emplacement_Sybase/jConnect-5_5/sp/sql_server12.5.sql 2. Placez-vous dans le rpertoire emplacement_Sybase/jConnect-5_5/classes. 3. Copiez le fichier jconn2.jar dans le rpertoire emplacement_c8/webapps/p2pd/WEB-INF/lib des ordinateurs Content Manager ou de composants d'application appropris.
Indication de la destination des messages de journalisation

Vous pouvez configurer un type de destination pour les messages de journalisation et configurer ensuite les proprits pour la destination spcifique. Vous pouvez galement configurer plusieurs destinations pour des messages de journalisation.
Procdure
1. Si la destination est une base de donnes, vrifiez que : vous avez cr la base de donnes de journalisation (p. 63), vous avez configur le client de base de donnes (p. 335).
2. Sur l'ordinateur o vous avez install Content Manager ou les composants d'application, dmarrez IBM Cognos Configuration. 3. Dans la fentre Explorateur, dans la section Environnement, cliquez sur l'option Journalisation. 4. Dans la fentre Proprits, dfinissez les proprits du serveur de journalisation. Si vous souhaitez utiliser le protocole TCP entre les composants d'IBM Cognos 8 sur un ordinateur et le serveur de journalisation local, dfinissez la proprit Voulez-vous activer le protocole TCP ? sur Vrai. Le paramtre implicite UDP offre une communication plus rapide avec un risque moindre de perte de connexion que le protocole TCP. Cependant, le risque de perte d'une connexion 336
Chapitre 11: Options de configuration locale via TCP est faible. Le protocole TCP est toujours utilis pour la communication entre un serveur de journalisation local et un serveur de journalisation distant. Si vous souhaitez modifier le nombre de processus disponibles pour le serveur de journalisation local, saisissez la valeur dans la proprit Nombre maximal de processus du serveur de journalisation local. Vous pouvez dfinir une valeur comprise entre 1 et 20. La valeur implicite 10 est recommande. Cependant, si vous disposez d'un nombre lev de messages de journalisation, vous pouvez allouer davantage de processus pour amliorer les performances. Si vous voulez appliquer un encodage UTF-8 aux messages de journalisation crits dans un fichier, dfinissez la proprit Voulez-vous utiliser l'encodage UTF-8 ? sur Vrai. Si le composant IBM Cognos 8 utilise l'encodage plusieurs octets, vous devez dfinir cette proprit sur Vrai et utiliser un diteur UTF-8 pour afficher le fichier journal. Sinon, ce fichier journal risque de comporter des caractres illisibles. 5. Dans la fentre Explorateur, dans la section Environnement, cliquez avec le bouton droit de la souris sur l'option Journalisation, puis cliquez successivement sur les options Nouvelle ressource et Destination. 6. Dans la zone Nom, saisissez le nom de la destination. 7. Dans la liste Type, cliquez sur le type appropri, puis sur le bouton OK. 8. Si la destination est un fichier, saisissez les valeurs appropries pour les proprits obligatoires et facultatives dans la fentre Proprits. 9. Si la destination est un serveur de journalisation distant, saisissez les valeurs appropries pour les proprits obligatoires et facultatives dans la fentre Proprits. Si l'lment URI interne du distributeur de l'ordinateur IBM Cognos 8 de destination est configur de manire utiliser le protocole SSL (p. 326), dans la fentre Proprits, dfinissez la proprit Voulez-vous activer le protocole SSL ? sur Vrai. Vous devez ensuite dfinir la destination des messages de journalisation lorsque vous configurez le serveur de journalisation distant. 10. Si la destination est une base de donnes, dans la fentre Explorateur, sous Journalisation, dfinissez le type de base de donnes et ses proprits de la faon suivante : Cliquez avec le bouton droit de la souris sur le nom de la base de donnes, cliquez sur Nouvelle ressource, puis sur Base de donnes. Dans la zone Nom, saisissez le nom de la destination. Dans la liste Type, cliquez sur le type de base de donnes appropri, puis sur le bouton OK. Dans la fentre Proprits, saisissez les valeurs appropries pour les proprits facultatives et obligatoires.
Chapitre 11: Options de configuration Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance. Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre. Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire Testez la connexion la nouvelle base de donnes. Dans la section Environnement de la fentre Explorateur, cliquez avec le bouton droit de la souris sur Journalisation, puis cliquez sur Tester. Les composants d'IBM Cognos 8 se connectent la base de donnes. Si vous avez configur plusieurs bases de donnes pour la journalisation des messages, les composants d'IBM Cognos 8 testent l'ensemble des bases de donnes. 11. Rptez les tapes 5 10 pour chacune des destinations auxquelles le serveur de journalisation doit envoyer des messages. 12. Dans le menu Fichier, cliquez sur l'option Enregistrer. 13. Dans la fentre Explorateur, cliquez sur Service IBM Cognos 8, puis sur IBM Cognos 8. 14. Dans le menu Fichier, cliquez sur l'option Redmarrer. Si vous avez slectionn une base de donnes comme destination, les composants d'IBM Cognos 8 crent les tables et les champs requis dans la base de donnes cre. Si la destination tait un serveur de journalisation distant, configurez le serveur de journalisation distant et dmarrez-le. Redmarrez ensuite le service IBM Cognos 8 sur l'ordinateur local. Si la destination tait une base de donnes, vous pouvez utiliser les composants d'IBM Cognos 8 pour excuter les rapports de journalisation partir de la base de donnes. Vous pouvez galement dfinir le niveau de journalisation qui contrle la quantit de dtails et le type de messages qui sont envoys vers un fichier ou une base de donnes de journalisation. Pour obtenir des instructions, reportez-vous au Guide d'administration et de scurit.
Modification des paramtres globaux

Vous pouvez modifier les paramtres globaux : pour personnaliser la prise en charge linguistique de l'interface utilisateur, pour personnaliser la prise en charge des monnaies, pour personnaliser la prise en charge des paramtres rgionaux du contenu,
338
Chapitre 11: Options de configuration pour faire correspondre la langue utilise dans l'interface utilisateur du produit, pour faire correspondre les paramtres rgionaux du contenu, pour ajouter des polices votre environnement IBM Cognos, pour modifier le fuseau horaire implicite, pour modifier l'encodage des courriers lectroniques, pour personnaliser les paramtres de tmoin (cookie).
Par dfaut, les composants d'IBM Cognos Series 8 appliquent une forme normalise tous les paramtres rgionaux, qui peuvent provenir de diffrentes sources et se prsenter sous divers formats. Cela signifie que tous les paramtres rgionaux tendus sont conformes une dfinition de langue et de code rgional. Chaque ordinateur a des paramtres systme rgionaux implicites et des paramtres rgionaux par utilisateur. Les paramtres rgionaux de l'utilisateur peuvent diffrer de ceux du systme. Important : Si vous modifiez les paramtres globaux sur l'un des ordinateurs Content Manager, vous devez effectuer les mmes modifications sur les autres ordinateurs Content Manager.
Personnalisation de la prise en charge linguistique de l'interface utilisateur

Utilisez la table Paramtres rgionaux du produit pour ajouter ou supprimer des langues prises en charge par l'interface utilisateur. Par exemple, si vous n'avez pas besoin d'une interface utilisateur en allemand, vous pouvez supprimer cette langue de la liste. La modification de la langue de l'interface utilisateur du produit n'affecte pas les donnes. Pour pouvoir ajouter la prise en charge d'une langue l'interface utilisateur, vous devez installer les fichiers linguistiques sur tous les ordinateurs de l'installation rpartie. Pour en savoir davantage, contactez le responsable du support technique. L'ajout de langues l'environnement d'IBM Cognos ne garantit pas que l'ordinateur dispose de la police ncessaire pour afficher les pages Web dans vos langues favorites. Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres utiliss. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Langues du produit. 4. Cliquez sur Ajouter. Conseil : Pour supprimer une langue prise en charge, cochez la case situe en regard de l'option Paramtres rgionaux pris en charge, puis cliquez sur l'option Supprimer. 5. Dans la deuxime colonne, saisissez la portion linguistique des paramtres rgionaux.
Chapitre 11: Options de configuration 6. Rptez les tapes 3 5 pour les autres langues prises en charge ajouter. 7. Cliquez sur OK. 8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Personnalisation de la prise en charge de la monnaie

Si vous souhaitez disposer de monnaies supplmentaires ou en supprimer certaines de l'interface utilisateur, vous pouvez mettre jour la liste des monnaies prises en charge dans la table Monnaies. Si vous utilisez des monnaies japonaises ou corennes, vous devez configurer la prise en charge pour que les caractres du yen japonais et du won coren s'affichent correctement.
Ajout de monnaies IBM Cognos 8

Vous pouvez ajouter des monnaies (prises en charge ou non) dans l'interface utilisateur. Les monnaies prises en charge sont ajoutes dans IBM Cognos Configuration. Vous pouvez ajouter des monnaies non prises en charge au fichier i18n_res.xml fourni dans IBM Cognos 8. Par dfaut, les composants d'IBM Cognos 8 prsentent uniquement un sous-ensemble des monnaies prises en charge dans l'interface utilisateur. Les monnaies sont identifies par leur code ISO 4217. La liste complte des monnaies prises en charge que vous pouvez ajouter figure dans le fichier i18n_res.xml situ dans le rpertoire emplacement_c8\bin. Si vous ajoutez un code de monnaie qui n'est pas pris en charge par IBM Cognos, vous devez l'ajouter manuellement au fichier i18n_res.xml dans le rpertoire emplacement_c8\bin. Copiez ce fichier sur chaque ordinateur IBM Cognos de votre installation. L'ajout de monnaies l'environnement d'IBM Cognos ne garantit pas que l'ordinateur dispose de la police ncessaire pour en afficher les symboles. Veillez installer les packs linguistiques appropris pour la prise en charge des symboles des monnaies que vous utilisez. Par exemple, pour afficher le symbole de la monnaie indienne (roupie), vous devez excuter un systme d'exploitation japonais ou installer le pack linguistique japonais. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Monnaies. 4. Cliquez sur Ajouter. Conseil : Pour supprimer un lment pris en charge, cochez la case situe en regard de cet lment, puis cliquez sur l'option Supprimer. 5. Dans la deuxime colonne, saisissez une valeur approprie. La valeur que vous ajoutez doit tre conforme aux codes ISO 4217 relatifs la reprsentation des monnaies et des formats. Gnralement, la valeur que vous ajoutez doit tre un code alphabtique de trois lettres. Les deux premiers caractres sont des lettres reprsentant le code 340
Chapitre 11: Options de configuration monnaie ISO 3166 du pays dont provient la monnaie. La lettre supplmentaire correspond l'initiale de la monnaie. 6. Rptez les tapes 3 5 pour les autres types d'lments pris en charge ajouter. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration de la prise en charge des caractres du yen japonais et du won coren

Les caractres du yen japonais et du won coren sont stocks respectivement avec les valeurs U+00A5 et U+20A9 dans la table de caractres Unicode standard. Toutefois, l'utilisation de ces valeurs n'est pas universelle et la valeur U+005C est souvent utilise pour le caractre du yen japonais et du won coren. Selon les polices disponibles, le caractre stock avec la valeur U+005C peut s'afficher sous la forme d'une barre oblique inverse au lieu du caractre du yen ou du won. Par exemple, si le serveur ne dispose pas de la police de langue approprie et utilise la police de remplacement standard, Andale WT, la valeur U+005C est employe en tant que barre oblique inverse. Des polices Andale WT japonaise et corenne sont fournies. Ces polices mettent en correspondance la valeur U+005C avec le caractre du yen ou du won. Elles sont disponibles sur le CD IBM Cognos 8 Supplementary Languages. Pour utiliser ces polices, vous devez les installer partir du CD IBM Cognos 8 Supplementary Languages, puis modifier le fichier GlobalReportStyles.css.
Procdure d'installation des polices pour les caractres du yen et du won

1. Utilisez l'assistant d'installation du CD Supplementary Languages sur chaque ordinateur contenant des composants d'application. Pour en savoir davantage, reportez-vous au manuel IBM Cognos 8 Supplementary Languages Installation and Configuration Guide 2. Sur la page de slection de composants de l'assistant d'installation, dveloppez l'option Polices de langue supplmentaires, puis slectionnez la police que vous souhaitez installer. 3. Suivez les instructions affiches dans l'assistant d'installation pour effectuer l'installation. Les polices sont copies dans le rpertoire emplacement_c8\bin\fonts. L'emplacement de la police est dfini par la valeur Emplacements des polices physiques dans IBM Cognos Configuration, sous Configuration locale, Environnement. Si vous stockez les polices dans un autre emplacement, vrifiez que celui-ci est ajout la valeur Emplacements des polices physiques.
Procdure de mise jour de la feuille de style

1. Ouvrez la feuille de style GlobalReportStyles.css dans un diteur de texte. La feuille de style GlobalReportStyles.css se trouve dans le rpertoire emplacement_c8\bin. 2. Activez l'une des sections suivantes et modifiez-la comme suit :
/* For Japanese: */ .pg, .pp {

font-family:'MS UI Gothic', 'Andale WT J' , Tahoma, arial, geneva, helvetica,sans-serif; }
/* For Korean: */ .pg, .pp { font-family:Gulim, 'Andale WT K' , Tahoma, arial, geneva, helvetica, sans-serif; }
Le gnrateur de fichiers PDF utilise la premire police disponible sur le serveur et inclut tous les caractres de la chane afficher. Si vous prfrez utiliser d'autres polices figurant sur votre serveur, vous pouvez les insrer dans la liste. 3. Enregistrez le fichier GlobalReportStyles.css. 4. Redmarrez le serveur IBM Cognos8. Toute modification apporte une feuille de style est remplace si vous effectuez une mise niveau d'IBM Cognos 8. Vous devez rpter cette procdure aprs une mise niveau.
Personnalisation de la prise en charge des paramtres rgionaux du contenu

Pour s'assurer que les utilisateurs visualisent les rapports, les donnes ou les mtadonnes dans leur langue favorite ou avec des spcificits propres leur rgion, vous pouvez ajouter des paramtres rgionaux partiels (langues) ou complets (langue-rgion) la table Paramtres rgionaux (contenu). De cette faon, si le contenu est disponible dans plusieurs langues ou avec plusieurs spcificits rgionales, il s'affiche pour les utilisateurs en fonction de leurs paramtres rgionaux. Pour une partie du contenu du portail, les paramtres rgionaux du contenu prvalent sur ceux du produit. Lorsque vous affichez les rapports en langue thae, les chiffres ne sont pas pris en charge. Si un paramtre rgional n'est pas obligatoire, vous pouvez le supprimer de la liste. Vous devez laisser au moins un paramtre rgional du contenu dans la liste pour que le serveur de rapport puisse fonctionner. L'ajout de paramtres rgionaux incomplets (langues) l'environnement d'IBM Cognos ne garantit pas que l'ordinateur dispose de la police ncessaire pour afficher les pages Web dans vos langues favorites. Veillez installer les packs linguistiques appropris pour la prise en charge des jeux de caractres utiliss. Pour en savoir davantage sur l'installation de packs linguistiques, reportez-vous au manuel IBM Cognos Supplementary Languages Installation and Configuration Guide.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Paramtres rgionaux (contenu).
342
Chapitre 11: Options de configuration 4. Cliquez sur Ajouter. Conseil : Pour supprimer un lment pris en charge, cochez la case situe en regard de cet lment, puis cliquez sur l'option Supprimer. 5. Dans la deuxime colonne, saisissez une valeur approprie. Pour ajouter la prise en charge d'une langue pour les donnes et mtadonnes de rapport, saisissez un paramtre local partiel (langue). Pour ajouter une prise en charge spcifique une rgion, saisissez des paramtres rgionaux complets (langue-rgion).
6. Rptez les tches 3 5 pour chaque paramtre rgional supplmentaire que vous voulez prendre en charge. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Mise en correspondance des paramtres rgionaux (contenu)

Utilisez la table Correspondances des paramtres rgionaux (contenu) pour faire correspondre les paramtres rgionaux de l'utilisateur avec des paramtres rgionaux complets (langue-rgion) ou partiels (langue). Vous pouvez galement faire correspondre la langue favorite d'un utilisateur avec une autre langue si le contenu n'est pas disponible dans la langue de l'utilisateur. Par exemple, si un rapport ou un tableau de bord n'est pas disponible dans la langue d'un utilisateur, comme le vietnamien, mais est disponible en franais et en allemand, vous pouvez utiliser la table pour faire correspondre la langue favorite de l'utilisateur (vietnamien) avec une autre langue (franais ou allemand). Le rapport ou tableau de bord s'affiche alors dans cette langue. Par dfaut, la table Correspondances des paramtres rgionaux (contenu) contient des paramtres rgionaux n'incluant pas la rgion. Cela permet de n'utiliser que la partie linguistique des paramtres rgionaux et garantit que vous voyez toujours les informations appropries. Par exemple, dans une base de donnes multilingue, les donnes sont gnralement disponibles dans diffrentes langues, telles que le franais (fr), l'espagnol (es) et l'anglais (en), plutt que dans des langues rgionales, telles que l'anglais du Canada (en-ca), l'anglais des tats-Unis (en-us) ou le franais de France (frfr). Les exemples ci-dessous montrent comment les composants d'IBM Cognos 8 dterminent le rapport ou le tableau de bord que l'utilisateur visualise si des versions en diffrentes langues sont disponibles.
Exemple 1
Un rapport est disponible dans Content Manager dans deux langues rgionales, telles que en-us (anglais des tats-Unis) et fr-fr (franais de France), mais les paramtres rgionaux de l'utilisateur sont dfinis sur fr-ca (franais du Canada). IBM Cognos 8 utilise les correspondances de paramtres rgionaux pour dterminer le rapport afficher pour l'utilisateur. Tout d'abord, IBM Cognos 8 vrifie dans Content Manager si le rapport est disponible dans la langue des paramtres rgionaux de l'utilisateur. Si tel n'est pas le cas, IBM Cognos 8 met en correspondance les paramtres rgionaux de l'utilisateur avec des paramtres rgionaux normaliss configurs dans l'onglet Correspondances des paramtres rgionaux (contenu). La langue des
Chapitre 11: Options de configuration paramtres rgionaux de l'utilisateur tant fr-ca, la correspondance est tablie avec fr. IBM Cognos 8 utilise la valeur de correspondance pour vrifier si le rapport est disponible en fr. Dans le cas prsent, le rapport est disponible en en-us et en fr-fr, mais pas en fr. Ensuite, IBM Cognos 8 met en correspondance les rapports disponibles avec des paramtres rgionaux normaliss. Ainsi, en-us devient en et fr-fr devient fr. Du fait que tant le rapport que les paramtres rgionaux de l'utilisateur sont mis en correspondance avec fr, l'utilisateur dont les paramtres rgionaux indiquent la langue fr-ca voit s'afficher le rapport en fr-fr.
Exemple 2
Les paramtres rgionaux de l'utilisateur et ceux du rapport correspondent la mme langue.IBM Cognos 8 slectionne les paramtres rgionaux utiliser. Par exemple, si les paramtres rgionaux d'un utilisateur indiquent la langue en-ca (anglais du Canada) et que les rapports sont disponibles en en-us (anglais des tats-Unis) et en-gb (anglais du Royaume-Uni), IBM Cognos 8 met en correspondance chaque paramtre rgional avec en.L'utilisateur visualise le rapport conformment aux paramtres rgionaux choisis par IBM Cognos 8.
Exemple 3
Les paramtres rgionaux du rapport et ceux de l'utilisateur ne sont pas mis en correspondance avec une langue commune. IBM Cognos 8 slectionne la langue. Dans ce cas, il peut s'avrer ncessaire de configurer la mise en correspondance. Par exemple, si un rapport est disponible en en-us (anglais des tats-Unis) et fr-fr (franais de France), tandis que les paramtres rgionaux de l'utilisateur indiquent la langue es-es (espagnol d'Espagne), IBM Cognos 8 slectionne la langue.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Correspondances des paramtres rgionaux (contenu). 4. Cliquez sur Ajouter. 5. Dans la zone Cl, saisissez les paramtres rgionaux de l'utilisateur. Pour faire en sorte que toutes les rgions correspondant une langue voient le contenu dans cette langue spcifique, saisissez la portion linguistique des paramtres rgionaux, suivie d'un tiret (-) et d'un astrisque (*). Par exemple, saisissez fr-*. Pour faire en sorte qu'un utilisateur voie le contenu correspondant ses paramtres rgionaux spcifiques (langue-rgion), saisissez les paramtres rgionaux complets. Par exemple, saisissez fr-ch. Pour mettre en correspondance une langue favorite avec une autre, saisissez la portion de langue favorite des paramtres rgionaux. Par exemple, saisissez zh.
344
Chapitre 11: Options de configuration Conseil : Pour indiquer les paramtres rgionaux utiliser pour plusieurs cls, saisissez le caractre gnrique (*) avec la valeur Cl puis, dans la zone Correspondance des paramtres rgionaux, saisissez les paramtres rgionaux. Si vous souhaitez par exemple que toutes les cls allemandes utilisent des paramtres rgionaux allemands, saisissez de* dans la zone Cl, puis saisissez de dans la zone Correspondance des paramtres rgionaux. 6. Dans la zone Correspondance des paramtres rgionaux, saisissez la portion linguistique des paramtres rgionaux. Les paramtres rgionaux de l'utilisateur spcifis dans la zone Cl appelleront le contenu dans cette langue. 7. Rptez les tapes 3 5 pour les autres mises en correspondance tablir. 8. Cliquez sur OK. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Mise en correspondance des langues du produit

Utilisez la table Correspondance des langues du produit pour indiquer la langue utilise dans l'interface utilisateur lorsque celle prcise dans les paramtres rgionaux de l'utilisateur n'est pas disponible. Vous pouvez faire en sorte que toutes les rgions correspondant un paramtre rgional utilisent la mme langue ou que des paramtres rgionaux complets spcifiques (langue-rgion) utilisent une langue particulire. Par dfaut, l'utilisateur voit l'interface du produit s'afficher dans la langue correspondant celle de ses paramtres rgionaux.
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Correspondance des langues du produit. 4. Cliquez sur Ajouter. 5. Dans la zone Cl, saisissez les paramtres rgionaux de l'utilisateur. Pour faire en sorte que toutes les rgions correspondant une langue voient l'interface utilisateur dans cette langue spcifique, saisissez la portion linguistique des paramtres rgionaux, suivie d'un tiret (-) et d'un astrisque (*). Par exemple, saisissez es-*. Pour faire en sorte que les paramtres rgionaux complets (langue-rgion) entranent l'affichage de l'interface utilisateur dans une langue spcifique, saisissez les paramtres rgionaux complets. Par exemple, saisissez es-es.
Chapitre 11: Options de configuration Pour mettre en correspondance une langue favorite avec une autre, saisissez la portion de langue favorite des paramtres rgionaux. Par exemple, saisissez zh. Conseil : Pour indiquer les paramtres rgionaux utiliser par dfaut, saisissez le caractre gnrique (*) comme valeur dans la zone Cl, puis dans la zone Correspondance des paramtres rgionaux, saisissez les paramtres rgionaux. 6. Dans la zone Correspondance des paramtres rgionaux, saisissez la portion linguistique des paramtres rgionaux. Les paramtres rgionaux de l'utilisateur spcifis dans la zone Cl appelleront le contenu dans cette langue. 7. Rptez les tapes 3 5 pour les autres mises en correspondance tablir. 8. Cliquez sur OK. 9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Personnalisation du fuseau horaire du serveur

Vous pouvez modifier le fuseau horaire utilis par Content Manager en slectionnant un autre fuseau horaire dans IBM Cognos Configuration. Pour les installations UNIX ne prenant pas en charge les interfaces graphiques utilisateur de type Java, vous pouvez consulter la liste des fuseaux horaires acceptables en ouvrant IBM Cognos Configuration sur l'ordinateur Windows sur lequel Framework Manager est install. Par dfaut, Content Manager est configur pour utiliser le fuseau horaire de votre systme d'exploitation. Toutes les activits programmes dans IBM Cognos 8 sont dfinies l'aide de ce fuseau horaire. En outre, les utilisateurs d'IBM Cognos Connection utilisent ce fuseau horaire lorsque leurs prfrences sont dfinies avec le fuseau horaire implicite. Pour en savoir davantage sur la dfinition des prfrences de l'utilisateur dans IBM Cognos Connection, reportez-vous au Guide d'administration et de scurit.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Dans la fentre Configuration globale, cliquez sur l'onglet Gnral. 4. Cliquez sur Fuseau horaire du serveur dans la colonne Valeur et slectionnez un autre fuseau horaire dans la liste. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Modification de l'encodage pour les courriers lectroniques

Par dfaut, les composants d'IBM Cognos 8 utilisent l'encodage UTF-8 dans les courriers lectroniques. Cette valeur dfinit l'encodage implicite utilis par le service de diffusion dans cette instance 346
Chapitre 11: Options de configuration pour tous les messages lectroniques. Il est possible que vous disposiez de clients de courrier lectronique plus anciens ou que vous envoyiez des courriers lectroniques depuis IBM Cognos 8 des tlphones portables et des assistants lectroniques ne reconnaissant pas le format UTF-8. Si tel est le cas, vous pouvez redfinir l'encodage des courriers lectroniques sur une valeur applicable tous vos clients de courrier lectronique (par exemple, ISO-8859-1, Shift-JIS). Chaque instance d'IBM Cognos 8 disposant d'un service de diffusion disponible doit tre modifie. L'encodage dfini a une incidence sur la totalit du message, notamment l'objet, les pices jointes, les noms de pices jointes et le texte du corps du message au format brut ou HTML.
Jeu de caractres
UTF-8 Europe de l'Ouest (ISO 8859-1) Europe de l'Ouest (ISO 8859-15) Europe de l'Ouest (Windows-1252) Europe centrale et de l'Est (ISO 8859-2) Europe centrale et de l'Est (Windows-1250) Cyrillique (ISO 8859-5) Cyrillique (Windows-1251) Turc (ISO 8859-9) Turc (Windows-1254) Grec (ISO 8859-7) Grec (Windows-1253) Japonais (EUC-JP) Japonais (ISO-2022-JP) Japonais (Shift-JIS) Chinois traditionnel (Big5) Chinois simplifi (GB-2312) Coren (EUC-KR)
Valeur d'encodage prise en charge

utf-8 iso-8859-1 iso-8859-15 windows-1252 iso-8859-2 windows-1250 iso-8859-5 windows-1251 iso-8859-9 windows-1254 iso-8859-7 windows-1253 euc-jp iso-2202-jp shift_jis big5 gb2312 euc-kr
Jeu de caractres
Coren (ISO 2022-KR) Coren (KSC-5601) Tha (Windows-874) Tha (TIS-620)
Valeur d'encodage prise en charge

ISO 2022-KR ksc_5601 windows-874 tis-620
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Dans la fentre Configuration globale, cliquez sur l'onglet Gnral. 4. Cliquez sur la proprit Encodage des courriers lectroniques dans la colonne Valeur. 5. Dfilez jusqu'au paramtre souhait et slectionnez-le. 6. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Personnalisation des tmoins (cookies)

Selon les exigences de votre environnement IBM Cognos, vous pouvez tre amen modifier les paramtres utiliss par les composants d'IBM Cognos 8 pour crer les tmoins (cookies). Vous pouvez utiliser IBM Cognos Configuration pour personnaliser le domaine, le chemin d'accs et l'indicateur de scurit des tmoins. Les composants d'IBM Cognos 8 dterminent le domaine des tmoins partir de la demande HTTP transmise par le client, qui correspond gnralement un navigateur Web. Dans la plupart des configurations rseau, les demandes HTTP passent par des intermdiaires tels que des serveurs proxy et des pare-feux pendant leur transfert depuis le navigateur vers les composants d'IBM Cognos 8. Certains intermdiaires modifient les informations que les composants d'IBM Cognos 8 utilisent pour calculer le domaine de tmoins ; ces composants ne parviennent alors pas dfinir de tmoins. Le symptme principal de ce problme est l'apparition rpte de l'invite de connexion. Pour viter ce problme, configurez le domaine des tmoins. Pour dfinir la valeur correcte pour le domaine des tmoins, utilisez le format et la valeur qui reprsentent la couverture la plus importante pour l'hte.
Hte
ordinateur ou serveur
Format du domaine
nom de l'ordinateur ou du serveur (sans point)
Exemple
masocit
348
Hte
Format du domaine
Exemple
.ma socit.com
le suffixe est .com, .edu, . .nom.suffixe gov, .int, .mil, .net ou .org (deux points) autre .nom1.nom2.suffixe (trois points)
.infosvoyage.co.nz
Procdure
1. Dmarrez IBM Cognos Configuration sur chaque ordinateur Content Manager. 2. Dans le menu Oprations, cliquez sur l'option Modifier la configuration globale. 3. Cliquez sur l'onglet Gnral. 4. Cliquez sur la colonne Valeur dans Paramtres de tmoin (cookie) pour chaque proprit que vous souhaitez modifier et indiquez la nouvelle valeur. Si vous laissez la proprit Domaine vide, le distributeur dduit le domaine du nom d'hte de la demande. 5. Cliquez sur OK.
Changement de passerelle
Pour amliorer les performances du serveur Web, vous pouvez configurer IBM Cognos 8 pour qu'il utilise d'autres passerelles la place du programme CGI implicite. Vous pouvez utiliser l'une des passerelles suivantes : Microsoft Internet Application Programming Interface (ISAPI) pour les services d'information Internet de Microsoft sous Windows, module Apache Web Server, application Passerelle de type servlet Java pour les serveurs d'applications.
Aucune configuration de serveur Web supplmentaire n'est requise pour utiliser ISAPI. Pour accder aux composants IBM Cognos 8 l'aide d'ISAPI, dans IBM Cognos Configuration, modifiez la portion cognos.cgi de la proprit URI de la passerelle en cognosisapi.dll. Dfinissez ensuite l'URI ISAPI, http://nom_hte/cognos8/isapi, dans votre navigateur. Avant de changer de passerelle, il est recommand de vrifier que la passerelle CGI implicite et votre configuration fonctionnent dans votre environnement.
Configuration de la passerelle pour le module IBM Cognos Apache Web Server

IBM Cognos 8 intgre trois modules Apache. Le module IBM Cognos Apache requiert Apache Server 1.3.x et le module IBM Cognos Apache 2 Apache Server 2.0.x. Le module IBM Cognos Apache 2.2 requiert Apache Server 2.2.x.
Procdure
1. Arrtez le serveur Web Apache. 2. Ajoutez le rpertoire emplacement_c8/cgi-bin la variable d'environnement approprie : Sous Solaris ou Linux : LD_LIBRARY_PATH Sous HP-UX, Pour Apache 1.3 : SHLIB_PATH Pour Apache 2.0 et Apache 2.2.x, SHLIB_PATH et LD_LIBRARY_PATH Sous AIX : LIBPATH
3. Sous HP-UX PA-RISC, procdez comme suit : Assurez-vous que la variable d'environnement LD_PRELOAD contient /usr/lib/libcl.2. Pour Apache 1.3, dfinissez la variable d'environnement COG_CGIBIN_DIR sur emplacement_c8/cgi-bin.
4. Ouvrez le rpertoire installation_Apache/conf. 5. Ouvrez le fichier httpd.conf dans un diteur. 6. Ajoutez ce qui suit la fin de la liste de chargement de module : LoadModule cognos_module "emplacement_c8/cgi-bin/nom_module" o nom_module correspond :
Systme d'exploi- Module tation Apache 1,3

Windows Solaris, AIX HP-UX PA-RISC HP-UX IA, Linux mod_cognos.dll mod_cognos.so mod_cognos.sl (non pris en charge)
Module Apache 2.0 Module Apache 2,2
mod2_cognos.dll mod2_cognos.so mod2_cognos.sl mod2_cognos.s0
mod2_2_cognos.dll mod2_2_cognos.so mod2_2_cognos.sl mod2_2_cognos.so
7. Pour Apache 1.3, ajoutez ce qui suit la fin de la liste d'ajout de module : AddModule mod_cognos.cpp 8. Ajoutez ce qui suit la section des alias :
350

ScriptAlias /cognos8/cgi-bin "emplacement_c8/cgi-bin" Alias /cognos8 "emplacement_c8/webcontent" <Directory "emplacement_c8/webcontent"> Options Indexes MultiViews </Directory>
La directive <Directory> est facultative. Conseil : Veillez dfinir l'alias cognos8/cgi-bin avant l'alias cognos8. 9. Pour Apache 2.2, ajoutez les rgles de scurit suivantes :
ScriptAlias /cognos8/cgi-bin "emplacement_c8/cgi-bin" Alias /cognos8 "emplacement_c8/webcontent" <Directory "emplacementc8/webcontent"> Options Indexes MultiViews AllowOverride None Options None Order allow,deny Allow from all </Directory> <Directory "emplacementc8/cgi-bin" AllowOverride None Options None Order allow,deny Allow from all </Directory>
10. Pour Apache 1.3 et Apache 2.0, ajoutez ce qui suit la section des rapports d'tat du serveur :
<Location /cognos8/cgi-bin/cognos_module> SetHandler cognos-handler </Location>
Pour Apache 2.2 et Apache 2.0, ajoutez ce qui suit la section des rapports d'tat du serveur :
<Location /cognos8/cgi-bin/cognos_module> SetHandler cognos-handler Order allow,deny Allow from all </Location>
Saisissez le code exactement tel qu'il vous a t fourni. La chane module_cognos fait rfrence au module charg l'tape 6. 11. Pour Apache 1.3 et Apache 2.0, afin d'activer la page de diagnostic de la passerelle, ajoutez ce qui suit la section des rapports d'tat du serveur : Guide d'installation et de configuration 351

<Location /cognos8/cgi-bin/diag_cognos_module> SetHandler cognos-handler </Location>
Pour Apache 2.2 et Apache 2.0, ajoutez ce qui suit la section des rapports d'tat du serveur :
<Location /cognos8/cgi-bin/cognos_module> SetHandler cognos-handler Order allow,deny Allow from all </Location>
Saisissez le code exactement tel qu'il vous a t fourni. La chane diag_ est obligatoire et la chane module_cognos fait rfrence au module charg l'tape 6. 12. Pour Apache 1.3, sous Windows, Solaris et AIX, ajoutez ce qui suit la section de l'annuaire d'utilisateurs :
<IfModule mod_cognos.cpp> CGIBinDir "emplacement_c8/cgi-bin" </IfModule>
13. Pour Apache 2.0, ajoutez ce qui suit la section de l'annuaire d'utilisateurs :
<IfModule mod_cognos.c> CGIBinDir "emplacement_c8/cgi-bin" </IfModule>
Pour Apache 2.2.x, ajoutez ce qui suit la section de l'annuaire d'utilisateurs :

<IfModule mod2_2_cognos.c.c> CGIBinDir "emplacement_c8/cgi-bin" </IfModule>
14. Enregistrez et fermez le fichier. 15. Pour Apache 2.0, sous HP-UX, activez la recherche de LD_LIBRARY_PATH en excutant la commande suivante dans le rpertoire installation_Apache/bin : chatr +s enable +b enable httpd 16. Dmarrez le serveur Web Apache. 17. Dans IBM Cognos Configuration, configurez la proprit URI de la passerelle de faon ce qu'elle utilise la passerelle apache_mod : http://nom_hte:port/cognos8/cgi-bin/nom_module o nom_module correspond au nom utilis l'tape 6.
Configuration de la passerelle du servlet

Si vous configurez la passerelle du servlet IBM Cognos pour qu'elle s'excute sur un serveur d'application pris en charge, votre environnement n'a bas besoin d'un serveur Web. Le serveur
352
Chapitre 11: Options de configuration d'application et la passerelle du servlet IBM Cognos remplacent les fonctions fournies par un serveur Web et d'autres passerelles IBM Cognos. Avant de crer et de dployer la passerelle de servlet IBM Cognos, vrifiez les points suivants : Le serveur d'application est install et fonctionne sur tous les ordinateurs sur lesquels la passerelle du servlet doit tre installe. Les composants de passerelle d'IBM Cognos 8 sont installs sur le mme systme que le serveur d'application. Le distributeur IBM Cognos 8 et les composants de Content Manager sont installs et s'excutent dans l'environnement. Le compte d'utilisateur du serveur d'application dispose des droits d'accs complets pour l'installation d'IBM Cognos. Il est recommand de crer un groupe UNIX ou Linux appel cognos8. Ce groupe doit contenir l'utilisateur qui dmarre le serveur d'application et l'utilisateur qui est propritaire des fichiers IBM Cognos. Dfinissez les droits de propritaire des fichiers IBM Cognos pour le groupe cognos8 et dfinissez les droits d'accs tous les fichiers IBM Cognos sur GROUP READABLE/ WRITABLE/EXECUTABLE. Pour plus de simplicit, vous pouvez galement utiliser le compte d'utilisateur du serveur d'application pour installer et excuter les composants d'IBM Cognos. Pour configurer la passerelle de type servlet IBM Cognos de faon ce qu'elle s'excute sur votre serveur d'application, vous devez effectuer les oprations suivantes : Crer une instance JVM spare, si ncessaire. Si vous avez l'intention d'excuter IBM Cognos 8 et la passerelle de type servlet IBM Cognos sur le mme serveur d'application, la passerelle de type servlet doit tre dploye sur une instance JVM spare. Vrifier que les composants IBM Cognos sont correctement configurs. Dfinir des variables d'environnement. Mettre jour l'environnement Java. Configurer la passerelle de type servlet IBM Cognos pour qu'elle s'excute sur le serveur d'application. Modifier le script de dmarrage du serveur d'application, si ncessaire. Configurer les proprits du serveur d'application et dployer la passerelle de type servlet IBM Cognos. Activer le protocole SSL, si ncessaire. Configurer le serveur Web.
Vous pouvez ensuite accder aux composants de Cognos 8 l'aide de la passerelle de type servlet IBM Cognos en indiquant l'URI de la passerelle. Par exemple : http[s]:nom_hte:port/ServletGateway
Chapitre 11: Options de configuration L'URI de la passerelle de type servlet IBM Cognos est sensible la casse.
Modification de la version de l'adresse IP

IBM Cognos 8 prend en charge deux versions d'adresse IP : IPv4 et IPv6.IPv4 utilise des adresses IP 32 bits et IPv6 des adresses IP 128 bits. Par exemple : IPv4 : 192.168.0.1:80 IPv6 : [2001:0db8:0000:0000:0000:148:57ab]:80
Dans IBM Cognos Configuration, vous pouvez slectionner IPv4 ou IPv6 pour la communication IBM Cognos 8 via la proprit Configuration du rseau. Par dfaut, la communication IPv4 est utilise. Le paramtre s'applique uniquement l'ordinateur sur lequel il est dfini. Si vous slectionnez l'option Prfrer la pile IPv4, toutes les connexions IBM Cognos 8 sortantes de cet ordinateur sont tablies l'aide du protocole IPv4 et le distributeur accepte uniquement les connexions IPv4 entrantes. Si vous slectionnez Prfrer les adresses IPv6, toutes les adresses IBM Cognos 8 sortantes de cet ordinateur sont tablies l'aide du protocole IPv6 et le distributeur accepte les connexions IPv4 et IPv6. Les postes client IPv4 peuvent communiquer avec les postes distributeur configurs pour IPv6. Les noms d'htes spcifis dans un URI sont rsolus en fonction de la valeur de la proprit Configuration du rseau. Cependant, si un URI a t spcifi avec une adresse numrique, il prvaut sur ce paramtre et la communication est tablie l'aide du protocole IPv4.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Cliquez sur la zone Valeur associe Version IP pour la rsolution du nom d'hte et cliquez sur Utiliser les adresses IPv4 ou Utiliser les adresses IPv6. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Configuration d'IBM Cognos 8 pour une utilisation avec d'autres produits d'IBM Cognos
Certains produits d'IBM Cognos offrent des fonctions non disponibles dans IBM Cognos 8. Vous pouvez continuer utiliser ces produits dans le mme environnement. D'autres tches de configuration peuvent se rvler ncessaires pour assurer l'accs d'IBM Cognos 8 des objets crs l'aide d'autres produits d'IBM Cognos. Les conditions supplmentaires requises pour l'accs dpendent du mode d'excution choisi pour les deux produits.
354
Activation des rapports et agents programms pour les sources de donnes d'IBM Cognos Planning Contributor
Pour excuter des rapports et agents programms qui ont pour base des sources de donnes IBM Cognos Planning Contributor, vous devez dfinir un mot de passe secret partag. Cela contribue la scurit des communications entre les serveurs IBM Cognos 8 et Contributor Data Server.
Procdure
1. Sur l'ordinateur du serveur de rapports, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Accs aux donnes, sur IBM Cognos Planning, puis sur Contributor Data Server. 3. Dans la fentre Proprits, cliquez sur la zone Valeur ct de la proprit Mot de passe de la signature, puis sur le bouton d'dition lorsqu'il apparat. 4. Dans la bote de dialogue Valeur - Mot de passe de la signature, saisissez le mot de passe qui sera l'objet d'une signature numrique. Le mot de passe est sensible la casse et doit correspondre la proprit Mot de passe de la signature que vous avez configure dans les proprits de Cognos Series 7, Configuration Manager, Cognos Planning/Cognos 8 - Contributor Data Server/Gnral. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer. Une signature numrique est cre partir du mot de passe. La signature numrique est encode par IBM Cognos 8 et dcode par Contributor Data Server.
Mise jour des proprits d'emplacement des fichiers sous Windows Vista
Si vous installez des composants client d'IBM Cognos 8 dans un environnement utilisant Windows Vista, vous devez modifier les proprits d'emplacement des fichiers dans IBM Cognos Configuration de faon ce qu'IBM Cognos 8 puisse utiliser un emplacement de donnes unique pour tous les utilisateurs. Ces modifications doivent tre effectues sur tous les ordinateurs o des composants client d'IBM Cognos 8 sont installs. Windows Vista est dot d'une fonction de scurit amliore qui empche le partage d'emplacements de donnes par plusieurs utilisateurs. Vous pouvez dfinir des variables d'environnement et les utiliser dans IBM Cognos Configuration lorsque vous indiquez les emplacements de fichiers. Cela vous permet de diriger les fichiers appropris vers un emplacement accessible aux utilisateurs d'IBM Cognos 8. Sous Windows, deux variables d'environnement sont prdfinies pour les utilisateurs : une pour l'ensemble des utilisateurs, l'autre pour un utilisateur spcifique. En outre, si vous installez Transformer sur un ordinateur disposant de Windows Vista et prvoyez d'utiliser le fichier cogtr.xml.samples en tant que modle, vous devez mettre jour les prfrences implicites dans le fichier de configuration de Transformer. tant donn que les variables d'environnement reprsentent les emplacements racine du systme, il est recommand d'inclure galement le nom du rpertoire racine de l'emplacement d'installation
Chapitre 11: Options de configuration lorsque vous indiquez les emplacements de fichiers dans IBM Cognos Configuration. Le rpertoire racine implicite d'IBM Cognos 8 est c8.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, cliquez sur Emplacement des fichiers de dploiement. 4. Remplacez l'lment de chemin relatif .. par la variable d'environnement et le rpertoire racine appropris : Pour un seul emplacement de fichiers par utilisateur, %LOCALAPPDATA% Pour un seul emplacement de fichiers destin tous les utilisateurs de l'ordinateur, %PUBLIC%
Par exemple : Pour dfinir un emplacement de fichiers unique par utilisateur, indiquez le chemin d'accs %LOCALAPPDATA%/c8/deployment. 5. Rptez l'tape 4 pour les proprits suivantes : Sous Environnement, - Emplacement des fichiers de donnes - Emplacement des fichiers de cartes - Emplacement des fichiers temporaires Sous Environnement, Journalisation, Fichier, - Emplacement du fichier journal Sous Cryptographie, - Emplacement de la bibliothque de cls symtriques communes Sous Cryptographie, IBM Cognos, - Emplacement du certificat - Emplacement de la bibliothque de cls de signature - Emplacement de la bibliothque de cls de chiffrement 6. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les variables d'environnement sont converties ds qu'un utilisateur accde aux emplacements de fichiers lors d'activits sur le systme.
356
Configuration d'un systme de contrle de la source

Pour faciliter la gestion, le partage et la scurisation des diffrentes versions de vos mtadonnes, vous pouvez configurer Framework Manager de faon ce qu'il utilise un systme de contrle de la source. Il faut au pralable qu'un des clients de systme de contrle de la source ci-dessous soit install sur le mme ordinateur que Framework Manager : Component Software Concurrent Versions System Visual Source Safe
Pour en savoir davantage sur l'installation et la configuration des systmes de contrle de la source, reportez-vous au manuel Framework Manager User Guide.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la section Environnement de la fentre Explorateur, cliquez avec le bouton droit de la souris sur l'option Systmes de contrle source, puis cliquez sur Nouvelle ressource et sur Systme de contrle source. L'option Systme de contrle source est disponible sur des ordinateurs Windows quips de Framework Manager ainsi que sur des ordinateurs Windows ou UNIX sur lesquels les composants d'application sont installs. 3. Dans la zone Nom, saisissez un nom pour le systme de contrle de la source. 4. Dans la zone Type, slectionnez un systme de contrle de la source. 5. Cliquez sur OK. 6. Dans la fentre Proprits, pour la proprit Emplacement du fichier excutable du systme de contrle source, indiquez l'emplacement et le nom du fichier .exe. Pour VSS, saisissez emplacement_fichier\ss.exe Pour CVS, saisissez emplacement_fichier\cvs-version.exe o version correspond au numro de version CVS. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer. Vous pouvez dsormais tester votre installation et votre configuration. Au besoin, vous pouvez galement modifier les paramtres implicites. Vous pouvez entre autres changer de port, configurer le protocole SSL, configurer les paramtres cryptographiques ou encore modifier l'URI de la passerelle afin d'utiliser une autre passerelle. Si vous avez procd une mise niveau depuis une ancienne version de Framework Manager, vous pouvez mettre niveau des projets existants dans la nouvelle version de Framework Manager. Pour en savoir davantage, reportez-vous au manuel Framework Manager User Guide.
Configuration d'IBM Cognos 8 Transformer

Une fois l'installation de Transformer effectue, vous pouvez effectuer les tches suivantes : Si vous avez install Transformer sur un ordinateur disposant de Windows Vista et prvoyez d'utiliser le fichier cogtr.xml.samples comme modle, vous devez mettre jour les prfrences implicites pour Windows Vista. Si vous souhaitez utiliser les modles Transformer depuis IBM Cognos Series 7 et continuer d'utiliser les sources de donnes IQD, vous devez ajouter les sources de donnes IBM Cognos Series 7 dans Transformer.
Pour mettre Transformer la disposition des modlisateurs afin que ceux-ci puissent l'installer et l'utiliser, vous pouvez effectuer les oprations suivantes : Cration d'un emplacement d'installation rseau pour les modlisateurs Transformer Exportation des donnes de configuration pour les modlisateurs Transformer Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs
Mise jour des prfrences implicites pour Windows Vista

Avec les amliorations apportes Windows Vista, Microsoft a modifi la structure des annuaires d'utilisateurs. Si vous souhaitez utiliser le fichier cogtr.xml.samples en tant que modle, vous devez modifier les paramtres des prfrences implicites. Si vous voulez que tous les utilisateurs disposent des mmes annuaires implicites, vous devez dfinir les prfrences implicites sur un emplacement commun auquel les utilisateurs ont accs. Si vous voulez que les utilisateurs disposent des annuaires de Windows Vista, vous pouvez supprimer les prfrences implicites des annuaires. Les instructions de cette rubrique sont destines l'installateur ou l'administrateur. Si vous tes un spcialiste mtier ou un modlisateur Transformer et que vous souhaitez tlcharger et utiliser Transformer, reportez-vous la section "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362).
Procdure
1. Connectez-vous en tant qu'administrateur. 2. Dans le rpertoire emplacement_c8\configuration, ouvrez le fichier cogtr.xml.sample en mode avec lvation dans un diteur de texte en cliquant avec le bouton droit de la souris sur ce dernier et en slectionnant Excuter en tant qu'administrateur. 3. Si vous souhaitez que tous les utilisateurs disposent des mmes annuaires implicites, dfinissez ces annuaires sur un emplacement auquel tous les utilisateurs peuvent accder en lecture et en criture. Les annuaires modifier sont les suivants :
<Preference Name="CubeSaveDirectory"Type="string" Value="..\temp"/> <Preference Name="DataSourceDirectory" Type="string" Value="..\temp"/> <Preference Name="DataWorkDirectory" Type="string" Value="..\temp"/>
358

<Preference Name="LogFileDirectory" Type="string" Value="..\logs"/> <Preference Name="ModelSaveDirectory" Type="string" Value="..\temp"/> <Preference Name="ModelWorkDirectory" Type="string" Value="..\temp"/>
4. Si vous souhaitez que les utilisateurs disposent des annuaires implicites de Windows Vista, supprimez les prfrences dfinies l'tape 3 dans le fichier. Les annuaires implicites de Windows Vista pour Transformer sont les suivants : CubeSaveDirectory Documents\Transformer\PowerCubes DataSourceDirectory Dans IBM Cognos Configuration, sous Environnement, proprit Emplacement des fichiers de donnes. DataWorkDirectory Dans IBM Cognos Configuration, sous Environnement, proprit Emplacement des fichiers temporaires. LogFileDirectory Documents\Transformer\Logs ModelSaveDirectory Documents\Transformer\Models ModelWorkDirectory Dans IBM Cognos Configuration, sous Environnement, proprit Emplacement des fichiers temporaires. 5. Modifiez les autres paramtres selon les besoins. 6. Enregistrez le fichier sous le nom cogtr.xml. Les changements sont appliqus la prochaine ouverture de Transformer.
Ajout de sources de donnes IBM Cognos Series 7 Transformer

Si vous prvoyez d'utiliser des modles Transformer et des sources de donnes IBM Cognos Series 7, vous devez ajouter l'emplacement de vos sources de donnes IBM Cognos Series 7 au fichier de passerelle Transformer. Les instructions de cette rubrique sont destines l'installateur ou l'administrateur. Si vous tes un spcialiste mtier ou un modlisateur Transformer et que vous souhaitez tlcharger et utiliser Transformer, reportez-vous la section "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362).
Procdure
1. Connectez-vous en tant qu'administrateur. Guide d'installation et de configuration 359
Chapitre 11: Options de configuration 2. Dans le rpertoire emplacement_c8\CS7Gateways\bin directory, ouvrez le fichier cs7g.ini dans un diteur de texte. Sous Windows Vista, ouvrez-le en mode avec lvation en cliquant avec le bouton droit de la souris sur l'diteur de texte et en slectionnant Excuter en tant qu'administrateur. 3. Ajoutez les emplacements de vos sources de donnes IBM Cognos Series 7 dans le fichier. 4. Enregistrez le fichier. Les changements sont appliqus la prochaine ouverture de Transformer.
Cration d'un emplacement d'installation rseau pour les modlisateurs Transformer

Certains utilisateurs avancs ou spcialiss de votre entreprise souhaitent peut-tre crer des cubes modliss selon des sources de donnes la fois personnelles et professionnelles. Ces utilisateurs voudront srement effectuer leur propre analyse des donnes pour leur domaine professionnel prcis ou pour un petit groupe d'utilisateurs. Un installateur ou un administrateur a la possibilit de tlcharger un fichier excutable dans un emplacement Web ou de rseau local (LAN), o les modlisateurs pourront l'excuter pour lancer l'Assistant d'installation de IBM Cognos 8 Transformer. Les instructions de cette rubrique sont destines l'installateur ou l'administrateur. Si vous tes un spcialiste mtier ou un modlisateur Transformer et que vous souhaitez tlcharger et utiliser Transformer, reportez-vous la section "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362). Avant de mettre le fichier d'installation la disposition des modlisateurs Transformer, vous devez configurer d'autres ressources et droits d'accs : Le logiciel du client de base de donnes est install (ou la disposition des modlisateurs en vue d'une installation) sur les ordinateurs Transformer utiliss pour accder aux sources de donnes IBM Cognos 8 ou IBM Cognos Series 7 IQD. Les modlisateurs doivent disposer de droits pour crer une source de donnes dans IBM Cognos Administration. Ils n'ont pas besoin d'un accs direct cette application. Ils peuvent crer et mettre jour des sources de donnes l'aide de Transformer ou d'outils de ligne de commande. Vous pouvez fournir aux modlisateurs un dossier scuris dans IBM Cognos Connection, dans lequel ils pourront publier les packs de cubes. Les modlisateurs doivent avoir accs un emplacement dans lequel stocker les cubes crs. Cet emplacement doit galement tre accessible pour le service IBM Cognos 8 et il peut s'agir d'un dossier de partage scuris sur un rseau local. Les modlisateurs auront peut-tre besoin de droits spciaux pour excuter distance l'utilitaire de connexion de cubes d'IBM Cognos 8, qui se trouve sur le serveur IBM Cognos 8. Pour en savoir davantage, reportez-vous la rubrique relative la mise jour de cubes publis et de connexions de cubes dans le Guide de l'utilisateur de Transformer.
360
Chapitre 11: Options de configuration Pour crer des cubes sur un serveur Transformer spcifique, les modlisateurs doivent disposer de droits FTP pour transfrer les modles et de droits d'excution pour crer les cubes sur ce serveur. Ils peuvent transfrer les modles et crer les cubes l'aide de scripts. Ils peuvent galement utiliser des mthodes automatises pour crer les cubes. Pour en savoir davantage, reportezvous au Guide d'administration et de scurit.
Procdure
1. Insrez le CD du produit de modlisation IBM Cognos 8 Transformer. 2. Si la page Accueil de l'Assistant d'installation s'affiche, quittez l'assistant. 3. Sur le CD, recherchez le fichier c8transformerinstall.exe. 4. Copiez le fichier dans un emplacement scuris auquel les modlisateurs Transformer ont accs.
Exportation des donnes de configuration pour les modlisateurs Transformer

Si vous souhaitez que le fichier d'installation de Transformer soit accessible aux modlisateurs Transformer, ces derniers doivent disposer des paramtres de distributeurs et de chiffrement pour configurer Transformer sur leur ordinateur local. Vous pouvez exporter la configuration d'un ordinateur Transformer afin de l'utiliser avec tous les autres ordinateurs Transformer. Les modlisateurs peuvent copier le fichier de configuration export dans leur rpertoire d'installation Transformer, puis excuter la commande permettant de configurer l'ordinateur Transformer en mode silencieux. Les instructions de cette rubrique sont destines l'installateur ou l'administrateur. Si vous tes un spcialiste mtier ou un modlisateur Transformer et que vous souhaitez tlcharger et utiliser Transformer, reportez-vous la section "Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs" (p. 362). Si vous avez mis jour les fichiers coglocale, cogtr.xml ou cs7g.ini sur l'ordinateur Transformer, vous devez les copier dans l'emplacement Web ou de rseau local (LAN) pour que les modlisateurs Transformer puissent les tlcharger sur leur ordinateur. Pour que la configuration puisse tre exporte, l'ordinateur source doit disposer des mmes composants IBM Cognos 8 que les ordinateurs des modlisateurs Transformer (p. 213). Si certains modlisateurs doivent effectuer l'installation sur Windows Vista, vous devez crer un fichier d'exportation partir d'un ordinateur Windows Vista. Il est recommand de crer des dossiers spars dans l'emplacement Web ou LAN pour Windows et Windows Vista.
Procdure d'exportation de la configuration des ordinateurs Transformer

1. Dans IBM Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que. 2. Si vous voulez exporter la configuration actuelle vers un autre dossier, dans la zone Rechercher dans, localisez et ouvrez le dossier. Veillez ce que le dossier soit protg contre tout accs non autoris ou inappropri.
Chapitre 11: Options de configuration 3. Dans la zone Nom de fichier, saisissez un nom pour le fichier de configuration. 4. Cliquez sur Enregistrer. 5. Renommez le fichier export en cogstartup.xml. 6. Copiez le fichier cogstartup.xml export depuis l'ordinateur source vers l'emplacement Web ou LAN o rside le fichier d'installation de Transformer. 7. Si vous avez modifi la configuration globale sur l'ordinateur source, copiez le fichier coglocale.xml depuis l'ordinateur source vers l'emplacement Web ou LAN o rside le fichier d'installation de Transformer. L'emplacement implicite du fichier coglocale.xml est emplacement_c8\configuration.
Procdure de tlchargement des fichiers de configuration de Transformer

1. Si vous avez mis jour le fichier cogtr.xml, copiez-le depuis le rpertoire emplacement_c8\configuration vers l'emplacement Web ou LAN o rside le fichier d'installation de Transformer. 2. Si vous avez mis jour le fichier cs7g.ini, copiez-le depuis le rpertoire emplacement_c8\CS7Gateways\bin vers l'emplacement Web ou LAN o rside le fichier d'installation de Transformer.
Dploiement d'IBM Cognos 8 Transformer pour les modlisateurs

Si vous tes un spcialiste mtier ou un modlisateur Transformer, vous devez maintenant dployer Transformer de faon pouvoir crer des cubes et les publier l'intention des utilisateurs ou groupes slectionns. Si vous n'avez pas effectu l'installation, suivez la procdure d'installation de Transformer. Pour configurer Transformer de faon ce qu'il puisse communiquer avec le distributeur IBM Cognos 8, suivez la procdure de configuration de Transformer. Si IBM Cognos Connection est scuris, vous devez disposer de privilges pour crer des sources de donnes et publier des packs dans IBM Cognos Connection. Vous avez la possibilit de mettre niveau des modles des versions Series 7.x de Transformer si vous les avez enregistrs sous forme de fichiers MDL. Vous pouvez continuer utiliser des cubes crs avec Series 7.3 et des versions ultrieures de Transformer dans IBM Cognos 8. Toutefois, pour employer des fournisseurs d'authentification IBM Cognos 8, vous devez mettre niveau les cubes. Une fois la mise niveau effectue, les cubes ne sont plus compatibles avec Series 7 Transformer. Pour mettre niveau des cubes vers IBM Cognos 8, vous devez : ouvrir le fichier MDL du modle Series 7.x Transformer dans IBM Cognos 8 Transformer, crer nouveau le cube dans IBM Cognos 8 Transformer.
Pour en savoir davantage, reportez-vous la section "Mise niveau des modles et des cubes Transformer" (p. 116).
362
Chapitre 11: Options de configuration Pour prendre en charge l'utilisation de sources de donnes IBM Cognos 8 (y compris les packs et rapports) dans Transformer, veillez ce que le client de base de donnes soit install sur l'ordinateur Transformer (p. 69).
Procdure d'installation de Transformer

1. Dans l'emplacement Web ou de rseau local (LAN) indiqu par l'administrateur, excutez le fichier c8transformerinstall.exe. Le contenu est dcompress dans le rpertoire Documents and Settings\nom_utilisateur\Local settings\Temp, puis l'Assistant d'installation de Transformer s'ouvre. 2. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordinateur. Conseil : Le composant Series 7 IQD Bridge n'est pas pris en charge sous Linux et HP-UX Itanium. 3. Sur la page Terminer de l'assistant, slectionnez Affichage du fichier Lisezmoi, puis cliquez sur Terminer. Conseil : Pour les installations en mode caractre sous UNIX et Linux, fermez le fichier texte Lisezmoi en appuyant simultanment sur les touches Ctrl + C ou sur Q. 4. Crez une variable d'environnement MANPATH et configurez-la pour qu'elle pointe vers le fichier cogtr.1 du rpertoire emplacement_Transformer/webcontent/documentation/en. Le fichier cogtr.1 fournit la syntaxe des options de ligne de commande UNIX qui sont prises en charge par IBM Cognos 8 Transformer. Vous pouvez accder la page de manuel correspondante sous UNIX en tapant man.
Procdure de configuration de Transformer

1. Accdez l'emplacement Web ou LAN o rside le fichier d'installation de Transformer. 2. Si des fichiers .xml sont prsents, copiez-les dans le rpertoire emplacement_Transformer\configuration, o emplacement_Transformer correspond au rpertoire d'installation de Transformer. L'emplacement implicite est C:\Program Files\Cognos\c8. 3. Si un fichier .ini est prsent, copiez-le dans le rpertoire emplacement_Transformer\CS7Gateways\bin. 4. Accdez au rpertoire emplacement_Transformer\bin. 5. Saisissez la commande de configuration : ./cogconfig.bat -s IBM Cognos Configuration applique les paramtres de configuration spcifis dans la copie locale du fichier cogstartup.xml, chiffre les rfrences d'identification, cre des certificats numriques et dmarre le service IBM Cognos 8. 6. Pour tester IBM Cognos 8 Transformer, dans le menu Dmarrer, cliquez successivement sur les options Programmes, IBM Cognos 8 et Transformer. Guide d'installation et de configuration 363
Chapitre 11: Options de configuration Si la fentre Transformer s'affiche, votre installation fonctionne. 7. Une fois que Transformer est install et s'excute correctement, supprimez les fichiers d'installation extraits du fichier d'installation.
364
Chapitre 12: Configuration de Cognos Portal Services

Cognos Portal Services fournit un ensemble de portlets Cognos utilisables dans IBM Cognos Connection ou dans d'autres portails. Vous pouvez utiliser les portlets pour parcourir, afficher et effectuer des recherches dans les rapports IBM Cognos de votre environnement de travail. D'autres utilisateurs peuvent afficher les informations IBM Cognos sans savoir utiliser les produits IBM Cognos. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Portal Services est install automatiquement avec les composants IBM Cognos 8. Dans un environnement rparti, il est inclus dans les composants d'application. L'installation inclut les fichiers de dploiement pour : le portail SAP Enterprise Portal (SAP EP), le portail IBM WebSphere 5.0, le portail BEA ALUI (Aqualogic User Interface), le portail SharePoint.
Pour certains dploiements de Portal Services, vous devez modifier des paramtres de proprit de Portal Services et configurer l'environnement IBM Cognos pour qu'il prenne en charge l'autre portail. S'il est utilis dans un autre portail, Cognos Portal Services ne peut authentifier les utilisateurs que dans un seul espace-noms. Si les composants d'IBM Cognos 8 sont configurs avec plusieurs espacesnoms, vous devez installer une passerelle distincte pour chaque espace-noms servant authentifier les utilisateurs du portail. Vous devez configurer chaque passerelle pour l'espace-noms appropri (p. 316), puis configurer les portlets dploys pour qu'ils utilisent cette passerelle. Aprs avoir configur les proprits requises, vous devez dployer les portlets Cognos vers un autre portail. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Pour utiliser Portal Services avec les composants d'IBM Cognos 8, procdez comme suit: Indiquez l'emplacement du fichier applications.xml, s'il y a lieu. Installez et testez les portlets sur l'autre portail. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit. Configurez la scurit pour l'environnement de l'autre portail.
Indication de l'emplacement du fichier Applications.xml

Si vous utilisez le fichier applications.xml en tant qu'lment d'un portlet d'application personnalis, tous les ordinateurs des composants d'application d'un environnement rparti doivent faire rfrence
Chapitre 12: Configuration de Cognos Portal Services au mme fichier applications.xml. Si vous disposez de plusieurs instances du fichier applications.xml, elles doivent toutes tre identiques. Remarque : Cette procdure n'est requise que si vous souhaitez utiliser le portlet des applications tendues, qui est fourni avec le SDK (Software Development Kit) d'IBM Cognos 8.
Procdure
1. Dmarrez IBM Cognos Configuration sur l'ordinateur sur lequel vous avez install le serveur de rapports. 2. Dans la section Environnement de la fentre Explorateur, cliquez sur Portal Services. 3. Dans la fentre Proprits, cliquez sur la valeur situe en regard de l'option Emplacement du fichier 'applications.xml'. 4. Remplacez la valeur localhost par un nom d'hte valide ou une adresse IP et, le cas chant, remplacez le numro de port implicite. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer. Vous pouvez maintenant dployer les portlets de Cognos sur votre serveur de portail. Pour obtenir des instructions, reportez-vous au Guide d'administration et de scurit.
Configuration de la scurit de Cognos Portal Services

Si vous utilisez Portal Services dans un autre portail, vous devez activer le code d'accs unique afin d'assurer l'intgration transparente entre cet autre portail et les composants d'IBM Cognos 8. Portal Services utilise un code d'accs unique pour authentifier les utilisateurs. Autrement dit, les utilisateurs n'ont pas besoin de se connecter d'autres applications sparment par l'intermdiaire du portail. Vous devez configurer un URI dans les composants d'IBM Cognos 8 pour chaque portlet dans Portal Services. Pour activer la scurit entre les composants d'IBM Cognos 8 et l'autre portail, procdez comme suit : Dsactivez l'accs anonyme aux composants d'IBM Cognos 8. Si votre infrastructure de scurit ncessite que vous fassiez appel une autre mthode de code d'accs unique, utilisez l'une des mthodes suivantes : Activez un code d'accs unique pour l'autre portail l'aide d'un secret partag. Si votre infrastructure de scurit ncessite que vous fassiez appel une autre mthode de code d'accs unique, utilisez l'une des mthodes suivantes : "Activation du code d'accs unique pour le portail WebSphere l'aide du serveur d'application" (p. 375) "Activation du code d'accs unique pour le portail BEA ALUI l'aide de l'authentification de base" (p. 376)
366
Chapitre 12: Configuration de Cognos Portal Services "Activation du code d'accs unique pour le portail BEA ALUI l'aide de SiteMinder" (p. 376)
Le cas chant, configurez les composants d'IBM Cognos 8 pour l'accs SSL.
Dsactivation de l'accs anonyme aux composants d'IBM Cognos 8

Portal Services utilise un code d'accs unique pour l'authentification. Lorsque la connexion anonyme est active dans les composants d'IBM Cognos 8, Portal Services connecte tous les utilisateurs du portail en tant qu'utilisateurs anonymes. Assurezvous que l'accs anonyme est dsactiv dans les composants d'IBM Cognos 8 pour que le code d'accs unique dans Portal Services fonctionne correctement. Cependant, vous pouvez tester les connexions de Portal Services l'aide de la connexion anonyme pour vous assurer que les portlets fonctionnent dans l'autre portail. Lorsque Portal Services ne parvient pas authentifier un utilisateur, ce dernier voit un message d'erreur s'afficher sur l'autre portail.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, Authentification, cliquez sur l'option IBM Cognos. 3. Dans la fentre Proprits, vrifiez que l'option Autoriser les connexions anonymes a la valeur Faux. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. 5. Rptez les tapes 1 4 sur tous les serveurs sur lesquels les composants d'IBM Cognos 8 sont installs.
Activation du code d'accs unique avec le secret partag

Vous pouvez utiliser un secret partag pour activer un code d'accs unique entre les portlets de Cognos et les composants d'IBM Cognos 8. Les portlets de Cognos envoient un message contenant une version chiffre du code d'utilisateur du portail. La cl de chiffrement est dtermine par la valeur d'une chane de caractres secrte partage par les portlets et le fournisseur de scurit Java personnalis sur le serveur IBM Cognos. Vous pouvez utiliser un secret partag pour l'autre portail uniquement si les codes d'utilisateurs du portail peuvent tre recherchs dans un espace-noms d'authentification NTLM, LDAP ou IBM Cognos Series 7 partag par les composants d'IBM Cognos 8. Les composants d'IBM Cognos 8 doivent avoir accs un serveur d'annuaire contenant les codes d'utilisateurs de tous les utilisateurs du portail. l'aide d'IBM Cognos Configuration, vous devez configurer un espace-noms d'authentification pour que le portail et les composants d'IBM Cognos 8 partagent la mme source d'authentification. Vous devez galement crer un espace-noms de fournisseur Java personnalis pour enregistrer le fournisseur Java du secret partag qui est propos avec les composants d'IBM Cognos 8. Au sein des portlets ou iViews, vous devez lier ces portlets ou iViews l'espace-noms du fournisseur Java personnalis l'intrieur de votre portail respectif : Guide d'installation et de configuration 367
Chapitre 12: Configuration de Cognos Portal Services Cognos iViews (SAP EP) application de portlet de Cognos (portail WebSphere) serveur distant (portail BEA ALUI) Cognos WebPart (portail SharePoint)
Il est inutile de configurer l'accs au contenu Web de Portal Services. En revanche, si vous dployez les portlets vers un autre portail, vous pouvez configurer l'accs vers un autre URI pour les images et le contenu Web de Portal Services.
Procdure de configuration des espaces-noms requis

1. Dans IBM Cognos Configuration, configurez un espace-noms pour authentifier les utilisateurs du portail. Pour en savoir davantage, reportez-vous la section "Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification" (p. 261). 2. Pour un espace-noms LDAP, configurez les proprits suivantes : Remplacez la valeur de la proprit Voulez-vous utiliser une identit externe ? par Vrai. Dfinissez la valeur de la proprit Correspondance des identits externes sur : (uid=${environment("REMOTE_USER")}) 3. Si vous utilisez un espace-noms IBM Cognos Series 7, vous devez mettre en correspondance les codes d'utilisateurs du portail avec les codes d'utilisateurs IBM Cognos Series 7 l'aide des codes d'accs au systme d'exploitation. Pour en savoir davantage, reportez-vous la documentation d'IBM Cognos Series 7. 4. Dans IBM Cognos Configuration, crez et configurez un espace-noms de fournisseur Java personnalis. Pour la proprit Identificateur d'espace-noms, saisissez un autre identificateur. Par exemple : cpstrusted Ce nouvel identificateur doit tre utilis dans les paramtres de configuration des portlets. Pour la proprit Nom de classe Java, saisissez : com.cognos.cps.auth.CPSTrustedSignon Les noms de classe Java sont sensibles la casse. 5. Dans IBM Cognos Configuration, dans la section Environnement, Portal Services, configurez les proprits suivantes : Dans la section Identificateur d'espace-noms de codes d'accs scuriss, saisissez l'identificateur de l'espace-noms LDAP, NTLM ou IBM Cognos Series 7 que vous avez configur l'tape 1.
368
Chapitre 12: Configuration de Cognos Portal Services Conseil: L'espace-noms de codes d'accs scuriss joue le rle d'intermdiaire et doit tre connect un espace-noms bas sur un rpertoire rel, de type LDAP, NTLM ou IBM Cognos Series 7. Dans la section Secret partag, saisissez la cl utiliser pour le code d'accs unique. Ce paramtre reprsente la cl secrte d'autorisation devant tre partage par les portlets de Cognos et le serveur IBM Cognos. Il fait office de mot de passe secret. Vous devez utiliser la mme chane de caractres lorsque vous configurez l'application de portlet. La cl doit tre constitue d'un seul mot. Pour des raisons de scurit, il est recommand d'indiquer une valeur non nulle. 6. Dans la section Environnement, pour l'option Paramtres de la passerelle, dfinissez la proprit Autoriser le remplacement des espaces-noms ? sur true. 7. Dans le menu Fichier, cliquez sur l'option Enregistrer. 8. Redmarrez le service IBM Cognos 8.
Procdure de configuration de l'accs au contenu Web de Portal Services

1. Sur l'ordinateur o les composants d'application sont installs, dmarrez IBM Cognos Configuration. 2. Dans la section Environnement de la fentre Explorateur, cliquez sur Portal Services. 3. Dans la fentre Proprits, cliquez sur la zone Valeur en regard de l'option URI du contenu Web. 4. Indiquez le nom d'hte ou l'adresse IP de la passerelle et un numro de port en utilisant le format suivant : hte_ou_adresse_IP:port 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Procdure de configuration des iViews de Cognos pour SAP EP

1. Ouvrez l'diteur iView pour chaque iView de Cognos. 2. Dans la zone Property Category, slectionnez l'option Show all. 3. Pour la proprit cpsauthsecret: CPS Authorization Secret, indiquez la chane de caractres secrte que vous avez utilise pour la proprit Secret partag lorsque vous avez configur l'espace-noms du fournisseur Java personnalis. 4. Pour la proprit cps: authentication namespace ID, saisissez l'identificateur de l'espace-noms du fournisseur Java personnalis. 5. Pour la proprit cpsserver: CPS Connection Server, saisissez l'adresse URL permettant d'accder aux composants de Portal Services par l'intermdiaire de la passerelle. Le format de l'URL est le suivant : Pour les portlets de contenu Cognos Guide d'installation et de configuration 369
Chapitre 12: Configuration de Cognos Portal Services URI_passerelle/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_action=cps. wsdl Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl Pour les applications tendues de Cognos URI_passerelle/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_action=cps. wsdl Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl Pour les portlets de liste de surveillance de Metrics Manager URI_passerelle/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_action=cps. wsdl Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Procdure de configuration des portlets de Cognos pour le portail WebSphere

1. Pour chaque application de portlet de Cognos, cliquez sur Modify parameters. 2. Pour la proprit cps_auth_secret, indiquez la chane de caractres secrte que vous avez utilise pour la proprit Secret partag lorsque vous avez configur l'espace-noms du fournisseur Java personnalis. 3. Pour la proprit cps_auth_namespace, saisissez l'identificateur de l'espace-noms du fournisseur Java personnalis. 4. Pour la proprit CPS Endpoint, saisissez l'adresse URL permettant d'accder aux composants de Portal Services par l'intermdiaire de la passerelle. Le format de l'URL est le suivant : Pour les portlets de contenu Cognos URI_passerelle/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_action=cps. wsdl 370
Chapitre 12: Configuration de Cognos Portal Services Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl Pour les applications tendues de Cognos URI_passerelle/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_action=cps. wsdl Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl Pour les portlets de liste de surveillance de Metrics Manager URI_passerelle/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl Exemple pour une passerelle de type CGI : http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_action=cps. wsdl Exemple pour une passerelle de type servlet : http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Procdures de configuration du serveur distant pour le portail BEA Aqualogic User Interaction (BEA ALUI)
1. l'aide d'un diteur ASCII, tel que le Bloc-notes, modifiez le fichier cpspt.properties dans le rpertoire emplacement_c8/cps/bea_aqualogic/webapps/gadgets/WEB-INF/classes. 2. Configurez les paramtres suivants :
Paramtre
Valeur
cps_endpoint Adresse URL permettant de se connecter au serveur de rapports et d'extraire les informations WSDL. Indiquez l'URI de la passerelle. Pour une passerelle de type servlet ou ISAPI, remplacez la partie localhost/ cognos8/cgi-bin/cognos.cgi par les valeurs permettant de cibler la passerelle. Par exemple : http://nom_hte/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/ [package]?wsdl&b_action=cps.wsdl forward_ cookies= Nom du tmoin (cookie) qui doit tre envoy au serveur de rapports pour le code d'accs unique. Laissez en blanc.
Paramtre
cps_auth_ secret
Valeur
Code secret partag qu'IBM Cognos 8 utilise pour chiffrer une variable d'entte HTTP contenant l'identit de l'utilisateur. Ce paramtre reprsente la cl secrte d'autorisation devant tre partage par les portlets de Cognos et le serveur IBM Cognos 8. Il fait office de mot de passe secret. Utilisez la valeur employe pour l'option Secret partag dans IBM Cognos Configuration. Pour des raisons de scurit, il est recommand d'indiquer une valeur non nulle.
cps_auth_ namespace
Identificateur de l'espace-noms du fournisseur Java personnalis.
3. Accdez au rpertoire emplacement_c8/cps/bea_aqualogic et excutez le fichier build suivant : Sous UNIX ou Linux, build.sh Sous Windows, build.bat
Un fichier cps-alui.war est cr dans le rpertoire emplacement_c8/cps/bea_aqualogic/gadgets. 4. Si les composants d'IBM Cognos 8 sont excuts l'aide de Tomcat, Arrtez IBM Cognos 8. Copiez le fichier cps-alui.war dans le rpertoire emplacement_c8/webapps. Tomcat dveloppe automatiquement le fichier WAR et dmarre le serveur distant. Dmarrez IBM Cognos 8.
5. Si les composants d'IBM Cognos 8 sont excuts sous un autre type de serveur d'application, copiez le fichier cps-alui.war pour le serveur d'application correspondant. Pour en savoir davantage, reportez-vous au guide d'administration de votre serveur d'application. Le code d'accs unique est configur.
Procdure de configuration des proprits pour Cognos WebPart pour le portail SharePoint
1. Dans un diteur ASCII simple, comme le Bloc-notes, ditez le fichier web.config dans le rpertoire unit\Program Files\Common Files\Microsoft Shared\web server extensions\60\CONFIG. 2. Recherchez la chane suivante :
<SSO cps_auth_namespace="" cps_auth_secret="" />
3. Dfinissez cps_auth_namespace sur l'identificateur d'espace-noms correspondant l'espacenoms Fournisseur Java personnalis. 4. Dfinissez cps_auth_secret sur la valeur employe pour l'option Secret partag dans IBM Cognos Configuration.
372
Activation du code d'accs unique pour SAP EP avec le permis de connexion SAP
Lorsque vous activez le code d'accs unique avec le permis de connexion SAP, vous devez configurer les composants d'IBM Cognos 8 avec un espace-noms SAP qui tablit un lien avec un serveur SAP BW. Ensuite, vous devez copier le certificat produit au cours de l'installation du portail SAP EP dans l'environnement de scurit personnalis de SAP BW. Les utilisateurs doivent disposer du mme code d'utilisateur dans tous les systmes accessibles par l'intermdiaire d'un code d'accs unique. Avant de commencer, vrifiez que vous avez : configur les composants d'IBM Cognos 8 pour l'utilisation d'une source d'authentification SAP. activ le code d'accs unique entre les composants d'IBM Cognos 8 et SAP BW. install les versions les plus rcentes de Service Pack sur le serveur SAP BW. Vous pouvez tlcharger les versions de Service Pack partir de SAPNET. install le programme de correction le plus rcent pour le portail SAP, install le module d'extension du portail d'entreprise correspondant la version de SAP EP ou au serveur SAP BW. Pour les versions SAP antrieures la version 6.2, sous SAPNET, tlchargez EP50_PLUG-IN pour la base 620 (SAPKINE32A). Installez SAPKINE32A l'aide de la transaction SAINT. install la bibliothque de scurit SAP sur les serveurs SAP BW. partir de sapservX, sous /general/misc/security/SAPSECU/plateforme, tlchargez sapsecin et sepsecu.dll, puis placez les deux fichiers dans le rpertoire d'excution /run du serveur SAP BW. Pour activer le code d'accs unique pour SAP EP, suivez les procdures correspondantes avec les permis de connexion SAP, dcrites dans le manuel SAP Enterprise Portal Security Guide. Vous pouvez dsormais utiliser des iViews de Cognos dans le portail SAP Enterprise Portal. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Activation du code d'accs unique pour SAP EP avec mise en correspondance des utilisateurs
Lorsque vous activez le code d'accs unique l'aide de la mise en correspondance des utilisateurs, vous dfinissez une source de donnes d'IBM Cognos dans le portail SAP EP. Les utilisateurs individuels ou les administrateurs peuvent saisir les mots de passe et les identificateurs d'utilisateurs pour les composants d'IBM Cognos 8 dans la source de donnes. Vous devez tablir la correspondance entre les rfrences de connexion des utilisateurs dans la source de donnes et un espace-
Chapitre 12: Configuration de Cognos Portal Services noms LDAP, IBM Cognos Series 7 ou NTLM. Les iViews de Portal Services transmettent les rfrences de connexion aux composants d'IBM Cognos 8 l'aide de l'authentification HTTP de base.
Procdure de prparation de l'environnement

1. Configurez l'URI de la passerelle que Portal Services utilisera pour demander l'authentification l'aide de l'authentification HTTP de base. Pour en savoir davantage sur la configuration d'une adresse URL pour utiliser l'authentification HTTP de base, reportez-vous la documentation de la passerelle ou celle du serveur Web. 2. Configurez le iView afin d'accder l'URL scurise. Pour en savoir davantage, reportez-vous la documentation de votre serveur Web. 3. Dans IBM Cognos Configuration, configurez un espace-noms pour authentifier les utilisateurs du portail. 4. Si vous utilisez un espace-noms LDAP, configurez les proprits suivantes : Remplacez la valeur de la proprit Voulez-vous utiliser une identit externe ? par Vrai. Dfinissez la valeur de la proprit Correspondance des identits externes sur : (uid=${environment("REMOTE_USER")})
Procdure de cration de la source de donnes et de mise en correspondance des utilisateurs

1. Dans le portail SAP, assurez-vous que les proprits ci-dessous sont configures pour la source de donnes dans le rpertoire /PortalContent/other_vendors/every_user/com.cognos.pct.c8/ systems/Cognos 8 : mthode de connexion = UIDPW nom du serveur = nom du serveur IBM Cognos numro de port = numro de port de la passerelle protocole du systme cible = HTTP type de mise en correspondance des utilisateurs = admin,Utilisateur alias systme (crer un alias systme)
Pour en savoir davantage, reportez-vous au manuel SAP Enterprise Portal Administration Guide. 2. Pour chaque iView de Cognos, activez la mise en correspondance des utilisateurs pour la source de donnes en saisissant le nom de l'alias systme au niveau de l'iView, dans un attribut appel CPS: User Mapping Datasource. Pour en savoir davantage, reportez-vous au manuel SAP Enterprise Portal Administration Guide. 3. Pour chaque iView de Cognos, dfinissez la proprit CPS: Authentication Namespace ID sur l'espace-noms que vous souhaitez utiliser pour l'authentification. 374
Chapitre 12: Configuration de Cognos Portal Services 4. Enregistrez les rfrences d'identification d'IBM Cognos pour les utilisateurs du portail. Les utilisateurs peuvent saisir leurs propres rfrences d'identification et mots de passe. Pour en savoir davantage, reportez-vous au manuel SAP Enterprise Portal Administration Guide. Il est recommand d'activer la communication scurise entre le portail SAP EP et IBM Cognos 8. Vous pouvez dsormais utiliser des iViews de Cognos dans le portail SAP Enterprise Portal. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Activation de la communication scurise entre le portail SAP EP et les composants d'IBM Cognos 8
Une connexion scurise l'aide du protocole SSL n'est pas ncessaire entre SAP EP et les composants d'IBM Cognos 8. Il est plus important d'activer un code d'accs unique avec la mise en correspondance des utilisateurs. La scurit SSL prise en charge par SAP utilise une cl de chiffrement dont la longueur est suprieure 56 bits. Par dfaut, les composants d'IBM Cognos 8 utilisent l'algorithme de chiffrement allant jusqu' 56 bits. IBM Cognos propose en complment un module de chiffrement amlior. Pour activer le protocole SSL, vous devez acheter et installer le module de chiffrement amlior pour OpenSSL en plus des composants d'IBM Cognos 8. Pour en savoir davantage, reportez-vous au manuel IBM Cognos Enhanced Encryption Module for OpenSSL Installation and Configuration Guide. Pour activer le protocole SSL entre le portail SAP EP et les composants d'IBM Cognos 8, reportezvous la documentation relative la scurit du portail SAP EP. Aprs avoir activ le protocole SSL, modifiez les proprits de tous les iViews afin que la proprit cpsserver: CPS Connection Server utilise https et non http. Vous pouvez dsormais utiliser les portlets de Cognos dans le portail SAP Enterprise Portal. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Activation du code d'accs unique pour le portail WebSphere l'aide du serveur d'application
Les portlets de Portal Services peuvent utiliser les objets Active Credentials fournis par le portail WebSphere pour se connecter aux composants d'IBM Cognos 8. Portal Services prend en charge les objets Active Credentials suivants : HttpBasicAuth, LtpaToken, SiteMinderToken et WebSealToken. Les rfrences d'identification de l'utilisateur du portail sont communiques la passerelle l'aide de cet objet. Pour en savoir davantage sur les objets Active Credentials, reportez-vous la documentation relative au portail IBM WebSphere. Pour utiliser un code d'accs unique de serveur d'application, reportez-vous la documentation relative au serveur d'application IBM WebSphere. Pour en savoir davantage sur les composants SSL pour IBM Cognos 8 sur un serveur d'application WebSphere, reportez-vous la section "Configuration du protocole SSL" (p. 325).
Chapitre 12: Configuration de Cognos Portal Services Une fois le code d'accs unique configur, vous pouvez utiliser les portlets de Cognos dans le portail WebSphere. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Activation du code d'accs unique pour le portail BEA ALUI l'aide de l'authentification de base
Vous pouvez configurer un portlet dans le portail BEA ALUI pour envoyer le nom d'utilisateur et le mot de passe sous forme d'en-tte d'authentification HTTP de base. L'en-tte peut tre utilis avec un espace-noms d'authentification NTLM, LDAP ou IBM Cognos Series 7 pour fournir un code d'accs unique.
Procdure
1. Dans IBM Cognos Configuration, configurez un espace-noms pour authentifier les utilisateurs du portail. 2. Installez une passerelle secondaire de type servlet, CGI ou ISAPI dans IBM Cognos 8. 3. Configurez la passerelle. 4. Dans la console d'administration du serveur Web, configurez les rpertoires virtuels permettant d'accder la passerelle. Pour en savoir davantage, reportez-vous la documentation de votre serveur Web. 5. Configurez le serveur distant BEA ALUI pour accder IBM Cognos 8 : Modifiez le fichier cpspt.properties dans le rpertoire emplacement_c8/cps/bea_aqualogic/ webapps/gadgets/WEB-INF/classes. Modifiez la proprit cps_endpoint de faon indiquer l'URL de la passerelle. Pour une passerelle de type CGI, vous pouvez utiliser le paramtre implicite si la passerelle et le serveur distant se trouvent sur le mme ordinateur. Sinon, remplacez la partie localhost par nom_hte:port. Pour une passerelle de type servlet ou ISAPI, remplacez la partie localhost/cognos8/cgi-bin/ cognos.cgi par les valeurs permettant de cibler la passerelle. Par exemple : http://nom_hte:port/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/[package]?wsdl&b_ action=cps.wsdl Dfinissez la proprit cps_auth_namespace sur l'espace-noms que vous souhaitez utiliser pour l'authentification.
Activation du code d'accs unique pour le portail BEA ALUI l'aide de SiteMinder
Si vous utilisez eTrust Siteminder pour fournir un code d'accs unique votre infrastructure de scurit, vous pouvez galement l'utiliser pour le code d'accs unique sur le portail BEA ALUI.
376
Chapitre 12: Configuration de Cognos Portal Services Vous devez configurer un espace-noms d'authentification SiteMinder dans IBM Cognos Series 8. Le portail BEA ALUI envoie le jeton d'authentification SiteMinder actif au serveur distant, qui l'envoie la passerelle IBM Cognos Series 8.
Procdure
1. Dans IBM Cognos Configuration, configurez un espace-noms d'authentification SiteMinder. Pour en savoir davantage, reportez-vous la section "Configuration des composants d'IBM Cognos 8 pour eTrust SiteMinder" (p. 293). 2. Configurez le serveur distant pour transfrer le jeton d'authentification : Modifiez le fichier cpspt.properties dans le rpertoire emplacement_c8/cps/bea_aqualogic/ webapps/gadgets/WEB-INF/classes. Modifiez la proprit forward_cookies de faon inclure le nom du jeton d'authentification actif fourni par SiteMinder. Modifiez la proprit cps_endpoint de faon indiquer l'URL de la passerelle. Pour une passerelle de type CGI, vous pouvez utiliser le paramtre implicite si la passerelle et le serveur distant se trouvent sur le mme ordinateur. Sinon, remplacez la partie localhost par nom_hte:port. Pour une passerelle de type servlet ou ISAPI, remplacez la partie localhost/cognos8/cgi-bin/ cognos.cgi par les valeurs permettant de cibler la passerelle. Par exemple : http://nom_hte:port/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/[package]?wsdl&b_ action=cps.wsdl Dfinissez la proprit cps_auth_namespace sur l'espace-noms que vous souhaitez utiliser pour l'authentification.
378
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat
IBM Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Vous pouvez choisir d'excuter IBM Cognos 8 dans un autre serveur pris en charge : Serveur BEA WebLogic Serveur d'application IBM WebSphere Serveur d'application Oracle Red Hat JBoss NetWeaver de SAP Serveur d'application Sun Java System (pour les systmes d'exploitation Windows, Linux et Solaris uniquement)
Afin de garantir le bon fonctionnement de vos produits, veillez appliquer tous les programmes de correction requis au systme d'exploitation et n'utiliser que les versions d'autres logiciels prises en charge par le produit d'IBM Cognos. Pour consulter une liste jour des environnements pris en charge par les produits d'IBM Cognos, tels que les systmes d'exploitation, les programmes de correction, les navigateurs, les serveurs Web, les serveurs d'annuaire, les serveurs de bases de donnes et les serveurs d'application Visitez le site Web Software Services de Cognos (http://support.cognos.com). Il est important de noter que le systme d'exploitation Linux est disponible dans plusieurs versions et prend en charge plusieurs plates-formes. Assurez-vous que le systme d'exploitation et la combinaison de matriel que vous utilisez sont pris en charge. Vous pouvez choisir d'excuter la passerelle de type servlet IBM Cognos sur un serveur d'application pris en charge.(p. 352). Lorsque vous utilisez la passerelle de type servlet, votre environnement ne requiert pas de serveur Web. Le serveur d'application et la passerelle de type servlet remplacent les fonctions fournies par le serveur Web et d'autres passerelles IBM Cognos. IBM Cognos 8 doit tre install et fonctionner correctement avant de configurer la passerelle de type servlet IBM Cognos. Si vous procdez une mise niveau de ReportNet vers IBM Cognos 8, reportez-vous la section "Mise niveau vers IBM Cognos 8 dans un environnement de serveur d'application " (p. 399). Si vous procdez une mise niveau de Metrics Manager vers IBM Cognos 8 - Metrics Manager, reportez-vous la section "Mise niveau de Metrics Manager vers IBM Cognos 8 dans un environnement de serveur d'application" (p. 400).
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Pour en savoir davantage sur la configuration d'une installation rpartie multi-serveurs d'IBM Cognos 8 dans un environnement de serveur d'application, visitez le site Web Cognos Software Services (http://support.cognos.com). Pour configurer IBM Cognos 8 de faon ce qu'il s'excute sur votre serveur d'application, vous devez excuter les tches suivantes : Crer une instance JVM spare, si ncessaire. Vrifier que les composants IBM Cognos sont correctement configurs. Effectuer une copie de sauvegarde des donnes et des cls de chiffrement existantes d'IBM Cognos, si ncessaire. Dfinir des variables d'environnement. Mettre jour l'environnement Java. Configurer les composants d'IBM Cognos pour qu'ils s'excutent au sein du serveur d'application. Identifier la version de JDK pour WebLogic 9 sur AIX, si ncessaire. Modifier le script de dmarrage du serveur d'application, si ncessaire. Configurer les proprits du serveur d'application et dployer IBM Cognos 8. Activer le protocole SSL, si ncessaire. Configurer le serveur Web. Annuler l'enregistrement des distributeurs qui ne sont plus utiliss. Importer toutes les donnes sauvegardes de la base de donnes Content Store.
Aprs avoir configur IBM Cognos 8 afin qu'il s'excute sur votre serveur d'application, vous pouvez effectuer des tches de configuration supplmentaires pour personnaliser le comportement des composants d'IBM Cognos afin de l'adapter votre environnement de cration de rapports (p. 305). Conseil : N'utilisez pas de chemin d'installation contenant des espaces pour le serveur d'application ou pour IBM Cognos 8. Les espaces entravent l'excution des scripts internes et des paramtres de commande. Si vous tes oblig de faire appel un chemin d'installation contenant des espaces, utilisez la convention de dnomination DOS 8.3 pour faire rfrence ce type d'emplacement.
Cration d'une instance JVM spare

Pour viter tout risque de conflit au niveau des classes Java ou des ressources systme, IBM Cognos 8 doit tre excut dans une instance JVM (Java Virtual Machine) isole des autres applications existantes. Cela permet de s'assurer qu'IBM Cognos 8 n'a pas d'incidence sur les applications client existantes. Si cela est possible, IBM Cognos 8 doit tre install dans une instance JVM spare des processus d'administration du serveur d'application, afin d'isoler la fois IBM Cognos 8 et les fonctions d'administration du serveur d'application.
380
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Pour isoler une instance JVM, vous pouvez crer au choix : un serveur gr spar dans BEA WebLogic, une instance de serveur spare dans IBM WebSphere, une instance OC4J spare dans Oracle 10g Application Server, une instance de serveur spare pour Red Hat JBoss, une instance Java distincte pour NetWeaver de SAP, un domaine spar pour le serveur d'application Sun Java System.
Si vous utilisez la passerelle de type servlet IBM Cognos, elle doit tre excute sur une instance distincte d'IBM Cognos 8.
Vrification de la configuration des composants d'IBM Cognos

Vrifiez les points suivants avant de configurer les composants d'IBM Cognos de faon ce qu'ils s'excutent sur votre serveur d'application : Les composants d'IBM Cognos sont installs (p. 153). Avant de dmarrer IBM Cognos 8, vous devez configurer la base de donnes Content Store. Le cas chant, installez et configurez les clients de base de donnes (p. 160), puis testez la connectivit la base de donnes. Le serveur d'application est install et fonctionnel sur chaque ordinateur sur lequel les composants d'IBM Cognos sont installs. Pour en savoir davantage sur l'installation, reportez-vous la documentation de votre serveur d'application. L'emplacement d'installation complet de toutes les polices est indiqu sur tous les ordinateurs des composants d'application. Vous prcisez cet emplacement dans IBM Cognos Configuration (p. 320). Par dfaut, l'emplacement d'installation n'utilise pas de chemin d'accs complet. Le compte d'utilisateur du serveur d'application dispose des droits d'accs complets pour l'installation d'IBM Cognos. Conseil : Nous vous recommandons de crer un groupe UNIX ou Linux appel cognos8. Ce groupe doit contenir l'utilisateur qui dmarre le serveur d'application et l'utilisateur qui est propritaire des fichiers IBM Cognos. Dfinissez les droits de propritaire des fichiers IBM Cognos pour le groupe cognos8 et dfinissez les droits d'accs tous les fichiers IBM Cognos sur GROUP READABLE/WRITABLE/EXECUTABLE. Pour plus de simplicit, vous pouvez galement utiliser le compte d'utilisateur du serveur d'application pour installer et excuter les composants d'IBM Cognos.
Sauvegarde des informations IBM Cognos

Vous devez sauvegarder les informations IBM Cognos si des composants d'IBM Cognos 8 s'excutent sur un serveur d'application (y compris Tomcat) et si vous passez un serveur d'application livr avec son propre environnement JVM, Vous devez aussi sauvegarder les informations IBM Cognos si vous devez modifier le JVM que vous utilisez. Remarque : Avant de procder la mise niveau, vous devez sauvegarder les informations existantes relatives IBM Cognos au sein de l'environnement de travail. Avant de configurer les composants d'IBM Cognos 8 pour qu'il s'excute sur un nouveau serveur d'application ou dans un environnement JVM, vous devez sauvegarder ce qui suit : Les donnes de la base de donnes Content Store en crant une exportation de dploiement. Les informations de configuration en les exportant ; toutes les donnes chiffres sont dchiffres lors de l'exportation. Les cls cryptographiques en les enregistrant un autre emplacement. Les nouvelles cls cryptographiques doivent tre cres l'aide du mme environnement JVM utilis par le serveur d'application. Ces cls pouvant tre cres uniquement si les cls prcdentes sont supprimes, il est important de sauvegarder ces dernires.
Pour garantir la scurit et l'intgrit des donnes d'IBM Cognos, enregistrez une copie de sauvegarde de la base de donnes Content Store, les informations de configuration et les cls cryptographiques dans un rpertoire protg contre l'accs non autoris et inappropri. Conseil : Pour connatre les cls existantes, examinez le rpertoire emplacement_c8/configuration. Les cls cryptographiques existent si ce rpertoire contient les sous-rpertoires suivants : csk, encryptkeypair ou signkeypair.
Procdure
1. S'il existe des donnes dans la base de donnes Content Store, dmarrez le service IBM Cognos 8 et exportez l'intgralit de la base de donnes Content Store l'aide de l'outil Dploiement. Pour en savoir davantage, reportez-vous la rubrique traitant de la cration d'une spcification de dploiement d'exportation dans le Guide d'administration et de scurit. 2. Dans IBM Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que et enregistrez les informations de configuration dans un format dchiffr. Nommez ce fichier de manire explicite, par exemple dchiffr.xml . Exportez les donnes vers un rpertoire protg contre tout accs non autoris ou inappropri, car les mots de passe sont stocks en texte brut. Vous tes invit confirmer le caractre non scuris de l'exportation. 3. Arrt du service IBM Cognos 8 : Si vous utilisez Tomcat, arrtez le service IBM Cognos 8 et fermez IBM Cognos Configuration. Si vous utilisez un serveur d'application autre que Tomcat, fermez IBM Cognos 8 dans votre environnement.
382
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 4. Sauvegardez toutes les cls cryptographiques en enregistrant les fichiers et rpertoires appropris dans un autre emplacement scuris. Les fichiers sont : emplacement_c8/configuration/cogstartup.xml emplacement_c8/configuration/caSerial emplacement_c8/configuration/cogconfig.prefs emplacement_c8/configuration/coglocale.xml
Les rpertoires sont : emplacement_c8/configuration/csk emplacement_c8/configuration/encryptkeypair emplacement_c8/configuration/signkeypair
5. Supprimez les fichiers caSerial et cogconfig.prefs ainsi que les trois rpertoires : csk, encryptkeypair et signkeypair. 6. Remplacez le fichier emplacement_c8/configuration/cogstartup.xml par celui qui contient les donnes exportes depuis IBM Cognos Configuration (par exemple, dchiffr.xml ). Important : Dans le rpertoire emplacement_c8/configuration, le fichier doit porter le nom cogstartup.xml . Les informations de ce fichier sont automatiquement chiffres de nouveau l'aide des cls cryptographiques lorsque vous enregistrez la configuration dans IBM Cognos Configuration.
Dfinition des variables d'environnement

Vous devez dfinir des variables d'environnement pour identifier l'emplacement de l'environnement JVM et le chemin d'accs la bibliothque. Vous pouvez dfinir des variables d'environnement l'aide d'une des mthodes suivantes : Sous Windows, dfinissez une variable systme ou utilisateur ou bien modifiez le script de dmarrage ou d'environnement du serveur d'application. Si vous dfinissez une variable utilisateur, veillez la dfinir pour le compte de l'utilisateur qui excute le serveur d'application ou la console d'administration. Sous UNIX et Linux, dfinissez une variable d'environnement dans le profil de l'utilisateur ou modifiez le script de dmarrage ou d'environnement du serveur d'application.
Pour en savoir davantage sur la modification du script de dmarrage d'un serveur d'application, reportez-vous la section "Modification du script de dmarrage du serveur d'application" (p. 387). Conseil : La plupart des versions des serveurs d'application sont livres avec un script spcialement conu pour dfinir des variables d'environnement. Par exemple, certaines versions de WebSphere sont livres avec le fichier setupCmdLine.bat ou setupCmdLine.sh, WebLogic est livr avec le fichier setEnv.cmd ou setEnv.sh et Oracle est livr avec le fichier iasenv.bat ou iasenv.sh. Ces scripts peuvent
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat tre modifis afin de dfinir les valeurs appropries pour une utilisation avec les composants d'IBM Cognos. La plupart de ces scripts dfinissent par dfaut la variable d'environnement JAVA_HOME.
Procdure
1. Dfinissez la variable d'environnement JAVA_HOME de faon ce qu'elle pointe vers l'environnement JVM utilis par le serveur d'application. Conseil : Si le serveur d'application est fourni avec un environnement JVM, la variable d'environnement JAVA_HOME doit tre dfinie de faon y faire rfrence. IBM Cognos Configuration utilise cette variable pour crer des cls de chiffrement pour les composants d'IBM Cognos qui sont compatibles avec l'environnement JVM utilis par le serveur d'application. Par exemple, pour WebLogic sous Windows, l'environnement JVM utilis par le serveur d'application est indiqu en tant que : lecteur:/emplacement_WebLogic/jdk142_04 2. Ajoutez emplacement_c8/bin la variable d'environnement approprie. Cette variable est utilise pour localiser les fichiers de la bibliothque d'IBM Cognos.
Windows AIX Solaris et Linux HP-UX
PATH LIBPATH LD_LIBRARY_PATH SHLIB_PATH
Conseil : Pour installer plusieurs instances d'IBM Cognos 8 sur un mme serveur, dfinissez la variable PATH, LIBPATH, LD_LIBRARY_PATH ou SHLIB_PATH dans la porte d'instance du serveur d'application (et non en tant que variable globale) afin de vous assurer que chaque instance a une valeur unique. Remarque : Les variables CRN_ROOT et COG_ROOT ne sont plus requises dans un environnement non group et doivent tre supprimes si elles taient utilises dans une installation prcdente.

Les services cryptographiques d'IBM Cognos 8 utilisent un fichier .jar (Java Archive) spcifique, appel bcprov-jdknn-nnn, qui doit se trouver dans votre environnement JVM utilis par votre serveur d'application. Ce fichier fournit des sous-programmes supplmentaires de chiffrement et de dchiffrement qui ne sont pas disponibles dans l'installation implicite du JVM. Pour garantir la
384
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat scurit, le fichier de chiffrement doit tre charg par l'environnement JVM l'aide du rpertoire d'extensions Java.
Procdure
Configuration des composants d'IBM Cognos pour une excution dans le serveur d'application
IBM Cognos 8 doit tre configur selon les informations de configuration du serveur d'application. La configuration doit tre enregistre pour que des cls cryptographiques puissent tre cres. IBM Cognos Configuration utilise l'environnement Java dfini par la variable d'environnement JAVA_HOME. Important : Vous devez dfinir la variable d'environnement JAVA_HOME pour l'environnement JVM fourni ou utilis par le serveur d'application, puis copier les fichiers du fournisseur de scurit avant d'excuter IBM Cognos Configuration afin de vous assurer que des cls de chiffrement valides sont gnres.
Procdure
1. Dans le rpertoire emplacement_c8/bin, dmarrez IBM Cognos Configuration : Sous Windows, saisissez cogconfig.bat dans une fentre de commande ou slectionnez IBM Cognos Configuration dans le menu Dmarrer. Sous UNIX ou Linux, saisissez cogconfig.sh
Si des cls de chiffrement existantes sont incompatibles, vous tes invit en crer automatiquement de nouvelles ce stade. Conseil : Veillez effectuer une copie de sauvegarde des cls existantes dans un emplacement scuris avant de poursuivre. Une fois les cls cres, il n'est pas possible de revenir en arrire. 2. Pour WebSphere 5.1, dans le fichier emplacement_c8/webapps/p2pd/WEB-INF/p2pd_deploy_ defaults.properties, supprimez la mise en commentaire de la ligne suivante : #noJMX=true 3. Pour WebSphere 5.1, placez les fichiers mx4j*.jar figurant dans le rpertoire emplacement_c8/ webapps/p2pd/WEB-INF/lib dans un emplacement en dehors du rpertoire /webapps. 4. Utilisez l'Assistant Cration d'application pour crer le fichier d'application qui va tre dploy sur le serveur d'application. Pour lancer l'Assistant Cration d'application partir d'IBM Cognos Configuration sous Oprations, cliquez sur Crer des fichiers d'application. L'assistant Guide d'installation et de configuration 385
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat permet de slectionner le type d'application crer et la racine de contexte utilise pour accder l'application. Vous devez crer le fichier d'application sur l'ordinateur o il va tre dploy. La valeur de la racine de contexte indique dans l'assistant doit tre la mme que celle saisie dans l'onglet Environnement et tre utilise pour dployer le serveur d'application. Pour IBM Cognos 8, le nom implicite de la racine de contexte et du rpertoire de l'application est p2pd ; il peut tre utilis dans la plupart des cas. Pour la passerelle de type servlet IBM Cognos, le nom implicite de la racine de contexte et du rpertoire de l'application est ServletGateway. Vous devrez peut-tre modifier d'autres valeurs de dploiement d'application implicites, telles que le nom de l'application, afin de mieux rpondre aux besoins de votre environnement. Conseil : Il n'est pas ncessaire de crer ou de dployer nouveau le fichier d'archive lorsque vous modifiez la configuration, car les informations de configuration sont stockes en dehors de l'application. Pour WebLogic et JBoss, vous pouvez utiliser l'assistant Cration d'application dans IBM Cognos Configuration pour crer l'application dans un rpertoire dvelopp. Par exemple, pour WebLogic, vous placez l'application dans C:\bear_projects\domains\apps\ p2pd, o p2pd est le nom de l'application. Lors du dploiement de l'application partir de la console d'administration de WebLogic, vous slectionnerez alors le rpertoire p2pd. Important : Pour JBoss, si vous utilisez l'option Dvelopper les fichiers dans un dossier, vous devez inclure l'extension .war dans le nom du dossier o l'assistant va crer l'application p2pd. Lorsque l'assistant vous invite indiquer l'emplacement du dossier, accdez emplacement_JBoss/server/nom_instance/deploy et crez un dossier appel p2pd.war. Pour en savoir davantage sur le type de fichier d'application (WAR, EAR ou rpertoire tendu) pris en charge par votre environnement, reportez-vous la documentation de votre serveur d'application. 5. Dans la fentre Explorateur d'IBM Cognos Configuration, dveloppez le dossier Environnement et modifiez les proprits suivantes pour qu'elles utilisent le numro de port et le nom d'hte ou l'adresse IP du serveur sur lequel le composant d'IBM Cognos 8 et le serveur d'application sont installs. Tous les URI du distributeur, notamment : URI du distributeur pour la passerelle URI externe du distributeur URI interne du distributeur URI du distributeur des applications externes URI de la passerelle URI de Content Manager
Le serveur d'application doit tre configur pour couter les connexions sur le nom d'hte ou l'adresse IP saisi dans l'URI. Pour en savoir davantage, reportez-vous la documentation de votre serveur d'application.
386
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Si vous remplacez la valeur implicite p2pd de la racine de contexte, vous devez galement modifier la partie de l'URI relative la racine de contexte. 6. Sous Environnement, Service IBM Cognos 8, cliquez avec le bouton droit de la souris sur l'option IBM Cognos 8, puis cliquez sur le bouton Supprimer. L'entre correspondant au service IBM Cognos 8 est utilise pour configurer les paramtres d'environnement permettant l'excution sous Tomcat. L'entre n'est pas requise en cas d'utilisation d'un serveur d'application diffrent. 7. Compltez les autres changements de configuration requis, en : indiquant les proprits de la base de donnes Content Manager, saisissant les codes d'utilisateurs et mots de passe.
Si vous avez utilis les paramtres implicites pour l'installation d'IBM Cognos, vous n'aurez peut-tre que quelques changements mineurs apporter aux paramtres de configuration implicites (p. 305). 8. Enregistrez la configuration. Les nouvelles cls cryptographiques sont cres l'aide de la machine virtuelle Java dfinie par la variable JAVA_HOME. 9. Fermez IBM Cognos Configuration.
Identifier la version de JDK pour WebLogic 9 sur AIX

WebLogic 9 requiert JDK 1.5. Si vous utilisez WebLogic Server 9 sur AIX, vous devez mettre jour les options Java dans le fichier commEnv.sh pour dfinir l'identificateur unique appropri pour la version srie. Si vous ne procdez pas cette mise jour, une incohrence peut survenir au niveau de l'identificateur unique de la version srie lors de l'utilisation de WebLogic Server 9 avec IBM Java 5.
Procdure
1. Ouvrez le fichier emplacement_WebLogic9/common/bin/commEnv.sh. 2. Modifiez le fichier de faon inclure la commande suivante :
JAVA_OPTIONS="${JAVA_OPTIONS}-Dcom.sun.xml.namespace.QName. useCompatibleSerialVersionUID=1.0"export JAVA_OPTIONS
3. Enregistrez et fermez le fichier commEnv.sh.
Modification du script de dmarrage du serveur d'application

Assurez-vous de la conformit avec la configuration requise pour les serveurs d'application avant d'excuter IBM Cognos 8. En fonction du serveur d'application, vous pouvez avoir besoin de dfinir des variables d'environnement, de copier des fichiers et d'ajouter ou modifier le code des fichiers.
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Si vous utilisez le serveur BEA WebLogic version 8.1 ou Red Hat JBoss, vous devez effectuer des modifications dans le script de dmarrage du serveur d'application. Le script de dmarrage doit tre modifi de faon utiliser les paramtres JVM. Pour JBoss, vous devez galement indiquer un argument log4j. Pour WebLogic 9, il est conseill d'utiliser la console d'administration pour modifier l'environnement WebLogic. Si vous utilisez le serveur d'application IBM WebSphere, SAP NetWeaver 6.40 ou le serveur d'application Oracle, aucune modification du script de dmarrage n'est requise, moins que vous ne souhaitiez ajouter les modifications apportes la variable d'environnement. Si vous effectuez des modifications, vous pouvez utiliser la console d'administration. Pour Red Hat JBoss, il est recommand de crer une copie de l'instance de serveur implicite pour que vous puissiez utiliser l'instance de serveur originale comme sauvegarde. Attribuez la copie un nom ne comportant pas d'espace, tel que cognos. Si votre environnement contient un JRE que vous utilisez pour d'autres produits, il est possible que le dossier du JRE contiennent des fichiers .jar non compatibles avec les fichiers .jar fournis avec IBM Cognos 8. Cela peut empcher le dmarrage d'IBM Cognos 8 sur votre serveur d'application. Dans ce cas, il est recommand d'indiquer IBM Cognos 8 d'utiliser les fichiers .jar approuvs en incluant le paramtre suivant dans la ligne de commande Java :
-Djava.endorsed.dirs=${cognos8_home}/tomcat[version]/common/endorsed
Procdure pour WebLogic

1. Crez un domaine WLS (WebLogic Server) pour IBM Cognos 8. Si vous configurez la passerelle de type servlet IBM Cognos, crez un second domaine pour cette application. Pour en savoir davantage sur la cration de domaines, reportez-vous la documentation de WebLogic. 2. Accdez au rpertoire appropri et ouvrez le script de dmarrage du serveur d'application dans un diteur. Exemples de rpertoires possibles : emplacement_ WebLogic8.1/user_projects /nom_domaine emplacement_ WebLogic9/user_projects /nom_domaine
Le nom du script de dmarrage peut varier selon le type d'installation de WebLogic effectu. Par exemple, dans le cas d'une installation de serveur gr, le nom du script de dmarrage est startManagedWebLogic.sh (sous UNIX) ou startManagedWebLogic.cmd (sous Windows). 3. Pour les versions IBM JRE, slectionnez le mode d'excution JVM, remplacez le paramtre implicite JAVA_VM= par JAVA_VM=server 4. Modifiez la variable JAVA_OPTIONS afin de dfinir l'analyseur syntaxique XML appropri pour IBM Cognos 8. Ajoutez la troisime ligne, comme indiqu dans l'exemple suivant :
JAVA_OPTIONS= -Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts-Dorg. xml.sax.driver=org.apache.xerces.parsers.SAXParser
5. Dfinissez les valeurs minimale et maximale de mmoire utilise par la machine virtuelle Java.
388
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat En rgle gnrale, la mmoire est dfinie au moyen de deux paramtres JVM : -Xms et -Xmx. Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. Pour WebLogic 9, le paramtre MaxPermSize doit aussi tre dfini. Voici un exemple :
-XX:MaxPermSize=128m
Pour en savoir davantage sur les paramtres JVM, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. 6. Vrifiez que le mode de production est activ. Pour WebLogic 8 et 9, dfinissez PRODUCTION_MODE= sur PRODUCTION_MODE=true 7. Enregistrez et fermez le fichier.
Procdure pour JBoss

1. Accdez au rpertoire emplacement_JBoss/bin et ouvrez le script de dmarrage du serveur d'application dans un diteur. Effectuez l'une des oprations suivantes : Pour Windows, ouvrez run.bat. Pour UNIX ou Linux, ouvrez run.sh.
2. Recherchez la variable JAVA_OPTS et augmentez la mmoire utilise par JVM. En rgle gnrale, la mmoire est dfinie au moyen de deux paramtres JVM : -Xms et -Xmx. Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. Voici un exemple :
rem Sun JVM memory allocation pool parameters. Modifyas appropriate.set JAVA_ OPTS=%JAVA_OPTS% -Xms192m -Xmx768m - Dsun.rmi.dgc.client.gcInterval=3600000 - Dsun.rmi.dgc.client.gcInterval=3600000 -
Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. 3. Ajoutez un argument log4j, comme indiqu dans l'exemple suivant :
rem Sun JVM memory allocation pool parameters. Modifyas appropriate.set JAVA_ OPTS=%JAVA_OPTS% -Xms256m -Xmx512m - Dsun.rmi.dgc.client.gcInterval=3600000 - Dsun.rmi.dgc.client.gcInterval=3600000 DLog4j.defaultInitOverride=true
Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. 4. Enregistrez et fermez le fichier.
Configuration des proprits du serveur d'application et dploiement des composants d'IBM Cognos
Vous devez configurer les proprits du serveur d'application et dployer les composants d'IBM Cognos.
Procdure pour WebSphere

1. Dmarrez le serveur d'application de WebSphere, puis accdez la console d'administration de WebSphere. 2. Crez une instance de serveur dans laquelle l'application IBM Cognos 8 va tre dploye, si cette option est disponible dans la version que vous excutez. Si vous dployez la passerelle de type servlet IBM Cognos, crez une seconde instance de serveur distincte. 3. Installez une nouvelle application au niveau de l'entreprise l'aide du fichier d'application cr par IBM Cognos Configuration. Pour IBM Cognos 8, la racine de contexte implicite p2pd peut tre utilise dans la plupart des cas. Pour la passerelle de type servlet IBM Cognos, la racine de contexte implicite est ServletGateway. Vous devrez peut-tre modifier d'autres valeurs de dploiement d'application implicites, telles que le nom de l'application, afin de mieux rpondre aux besoins de votre environnement. La valeur de la racine de contexte utilise pour dployer l'application doit tre la mme que celle indique dans IBM Cognos Configuration lors de l'excution de l'assistant Cration d'application. 4. Dfinissez la mmoire utilise par la machine virtuelle Java. En rgle gnrale, la mmoire est dfinie en ajoutant ou en modifiant la taille initiale et maximale de segment mmoire Java. Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. Conseil : Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. 5. Dans les proprits du serveur, ajoutez une variable d'environnement, selon le tableau ci-dessous, qui fait rfrence au rpertoire emplacement_installation/bin.
Windows AIX Solaris HP-UX
390
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 6. Arrtez puis redmarrez l'instance du serveur d'application WebSphere utilise pour les composants d'IBM Cognos. 7. Vrifiez que les composants d'IBM Cognos sont en cours d'excution en recherchant le message suivant dans la console d'administration ou le fichier journal du serveur d'application : Le distributeur est prt traiter les demandes.
Procdure pour WebLogic

1. Si vous avez choisi l'option du rpertoire dvelopp lors de la cration de l'application dans IBM Cognos Configuration, passez l'tape 2. Si vous avez cr un fichier WAR, dployez l'application manuellement : Crez un rpertoire dans un emplacement accessible par le serveur d'application, en donnant au rpertoire le mme nom que la racine du contexte. Pour IBM Cognos 8, le nom implicite de la racine de contexte et du rpertoire de l'application est p2pd ; il peut tre utilis dans la plupart des cas. Pour la passerelle de type servlet IBM Cognos, la racine de contexte implicite est ServletGateway. Vous devrez peut-tre modifier d'autres valeurs de dploiement d'application implicites, telles que le nom de l'application, afin de mieux rpondre aux besoins de votre environnement. La valeur de la racine de contexte utilise pour dployer l'application doit tre la mme que celle indique dans IBM Cognos Configuration. Dans le rpertoire que vous venez de crer, procdez l'extraction du fichier WAR de l'application dans l'emplacement d'installation de WebLogic en saisissant la commande suivante partir d'une invite de commande : emplacement_WebLogic/version_jdk/bin/jar xvfm "emplacement_installation/application. war" . Important : Vous devez ajouter un espace, suivi d'un point, la fin de la commande. Dans cette commande, le point ne fait pas rfrence au rpertoire actuel. 2. Dmarrez le serveur d'administration WebLogic et le serveur gr WebLogic associs au domaine IBM Cognos. L'application Node Manager doit tre lance pour que vous puissiez arrter et dmarrer les instances du serveur gr l'aide de la console d'administration. 3. Pour WebLogic 9, vous devez modifier l'environnement dans la console d'administration WebLogic avant de dployer IBM Cognos 8. Connectez-vous la console d'administration et accdez l'instance de serveur gr prvue pour hberger l'application IBM Cognos 8. Slectionnez l'onglet Server Start correspondant l'instance de serveur gr et activez le mode d'dition. 4. Dans la zone Java Home, saisissez le chemin d'accs au JVM. Cette valeur doit tre identique celle utilise pour IBM Cognos 8. Vous devez utiliser l'environnement JVM intgr l'installation de WebLogic. 5. Dfinissez les arguments Java. Les arguments Java incluent tous les paramtres JVM, notamment les paramtres de mmoire dfinis l'aide de deux paramtres JVM : -Xms et -Xmx. Pour WebLogic 9, MaxPermSize doit Guide d'installation et de configuration 391
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat aussi tre dfini. Vous devez galement dfinir l'analyseur syntaxique XML appropri pour IBM Cognos 8. Par exemple, dans la zone Arguments, saisissez : -Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces. parsers.SAXParser Si vous utilisez WebLogic Server 9 sur AIX, vous devez aussi dfinir l'identificateur unique appropri pour la version srie dans les arguments Java. Si vous ne procdez pas cette mise jour, une incohrence peut survenir au niveau de l'identificateur unique de la version srie lors de l'utilisation de WebLogic Server 9 avec IBM Java 5, car WebLogic 9 requiert JDK 1.5. Par exemple, dans la zone Arguments, saisissez : -Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces. parsers.SAXParser -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 Pour en savoir davantage sur les paramtres JVM, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. 6. Enregistrez et appliquez les modifications. Vous pouvez maintenant dmarrer et arrter l'instance du serveur gr partir de l'onglet Control. 7. Dmarrez l'instance du serveur. L'instance du serveur doit tre dmarre avant de dployer IBM Cognos 8 ou la passerelle de type servlet IBM Cognos. 8. Dployez l'application IBM Cognos 8 ou la passerelle de type servlet IBM Cognos dans la console WebLogic l'aide d'une nouvelle application Web, comme suit : Dfinissez le nom de l'application. Par exemple, cognos8. Dfinissez le chemin d'accs au rpertoire dans lequel les fichiers de l'application tendue se trouvent. Remarque : IBM Cognos 8 utilise un chargeur personnalis. Vous devez faire appel l'option de rpertoire dvelopp lors du dploiement. Slectionnez l'instance de serveur cible. Il est recommand de n'utiliser le serveur d'administration que pour les tches d'administration de WebLogic et de dployer l'application IBM Cognos 8 sur sa propre instance de serveur gr. 9. Une fois le dploiement correctement effectu, dfinissez la priode de rechargement pour l'application Web sur -1 afin d'amliorer les performances. Cela vite que WebLogic ne recherche des fichiers d'application mis jour qui sont utiliss uniquement dans un environnement de dveloppement. 10. Arrtez et redmarrez le serveur gr WebLogic associ au domaine IBM Cognos afin d'activer les modifications.
392
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 11. Vrifiez que les composants d'IBM Cognos sont en cours d'excution en recherchant le message suivant dans la fentre de la console du serveur d'application ou dans le fichier journal du serveur d'application : Le distributeur est prt traiter les demandes.
Procdure pour SAP NetWeaver 6.40 sous Windows

1. Ouvrez l'outil de configuration en saisissant ce qui suit : lecteur:\usr\sap\sapid\JCxx\j2ee\configtool\configtool.bat Ainsi, si l'ID SAP est J2E et que l'installation se trouve sur le lecteur D, vous devez saisir : D:\usr\sap\J2E\JC00\j2ee\configtool\configtool.bat 2. Lorsque vous tes invit utiliser les paramtres de base de donnes implicites, cliquez sur Yes. 3. Sous cluster-data, instance_IDxxxxxxx, Dispatcher_IDxxxxxxx, services, o xxxxxxx correspond au numro didentification de votre installation, mettez en vidence http. 4. Sous Global Properties, mettez en vidence KeepAliveTimeout et saisissez un nombre plus lev, puis cliquez sur Set. Conseil : Il est recommand d'adopter une valeur KeepAliveTimeout initiale au moins gale 60. 5. Sous cluster-data, instance_IDxxxxxxx, mettez en vidence Server_IDxxxxxxx. 6. Dfinissez la mmoire utilise par la machine virtuelle Java. Suivez les instructions fournies par SAP. Pour en savoir davantage, consultez la note SAP 723909 dans le portail de support SAP. Si votre ordinateur dispose de moins de 1,5 Go de mmoire, des problmes peuvent se produire lors de l'excution de SAP NetWeaver. La valeur minimale 768 Mo est recommande. 7. Dans la zone des paramtres Java, dfinissez l'analyseur syntaxique XML comme suit : -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser 8. Pour les environnements IBM Cognos 8 utilisant Report Studio, sous cluster-data, instance_IDxxxxxxx, mettez en vidence Server_IDxxxxxxx, services, puis mettez en vidence http. 9. Sous Global Properties, mettez en vidence CompressedOthers, saisissez false, puis cliquez sur Set. 10. Enregistrez les modifications. Vous tes invit redmarrer le serveur. 11. Redmarrez le serveur l'aide de la console de gestion SAP ou en redmarrant les services dans la section Services. 12. Utilisez l'outil Dploiement pour crer un nouveau projet.
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 13. Chargez le fichier d'application IBM Cognos que vous avez cr avec IBM Cognos Configuration. Par dfaut, ce fichier se nomme p2pd.ear pour IBM Cognos 8 et ServletGateway.ear pour la passerelle de type servlet IBM Cognos. 14. l'aide de l'outil Dploiement, connectez-vous l'outil Administration et dployez le fichier d'application. 15. Lorsque vous tes invit dmarrer l'application, cliquez sur Yes. 16. Enregistrez le projet.
Procdure pour Oracle Application Server Release 2

1. Crez une instance OC4J au sein de laquelle les composants d'IBM Cognos s'excuteront. 2. Dfinissez la mmoire utilise par la machine virtuelle Java. En gnral, la mmoire est dfinie en ajoutant ou en modifiant les deux paramtres JVM: -Xms et -Xmx. Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. 3. Dans les proprits du serveur, ajoutez -userThreads aux options OC4J. 4. Dans les proprits du serveur, ajoutez une variable d'environnement, selon le tableau ci-dessous, qui fait rfrence au rpertoire emplacement_installation/bin.
5. Dployez le fichier d'application IBM Cognos (nomm par dfaut p2pd.ear pour IBM Cognos 8 et ServletGateway.ear pour la passerelle de type servlet IBM Cognos) cr par IBM Cognos Configuration. La valeur du paramtre Map to URL doit tre identique celle de la racine de contexte indique dans IBM Cognos Configuration. 6. Dmarrez l'instance de OC4J que vous avez cre pour les composants d'IBM Cognos. 7. Vrifiez que les composants d'IBM Cognos sont en cours d'excution en recherchant le message suivant dans la fentre de la console du serveur d'application ou dans le fichier journal du serveur d'application :
394
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Le distributeur est prt traiter les demandes.
Procdure pour Oracle Application Server Release 3

1. Crez une instance OC4J au sein de laquelle les composants d'IBM Cognos s'excuteront. 2. Sous Windows uniquement, mettez en commentaires les entres suivantes dans le fichier emplacement_Oracle\j2ee\instance_Cognos_OC4J\config\global-web-application.xml :
<welcome-file-list> <welcome-file>index.html</welcome-file> <welcomefile>default.jsp</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> </welcome-file-list>
3. Ouvrez le fichier emplacement_Oracle/opmn/conf/opmn.xml. 4. Ajoutez une variable d'environnement faisant rfrence au rpertoire emplacement_installation/bin et dfinissez des variables pour les sources de donnes. Exemple pour Windows et DB2 :
<environment> <variable id="PATH" value="c8_location/bin" append="true"/> <variable id="DB2DIR" value="location"/> <variable id="DB2INSTANCE value="instance_name"/> <variable id="INSTHOME value="location"/></environment>
Ce tableau rpertorie les variables d'environnement pour chaque systme d'exploitation qui doit faire rfrence au rpertoire emplacement_c8/bin.
5. Dfinissez la mmoire utilise par la machine virtuelle Java. Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. Voici un exemple :
<data id="java-options" value="-server -Xmx768m -XX:MaxNewSize=384m-XX: NewSize=192m -XX:MaxPermSize=128m -classpath c8_location\bin;c8_location\ webapps\p2pd\WEB-INF\lib-
6. Dfinissez le paramtre userThreads OC4J. Voici un exemple :

<data id="oc4j-options" value="-properties -userThreads"/>
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 7. Enregistrez et fermez le fichier emplacement_Oracle/opmn/conf/opmn.xml. 8. Dployez le fichier d'application IBM Cognos (nomm par dfaut p2pd.ear pour IBM Cognos 8 et ServletGateway.ear pour la passerelle de type servlet IBM Cognos) cr par IBM Cognos Configuration. La valeur du paramtre Map to URL doit tre identique celle de la racine de contexte indique dans IBM Cognos Configuration. 9. Dmarrez l'instance de OC4J que vous avez cre pour les composants d'IBM Cognos. 10. Vrifiez que les composants d'IBM Cognos sont en cours d'excution en recherchant le message suivant dans la fentre de la console du serveur d'application ou dans le fichier journal du serveur d'application : Le distributeur est prt traiter les demandes.
Procdure pour JBoss

1. Si vous ne souhaitez pas utiliser le port implicite 8080, ouvrez le fichier emplacement_JBoss/server/nom_instance/deploy/jbossweb-tomcat55.sar/server.xml. 2. Dans le fichier server.xml, redfinissez le numro de port implicite 8080 utilis par l'instance de serveur sur le port indiqu dans IBM Cognos Configuration. Par exemple :
<Service name="jboss.web" className="org.jboss.web.tomcat.tc5. StandardService"><Connector port="8080" address="${jboss.bind.address}" maxThreads="250" strategy="ms" maxHttpHeaderSize="8192" emptySessionPath="true" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true"/>
3. Enregistrez et fermez le fichier server.xml. 4. Placez l'application p2pd dans le dossier emplacement_JBoss/server/nom_instance/deploy, si elle ne s'y trouve pas dj. 5. Dmarrez le serveur d'application. L'application p2pd est automatiquement dtecte et lance par le serveur d'application. 6. Vrifiez que les composants d'IBM Cognos sont en cours d'excution en recherchant le message suivant dans la fentre de la console du serveur d'application ou dans le fichier journal du serveur d'application :
The dispatcher is ready to process requests.
Procdure pour le serveur d'application Sun Java System

1. Utilisez la console d'administration du serveur d'application Sun Java System pour ajouter une nouvelle option JVM afin de dfinir l'analyseur syntaxique XML qui sera utilis par IBM Cognos Application. Par exemple :
"-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp. DocumentBuilderFactoryImpl"
2. Ajoutez une option JVM pour dfinir la taille maximale de segment mmoire Java de manire limiter la quantit de mmoire maximale pouvant tre utilise par le processus Java.
396
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat En rgle gnrale, la mmoire est dfinie en ajoutant ou en modifiant la taille initiale et maximale de segment mmoire Java. Pour en savoir davantage sur ces paramtres, reportez-vous la documentation du serveur d'application ou de la machine virtuelle Java. Par exemple, ajoutez "-Xmx768M" pour dfinir 768 Mo de mmoire comme valeur maximale pour les processus Java. Conseil : Les valeurs de dpart recommandes sont 256 Mo minimum et 768 Mo maximum. Vous pouvez modifier ces valeurs en fonction de votre environnement. 3. Attribuez une valeur suprieure la valeur implicite dfinie (5) pour le paramtre "Maximum number of request processing threads", en fonction de votre environnement. Conseil :Commencez par une valeur de 250. Une valeur trop faible peut tre l'origine d'une instabilit du systme et de l'chec des processus. Une valeur trop leve entrane une rservation inutile des ressources du systme. 4. Copiez le fichier emplacement_c8 \webapps\p2pd\WEB-INF\lib\xercesImpl.jar dans emplacement_SJSAS\domains\<nom_domaine>\lib\ext.
Activation du protocole SSL

Si vous utilisez le protocole SSL (Secure Socket Layer) pour les composants d'IBM Cognos, vous devez galement activer le protocole SSL dans l'environnement du serveur d'application. Identifiez ensuite le certificat de serveur SSL pour les composants d'IBM Cognos.
Procdure
1. Configurez le serveur d'application de faon ce qu'il utilise le protocole SSL. Un certificat de serveur SSL est cr par une autre autorit de certification. Le certificat de l'autorit de certification qui cre le certificat de serveur SSL vous est galement dlivr. Pour en savoir davantage sur la configuration du serveur d'application pour SSL, reportez-vous la documentation du serveur. Pour en savoir davantage sur l'utilisation des certificats CA avec votre serveur d'application, reportez-vous la documentation relative l'autorit de certification. 2. Copiez le certificat de l'autorit de certification dans le rpertoire emplacement_installation/bin et renommez le fichier en ca.cer. Ce fichier doit utiliser l'encodage Base-64, format X.509. 3. partir du rpertoire emplacement_installation/bin : Sous Windows, saisissez : ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p mot_de_passe Sous UNIX ou Linux, saisissez : ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p mot_de_passe
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat Important : Vous devez saisir jCAKeystore comme nom de bibliothque de cls de l'autorit de certification.

Si vous utilisez un serveur Web dans votre environnement, configurez-le maintenant. Pour en savoir davantage sur la configuration du serveur Web, reportez-vous la section "Configuration du serveur Web" (p. 133). Pour en savoir davantage sur la configuration du module d'extension du serveur Web de WebSphere, visitez le site Web Cognos Software Services (http://support.cognos.com). Si vous utilisez SAP NetWeaver sous Windows et n'utilisez pas de serveur Web et une passerelle IBM Cognos pour la communication Web, vous pouvez tre amen crer un rpertoire virtuel, galement dsign par le terme alias Web. Ce rpertoire virtuel est requis pour permettre le chargement de contenu statique (pages html, images, etc). Lors de la cration du fichier d'application IBM Cognos, slectionnez l'option d'inclusion des fichiers statiques depuis le dossier Webcontent. Crez un rpertoire virtuel qui utilise la valeur de la racine de contexte en tant que nom (par dfaut, p2pd pour Cognos 8 ou ServletGateway pour la passerelle de type servlet Cognos). Vrifiez que le rpertoire virtuel pointe sur le dossier emplacement_c8/webcontent.
Procdure de dfinition du rpertoire virtuel supplmentaire pour SAP NetWeaver on Windows

Crez le rpertoire virtuel suivant :
Alias
racine_contexte (par exemple, p2pd)
Emplacement
emplacement_c8/webcontent
Autorisation
Read
Annulation de l'inscription des distributeurs

Une fois que vous avez dmarr le serveur d'application et l'application IBM Cognos, annulez l'inscription des distributeurs IBM Cognos qui avaient t inscrits et qui ne sont plus utiliss. Par exemple, annulez l'inscription de tous les distributeurs Tomcat excuts dsormais sous le serveur d'application. Supprimez les distributeurs l'aide d'IBM Cognos Administration. Pour accder cet outil, vous devez disposer de droits d'excution sur la fonction protge Administration.
Procdure
1. Ouvrez IBM Cognos Connection. 2. Dans le coin suprieur droit de l'cran, cliquez sur Lancez, puis sur IBM Cognos Administration. 3. Dans l'onglet Configuration, cliquez sur Distributeurs et services.
398
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 4. Pour le distributeur dont vous voulez annuler l'inscription, cliquez sur Plus dans le menu Oprations. 5. Cliquez sur Annuler l'inscription. 6. Dans la bote de dialogue de confirmation, cliquez sur OK. Les informations sur le distributeur sont retires de Content Manager.
Importation des donnes de la base de donnes Content Store

Si vous avez export la base de donnes Content Store avant de configurer les composants d'IBM Cognos pour qu'ils s'excutent sur le serveur d'application (p. 382), importez le dploiement pour restaurer et chiffrer les donnes l'aide des nouvelles cls de chiffrement.
Procdure
1. Dmarrez IBM Cognos 8. 2. Importez l'intgralit de la base de donnes Content Store l'aide de l'outil Dploiement Pour en savoir davantage, reportez-vous la rubrique traitant de l'importation vers un environnement cible dans le Guide d'administration et de scurit.
Mise niveau vers IBM Cognos 8 dans un environnement de serveur d'application

Si vous procdez une mise niveau d'une version prise en charge vers IBM Cognos 8, effectuez la procdure suivante :
Procdure
1. Effectuez une copie de sauvegarde des informations d'IBM Cognos existantes (p. 382). 2. Utilisez les outils d'administration du serveur d'application afin d'annuler le dploiement de l'application IBM Cognos. Pour en savoir davantage sur l'annulation du dploiement d'applications, reportez-vous la documentation de votre serveur d'application. Si le rpertoire vers lequel l'application IBM Cognos existante a t initialement dploye n'est pas supprim pendant le processus d'annulation du dploiement, supprimez-le. Supprimez galement tous les fichiers .jar IBM Cognos qui se trouvent dans l'antmmoire de l'environnement du serveur d'application. Dans WebLogic 8.1, l'antmmoire se trouve dans %WL_HOME%\user_projects\domains\ nom_domaine\ nom_serveur_gr\.wlnotdelete\extract\crn_p2pd_p2pd\ jarfiles 3. Dsinstallez la version existante. (p. 147). 4. Installez IBM Cognos 8 (p. 153).
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat 5. Suivez les instructions appropries indiques dans ce chapitre pour modifier le serveur d'application. Vous devez effectuer les oprations suivantes pour la plupart des installations : Configurer IBM Cognos 8 pour qu'il s'excute au sein du serveur d'application. Configurer les proprits du serveur d'application et dployer IBM Cognos 8.
6. Pour activer les nouvelles fonctions aprs avoir effectu la mise niveau, enregistrez la configuration dans IBM Cognos Configuration, puis redmarrez les services.
Mise niveau de Metrics Manager vers IBM Cognos 8 dans un environnement de serveur d'application
Si vous effectuez une mise niveau de Metrics Manager vers IBM Cognos 8, procdez comme suit :
Procdure
1. Suivez la procdure pour mettre niveau Metrics Manager vers IBM Cognos 8 (p. 105). 2. Suivez les instructions appropries indiques dans ce chapitre pour modifier le serveur d'application. Vous devez effectuer les oprations suivantes pour la plupart des installations : Configurer IBM Cognos 8 pour qu'il s'excute au sein du serveur d'application. Configurer les proprits du serveur d'application et dployer IBM Cognos 8.
3. Pour activer les nouvelles fonctions aprs avoir effectu la mise niveau, vous devez enregistrer la configuration dans IBM Cognos Configuration puis redmarrer les services.
400
Chapitre 14: Options de configuration avances

Les options de configuration avances ont trait aux modifications que vous apportez, aprs installation, aux proprits de configuration des ressources utilises par les composants d"IBM Cognos 8. IBM Cognos Configuration ne permet pas d'apporter ces modifications. Les options de configuration avances amliorent la scurit et les performances et modifient le comportement implicite des composants d'IBM Cognos 8.
Changement du type de JVM utilise par IBM Cognos 8

Pour mieux adapter votre environnement de cration de rapports, vous pouvez changer le type de JVM (Java Virtual Machine) utilise par les composants d'IBM Cognos 8, en fonction des critres suivants : Java HotSpot Client VM Cette JVM permet d'amliorer des environnements de banc d'essai, de dmonstration ou de dveloppement. Elle est spcialement conue pour rduire le temps de dmarrage des applications et l'utilisation de la mmoire. Il s'agit du paramtrage implicite de l'installation d'IBM Cognos sous Windows. Sur des plateformes UNIX et Linux, aucun JRE (Java Runtime Environment) n'est fourni. La JVM implicite utilise par les composants d'IBM Cognos 8 dpend donc du paramtrage du JRE existant. Java HotSpot Server VM Ce module permet d'optimiser l'excution des applications serveur longues lorsque les performances ont priorit sur le temps de dmarrage. Pour en savoir davantage, reportez-vous au site Web de Sun Microsystems Inc.
Procdure
1. Ouvrez l'emplacement o sont installes les bibliothques de Java Runtime Environment (JRE) : Sous Windows, accdez au rpertoire emplacement_c8\bin\jre\version_jre\lib\i386. Sous UNIX ou Linux, ouvrez le rpertoire JAVA_HOME/jre/lib.
2. Ouvrez le fichier jvm.cfg dans un diteur. 3. Assurez-vous que la JVM que vous voulez utiliser figure sur la premire ligne sans commentaire. Saisissez le texte appropri pour la JVM que vous voulez utiliser :
JVM
Hotspot Client Hotspot Server
Texte
hotspot serveur
Chapitre 14: Options de configuration avances 4. Enregistrez et fermez le fichier.
Changement de la version de Java Runtime Environment utilise par les composants d'IBM Cognos 8
Pour fonctionner, les composants d'IBM Cognos 8 ont besoin d'un environnement JRE (Java Runtime Environment). La version actuelle fournie avec IBM Cognos 8 est JRE 1.5.0. Pour en savoir davantage sur les versions JRE prises en charge, visitez le site Web Cognos Software Services (http://support.cognos.com). IBM Cognos Configuration et les autres composants d'IBM Cognos 8 utilisent le JRE rfrenc par la variable d'environnement JAVA_HOME. Sous Windows, si la variable JAVA_HOME n'est pas dfinie, le JRE fourni avec les composants de IBM Cognos 8 est utilis par dfaut. Pour changer de version de JRE, vous devez modifier la configuration. Ces modifications peuvent s'avrer utiles dans les situations suivantes : Vous voulez utiliser les composants d'IBM Cognos 8 avec un serveur d'application qui ncessite une version de JRE spcifique. Vous utilisez dj une version de JRE avec d'autres applications.
Si vous utilisez les composants d'IBM Cognos 8 dans un environnement de serveur d'application, suivez la procdure dcrite dans la section "Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat" (p. 379). Cette procdure inclut les tapes permettant de mettre jour l'environnement Java. Avant de commencer, assurez-vous que les composants d'IBM Cognos 8 et le JRE que vous souhaitez utiliser sont installs. Pour changer de version de JRE, procdez comme suit : Le cas chant, effectuez une sauvegarde de toutes les donnes et cls de chiffrement existantes d'IBM Cognos. Mettez jour l'environnement Java. Le cas chant, importez les donnes dans la base de donnes Content Store.
Les tches de cette section correspondent une installation d'IBM Cognos 8 avec Tomcat.
Sauvegarde des informations IBM Cognos

Vous devez sauvegarder les informations IBM Cognos si des composants d'IBM Cognos 8 s'excutent sur un serveur d'application (y compris Tomcat) et si vous passez un serveur d'application livr avec son propre environnement JVM, Vous devez aussi sauvegarder les informations IBM Cognos si vous devez modifier le JVM que vous utilisez. Remarque : Avant de procder la mise niveau, vous devez sauvegarder les informations existantes relatives IBM Cognos au sein de l'environnement de travail. Avant de configurer les composants d'IBM Cognos 8 pour qu'il s'excute sur un nouveau serveur d'application ou dans un environnement JVM, vous devez sauvegarder ce qui suit :
402
Chapitre 14: Options de configuration avances Les donnes de la base de donnes Content Store en crant une exportation de dploiement. Les informations de configuration en les exportant ; toutes les donnes chiffres sont dchiffres lors de l'exportation. Les cls cryptographiques en les enregistrant un autre emplacement. Les nouvelles cls cryptographiques doivent tre cres l'aide du mme environnement JVM utilis par le serveur d'application. Ces cls pouvant tre cres uniquement si les cls prcdentes sont supprimes, il est important de sauvegarder ces dernires.
Pour garantir la scurit et l'intgrit des donnes d'IBM Cognos, enregistrez une copie de sauvegarde de la base de donnes Content Store, les informations de configuration et les cls cryptographiques dans un rpertoire protg contre l'accs non autoris et inappropri. Conseil : Pour connatre les cls existantes, examinez le rpertoire emplacement_c8/configuration. Les cls cryptographiques existent si ce rpertoire contient les sous-rpertoires suivants : csk, encryptkeypair ou signkeypair.
Procdure
1. S'il existe des donnes dans la base de donnes Content Store, dmarrez le service IBM Cognos 8 et exportez l'intgralit de la base de donnes Content Store l'aide de l'outil Dploiement. Pour en savoir davantage, reportez-vous la rubrique traitant de la cration d'une spcification de dploiement d'exportation dans le Guide d'administration et de scurit. 2. Dans IBM Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que et enregistrez les informations de configuration dans un format dchiffr. Nommez ce fichier de manire explicite, par exemple dchiffr.xml . Exportez les donnes vers un rpertoire protg contre tout accs non autoris ou inappropri, car les mots de passe sont stocks en texte brut. Vous tes invit confirmer le caractre non scuris de l'exportation. 3. Arrt du service IBM Cognos 8 : Si vous utilisez Tomcat, arrtez le service IBM Cognos 8 et fermez IBM Cognos Configuration. Si vous utilisez un serveur d'application autre que Tomcat, fermez IBM Cognos 8 dans votre environnement.
4. Sauvegardez toutes les cls cryptographiques en enregistrant les fichiers et rpertoires appropris dans un autre emplacement scuris. Les fichiers sont : emplacement_c8/configuration/cogstartup.xml emplacement_c8/configuration/caSerial emplacement_c8/configuration/cogconfig.prefs emplacement_c8/configuration/coglocale.xml
Chapitre 14: Options de configuration avances Les rpertoires sont : emplacement_c8/configuration/csk emplacement_c8/configuration/encryptkeypair emplacement_c8/configuration/signkeypair
5. Supprimez les fichiers caSerial et cogconfig.prefs ainsi que les trois rpertoires : csk, encryptkeypair et signkeypair. 6. Remplacez le fichier emplacement_c8/configuration/cogstartup.xml par celui qui contient les donnes exportes depuis IBM Cognos Configuration (par exemple, dchiffr.xml ). Important : Dans le rpertoire emplacement_c8/configuration, le fichier doit porter le nom cogstartup.xml . Les informations de ce fichier sont automatiquement chiffres de nouveau l'aide des cls cryptographiques lorsque vous enregistrez la configuration dans IBM Cognos Configuration.

Les fichiers du fournisseur de scurit d'IBM Cognos doivent se trouver dans l'environnement JVM pour la nouvelle version de Java. Les services cryptographiques d'IBM Cognos 8 utilisent un fichier .jar (Java Archive) spcifique, appel bcprov-jdknn-nnn.jar, qui doit se trouver dans votre environnement JRE. Ce fichier fournit des sous-programmes supplmentaires de chiffrement et de dchiffrement qui ne sont pas disponibles dans l'installation implicite du JVM. Pour garantir la scurit, le fichier de chiffrement doit tre charg par l'environnement JVM l'aide du rpertoire d'extensions Java. Si vous souhaitez utiliser votre propre JRE et dfinir la variable JAVA_HOME sur l'emplacement correspondant sous Windows ou si vous effectuez l'installation sous UNIX, vous devrez peut-tre mettre jour l'environnement Java pour les services cryptographiques. Sous Windows, vous pouvez dfinir JAVA_HOME en tant que variable systme ou variable utilisateur. Si vous la dfinissez en tant que variable systme, vous devrez probablement redmarrer votre ordinateur pour qu'elle prenne effet. Si vous la dfinissez en tant que variable utilisateur, faites en sorte que l'environnement dans lequel s'excute Tomcat puisse y accder. Si vous ne disposez pas d'une variable JAVA_HOME dj dfinie sous Windows ou si la variable JAVA_HOME pointe vers une version de Java non compatible avec IBM Cognos 8, les fichiers JRE fournis avec l'installation seront utiliss et vous n'aurez pas besoin de mettre jour les fichiers de votre environnement.
Procdure
1. Vrifiez que la variable d'environnement JAVA_HOME est dfinie de faon pointer vers l'emplacement du JRE. Par exemple, pour dfinir JAVA_HOME au niveau des fichiers JRE fournis avec l'installation, le chemin d'accs est emplacement_c8/bin/jre/version.
404
Chapitre 14: Options de configuration avances 2. Copiez le fichier bcprov-jdknn-nnn.jar du rpertoire emplacement_c8/bin/jre/version/lib/ext dans le rpertoire emplacement_Java/lib/ext. 3. Dmarrez IBM Cognos Configuration. 4. Enregistrez la configuration. IBM Cognos Configuration cre de nouvelles cls et chiffre les donnes.
Importation des donnes de la base de donnes Content Store

Si vous avez export la base de donnes Content Store avant de changer la JVM, importez le dploiement pour restaurer et chiffrer les donnes l'aide des nouvelles cls de chiffrement.
Procdure
Pour importer les donnes de la base de donnes Content Store, dmarrez le service IBM Cognos 8 et importez l'intgralit de la base de donnes Content Store l'aide de l'outil Dploiement. Pour en savoir davantage, reportez-vous la rubrique traitant de l'importation vers un environnement cible dans le Guide d'administration et de scurit.
Configuration des composants d'IBM Cognos 8 pour l'utilisation d'une autre autorit de certification
Par dfaut, les composants d'IBM Cognos 8 utilisent leur propre service d'autorit de certification (CA) pour tablir la racine d'approbation dans l'infrastructure de scurit d'IBM Cognos. Vous pouvez configurer les composants d'IBM Cognos 8 afin qu'ils utilisent une autre autorit de certification si vous disposez dj d'une autre autorit de certification, telle qu'iPlanet ou Microsoft, dans votre environnement d'excution de rapports. Lorsque vous configurez les composants d'IBM Cognos 8 afin qu'ils utilisent une autre autorit de certification, veillez indiquer les mmes informations dans l'utilitaire de ligne de commande et dans IBM Cognos Configuration. Pour configurer les composants d'IBM Cognos 8 afin qu'ils utilisent une autre autorit de certification, vous devez : crer les cls de scurit d'IBM Cognos et les demandes de signature de certificat utiliser avec l'autorit de certification, soumettre les cls de scurit d'IBM Cognos et les certificats l'autorit de certification, configurer les composants d'IBM Cognos 8 pour l'utilisation de l'autorit de certification.
Cration de cls et de demandes de signature de certificat

L'utilitaire de ligne de commande permet de crer toutes les cls pour les bibliothques de cls d'IBM Cognos et de crer les demandes de signature de certificat (CSR). Le tableau ci-dessous prsente les options de l'outil de ligne de commande utilis pour crer des cls et des demandes de signature.
Chapitre 14: Options de configuration avances
Commande
Mode de fonctionnement principal -c -i Modificateurs de fonctionnement -s -e -T Indicateurs d'informations -d -r -t -p -a
Description
Crer une nouvelle CSR Importer un certificat
Utiliser l'identit de signature Utiliser l'identit de chiffrement Utiliser la bibliothque d'approbations (uniquement avec -i)
Nom unique utiliser pour le certificat CSR ou emplacement de fichier de certificat (selon le mode) Fichier de certificat de l'autorit de certification (uniquement avec -i) Mot de passe de la bibliothque de cls (doit tre fourni) Algorithme de paire de cls. RSA ou DSA. Implicite : RSA
-D
Emplacement du rpertoire Les exemples de valeurs suivants sont utiliss :
Proprit
DN du certificat de signature DN du certificat de chiffrement Mot de passe de bibliothque de cls
Valeur
CN=SignCert,O=MaSocit,C=CA CN=EncryptCert,O=MaSocit,C=CA mot de passe
Procdure
1. Dans le rpertoire emplacement_c8\configuration, sauvegardez le fichier cogstartup.xml un emplacement sr. 2. Sauvegardez le contenu des rpertoires suivants un emplacement sr : 406
Chapitre 14: Options de configuration avances emplacement_c8\configuration\signkeypair emplacement_c8\configuration\encryptkeypair
3. Par le biais d'IBM Cognos Configuration, exportez la configuration sous la forme de texte en clair en procdant comme suit : Ouvrez IBM Cognos Configuration. Dans le menu Fichier, cliquez sur Exporter en tant que. Lorsque vous tes invit indiquer si le contenu dchiffr doit tre export, cliquez sur Oui. Dans la bote de dialogue Exportation en tant que, slectionnez cogstartup.xml, puis cliquez sur Enregistrer. Lorsque vous tes invit indiquer si le fichier existant doit tre remplac, cliquez sur Oui. Lorsque vous avez effectu ces tches, fermez la bote de dialogue IBM Cognos Configuration. Enregistrez la configuration. Fermez IBM Cognos Configuration.
4. Accdez au rpertoire emplacement_c8\bin. 5. Crez la demande de signature de certificat pour les cls de signature en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MaSocit,C=CA" -r signRequest.csr -D ../configuration/signkeypair -p mot_de_passe Sous Windows, saisissez ThirdPartyCertificateTool.bat c -s -d "CN=SignCert,O=MaSocit,C=CA" -r signRequest.csr -D ../configuration/signkeypair -p mot de passe Conseil : Les noms de fichier UNIX ou Linux sont sensibles la casse et doivent tre saisis exactement de la manire indique. Vous pouvez ignorer les avertissements relatifs la journalisation. La commande cre le fichier jSignKeystore dans le rpertoire signkeypair, dfinit le mot de passe spcifi, cre une paire de cls et la stocke dans la bibliothque de cls, puis exporte le fichier signRequest.csr dans le rpertoire emplacement_c8\bin. 6. Crez la demande de signature de certificat pour les cls de chiffrement en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MaSocit,C=CA" -r encryptRequest.csr -D ../configuration/encryptkeypair -p mot_de_passe
Chapitre 14: Options de configuration avances Sous Windows, saisissez ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MaSocit,C=CA" -r encryptRequest.csr -D ../configuration/encryptkeypair -p mot_de_passe Vous pouvez ignorer les avertissements relatifs la journalisation. La commande cre le fichier jEncKeystore dans le rpertoire encryptkeypair, dfinit le mot de passe spcifi, cre une paire de cls et la stocke dans la bibliothque de cls, puis exporte le fichier encryptRequest.csr dans le rpertoire emplacement_c8\bin. 7. Copiez les fichiers signRequest.csr et encryptRequest.csr qui ont t gnrs aux tapes 5 et 6 dans un rpertoire accessible par votre autorit de certification. 8. Entrez les fichiers signRequest.csr et encryptRequest.csr dans l'autorit de certification. L'autorit de certification tierce produit un certificat de signature et un certificat de chiffrement. Pour en savoir davantage, reportez-vous la documentation sur votre autorit de certification. 9. Copiez le contenu du certificat de signature dans le fichier signCertificate.cer. 10. Copiez le contenu du certificat de chiffrement dans le fichier encryptCertificate.cer. 11. Recherchez le certificat d'authentification racine pour l'autorit de certification et copiez le contenu dans un fichier ca.cer. 12. Copiez ca.cer, signCertificate.cer et encryptCertificate.cer dans le rpertoire emplacement_c8\bin. Ces fichiers doivent tre au format PEM (ASCII encod en base-64). 13. Importez le certificat de signature de l'tape 10 dans la bibliothque de cls de signature d'IBM Cognos en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D ../configuration/signkeypair -p mot_de_passe -t ca.cer Sous Windows, saisissez ThirdPartyCertificateTool.bat-i -s -r signCertificate.cer -D ../configuration/signkeypair -p mot_de_passe -t ca.cer Vous pouvez ignorer les avertissements relatifs la journalisation. La commande lit les fichiers signCertificate.cer et ca.cer dans le rpertoire emplacement_c8\bin et importe les certificats des deux fichiers dans le fichier jSignKeystore du rpertoire signkeypair via le mot de passe spcifi. 14. Importez le certificat de chiffrement de l'tape 11 dans la bibliothque de cls de chiffrement d'IBM Cognos en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair -p mot_de_passe -t ca.cer Sous Windows, saisissez
408
Chapitre 14: Options de configuration avances ThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair -p mot_de_passe -t cacert.cer Vous pouvez ignorer les avertissements relatifs la journalisation. La commande lit les fichiers encryptCertificate.cer et ca.cer dans le rpertoire emplacement_c8\bin et importe les certificats des deux fichiers dans le fichier jEncKeystore du rpertoire encryptkeypair via le mot de passe spcifi. 15. Importez le certificat de l'autorit de certification de l'tape 12 dans la bibliothque d'approbations d'IBM Cognos en saisissant la commande suivante : Sous UNIX ou Linux, saisissez ThirdPartyCertificateTool.sh -i -T -r ca.cer -D ../configuration/signkeypair -p mot_de_passe Sous Windows, saisissez ThirdPartyCertificateTool.bat -i -T -r ca.cer -D ../configuration/signkeypair -p mot_de_passe La commande lit le fichier ca.cer et importe le contenu dans le fichier jCAKeystore du rpertoire signkeypair via le mot de passe spcifi. Les certificats sont prts tre configurs pour IBM Cognos 8.
Configuration des composants d'IBM Cognos 8 excuter avec une autre autorit de certification
Vous devez configurer chaque ordinateur IBM Cognos pour qu'il utilise une autorit de certification externe en dfinissant la proprit approprie dans IBM Cognos Configuration. En dfinissant cette proprit, les composants d'IBM Cognos 8 partent de l'hypothse que toutes les cls requises ont t cres et testes par l'autorit de certification externe. Assurez-vous que les emplacements de bibliothque de cls et le mot de passe dans IBM Cognos Configuration correspondent ceux saisis dans l'outil de ligne de commande tiers.
Procdure
1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, Cryptographie, cliquez sur l'option IBM Cognos. 3. Dans la fentre Proprits, sous le groupe de proprits Paramtres de l'autorit de certification, cliquez sur la zone Valeur situe ct de la proprit Utiliser une autorit de certification de tierce partie, puis cliquez sur Vrai. Remarque : Lorsque vous dfinissez cette proprit sur Vrai, toutes les proprits relatives l'autorit de certification et au nom d'identit sont ignores. 4. Configurez les proprits suivantes de faon ce qu'elles correspondent celles saisies dans l'utilitaire de ligne de commande : Emplacement de la bibliothque de cls de signature Mot de passe de la bibliothque de cls de signature Guide d'installation et de configuration 409
Chapitre 14: Options de configuration avances Emplacement de la bibliothque de cls de chiffrement Mot de passe de la bibliothque de cls de chiffrement Mot de passe de la bibliothque de cls de l'autorit de certification
5. Dans le menu Fichier, cliquez sur l'option Enregistrer. 6. Pour dmarrer le service IBM Cognos 8, dans le menu Oprations, cliquez sur l'option Dmarrer. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution. Si vous souhaitez dmarrer un service spcifique, slectionnez son nud dans la fentre Explorateur et cliquez sur Dmarrer dans le menu Oprations.
410
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance

Excutez une installation et une configuration sans surveillance pour : installer une configuration identique sur plusieurs ordinateurs du rseau, automatiser le processus d'installation et de configuration en dfinissant des options et des paramtres pour les utilisateurs.
Avant de prparer une installation et une configuration sans surveillance, assurez-vous que la configuration systme requise est entirement respecte et que tous les autres produits ncessaires sont dment installs et configurs. Pour excuter une installation et une configuration sans surveillance : configurez un fichier de spcification de transfert (.ats) contenant les options d'installation, excutez l'outil d'installation en mode silencieux, utilisez un fichier de configuration prconfigur provenant d'un autre ordinateur, excutez l'outil de configuration en mode silencieux.
Une fois ces tches accomplies, vrifiez que le rpertoire d'installation d'IBM Cognos 8 sur tous les ordinateurs est protg contre tout accs non autoris ou inappropri. Vous serez alors prt utiliser IBM Cognos 8.
Excution d'une installation sans surveillance

Utilisez un fichier de spcification de transfert (.ats) pour copier les composants d'IBM Cognos 8 (y compris Framework Manager ou Metrics Designer) sur votre ordinateur sans que le systme ne vous demande de saisir des informations. Par dfaut, chaque fois que vous installez des composants d'IBM Cognos 8 l'aide de l'Assistant d'installation, les options que vous slectionnez sont enregistres dans un fichier de spcification de transfert. Par consquent, si vous avez dj install des composants d'IBM Cognos 8 sur un ordinateur, vous pouvez utiliser le fichier de spcification de transfert cr par l'installation comme modle pour des installations sans surveillance sur d'autres ordinateurs. Si vous n'utilisez pas l'Assistant d'installation pour installer des composants, vous pouvez utiliser le fichier de spcification de transfert implicite nomm response.ats, disponible sur le CD. Vous devez modifier le fichier response.ats en fonction de votre environnement avant de l'utiliser pour une installation sans surveillance.
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance Pour contrler le bon droulement de l'installation sans surveillance, vrifiez l'tat renvoy. Une valeur nulle (0) indique que l'installation s'est effectue correctement. Toute autre valeur indique qu'une erreur s'est produite.
Procdure d'utilisation d'un fichier cr par une installation prcdente

1. Utilisez l'Assistant d'installation pour installer les composants d'IBM Cognos 8 sur votre ordinateur. 2. Ouvrez le rpertoire emplacement_c8/instlog. 3. Localisez le fichier de spcification de transfert (.ats) cr : Si vous avez install Framework Manager, le nom de fichier est ts-C8BIMODEL-version-aaaammjj_hhmm.ats. Si vous avez install IBM Cognos 8 pour la cration de rapports, le nom de fichier est ts-produit_cognos_IBM-version-aaaammjj_hhmm.ats. Si vous avez install Metric Studio, le nom de fichier est ts-CMM-version-aaaammjj_hhmm.ats. Si vous avez install Metric Designer, le nom de fichier est ts-CMD-version-yyyymmdd_hhmm.ats.
4. Copiez le fichier de spcification de transfert sur l'ordinateur o vous prvoyez d'installer IBM Cognos 8. 5. Sur l'ordinateur o vous prvoyez d'installer le logiciel, insrez le CD appropri dans le lecteur et copiez son contenu sur le disque dur. 6. Installez IBM Cognos 8 : Sous Windows, ouvrez une fentre Invite de commandes, pointez sur le rpertoire win32 dans lequel vous avez copi le contenu du CD, puis saisissez la commande suivante, dans laquelle emplacement est le rpertoire dans lequel vous avez copi nom_fichier, le fichier de spcification de transfert : issetup -s location/filename.ats Sous UNIX ou Linux, pointez sur le rpertoire dans lequel vous avez copi le contenu du CD, puis saisissez la commande suivante dans le rpertoire de votre systme d'exploitation, dans laquelle emplacement est le rpertoire dans lequel vous avez copi nom_fichier, le fichier de spcification de transfert : Avec XWindows, saisissez issetup -s location/filename.ats Sans XWindows, saisissez issetupcc -s location/filename.ats Si l'tat renvoy est diffrent de zro (0), vrifiez les messages d'erreur des fichiers de journalisation. Les erreurs sont consignes dans le fichier suivant, situ dans le rpertoire d'installation :
412
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance Pour Framework Manager, le nom de fichier est tl-C8BIMODEL-version-aaaammjj-hhmm_summary-error.txt. Pour les composants du serveur d'excution de rapports d'IBM Cognos 8, le nom de fichier est tl-produit_Cognos_IBM-version-aaaammjj-hhmm_summary-error.txt. Pour les composants de Metric Studio, le nom de fichier est tl-CMM-version-aaaammjj-hhmm_summary-error.txt. Pour Metric Designer, le nom de fichier est tl-CMD-version-aaaammjj-hhmm_summary-error.txt.
Si des erreurs se produisent avant que l'initialisation soit suffisamment avance, des messages de journalisation sont achemins vers l'un des fichiers journaux suivants dans le rpertoire Temp : Pour Framework Manager, le nom de fichier est tl-C8BIMODEL-version-aaaammjj-hhmm.txt. Pour les composants d'excution de rapports d'IBM Cognos 8, le nom de fichier est tl-produit_Cognos_IBM-version-aaaammjj-hhmm.txt. Pour les composants de Metric Studio, le nom de fichier est tl-CMM-version-aaaammjj-hhmm_summary-error.txt. Pour Metric Designer, le nom de fichier est tl-CMD-version-aaaammjj-hhmm_summary-error.txt.
Veillez galement ce que le rpertoire d'installation soit protg contre tout accs non autoris ou inappropri. Lorsque toutes les erreurs sont rsolues, vous pouvez procder une configuration sans surveillance.
Procdure d'utilisation du fichier response.ats

1. Sur l'ordinateur cible, insrez le CD dans le lecteur et copiez-en le contenu sur le disque dur. 2. Ouvrez le rpertoire win32, puis ouvrez le fichier response.ats dans un diteur de texte. Chaque section du fichier response.ats correspond une bote de dialogue de l'Assistant d'installation. 3. Indiquez l'emplacement d'installation des fichiers programmes d'IBM Cognos 8 dans APPDIR=emplacement. Conseil : Il ne doit y avoir aucun espace de part et d'autre du signe gal (=). 4. Pour les composants serveur d'IBM Cognos 8, dans la section nomme [Component List], en regard de chaque composant : pour installer le composant, saisissez 1, pour ne pas installer le composant, saisissez 0.
Remarque : Vous ne slectionnez pas de composants pour Framework Manager, ni pour Metric Designer. Tous les fichiers requis sont installs. 5. Dans le cas d'une installation Windows, pour la proprit APPFOLDER=, saisissez le nom du dossier du menu Dmarrer qui contient les raccourcis de vos programmes.
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance Conseil : Afin de vous assurer que le dossier des raccourcis est visible pour tous les utilisateurs, saisissez 1 pour la proprit ALLUSERS_FLAG=. 6. Pour les informations d'installation, dans la section [Install Conditions] : pour indiquer que la condition est vraie, saisissez 1, pour indiquer que la condition est fausse, saisissez 0.
7. Aprs avoir apport les changements ncessaires au fichier response.ats, enregistrez-le dans un rpertoire local. 8. Ouvrez le rpertoire win32. 9. l'invite de commande, saisissez la commande suivante, o emplacement correspond au rpertoire dans lequel vous avez copi le fichier response.ats : Sous Windows, UNIX avec XWindows et Linux, saisissez issetup -s emplacement/response.ats Sous UNIX sans XWindows, saisissez issetupcc -s emplacement/response.ats Si l'tat renvoy est diffrent de zro (0), vrifiez les messages d'erreur des fichiers de journalisation. Les erreurs sont consignes dans le fichier suivant, situ dans le rpertoire d'installation : Pour Framework Manager, le nom de fichier est tl-C8BIMODEL-version-aaaammjj-hhmm_summary-error.txt. Pour les composants du serveur d'excution de rapports d'IBM Cognos 8, le nom de fichier est tl-produit_Cognos_IBM-version-aaaammjj-hhmm_summary-error.txt. Pour les composants de Metric Studio, le nom de fichier est tl-CMM-version-aaaammjj-hhmm_summary-error.txt. Pour Metric Designer, le nom de fichier est tl-CMD-version-aaaammjj-hhmm_summary-error.txt.
Si des erreurs se produisent avant que l'initialisation soit suffisamment avance, des messages de journalisation sont achemins vers l'un des fichiers journaux suivants dans le rpertoire Temp : Pour Framework Manager, le nom de fichier est tl-C8BIMODEL-version-aaaammjj-hhmm.txt. Pour les composants d'excution de rapports d'IBM Cognos 8, le nom de fichier est tl-produit_Cognos_IBM-version-aaaammjj-hhmm.txt. Pour les composants de Metric Studio, le nom de fichier est tl-CMM-version-aaaammjj-hhmm_summary-error.txt. Pour Metric Designer, le nom de fichier est tl-CMD-version-aaaammjj-hhmm_summary-error.txt.
Veillez galement ce que le rpertoire d'installation soit protg contre tout accs non autoris ou inappropri. Une fois toutes les erreurs rsolues, vous pouvez excuter une configuration sans surveillance.
414
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance
Excution d'une configuration sans surveillance

Avant d'excuter une configuration sans surveillance, vous devez exporter une configuration partir d'un autre ordinateur, sur lequel sont installs les mmes composants d'IBM Cognos 8. Vous pouvez ensuite excuter IBM Cognos Configuration en mode silencieux. La configuration exporte contient les proprits des composants d'IBM Cognos 8 que vous avez installs sur l'ordinateur source. Si vous avez modifi la configuration globale, vous devez galement copier le fichier de configuration globale de l'ordinateur source sur l'ordinateur sur lequel vous prvoyez d'excuter une configuration sans surveillance. La configuration globale comporte des paramtres tels que les paramtres rgionaux du contenu, la langue du produit et les paramtres de monnaies, polices et cookies (tmoins). Pour en savoir davantage, reportez-vous la section "Modification des paramtres globaux" (p. 338). Assurez-vous que les paramtres de configuration de l'ordinateur local sont appropris pour configurer un autre ordinateur IBM Cognos 8 sur lequel les mmes composants sont installs. Par exemple, si vous avez remplac la portion de nom d'hte, local host, de la proprit URI de la passerelle par une adresse IP ou un nom d'ordinateur, assurez-vous que ce paramtre convient pour la configuration du nouvel ordinateur. Pour contrler le bon droulement de la configuration sans surveillance, vrifiez l'tat renvoy. Une valeur nulle (0) indique que l'installation s'est effectue correctement. Toute autre valeur indique qu'une erreur s'est produite.
Procdure
1. Dans IBM Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que. 2. Si vous voulez exporter la configuration actuelle vers un autre dossier, dans la zone Rechercher dans, localisez et ouvrez le dossier. Veillez ce que le dossier soit protg contre tout accs non autoris ou inappropri. 3. Dans la zone Nom de fichier, saisissez un nom pour le fichier de configuration. 4. Cliquez sur le bouton Enregistrer. 5. Copiez le fichier de configuration export de l'ordinateur source ou de l'emplacement de rseau vers le rpertoire emplacement_c8/configuration de l'ordinateur o vous prvoyez d'effectuer la configuration sans surveillance. 6. Renommez le fichier cogstartup.xml. 7. Si vous avez modifi la configuration globale sur l'ordinateur source, copiez le fichier coglocale.xml de l'ordinateur source dans le rpertoire emplacement_c8/configuration de l'ordinateur sur lequel vous prvoyez d'effectuer la configuration sans surveillance. 8. Ouvrez le rpertoire emplacement_c8/bin. 9. Saisissez la commande de configuration : Sous UNIX ou Linux, saisissez
Chapitre 15: Excution d'une installation et d'une configuration sans surveillance ./cogconfig.sh -s Sous Windows, saisissez cogconfig.bat -s Conseil : Pour consulter les messages de journalisation crs au cours d'une configuration sans surveillance, ouvrez le fichier cogconfig_response.csv situ dans le rpertoire emplacement_c8/logs. IBM Cognos Configuration applique les paramtres de configuration spcifis dans la copie locale du fichier cogstartup.xml, chiffre les rfrences d'identification, cre des certificats numriques et, le cas chant, dmarre un service ou processus IBM Cognos 8.
416
Chapitre 16: Gestion des performances

Cette section inclut des rubriques relatives l'utilisation d'IBM Cognos et d'autres outils et indicateurs pour la gestion des performances de votre environnement IBM Cognos 8.
Indicateurs de performances du systme

IBM Cognos 8 fournit des indicateurs systme permettant de contrler l'tat du systme global et de chaque serveur, distributeur et service. Vous pouvez galement dfinir les seuils des scores d'indicateurs. Les indicateurs de performances du systme incluent par exemple le nombre de sessions de votre systme, la dure pendant laquelle un rapport est rest en file d'attente, la dure d'excution d'un composant JVM (Java Virtual Machine) et le nombre de demandes et processus du systme. Les indicateurs de performances du systme sont disponibles dans IBM Cognos Administration, accessible partir d'IBM Cognos Connection. Pour en savoir davantage sur l'utilisation des indicateurs de performances du systme, reportez-vous au Guide d'administration et de scurit. L'une des nouvelles fonctionnalits consiste prendre une photo des indicateurs systme en cours, ce qui vous permet de suivre les tendances au fil du temps ou de consulter les dtails relatifs l'tat du systme un moment prcis. Pour en savoir davantage, reportez-vous la rubrique relative au fichier de vidage des indicateurs, dans le chapitre Dpannage du Guide d'administration et de scurit.
Activation des services requis uniquement

Si certains services IBM Cognos 8 ne sont pas ncessaires dans votre environnement, vous pouvez les dsactiver afin d'optimiser les performances des autres services. Par exemple, pour ddier un ordinateur l'excution et la diffusion de rapports, vous pouvez dsactiver le service de prsentation sur un serveur de rapports. Lorsque vous dsactivez le service de prsentation, les performances du serveur de rapports sont amliores. Remarques : Le service de prsentation doit rester activ sur au moins un ordinateur de votre environnement IBM Cognos 8. Si vous souhaitez utiliser Query Studio, vous devez activer le service de prsentation. Si vous souhaitez utiliser Analysis Studio, vous devez activer le service de production de rapports. Si certains composants d'IBM Cognos 8 ne sont pas installs sur un ordinateur, il est prfrable de dsactiver les services associs ces composants manquants. Si vous ne les dsactivez pas, les composants d'IBM Cognos 8 risquent de subir des interruptions alatoires.
Services IBM Cognos 8

Aprs l'installation et la configuration d'IBM Cognos 8, un distributeur est disponible par dfaut sur chaque ordinateur. Chaque distributeur est associ un ensemble de services, prsents dans le tableau ci-dessous.
Service
Service d'agent
Fonction
Excute des agents. Si les conditions d'un agent sont remplies lorsque l'agent est excut, le service d'agent demande au service de suivi d'excuter les tches. Gre les demandes en arrire-plan concernant l'excution de rapports et fournit des versions de sortie des rapports pour le compte du service de suivi. Excute des fonctions de manipulation d'objets dans Content Store (par exemple, ajout, requte, mise jour, suppression, dplacement et copie). Met galement en uvre des fonctions de gestion de Content Store, telles que l'importation et l'exportation.
Service de production de rapports par lots
Service Content Manager
Service de transfert de donnes
Gre l'excution des tches de transfert de donnes dans IBM Cognos 8. Les tches de mouvement de donnes, telles que Builds et JobStreams, sont cres dans Data Manager Designer et publies dans IBM Cognos 8. Envoie des courriers lectroniques un serveur SMTP externe pour le compte d'autres services, tels que le service de production de rapports, le service de travail, le service d'agent ou le service d'intgration de donnes.
Service de diffusion
418
Service
Service de gestion des vnements
Fonction
Cre, programme et gre des objets d'vnements reprsentant des rapports, des travaux, des agents, la mise jour de Content Store, des importations et exportations de dploiement et des indicateurs. Excute des travaux en indiquant au service de suivi qu'il doit excuter les tches en arrire-plan. Les tches incluent notamment des rapports, d'autres travaux, des importations et des exportations. Enregistre les messages de journalisation gnrs par le distributeur et par d'autres services. Le service de journalisation peut tre configur pour enregistrer les informations de journalisation dans un fichier, une base de donnes, un serveur de journalisation distant, le journal des vnements Windows ou un journal systme UNIX. Les informations de journalisation peuvent ensuite tre analyses par les clients ou par Cognos Software Services. Elles incluent : les vnements lis la scurit, les informations sur les erreurs des applications et du systme, les informations de diagnostic slectionnes.
Service de travail
Service de journalisation
Service Metric Studio
Fournit l'interface utilisateur Metric Studio pour le suivi et la saisie des informations sur les performances. Gre la migration entre IBM Cognos Series 7 et IBM Cognos 8.
Service de migration
Service
Service de suivi
Fonction
Gre le suivi et l'excution des tches qui sont programmes, soumises pour une excution ultrieure ou excutes en arrire-plan. Affecte un service cible pour le traitement d'une tche programme. Par exemple, le service de suivi peut demander au service de production de rapports par lots d'excuter un rapport, au service de travail d'excuter un travail ou au service d'agent d'excuter un agent. Cre des objets d'historique dans Content Manager et gre les oprations de reprise et de rcupration lies l'excution des entres. Convertit les rponses XML gnriques provenant d'un autre service dans un format de sortie, tel que HTML ou PDF. Fournit des fonctions d'affichage, de navigation et d'administration dans IBM Cognos Connection.
Service de prsentation
Service de donnes de production de rapports
Gre le transfert des donnes de rapport entre Cognos 8 et les applications qui les exploitent, notamment IBM Cognos 8 Go! Office et IBM Cognos 8 Go! Mobile.
420
Service
Service de production de rapports
Fonction
Gre les demandes interactives concernant l'excution de rapports et fournit des sorties de rapports un utilisateur d'IBM Cognos Connection ou d'un studio. Dfinit le service compatible avec l'API BI Bus utilis pour obtenir les paramtres de configuration d'IBM Cognos 8 pour l'ensemble de l'application. Il fournit galement des mthodes permettant de normaliser et de valider les chanes de paramtres rgionaux et de les mettre en correspondance avec les paramtres rgionaux pris en charge par votre application.
Service du systme
Mise au point d'un Content Store DB2

Si vous utilisez une base de donnes DB2 pour Content Store (p. 63), vous pouvez effectuer la procdure permettant d'acclrer le traitement des requtes. Par dfaut, DB2 attribue des tables qui contiennent des LOBS (large objects) un espace de table gr par une base de donnes. Ainsi, les LOBS ne sont pas grs par les groupes de mmoire tampon DB2. Ce qui entrane des requtes E/S directes sur les LOBS, ce qui a une incidence sur les performances. En rattribuant les tables qui contiennent des LOBS un espace de table gr par une base de donnes, vous rduisez le nombre de requtes E/S directes. Avant de modifier un Content Store DB2, allouez un espace de journalisation suffisant pour restructurer la base de donnes. Pour reconfigurer le Content Store DB2, procdez comme suit : Exportez les donnes partir des tables qui contiennent au moins un LOB (large object). Crez les tables dans un espace de table gr par le systme. Importez les donnes dans les tables.
Mise au point des paramtres Apache Tomcat

Si vous utilisez Apache Tomcat, vous pouvez modifier ses paramtres pour amliorer les performances.
Chapitre 16: Gestion des performances Vous pouvez modifier les paramtres maxProcessor et acceptCount dans le fichier server.xml.
Procdure
1. Ouvrez le fichier server.xml. 2. Modifiez les paramtres qui figurent aprs le commentaire ci-dessous :

Recherchez la ligne suivante :

maxProcessors="75"
et remplacez-la par la suivante :

maxProcessors="1000"
3. Recherchez la ligne suivante :

acceptCount="100"

acceptCount="500"
4. Enregistrez le fichier server.xml mis jour.
Augmentation de la capacit de traitement des demandes pour la base de donnes de contenu d'IBM Cognos
La base de donnes de contenu d'IBM Cognos est configure pour un petit systme. Si vous l'utilisez dans le cadre d'un grand systme, pour lequel le nombre de demandes simultanes est suprieur dix, vous devez ajuster les paramtres de mmoire JVM implicites et augmenter la taille de l'antmmoire de pages de la base de donnes Derby.
Procdure
1. Dans le rpertoire emplacement_c8\bin, ouvrez le fichier derby.sh. 2. Recherchez la ligne suivante :
MEM_SETTINGS=-Xmx256m

MEM_SETTINGS="-Xmx1152m -XX:MaxPermSize=128M -XX:MaxNewSize=576m-XX: NewSize=288m"
3. Dans le rpertoire emplacement_c8\configuration, renommez derby.properties.sample en derby.properties. 4. Dans le mme rpertoire, ouvrez le fichier derby.properties. 5. Ajoutez un commentaire la ligne suivante :
derby.storage.pageCacheSize=15000
422
Amlioration des performances de la bibliothque d'indicateurs

IBM Cognos 8 offre un script nomm cmm_update_stats qui met jour les index de votre base de donnes et amliore ainsi ses performances. En rgle gnrale, ce script est utilis avant ou aprs un chargement lorsque la quantit ou la rpartition des donnes change de faon significative. Par exemple, vous pouvez peut-tre amliorer les performance si vous excutez ce script lorsque le nombre de tableaux de bord passe de 100 1 000.
Procdure
1. Assurez-vous que la bibliothque d'indicateurs n'est pas en cours d'utilisation. 2. Ouvrez le rpertoire suivant : emplacement_c8\configuration\schemas\cmm 3. Ouvrez le rpertoire de base de donnes appropri. 4. Selon le type de base de donnes, excutez l'un des scripts suivants partir de la ligne de commande : Pour Microsoft SQL Server ou DB2 : cmm_update_stats nom_hte nom_bibliothque_indicateurs nom_utilisateur_Admin mot_de_passe Pour Oracle : cmm_update_stats nom_bibliothque_indicateurs nom_utilisateur_Admin mot_de_passe
Rduction du dlai de diffusion pour les rapports sur un rseau

Les rapports diffuss globalement sont plus longs ouvrir dans les emplacements distants qu'en local. En outre, les rapports HTML sont plus longs ouvrir que les rapports PDF, car le nombre de requtes traiter est suprieur. Il existe deux faons de rduire le dlai d'ouverture des rapports dans les emplacements distants. Vous pouvez diminuer le nombre de requtes entre le navigateur et le serveur en excutant le rapport au format PDF. Si des rapports HTML sont requis, vous pouvez acclrer la livraison du rapport en configurant des passerelles supplmentaires dans certains emplacements distants. Le contenu statique tel que les images et les feuilles de style sera diffus plus rapidement.
Augmentation du dlai d'attente asynchrone dans les environnements forte charge utilisateur
Si vous disposez d'un environnement forte charge utilisateur (plus de 165 utilisateurs) et que des rapports interactifs s'excutent en continu dans une installation rpartie, vous pouvez augmenter le paramtre de dlai asynchrone afin de ne plus recevoir de messages d'erreurs.La valeur implicite est 30000.
Chapitre 16: Gestion des performances Vous pouvez galement dfinir le paramtre de dlai maximal de la file d'attente sur 360. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8. Pour rsoudre ce problme :
Procdure
1. Ouvrez le rpertoire suivant : emplacement_c8webapps/p2pd/WEB-INF/services/. 2. Ouvrez le fichier reportservice.xml dans un diteur de texte. 3. Dfinissez le paramtre async_wait_timeout_ms sur 120000. 4. Enregistrez le fichier. 5. Redmarrez le service.
424
Annexe A: Configuration manuelle d'IBM Cognos 8

La console connecte l'ordinateur UNIX ou Linux sur lequel vous installez IBM Cognos 8 ne prend peut-tre pas en charge les interfaces graphiques utilisateur de type Java. Vous devez effectuer manuellement les tches suivantes : Modifier manuellement les paramtres de configuration implicites en modifiant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8/configuration, Modifier manuellement les langues ou les monnaies prises en charge ou les correspondances des paramtres rgionaux en modifiant le fichier coglocale.xml situ dans le rpertoire emplacement_c8/configuration, Appliquer la configuration et les paramtres rgionaux l'ordinateur en dmarrant les services IBM Cognos 8 en mode silencieux, Dployer IBM Cognos 8 dans un environnement de serveur d'application en crant manuellement un fichier d'application d'IBM Cognos.
Pour toutes les installations, certaines tches de configuration sont ncessaires pour qu'IBM Cognos 8 puisse fonctionner dans votre environnement. Si vous rpartissez des composants d'IBM Cognos 8 sur plusieurs ordinateurs, l'ordre dans lequel vous configurez et dmarrez les ordinateurs est important. D'autres tches de configuration sont facultatives et dpendent de votre environnement d'excution de rapports. Vous pouvez changer le comportement implicite d'IBM Cognos 8 en modifiant le fichier cogstartup.xml afin de changer les valeurs de proprits. Vous pouvez galement utiliser des exemples de fichiers permettant IBM Cognos 8 d'utiliser des ressources existantes de votre environnement.
Configuration manuelle d'IBM Cognos 8 sous UNIX et Linux

La console connecte l'ordinateur UNIX ou Linux sur lequel vous installez IBM Cognos 8 ne prend peut-tre pas en charge les interfaces graphiques utilisateur de type Java. Vous devez effectuer ce qui suit : modifier manuellement les paramtres de configuration implicites en modifiant le fichier cogstartup.xml situ dans le rpertoire emplacement_c8/configuration, modifier manuellement les langues ou les monnaies prises en charge ou les correspondances des paramtres rgionaux en modifiant le fichier coglocale.xml situ dans le rpertoire emplacement_c8/configuration, appliquer la configuration et les paramtres rgionaux l'ordinateur en excutant IBM Cognos Configuration en mode silencieux.
Annexe A: Configuration manuelle d'IBM Cognos 8 Pour toutes les installations, certaines tches de configuration sont ncessaires pour qu'IBM Cognos 8 puisse fonctionner dans votre environnement. Si vous rpartissez des composants d'IBM Cognos 8 sur plusieurs ordinateurs, l'ordre dans lequel vous configurez et dmarrez les ordinateurs est important. D'autres tches de configuration sont facultatives et dpendent de votre environnement d'excution de rapports. Vous pouvez changer le comportement implicite d'IBM Cognos 8 en modifiant le fichier cogstartup.xml afin de changer les valeurs de proprits. Vous pouvez galement utiliser des exemples de fichiers permettant IBM Cognos 8 d'utiliser des ressources existantes de votre environnement.
Modification manuelle des paramtres de configuration implicites sur les ordinateurs UNIX et Linux
Si la console connecte l'ordinateur UNIX ou Linux ne prend pas en charge les interfaces graphiques utilisateur de type Java, vous devez modifier le fichier cogstartup.xml afin de configurer IBM Cognos 8 pour qu'il fonctionne dans votre environnement. Remarque : Si vous n'utilisez pas l'interface graphique utilisateur, certains paramtres de configuration ne sont pas enregistrs dans le fichier cogstartup.xml. Par exemple, le fuseau horaire du serveur n'est pas dfini pour vos composants d'IBM Cognos lorsque vous modifiez le fichier cogstartup.xml directement et que vous excutez IBM Cognos Configuration en mode silencieux. Dans ce cas, les paramtres des autres utilisateurs qui utilisent le fuseau horaire du serveur peuvent ne pas fonctionner comme prvu. Si vous souhaitez qu'IBM Cognos 8 utilise une ressource, telle qu'un fournisseur d'authentification existant dans votre environnement, vous pouvez ajouter un composant votre configuration. Pour ce faire, copiez le code XML requis des exemples de fichiers vers le fichier cogstartup.xml, puis modifiez les valeurs en fonction de l'environnement. Important : Par dfaut, le fichier cogstartup.xml est encod au format UTF-8. Lorsque vous enregistrez le fichier cogstartup.xml, veillez modifier l'encodage des paramtres rgionaux de l'utilisateur afin qu'ils correspondent l'encodage utilis. L'encodage des paramtres rgionaux de l'utilisateur est dfini par les variables d'environnement. Avant de modifier le fichier cogstartup.xml, n'oubliez pas que le code XML est sensible la casse. La casse est importante dans toutes les sections de texte, notamment les libells d'lments et d'attributs, les lments et les valeurs. Avant de modifier le fichier cogstartup.xml, veillez : faire une copie de sauvegarde, crer la base de donnes Content Store sur un ordinateur disponible de votre rseau, passer en revue la configuration requise pour votre type d'installation.
Procdure
1. Accdez au rpertoire emplacement_c8/configuration. 2. Ouvrez le fichier cogstartup.xml dans un diteur.
426
Annexe A: Configuration manuelle d'IBM Cognos 8 3. Identifiez le paramtre de configuration que vous voulez modifier en consultant l'aide et les commentaires de descriptifs qui se trouvent devant la balise de dbut des lments <crn:parameter> . 4. Modifiez la valeur de l'lment <crn:value> pour qu'il soit conforme votre environnement. Conseil : Utilisez l'attribut type pour dterminer le type de donnes de la proprit de configuration. 5. Rptez les tches 3 et 4 jusqu' ce que les valeurs de configuration soient adaptes votre environnement. 6. Enregistrez et fermez le fichier. Vous devez prsent utiliser un diteur XML de validation afin de valider les modifications par rapport aux rgles inscrites dans le fichier cogstartup.xsd situ dans le rpertoire emplacement_c8/configuration.
Ajout d'un composant la configuration

Le fichier cogstartup.xml contient les paramtres de configuration utiliss par IBM Cognos 8 et par les composants implicites. Vous pouvez modifier les composants utiliss par IBM Cognos 8 en copiant des lments XML d'exemples de fichiers dans le fichier cogstartup.xml. Vous pouvez ensuite modifier les valeurs de configuration afin de les adapter votre environnement. Par exemple, pour utiliser une base de donnes Oracle plutt qu'une base de donnes Microsoft SQL Server en tant que Content Store, vous pouvez utiliser l'exemple de fichier ContentManager_code_de_langue.xml afin de remplacer les informations implicites de connexion la base de donnes. IBM Cognos 8 ne peut utiliser qu'une seule instance la fois des lments ci-dessous: la base de donnes Content Store, un fournisseur cryptographique, un modle de configuration pour le service IBM Cognos 8.
Avant de commencer modifier des fichiers XML, vous devez en connatre la structure.
Procdure
1. Accdez au rpertoire emplacement_c8/configuration/samples. 2. Choisissez un exemple de fichier et ouvrez-le dans un diteur : Si vous souhaitez utiliser Oracle, DB2 ou Sybase en tant que Content Store, ouvrez le fichier ContentManager_code_de_langue.xml. Si vous souhaitez utiliser un fournisseur d'authentification, ouvrez le fichier Authentication_code_de_langue.xml. Si vous souhaitez utiliser un fournisseur cryptographique, ouvrez le fichier Cryptography_code_de_langue.xml.
Annexe A: Configuration manuelle d'IBM Cognos 8 Si vous souhaitez consigner les messages ailleurs que dans un fichier, ouvrez le fichier Logging_code_de_langue.xml. Si vous souhaitez utiliser un modle de taille moyenne ou grande pour la quantit de ressources utilise par le processus IBM Cognos 8, ouvrez le fichier CognosService_code_de_langue.xml.
3. Copiez les lments dont vous avez besoin. Conseil : Veillez copier le code en incluant les balises de dbut et de fin de l'lment <crn:instance>. Par exemple, recherchez les commentaires (Begin of) et (End of) :

4. Accdez au rpertoire emplacement_c8/configuration. 5. Ouvrez le fichier cogstartup.xml dans un diteur. 6. Collez le code de l'exemple de fichier dans le fichier cogstartup.xml en remplaant l'lment <crn:instance> appropri. 7. Modifiez les valeurs de ces nouveaux lments afin de les adapter votre environnement. Ne modifiez pas l'attribut de classe de l'lment <crn:instance>.Vous pouvez modifier l'attribut de nom afin de l'adapter votre environnement. Par exemple, si vous utilisez une base de donnes Oracle comme Content Store, modifiez uniquement l'attribut de nom pour l'adapter votre environnement.
<crn:instance class="Oracle" name="MyContentStore">
8. Enregistrez et fermez le fichier. 9. Excutez IBM Cognos Configuration en mode silencieux en saisissant la commande suivante : ./cogconfig.sh -s Cela garantit la validit du fichier et le chiffrement des mots de passe.
Modification manuelle des paramtres chiffrs

Il est possible de modifier manuellement les paramtres chiffrs, tels que les mots de passe ou les rfrences de l'utilisateur, dans le fichier cogstartup.xml. Pour demander IBM Cognos Configuration d'enregistrer un paramtre chiffr, vous devez modifier la valeur, puis dfinir l'indicateur de chiffrement sur Faux.
Procdure
1. Accdez au rpertoire emplacement_c8/configuration. 2. Ouvrez le fichier cogstartup.xml dans un diteur.
428
Annexe A: Configuration manuelle d'IBM Cognos 8 3. Identifiez le paramtre chiffr que vous voulez modifier en consultant l'aide et les commentaires de descriptifs qui se trouvent devant la balise de dbut des lments <crn:parameter>. 4. Modifiez la valeur de l'lment <crn:value> pour qu'il soit conforme votre environnement. Conseil : Utilisez l'attribut type pour dterminer le type de donnes de la proprit de configuration. 5. Faites passer la valeur de chiffrement Faux. Par exemple :
<crn:value encrypted="false">
6. Rptez les tches 3 5 jusqu' ce que les valeurs de configuration soient adaptes votre environnement. 7. Enregistrez et fermez le fichier. 8. Saisissez la commande de configuration suivante : ./cogconfig.sh -s Les nouveaux paramtres sont enregistrs et chiffrs.
Modification manuelle des paramtres globaux sur les ordinateurs UNIX et Linux
Si la console connecte l'ordinateur UNIX ou Linux ne prend pas en charge les interfaces graphiques utilisateur de type Java, vous devez modifier manuellement le fichier coglocale.xml situ dans le rpertoire emplacement_c8/configuration. Vous pouvez modifier les paramtres globaux : pour prciser la langue utilise dans l'interface utilisateur lorsque celle spcifie dans les paramtres rgionaux de l'utilisateur n'est pas disponible, pour prciser les paramtres rgionaux utiliss dans les rapports lorsque ceux de l'utilisateur ne sont pas disponibles, pour ajouter une prise en charge de monnaie ou de paramtres rgionaux aux donnes du rapport ou aux mtadonnes, pour ajouter une prise en charge linguistique l'interface utilisateur,
Par dfaut, les composants d'IBM Cognos Series 8 appliquent une forme normalise tous les paramtres rgionaux, qui peuvent provenir de diffrentes sources et se prsenter sous divers formats. Cela signifie que tous les paramtres rgionaux tendus sont conformes une dfinition de langue et de code rgional. Pour pouvoir ajouter la prise en charge d'une langue l'interface utilisateur, vous devez installer les fichiers linguistiques sur tous les ordinateurs de l'installation rpartie. Pour en savoir davantage, contactez le responsable du support technique d'IBM Cognos.
Exemple 1
Un rapport est disponible dans Content Manager dans deux langues rgionales, telles que en-us (anglais des tats-Unis) et fr-fr (franais de France), mais les paramtres rgionaux de l'utilisateur sont dfinis sur fr-ca (franais du Canada). IBM Cognos 8 utilise les correspondances de paramtres rgionaux pour dterminer le rapport afficher pour l'utilisateur. Tout d'abord, IBM Cognos 8 vrifie dans Content Manager si le rapport est disponible dans la langue des paramtres rgionaux de l'utilisateur. Si tel n'est pas le cas, IBM Cognos 8 met en correspondance les paramtres rgionaux de l'utilisateur avec des paramtres rgionaux normaliss configurs dans l'onglet Correspondances des paramtres rgionaux (contenu). La langue des paramtres rgionaux de l'utilisateur tant fr-ca, la correspondance est tablie avec fr. IBM Cognos 8 utilise la valeur de correspondance pour vrifier si le rapport est disponible en fr. Dans le cas prsent, le rapport est disponible en en-us et en fr-fr, mais pas en fr. Ensuite, IBM Cognos 8 met en correspondance les rapports disponibles avec des paramtres rgionaux normaliss. Ainsi, en-us devient en et fr-fr devient fr. Du fait que tant le rapport que les paramtres rgionaux de l'utilisateur sont mis en correspondance avec fr, l'utilisateur dont les paramtres rgionaux indiquent la langue fr-ca voit s'afficher le rapport en fr-fr.
Exemple 2
Les paramtres rgionaux de l'utilisateur et ceux du rapport correspondent la mme langue.IBM Cognos 8 slectionne les paramtres rgionaux utiliser. Par exemple, si les paramtres rgionaux d'un utilisateur indiquent la langue en-ca (anglais du Canada) et que les rapports sont disponibles en en-us (anglais des tats-Unis) et en-gb (anglais du Royaume-Uni), IBM Cognos 8 met en correspondance chaque paramtre rgional avec en.L'utilisateur visualise le rapport conformment aux paramtres rgionaux choisis par IBM Cognos 8.
Exemple 3
Les paramtres rgionaux du rapport et ceux de l'utilisateur ne sont pas mis en correspondance avec une langue commune. IBM Cognos 8 slectionne la langue. Dans ce cas, il peut s'avrer ncessaire de configurer la mise en correspondance. Par exemple, si un rapport est disponible en en-us (anglais des tats-Unis) et fr-fr (franais de France), tandis que les paramtres rgionaux de l'utilisateur indiquent la langue es-es (espagnol d'Espagne), IBM Cognos 8 slectionne la langue.
Procdure
1. Sur chaque ordinateur o vous avez install Content Manager, ouvrez le rpertoire emplacement_c8/configuration. 2. Ouvrez le fichier coglocale.xml dans un diteur. 3. Ajoutez ou modifiez l'lment et l'attribut requis entre les balises de dbut et de fin.
Type d'lment
Langue
Balise de dbut
<supportedProductLocales>
Balise de fin
</supportedProductLocales>
430
Type d'lment
Paramtres rgionaux (contenu) Monnaie Correspondance des paramtres rgionaux Correspondance des paramtres rgionaux (contenu) Polices
Balise de dbut
<supportedContentLocales>
Balise de fin
</supportedContentLocales>
<supportedCurrencies> <productLocaleMap>
</supportedCurrencies> </productLocaleMap>
<contentLocaleMap>
</contentLocaleMap>
<supportedFonts>
</supportedFonts> </parameter>
Paramtres de tmoin <parameter name="setting"> (cookie), emplacement d'archives des rapports
Conseil : Pour supprimer une prise en charge, supprimez l'lment. 4. Enregistrez et fermez le fichier. Conseil : Nous vous recommandons d'utiliser un diteur XML pour valider les modifications par rapport aux rgles du fichier cogstartup.xsd, situ dans le rpertoire emplacement_c8/configuration. Si vous ajoutez un code de monnaie qui n'est pas pris en charge, vous devez l'ajouter manuellement au fichier i18n_res.xml dans le rpertoire emplacement_c8/bin/. Copiez ce fichier sur chaque ordinateur IBM Cognos de votre installation.
Dmarrage et arrt d'IBM Cognos 8 en mode silencieux sur des ordinateurs UNIX et Linux
Vous excutez IBM Cognos Configuration en mode silencieux pour appliquer les paramtres de configuration et dmarrer les services sur des ordinateurs UNIX ou Linux qui ne prennent pas en charge une interface utilisateur graphique base sur Java. Avant d'excuter l'outil de configuration en mode silencieux, vous devez vous assurer que le fichier cogstartup.xml est valide, conformment aux rgles dfinies dans le fichier cogstartup.xsd. Le fichier cogstartup.xsd se trouve dans le rpertoire emplacement_c8\configuration.
Procdure de dmarrage d'IBM Cognos 8

1. Assurez-vous que le fichier cogstartup.xml, situ dans le rpertoire emplacement_c8/configuration, a t modifi en fonction de votre environnement. Pour en savoir davantage, reportez-vous la section "Modification manuelle des paramtres de configuration implicites sur les ordinateurs UNIX et Linux" (p. 426).
Annexe A: Configuration manuelle d'IBM Cognos 8 2. Accdez au rpertoire emplacement_c8/bin. 3. Saisissez la commande suivante : ./cogconfig.sh -s Conseil : Pour consulter les messages de journalisation crs au cours d'une configuration sans surveillance, ouvrez le fichier cogconfig_response.csv situ dans le rpertoire emplacement_c8/logs. IBM Cognos Configuration applique les paramtres de configuration spcifis dans le fichier cogstartup.xml, chiffre les rfrences d'identification, cre des certificats numriques et, le cas chant, dmarre le service ou le processus IBM Cognos 8.
Procdure d'arrt d'IBM Cognos 8

1. Accdez au rpertoire emplacement_c8/bin. 2. Saisissez la commande suivante : ./cogconfig.sh -stop
Cration manuelle du fichier d'application d'IBM Cognos

IBM Cognos 8 et la passerelle du servlet doivent tre inclus dans un fichier d'application en vue de leur dploiement sur les serveurs d'applications pris en charge (p. 387), (p. 352). IBM Cognos 8 offre un assistant Cration d'application qui permet de crer le fichier d'application. Vous pouvez crer un fichier d'archive Web (.war), un fichier d'archive d'entreprise (.ear) ou un rpertoire dvelopp incluant tous les fichiers ncessaires pour l'application. Pour en savoir davantage sur les fichiers WAR et EAR ou les rpertoires dvelopps et pour dterminer lesquels de ces lments sont pris en charge par votre serveur d'application, reportez-vous la documentation fournie avec ce dernier. Si vous choisissez de ne pas utiliser l'assistant Cration d'application, procdez comme suit pour crer le fichier d'application : Si le serveur d'application n'est pas utilis en tant que serveur Web, il n'est pas ncessaire d'inclure le contenu statique d'IBM Cognos (pages html, images, etc.) dans le fichier d'application. L'exclusion du contenu statique lors de la cration du fichier d'application permet de rduire la taille de ce fichier.
Procdure de cration d'un fichier d'application IBM Cognos 8

1. Accdez au rpertoire emplacement_c8/war/p2pd. 2. Excutez le script de cration en utilisant la syntaxe de commande suivante : Pour Windows, build.bat type_fichier option Pour UNIX ou Linux, build.sh type_fichier option
432
Annexe A: Configuration manuelle d'IBM Cognos 8 o type_fichier peut correspondre un des lments suivants :
Valeur
war war_without_webcontent war_without_docsamples
Description
Fichier WAR avec contenu statique. Fichier WAR sans contenu statique. Fichier WAR avec contenu statique, mais sans documentation ni fichier d'exemple. Fichier EAR avec contenu statique. Fichier EAR sans contenu statique. Fichier EAR avec contenu statique, mais sans documentation ni fichier d'exemple. Rpertoire contenant l'application, avec contenu statique. Rpertoire contenant l'application, sans contenu statique. Rpertoire contenant l'application, avec contenu statique, mais sans documentation ni fichier d'exemple.
ear ear_without_webcontent ear_without_docsamples
expand
expand_without_webcontent
expand_without_docsamples
et o option peut correspondre un ou plusieurs des lments suivants :
Option
-Dappserver_type=valeur
Valeur
jboss other (valeur implicite)
Description
Excution d'oprations pour un serveur d'application JBoss. Excution d'oprations pour un serveur d'application non JBoss.
-Dcontext_root=valeur
p2pd (valeur implicite)
Prdfinition d'une valeur de racine de contexte pour l'application.
Option
-Dwar_name=valeur
Valeur
chemin d'accs/nom de fichier La valeur implicite est ../../p2pd.war
Description
Chemin d'accs et nom du fichier WAR crer.
-Dear_name=valeur
chemin d'accs/nom de fichier La valeur implicite est ../../p2pd.ear
Chemin d'accs et nom du fichier EAR crer.
-Dexpand_location=valeur (Pour le dveloppement des types de fichiers)
chemin d'accs/rpertoire Chemin d'accs au rpertoire dans lequel les La valeur implicite est fichiers d'application ../../temp/expand vont tre dvelopps.
Procdure de cration d'un fichier d'application de passerelle de type servlet

1. Accdez au rpertoire emplacement_c8/war/gateway. 2. Excutez le script de cration en utilisant la syntaxe de commande suivante : Pour Windows, build.bat type_fichier option Pour UNIX ou Linux, build.sh type_fichier option o type_fichier peut correspondre un des lments suivants :
Valeur
gateway_war gateway_war_without_docsamples
Description
Fichier WAR avec contenu statique. Fichier WAR avec contenu statique, mais sans documentation ni fichier d'exemple. Fichier EAR avec contenu statique. Fichier EAR avec contenu statique, mais sans documentation ni fichier d'exemple. Rpertoire contenant l'application, avec contenu statique.
gateway_ear gateway_ear_without_docsamples
expand
434
Valeur
expand_without_docsamples
Description
Rpertoire contenant l'application, avec contenu statique, mais sans documentation ni fichier d'exemple.
et o option peut correspondre un ou plusieurs des lments suivants :
Option
-Dappserver_type=valeur
Valeur
jboss other (valeur implicite)
Description
Excution d'oprations pour un serveur d'application JBoss. Excution d'oprations pour un serveur d'application non JBoss.
-Dcontext_root=valeur
ServletGateway (valeur implicite)
Prdfinition d'une valeur de racine de contexte pour l'application. Chemin d'accs et nom du fichier WAR crer.
-Dwar_name=valeur
chemin d'accs/nom de fichier La valeur implicite est ../../ ServletGateway.war
-Dear_name=valeur
chemin d'accs/nom de fichier La valeur implicite est ../../ ServletGateway.ear
Chemin d'accs et nom du fichier EAR crer.
-Dexpand_location=valeur
chemin d'accs/rpertoire La valeur implicite est ../../temp/expand
Chemin d'accs au rpertoire dans lequel les fichiers d'application vont tre dvelopps.
436
Annexe B: Dpannage
Ces informations de rfrence et solutions de dpannage constituent un outil pratique pour rsoudre des problmes spcifiques dtects durant ou aprs l'installation de composants d'IBM Cognos 8. Pour en savoir davantage sur le dpannage des ressources, reportez-vous la section Dpannage du Guide d'administration et de scurit. Les problmes se caractrisent par leurs symptmes. Chaque symptme permet de remonter une ou plusieurs causes en utilisant des outils et techniques de dpannage spcifiques. Une fois le problme identifi, il est possible de le rsoudre en excutant une srie d'oprations. Les fichiers journaux sont utiles pour le dpannage. Un autre outil de dpannage prcieux est la base de connaissances, disponible sur le site Web Cognos Software Services (http://support.cognos. com). Il s'agit d'une base de donnes dans laquelle figurent un ensemble de problmes et leurs solutions pour tous les produits d'IBM Cognos. Si vous ne parvenez pas rsoudre un problme, votre ultime recours est le responsable du support technique. Pour analyser un problme, ce dernier a besoin d'informations sur la situation et les symptmes que vous observez. Pour l'aider diagnostiquer la cause du problme, runissez les donnes ncessaires avant de le contacter.
Fichiers journaux
Les fichiers journaux peuvent vous aider rsoudre des problmes car ils enregistrent les activits qui ont lieu lorsque vous utilisez un produit. Les oprations excutes dans IBM Cognos 8 sont enregistres dans divers fichiers journaux des fins de suivi. Par exemple, si vous tes confront des problmes lors de l'installation d'IBM Cognos 8, consultez le fichier journal de transfert afin de savoir quelles activits l'assistant d'installation a effectues durant le transfert des fichiers. Avant d'afficher les fichiers journaux, vrifiez qu'ils contiennent les informations dont vous avez besoin. Le nombre de fichiers journaux et les informations qu'ils contiennent sont dfinis par des paramtres dans IBM Cognos Connection et dans IBM Cognos Configuration. Utilisez IBM Cognos Administration dans IBM Cognos Connection pour connatre les catgories de journalisation et apprendre dfinir le niveau de dtail journaliser pour chaque catgorie. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8. Utilisez IBM Cognos Configuration pour spcifier la taille, le nombre et l'emplacement des fichiers journaux, ainsi que pour configurer les proprits du serveur de journalisation. Pour en savoir davantage, reportez-vous au Guide de l'utilisateur d'IBM Cognos Configuration. Lors d'un dpannage, les fichiers ci-aprs peuvent vous tre utiles :
Fichier journal de transfert

Ce fichier est utilis pour consigner les activits que l'Assistant d'installation excute lors du transfert de fichiers. Le fichier journal de transfert se trouve dans le rpertoire emplacement_c8\instlog. Le
Annexe B: Dpannage nom du fichier indique le nom du produit, sa version et son numro d'dition, et comprend un horodateur. Exemple de format du nom de fichier : tl-C8BISRVR-8.1-0.0-20080901_1122.txt
Fichier journal rcapitulatif des erreurs de transfert

Ce fichier est utilis pour consigner les composants que vous avez installs, des informations sur l'espace disque, les slections que vous avez faites dans les botes de dialogue de transfert et les erreurs ventuelles dtectes par l'Assistant d'installation lors du transfert des composants. Le fichier journal rcapitulatif des erreurs de transfert se trouve dans le rpertoire emplacement_c8/instlog. Le nom du fichier indique le nom du produit, sa version et son numro d'dition, et comprend un horodateur. Exemple de format du nom de fichier : tl-C8BISRVR-8.1-0.0-20080901_1122_summary_error.txt
Fichier de configuration de dmarrage

Ce fichier est utilis pour consigner vos choix de configuration chaque fois que vous enregistrez vos paramtres de proprit. Le nom du fichier est cogstartup.xml. Si vous n'tes pas en mesure d'enregistrer la configuration ou si vous rencontrez des problmes, vous pouvez revenir un fichier de configuration enregistr prcdemment. Les fichiers de sauvegarde de la configuration se trouvent dans le rpertoire emplacement_c8/configuration. Voici un exemple du format de nom de fichier pour des fichiers de configuration de sauvegarde : cogstartup_200811231540.xml
Fichier de verrouillage de configuration de dmarrage

Ce fichier est cr chaque fois que vous excutez IBM Cognos Configuration. Il vous empche d'ouvrir plusieurs fentres d'IBM Cognos Configuration. Si vous avez des difficults ouvrir IBM Cognos Configuration, vrifiez le fichier cogstartup.lock dans le rpertoire emplacement_c8/configuration. Si le fichier est prsent alors qu'IBM Cognos Configuration n'est pas ouvert, cela signifie qu'IBM Cognos Configuration n'a pas t arrt correctement la dernire fois que vous l'avez utilis. Vous pouvez supprimer ce fichier .lock et ouvrir IBM Cognos Configuration.
Fichier de configuration des paramtres rgionaux

Ce fichier est utilis pour consigner les choix de configuration poss dans IBM Cognos Configuration concernant les paramtres rgionaux du produit et du contenu, la mise en correspondance des paramtres rgionaux et la prise en charge des monnaies. Si vous rencontrez des problmes de prise en charge des langues dans l'interface utilisateur ou dans les rapports, utilisez ces fichiers pour suivre les changements. Les fichiers de sauvegarde de la configuration se trouvent dans le rpertoire emplacement_c8/configuration. Exemple de format du nom de fichier : coglocale_200811231540.xml
Fichier journal d'excution

Le fichier journal implicite d'IBM Cognos nomm cogserver.log, ou d'autres fichiers journaux configurs pour recevoir des messages de journalisation du serveur de journalisation, consignent des informations aprs le dmarrage du service IBM Cognos 8. Celles-ci se trouvent dans le rpertoire
438
Annexe B: Dpannage emplacement_c8. Si vous avez configur une autre destination pour les messages de journalisation, vrifiez le fichier ou la base de donnes approprie. Certains messages de journalisation signalent des problmes. La plupart de ces messages contiennent uniquement des informations mais d'autres peuvent vous aider diagnostiquer des problmes dans votre environnement d'excution.
Fichier journal de passerelle

Les passerelles consignent les erreurs dans le fichier journal de passerelle qui se trouve dans le rpertoire emplacement_c8/logs. Vous pouvez utiliser le fichier journal de passerelle pour dpanner des problmes empchant la passerelle de traiter les demandes ou d'utiliser le chiffrement. Les symptmes de ces problmes sont les suivants : les codes d'utilisateur et les mots de passe ne fonctionnent pas, le code d'accs unique ne fonctionne pas et le distributeur s'excute mais les utilisateurs reoivent le message d'erreur suivant : The IBM Cognos BI server is not
available : Le nom du fichier journal de passerelle est le suivant (o interface_passerelle est cgi,
mod (module Apache 1.3), mod2 (module Apache 2.0) ou isapi) : gwinterface_passerelle.log (par ex., gwcgi.log)
Fichier journal de dsinstallation

Ce fichier est utilis pour consigner les activits que l'Assistant de dsinstallation excute lors de la dsinstallation de fichiers. Le fichier journal s'intitule cognos_uninst_log.htm et se trouve dans le rpertoire Temp. Vous pouvez utiliser le fichier journal pour assurer le dpannage de certains problmes lis la dsinstallation des composants d'IBM Cognos 8.
Fichier journal du mode silencieux

Ce fichier est utilis pour consigner les activits qu'IBM Cognos Configuration excute en cours d'excution en mode silencieux. Ce fichier journal s'intitule cogconfig_response.csv et se trouve dans le rpertoire emplacement_c8/logs.
Fichier de mise niveau de ReportNet(R) vers IBM Cognos 8

Ce fichier contient un rcapitulatif des rsultats d'une mise niveau de ReportNet vers IBM Cognos 8. Ce fichier journal se nomme upgradeLog.xml et se trouve dans le rpertoire emplacement_c8/logs. Le fichier est au format xml et il fait rfrence une feuille de style xslt. Vous pouvez cliquer deux fois sur le fichier pour qu'il s'affiche dans votre navigateur.
Problmes de dmarrage d'IBM Cognos 8

Certains problmes peuvent se produire lorsque vous tentez : de dmarrer le service IBM Cognos 8, d'ouvrir la page Bienvenue d'IBM Cognos Connection pour la premire fois, de dmarrer un serveur d'application, tel que WebLogic ou WebSphere.
Annexe B: Dpannage
Symptmes
Solution
La page de garde d'IBM Cognos Connection ne Vrifiez la configuration de votre serveur Web. s'affiche pas lorsque vous dmarrez IBM Cognos 8. Le service dmarre, mais aucune table n'est cre dans la base de donnes Content Store. Le service ne dmarre pas. Vrifiez la configuration de la base de donnes Content Store.
Assurez-vous que vous attendez quelques instants avant de soumettre une demande. Vrifiez les droits d'accs aux fichiers et les noms des rpertoires de l'emplacement d'installation du serveur d'application.
Le serveur d'application ne dmarre pas.
Assurez-vous que vous utilisez un autre logiciel pris en charge par les composants d'IBM Cognos. Vous pouvez afficher une liste d'environnements mis jour, tels que les systmes d'exploitation, les programmes de correction, les navigateurs, les serveurs Web, les serveurs d'annuaire et les serveurs de base de donnes sur le site Web Cognos Software Services (http://support.cognos.com).
Erreur CFG-ERR-0106 lors du dmarrage du service IBM Cognos 8 dans IBM Cognos Configuration
Lorsque vous dmarrez le service IBM Cognos 8, le message d'erreur suivant peut s'afficher : CFG-ERR-0106 Cognos Configuration n'a reu aucune rponse du service Cognos 8 pendant la priode alloue. Assurez-vous que le service Cognos 8 est disponible et correctement configur. Il existe deux causes possibles ce problme : Le service IBM Cognos 8 a besoin de plus de temps pour dmarrer. Un ordinateur Content Manager en attente peut tre configur de manire incorrecte.
Le service IBM Cognos 8 a besoin de plus de temps

Par dfaut, IBM Cognos Configuration vrifie la progression de la demande de dmarrage toutes les demi-secondes pendant trois minutes. Si IBM Cognos Configuration ne reoit pas de rponse dans ce dlai, le message d'erreur s'affiche. Pour viter cette erreur, vous pouvez modifier le dlai d'attente avant qu'IBM Cognos Configuration reoive une rponse du service IBM Cognos 8. Pour cela, configurez les proprits ServiceWaitInterval et ServiceMaxTries dans le fichier emplacement_c8/configuration/cogconfig.prefs. La proprit ServiceWaitInterval reprsente l'intervalle, en millisecondes, pour lequel IBM Cognos Configuration vrifie la progression de la demande de dmarrage. Sa valeur implicite est 500, ce qui quivaut une demi-seconde. La proprit ServiceMaxTries reprsente le nombre de fois o IBM Cognos Configuration vrifie la progression de la demande de dmarrage. Sa valeur implicite est 360.
440
Annexe B: Dpannage
Content Manager est configur de manire incorrecte

Si le message d'erreur s'affiche sur un ordinateur Content Manager en attente, le paramtre de stockage des cls symtriques est peut-tre incorrect. Pour viter ce problme, configurez l'ordinateur Content Manager en attente afin qu'il stocke les cls symtriques localement.
Procdure de modification du temps d'attente

1. l'aide d'IBM Cognos Configuration, arrtez le service IBM Cognos 8. 2. Ouvrez le fichier emplacement_c8/configuration/cogconfig.prefs dans un diteur. Ce fichier est cr automatiquement la premire fois que vous excutez IBM Cognos Configuration. 3. Ajoutez le code suivant au fichier : ServiceWaitInterval=nombre de millisecondes ServiceMaxTries=frquence Conseil : Ajoutez les valeurs numriques correspondant vos besoins de configuration. 4. Enregistrez le fichier. 5. l'aide d'IBM Cognos Configuration, dmarrez le service IBM Cognos 8.
Procdure de stockage de cls symtriques localement

1. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager en attente. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez sur l'option Cryptographie. 3. Dans la fentre Proprits, dans la section Paramtres CSK, dfinissez l'option Stocker la cl symtrique localement sur la valeur Vrai. 4. Dans le menu Fichier, cliquez sur l'option Enregistrer. 5. Dans le menu Oprations, cliquez sur l'option Dmarrer. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution. Si vous souhaitez dmarrer un service spcifique, slectionnez son nud dans la fentre Explorateur et cliquez sur Dmarrer dans le menu Oprations.
Erreur de chiffrement lors du dmarrage d'IBM Cognos 8

Vous avez reu le message d'erreur suivant lorsque vous avez tent de dmarrer le service IBM Cognos 8 aprs avoir install des composants serveur ou client : [Cryptography] 1. [ ERREUR ] java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory:
Annexe B: Dpannage Votre environnement d'excution Java (JRE) ne dispose pas des sous-programmes de chiffrement et dchiffrement requis par IBM Cognos 8. Vous devez copier le fichier d'archive Java (.jar) fourni dans votre rpertoire JRE.
Procdure
Copiez le fichier bcprov-jdknn-nnn.jar du rpertoire emplacement_c8/bin/jre/version/lib/ext dans le rpertoire emplacement_Java/jre/lib/ext.
chec du dmarrage du service IBM Cognos 8 car le port est utilis par un autre processus
Il est possible que vous ne puissiez pas dmarrer un service ou un processus d'IBM Cognos 8 si l'un des ports implicites est utilis par un autre processus. Conseil : Pour voir les connexions rseau TCP/IP actuelles, utilisez la commande netstat. Utilisez IBM Cognos Configuration pour modifier le port implicite utilis par IBM Cognos 8. Si vous modifiez le port utilis par le distributeur local, vous devez modifier la valeur des proprits URI du distributeur. tant donn que le changement a une incidence sur tous les URI dfinis en fonction du distributeur local, vous devez modifier ceux de tous les composants locaux. Par dfaut, l'URI des composants locaux contient la chane localhost. Par exemple, si vous installez tous les composants sur un mme ordinateur et souhaitez utiliser un autre port pour le distributeur, remplacez 9300 dans tous les URI du distributeur et de Content Manager par le nouveau numro de port.
Procdure de modification du port implicite

1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, cliquez sur le groupe ou le composant appropri : Pour accder au numro de port dans les URI du distributeur et de Content Manager, cliquez sur Environnement. Pour accder au numro de port du serveur de journalisation local, dans la section Environnement, cliquez sur Journalisation. Pour accder au numro du port d'arrt, dans la section Environnement, cliquez sur Service IBM Cognos 8, IBM Cognos 8. Pour accder au numro de port correspondant l'emplacement du fichier applications.xml utilis par Portal Services, dans la section Environnement, cliquez sur Portal Services. 3. Dans la fentre Proprits, cliquez sur la zone Valeur ct de la proprit que vous voulez modifier. 4. Remplacez 9300 par la nouvelle valeur. Veillez changer les ports dans tous les URI contenant la chane localhost:9300. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
442
Annexe B: Dpannage 6. Dans le menu Opration, cliquez sur l'option Dmarrer.
Le service IBM Cognos 8 ne dmarre pas ou choue aprs le dmarrage

Vous lancez le service IBM Cognos 8 mais soit celui-ci ne dmarre pas correctement, soit il est trs lent dmarrer. Peu aprs le dmarrage du service, le systme se bloque. Alors que le service est en cours de dmarrage, Java utilise l'intgralit des ressources du processeur. Vous pouvez galement recevoir des messages d'erreur en plusieurs exemplaires, comme ceux-ci : DPR-DPR-1035 Erreur dtecte par le distributeur. CAM-CRP-1157 Impossible de synchroniser la bibliothque de cls symtriques communes locale avec Content Manager.
Si vous utilisez une base de donnes DB2 comme Content Store, assurez-vous que la version de la base de donnes et la version Java sont compatibles. Pour DB2 version 8.2, Java 1.5 n'est pas pris en charge. Pour DB2 version 9, Java 1.5 est pris en charge sur tous les systmes d'exploitation l'exception de HPUX et Solaris. Pour consulter une liste jour des environnements pris en charge par les produits IBM Cognos, tels que les systmes d'exploitation, les correctifs, les navigateurs, les serveurs Web, d'annuaire, de bases de donnes et d'applications, consultez le site Web Cognos Software Services (http://support.cognos. com).
546816
Le serveur IBM Cognos 8 ne dmarre pas mais ne renvoie aucun message d'erreur
Un serveur IBM Cognos 8 peut refuser de dmarrer aprs une mise niveau ou une nouvelle installation, sans qu'aucun message d'erreur ne s'affiche. Ceci peut arriver lorsqu'un serveur IBM Cognos 8 prcdemment en cours d'excution ou nouvellement install est configur pour utiliser une grande quantit de mmoire. Lorsque le serveur sur lequel IBM Cognos 8 est install dispose de la mise jour de scurit 921883 version 1.0 de Microsoft, un problme peut survenir lorsqu'une grande quantit de mmoire contigu est utilise par une application. Il s'agit d'un problme connu avec la version 1.0 de la mise jour de scurit 921883 de Microsoft. Microsoft a fourni une deuxime version de la mise jour pour corriger ce problme. Vous pouvez rsoudre le problme en dsinstallant la premire mise jour de scurit ou en installant la version 2.0 de la mise jour. Vous pouvez galement configurer le serveur IBM Cognos 8 pour qu'il utilise moins de mmoire. Pour en savoir davantage, reportez-vous l'article sur le dysfonctionnement des programmes utilisant une grande quantit de mmoire contigu, dans la base de connaissances Microsoft, l'adresse http: //support.microsoft.com.
Non-disponibilit du serveur IBM Cognos BI lors du dmarrage d'IBM Cognos 8

Aprs avoir configur les composants d'IBM Cognos et dmarr le service IBM Cognos 8, le message d'erreur suivant peut s'afficher lorsque vous ouvrez IBM Cognos Connection : chec de la connexion entre la passerelle Cognos et le serveur de Cognos BI. Guide d'installation et de configuration 443
Annexe B: Dpannage Il est possible que le serveur ne soit pas disponible ou que la configuration de la passerelle soit incorrecte. Pour en savoir davantage, reportez-vous au fichier journal du serveur IBM Cognos. Par dfaut, le fichier cogserver.log se trouve dans le rpertoire emplacement_c8/logs. Si vous avez configur une autre destination pour les messages de journalisation, vrifiez le fichier ou la base de donnes approprie. Content Manager ne peut parfois pas se connecter la base de donnes Content Store si cette dernire n'est pas correctement configure. Cela peut se produire si : la base de donnes Content Store utilise un encodage de caractres non pris en charge, la base de donnes Content Store utilise une squence d'assemblage de base de donnes sensible la casse, les paramtres de configuration spcifis dans IBM Cognos Configuration ne sont pas valides.
Encodage de caractres non pris en charge

Si le fichier journal contient les messages suivants, l'encodage de caractres de la base de donnes cre en tant que Content Store n'est pas pris en charge : Pour Oracle : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-SYS-5121 Content Manager ne parvient pas dmarrer car le jeu de caractres de la base de donnes Content Store n'est pas pris en charge. CM-SYS-5126 Le serveur de base de donnes Content Store utilise le jeu de caractres US7ASCII. CM-SYS-5125 Le client de base de donnes Content Store utilise le jeu de caractres US7ASCII. Pour DB2 UDB : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-SYS-5121 Content Manager ne parvient pas dmarrer car le jeu de caractres de la base de donnes Content Store n'est pas pris en charge. CM-SYS-5124 Le serveur de base de donnes Content Store utilise la page de codes 1252. Pour Sybase : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-SYS-5121 Content Manager ne parvient pas dmarrer car le jeu de caractres de la base de donnes Content Store n'est pas pris en charge. Pour que Content Manager puisse se connecter la base de donnes Content Store, cette dernire doit utiliser l'encodage de caractres appropri :
444
Annexe B: Dpannage
Base de donnes
Oracle 9i
Encodage de caractres
AL32UTF8 AL32UTF16
DB2 UDB Sybase ASE Microsoft SQL Server
Codeset UTF-8 UTF-8 UTF8 UTF16
Pour rsoudre ce problme, vous devez recrer la base de donnes Content Store l'aide de l'encodage de caractres correct ou convertir l'encodage de caractres. Pour en savoir davantage, reportez-vous la documentation sur la base de donnes.
Squence d'assemblage sensible la casse

Si les messages suivants s'affichent dans le fichier journal, la base de donnes cre en tant que Content Store utilise une squence d'assemblage de base de donnes sensible la casse : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-SYS-5122 La base de donnes Content Store utilise une squence de classement des caractres implicite qui fait la distinction entre les majuscules et les minuscules. Content Manager requiert un Content Store utilisant un assemblage non sensible la casse. CM-SYS-5123 Le serveur de base de donnes Content Store utilise l'assemblage <paramtre>. CM-SYS-5007 chec du lancement de la compilation <numro_version> de Content Manager. Passez en revue les fichiers journaux de Content Manager puis contactez l'administrateur du systme ou le support client. Pour rsoudre ce problme, vous devez recrer la base de donnes Content Store l'aide d'une squence d'assemblage de base de donnes qui n'est pas sensible la casse. Pour en savoir davantage, reportez-vous la documentation sur la base de donnes.
Paramtres de configuration non valides

Si le fichier journal contient le message suivant ou un message similaire, vous n'avez pas configur correctement la base de donnes Content Store dans IBM Cognos Configuration. Pour Microsoft SQL Server : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-CFG-5036 Content Manager n'a pas pu se connecter Content Store. La chane de connexion est 'jdbc:JSQLConnect://localhost:1433/cm'. chec de connexion:com.jnetdirect.jsql.x: Cannot open database requested in login 'cm'. chec de connexion. url:jdbc:JSQLConnect://localhost:1433/cm. Guide d'installation et de configuration 445
Annexe B: Dpannage Pour DB2 : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-SYS-5003 Content Manager ne parvient pas accder au Content Store. Vrifiez les paramtres de connexion la base de donnes, puis contactez l'administrateur de base de donnes. [IBM][CLI Driver] SQL1013N Pseudonyme de base de donnes ou nom de base de donnes CM123 non trouv. Pour Oracle : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-CFG-5036 Content Manager n'a pas pu se connecter Content Store. La chane de connexion est jdbc:oracle:thin:@localhost:1521:pb1 . ORA-01017 : nom d'utilisateur/mot de passe non valide ; connexion refuse. Pour Sybase : CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la connexion Content Store. CM-CFG-5036 Content Manager n'a pas pu se connecter Content Store. La chane de connexion est jdbc:sybase:Tds:localhost:5000/cm . JZ006: Caught IOException: java.net.ConnectException: Connection refused: connect. Si vous utilisez une base de donnes Oracle, n'utilisez pas de caractres illgaux, tels que le tiret de soulignement dans IBM Cognos Configuration pour la proprit Nom du service. Si le nom du service comprend des caractres non autoriss, les tables ne sont pas cres dans la base de donnes Content Store au dmarrage du service IBM Cognos 8.

1. Sur l'ordinateur o vous avez install Content Manager, dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Accs aux donnes, Content Manager, cliquez avec le bouton droit de la souris sur l'option Content Store, puis slectionnez Supprimer. Cette opration supprime la ressource implicite. Content Manager doit tre configur de faon accder une seule base de donnes Content Store. 3. Cliquez avec le bouton droit de la souris sur l'option Content Manager, puis cliquez sur Nouvelle ressource et Base de donnes. 4. Dans la zone Nom, saisissez un nom pour la ressource. 5. Dans la zone Type, slectionnez le type de base de donnes, puis cliquez sur le bouton OK. Si vous procdez une mise niveau et que vous souhaitez utiliser une base de donnes Content Store existante, veillez slectionner le type de base de donnes utilis pour la version prcdente de ReportNet.
446
Annexe B: Dpannage Si vous avez install plusieurs versions d'IBM Cognos 8, vous devez utiliser une base de donnes Content Store diffrente pour chaque version. Lorsqu'une base de donnes Content Store est utilise par une nouvelle version d'IBM Cognos 8, elle ne peut pas tre utilise par une version antrieure de ReportNet. Conseil : Si vous utilisez la paire Net8 de type mot-cl et valeur d'Oracle pour grer la connexion la base de donnes, slectionnez Base de donnes Oracle (options avances). 6. Dans la fentre Proprits, fournissez des valeurs en fonction du type de base de donnes : Si vous utilisez une base de donnes Microsoft SQL Server, saisissez les valeurs appropries pour les proprits Serveur de base de donnes comportant un numro de port ou un nom d'instance et Nom de la base de donnes. Pour une base de donnes Microsoft SQL Server, vous pouvez utiliser un numro de port, tel que 1433, ou une instance nomme en tant que valeur de la proprit Serveur de base de donnes comportant un numro de port ou un nom d'instance. Pour vous connecter une instance nomme, vous devez indiquer son nom en tant que proprit URL JDBC ou source de donnes. Par exemple, vous pouvez saisir localhost\instance1. Si aucune proprit de nom d'instance n'est indique, une connexion l'instance implicite est cre. Notez que les proprits indiques pour l'instance nomme, ainsi que le code d'utilisateur, le mot de passe et le nom de la base de donnes, servent crer une adresse URL JDBC. Voici un exemple : jdbc:JSQLConnect://localhost\\instance1/user=sa/autres proprits si ncessaire Si vous utilisez une base de donnes DB2, pour la proprit Nom de la base de donnes, saisissez le pseudonyme de la base de donnes. Si vous utilisez une base de donnes Oracle, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom du service. Si vous utilisez une base de donnes Oracle avance, pour la proprit Identificateur de base de donnes, saisissez la paire Net8 de type mot-cl et valeur d'Oracle pour la connexion. Voici un exemple : (description=(adresse=(hte=mon_hte)(protocole=tcp)(port=1521)(donnes_connexion= (sid=(orcl))))) Si vous utilisez une base de donnes Sybase, saisissez les valeurs appropries pour les proprits Serveur de base de donnes et numro de port et Nom de la base de donnes. 7. Si vous souhaitez modifier les rfrences d'identification de connexion, prcisez un code d'utilisateur et un mot de passe : Cliquez sur la zone Valeur en regard de la proprit Code d'utilisateur et mot de passe, puis cliquez sur le bouton d'dition quand il s'affiche. Saisissez les valeurs appropries et cliquez sur OK.
Annexe B: Dpannage 8. Dans le menu Fichier, cliquez sur l'option Enregistrer. Les rfrences d'identification pour la connexion sont immdiatement chiffres. 9. Testez la connexion entre Content Manager et la base de donnes Content Store. Conseil : Dans la fentre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle base de donnes, puis cliquez sur Tester. Content Manager se connecte la base de donnes, vrifie les droits d'accs de celle-ci, puis cre une table et la complte. La table n'est pas supprime et est utilise chaque excution du test.
chec de la connexion un espace-noms lors de l'utilisation d'IBM Cognos Connection (Erreur PRSCSE1255)
Ouvrez IBM Cognos 8 via IBM Cognos Connection. Toutefois, lorsque vous tentez de crer une source de donnes et de vous connecter un espace-noms, les messages d'erreur suivants s'affichent : PRS-CSE-1255 Erreur lors du dchiffrement des donnes. CAM-CRP-1064 Impossible de traiter les donnes PKCS #7 en raison d'une erreur interne. Raison : java.lang.IndexOutOfBoundsException.
Ce problme peut survenir si vous ne disposez pas des droits d'accs ncessaires pour les rpertoires suivants : c8\configuration c8\configuration\csk c8\configuration\encryptkeypair c8\configuration\signkeypair
La solution consiste activer les droits de lecture et d'excution sur les rpertoires cits ci-dessus pour tous les utilisateurs devant dmarrer le service IBM Cognos 8.
chec du redmarrage des services d'IBM Cognos 8 aprs une panne de rseau
Aprs une panne de rseau, IBM Cognos Bootstrap Service redmarre les services IBM Cognos 8 des installations Tomcat o l'adresse IP de rseau est dfinie dans l'URI interne du distributeur. Lors du redmarrage, l'initialisation des services IBM Cognos 8 peut chouer. Il faudra alors les redmarrer manuellement une fois le rseau rtabli. Pour rsoudre ce problme, configurez la proprit URI interne du distributeur dans IBM Cognos Configuration de faon utiliser localhost ou le nom d'hte du rseau.
Aucun avertissement pour indiquer que la version antrieure de Content Store sera mise jour automatiquement lors de l'installation d'une version plus rcente d'IBM Cognos 8
Une version de ReportNet est installe sur votre ordinateur. Vous installez une version plus rcente dans un nouvel emplacement. Vous utilisez la mme base de donnes Content Store pour les deux 448
Annexe B: Dpannage versions. Aprs avoir configur la dernire version et dmarr le service IBM Cognos 8, la version prcdente de ReportNet ne fonctionne plus, car tout le contenu est automatiquement mis niveau. Si vous souhaitez utiliser diffrentes versions de ReportNet et d'IBM Cognos 8 aprs une mise niveau, avant d'installer la dernire version, veillez effectuer : une copie de sauvegarde de la base de donnes que vous utilisez comme Content Store, une restauration de cette sauvegarde dans un nouvel emplacement.
Vous pouvez galement choisir d'utiliser l'outil de dploiement pour importer la totalit de la base de donnes Content Store d'une version antrieure de ReportNet dans une version plus rcente. Toutes les donnes existantes de la base de donnes Content Store sont remplaces par le contenu import. Vous recevez un message d'avertissement.
chec du tlchargement des ressources

Vous dmarrez Report Studio dans Internet Explorer et le message d'erreur suivant s'affiche : chec du tlchargement des ressources spcifies. Il est possible que la cause soit une mise niveau rcente de Microsoft XMLHTTP si vous n'avez pas dfini de prfrence de langue dans Internet Explorer. Pour rsoudre le problme, dfinissez une prfrence de langue dans Internet Explorer.
Erreur SQL1224N retourne par DB2 en cas de connexion depuis AIX

Si la base de donnes Content Store est une base de donnes DB2 et qu'une erreur SQL1224N s'affiche sur AIX, recherchez des informations supplmentaires sur l'erreur dans le fichier db2diag.log. Si le message d'erreur comprend le code de motif 18, vous devrez peut-tre modifier la configuration de DB2 pour accepter un plus grand nombre de connexions. Pour en savoir davantage, reportezvous aux pages du support technique d'IBM DB2 concernant l'erreur SQL1224N.
Erreur de Content Manager lors du dmarrage d'IBM Cognos 8

Aprs avoir dmarr IBM Cognos 8, aucun processus BIBUSTKSERVMA ne dmarre. Des erreurs sont consignes dans les fichiers pogo******.log et cogserver.log. Les utilisateurs reoivent des erreurs dans le navigateur lorsqu'ils se connectent IBM Cognos Connection. Dans le fichier pogo******.log, une erreur lie Content Manager s'affiche. Dans le fichier cogserver.log, le message d'erreur suivant s'affiche : chec de l'inscription du distributeur dans Content Manager. Le systme essaiera nouveau de faon priodique. Lorsque vous vous connectez http://nom_ordinateur/cognos8, les messages d'erreur suivants s'affichent dans le navigateur : DPR-ERR-2058 Le distributeur ne peut rpondre cette demande en ce moment. Il est en cours d'initialisation. SoapSocketException: Connection Refused
Annexe B: Dpannage IBM Cognos Configuration utilise un code d'utilisateur pour tablir une liaison la base de donnes LDAP. Si ce code d'utilisateur est dplac dans un autre groupe, IBM Cognos Configuration ne peut plus dterminer son emplacement. Pour remdier ce problme, replacez le code d'utilisateur dans son groupe d'origine.
DPR-ERR-2014 Une erreur s'affiche dans le fichier journal sur l'ordinateur Content Manager
Si Content Manager est install sur un ordinateur distinct et que le service de gestion des vnements de l'ordinateur Content Manager est dsactiv, il est possible que le message d'erreur suivant s'affiche dans le fichier cogserver.log :
DPR-ERR-2014 Unable to load balance the request becauseno nodes in the cluster are available, or no nodes are configuredfor the service: eventManagementService
Pour corriger ce problme, procdez comme suit : Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager. Dans le volet Explorateur, accdez Environnement, Service IBM Cognos 8. Dfinissez la proprit Service de gestion des vnements activ ? sur Faux.
La prsence de caractres non ASCII dans le rpertoire d'installation entrane des erreurs d'excution
Sur tous les systmes d'exploitation, si vous utilisez des caractres non ASCII dans le rpertoire d'installation d'IBM Cognos 8, cela n'entranera pas des erreurs d'excution. Certaines fonctions de produits, comme l'excution de rapports, risquent aussi d'chouer. Pour rsoudre ce problme, installez IBM Cognos 8 dans le rpertoire implicite ou utilisez un nom de rpertoire contenant uniquement des caractres ASCII Latin-1.
Impossible d'ouvrir un cube MS ou Cognos

Vous ne pouvez pas ouvrir un cube MS ou vous pouvez en ouvrir un mais seules les mtadonnes s'affichent. Pour un cube MS, vous pouvez recevoir le message d'erreur suivant : MO-ERR-0030 Impossible de se connecter la source de donnes. Configurez le service en tant qu'utilisateur du domaine avec les droits ncessaires. Pour rsoudre ce problme, assurez-vous que l'utilisateur qui excute le service IBM Cognos 8 dispose des droits d'accs au cube. Les cubes sont accessibles par l'intermdiaire de lecteurs mis en correspondance ou de noms chemins d'accs UNC.
Procdure pour les cubes MS

1. Ajoutez le compte d'utilisateur de domaine qui lance le service IBM Cognos 8 au privilge Fonctionner en tant que partie intgrante du systme d'exploitation : 450 Dans Outils d'administration, slectionnez Stratgie de scurit locale.
Annexe B: Dpannage Dveloppez Paramtres de scurit, Stratgies locales et cliquez sur Attribution des droits utilisateur. Cliquez avec le bouton droit de la souris sur la stratgie Fonctionner en tant que partie intgrante du systme d'exploitation et slectionnez Proprits. Cliquez sur Ajouter un utilisateur ou un groupe et ajoutez le compte d'utilisateur qui lance le service IBM Cognos 8.
2. Si vous utilisez la mthode d'authentification par code d'utilisateur et mot de passe de domaine, ajoutez le compte d'utilisateur qui lance le service IBM Cognos 8 au domaine qui inclut Content Manager, le serveur de rapports (composants d'application), le serveur Web IIS et le serveur de sources de donnes (Microsoft SQL Server ou Microsoft Analysis Server). 3. Si vous utilisez un espace-noms externe, tel qu'Active Directory Server, pour l'authentification, ajoutez le compte d'utilisateur qui lance le service IBM Cognos 8 au domaine qui inclut le fournisseur d'authentification. Ce domaine doit aussi inclure Content Manager, le serveur de rapports (composants d'application), le serveur Web IIS et le serveur de sources de donnes (Microsoft SQL Server ou Microsoft Analysis Server). Pour en savoir davantage sur la configuration d'espaces-noms externes pour l'authentification, reportez-vous aux rubriques relatives aux fournisseurs d'authentification dans le Guide d'installation et de configuration.
Procdure pour les cubes

Assurez-vous que le profil d'utilisateur IBM Cognos dispose de droits d'accs suffisants au systme d'exploitation ou au domaine pour ouvrir le fichier du cube. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit.
Impossible d'ouvrir une source de donnes OLAP

L'une des sources de donnes suivantes ne s'ouvre pas : MSAS Essbase DB2
Vous pouvez essayer d'ouvrir le mme cube dans Excel. Ceci vous permettra de dterminer si le serveur OLAP fonctionne et si le logiciel client adquat est install.
Page introuvable lors du dmarrage d'IBM Cognos 8 sous Windows 2003

Aprs avoir install IBM Cognos 8 sous Windows 2003, il est possible que le message d'erreur suivant s'affiche lors de son dmarrage : La page est introuvable. La page que vous recherchez a peut- tre t supprime, renomme ou est momentanment inaccessible. Erreur HTTP 404 - Fichier ou rpertoire introuvable.
Annexe B: Dpannage Cette erreur provient d'une fonction de scurit des services d'information Internet (IIS) sous Windows 2003. Cette fonction de scurit n'autorise pas les extensions de fichiers cgi inconnues. Pour rsoudre ce problme, ajoutez une extension pour le fichier cognos.cgi dans les services d'information Internet. Pour en savoir davantage, reportez-vous la documentation concernant les services d'informations Internet (IIS).
La page ne s'affiche pas l'ouverture du portail aprs avoir install IBM Cognos 8
Aprs avoir install et configur IBM Cognos 8, vous ne parvenez pas ouvrir IBM Cognos Connection. Cela peut tre d une mauvaise configuration du serveur Web. Par exemple, il se peut que les rpertoires virtuels requis pour IBM Cognos 8 n'existent pas ou qu'ils pointent vers les mauvais dossiers physiques. Pour en savoir davantage sur la configuration du serveur Web, reportez-vous au Guide d'installation et de configuration.
L'erreur DPR-ERR-2058 s'affiche dans le navigateur Web lors du dmarrage d'IBM Cognos 8
Lorsque vous dmarrez les services dans IBM Cognos Configuration, puis essayez d'ouvrir le portail, un message semblable l'un des suivants peut s'afficher : DPR-ERR-2058 Le distributeur a dtect une erreur lors du traitement d'une demande. Il faut initialiser le gestionnaire XTS avant de pouvoir l'appeler. DPR-ERR-2058 Le distributeur ne peut rpondre cette demande en ce moment. Il est en cours d'initialisation. Veuillez essayer nouveau ou vous adresser l'administrateur. Ces messages d'erreur s'affichent gnralement lorsque le distributeur ne peut pas communiquer avec Content Manager. Afin de dterminer la cause de ces erreurs, consultez le fichier cogserver.log dans le rpertoire emplacement_c8/logs. Les causes les plus frquentes sont rpertories ci-dessous avec leurs solutions.
L'initialisation des services IBM Cognos n'est pas termine

Aprs avoir dmarr les services dans IBM Cognos Configuration et une fois que l'outil de configuration indique que les services sont actifs, attendez quelques minutes pour laisser tous les services le temps de dmarrer avant d'ouvrir le portail.
Content Manager n'est pas disponible

Dans une installation rpartie, assurez-vous que Content Manager est install, configur et en cours d'excution. Assurez-vous galement que les autres ordinateurs IBM Cognos sont configurs avec l'URI Content Manager correct.
La base de donnes Content Store n'est pas disponible ou n'est pas configure correctement
Assurez-vous que la base de donnes Content Store a t cre et que vous l'avez configure correctement dans IBM Cognos Configuration.
452
Annexe B: Dpannage
Les tables ne sont pas cres dans la base de donnes Content Store
Assurez-vous d'utiliser une version de DB2, Microsoft SQL Server, Oracle ou Sybase prise en charge par les composants d'IBM Cognos.
Les rfrences de connexion de la base de donnes Content Store ne sont pas correctes
Vrifiez si les informations ont chang. Par exemple, DB2 lit les informations depuis le module de gestion des utilisateurs NT. Si le mot de passe du compte NT a chang, vous devez galement modifier les rfrences d'identification de connexion pour la base de donnes Content Store dans IBM Cognos Configuration. Vrifiez que le mot de passe de connexion ne contient pas de caractres spciaux. Le pilote JDBC n'accepte parfois pas les caractres rservs pour le format xml, tels que %, !, < et >.
L'utilisateur ne dispose pas des droits d'accs appropris

Vrifiez que l'utilisateur dispose des droits d'accs appropris.
Mmoire insuffisante sous HP-UX

Si vous utilisez Tomcat, vous pouvez dterminer si le problme est li la configuration du serveur HP-UX. Le nombre maximal attendu d'units d'excution par processus a peut-tre t dpass. Procdure de vrification d'un problme de configuration HP-UX 1. Dans le fichier /bin/startup.sh, trouvez ../tomcat4.1.27/bin/catalina.sh start "$@" 2. Remplacez cette chane par la suivante : ../tomcat4.1.27/bin/catalina.sh run "$@" La commande "run" affiche la sortie Tomcat dans la fentre de la console IBM Cognos 8. 3. Arrtez et redmarrez IBM Cognos 8 l'aide des commandes ./shutdown.sh et ./startup.sh. Si le message d'erreur suivant s'affiche dans la fentre de la console d'un serveur d'application, le problme vient de la configuration de HP-UX : OutofMemoryException error: Unable to create new native thread on HP-UX. Le problme vient du fait que les valeurs implicites de 11.0 et 11i HP-UX sont trop faibles pour la plupart des applications Java. Conseil : Vous pouvez vrifier le nombre d'units d'excution comprises dans votre processus en utilisant l'option -eprof disponible dans JDK 1.1.8, puis en analysant le fichier Java.eprof l'aide de l'option HPjmeter en slectionnant l'indicateur d'units d'excution.
Procdure d'augmentation du nombre maximal d'units d'excution par processus

1. Demandez l'administrateur systme de modifier les paramtres de noyau suivants : max_thread_proc = 512 nkthread = 1024
2. Veillez ce que les paramtres ulimit soient illimits. Guide d'installation et de configuration 453
Annexe B: Dpannage
Content Manager ne parvient pas se connecter la base de donnes Content Store sous Oracle
Si vous utilisez une base de donnes Oracle comme Content Store, l'erreur DPR-ERR-2058 peut tre gnre lorsque vous vous connectez au portail http://nom_hte/cognos8. Toutes les tables sont cres dans la base de donnes Vous pouvez galement recevoir les messages d'erreur suivants : CM-CFG-5036 Content Manager n'a pas pu se connecter Content Store. ORA-01017 : nom d'utilisateur/mot de passe non valide ; connexion refuse
Procdure de dfinition du nom de serveur de la base de donnes Oracle

1. Dans la fentre Explorateur, cliquez sur Accs aux donnes, sur Content Manager, puis sur Content Store. 2. Remplacez le nom de serveur de la base de donnes Oracle par un nom qualifi complet, tel que nom_hte.nom_socit:1534, qui correspondra au nom contenu dans le fichier tnsnames.ora.
Erreur EBA-090034 au dmarrage de WebLogic 8

Aprs avoir configur WebLogic 8 de faon utiliser le protocole SSL, vous avez utilis la commande startManagedWebLogic.cmd pour lancer le serveur d'application. Le serveur d'application n'a pas dmarr et vous avez reu le message d'erreur suivant : EBA-0990034 Not listening for SSL Ce problme est survenu car WebLogic 8 dispose d'une fonctionnalit incompatible avec le fichier bcprov-jdk14.134.jar d'IBM Cognos 8. Pour rsoudre le problme, vous devez ajouter une nouvelle version du fichier bcprov.jar de BouncyCastle dans le rpertoire d'extension Java de WebLogic.
Procdure
1. Sur le site Web de BouncyCastle, http://www.bouncycastle.org/download/, tlchargez un fichier bcprov.jar BouncyCastle compatible, tel que bcprov-jdk14-137.jar. 2. Copiez le fichier .jar tlcharg dans le rpertoire d'extension Java de WebLogic, emplacement_ WebLogic\jdk142_nn\jre\lib\ext. 3. Dans le rpertoire emplacement_WebLogic\jdk142_nn\jre\lib\security, modifiez le fichier java.security et ajoutez la ligne suivante la liste de fournisseurs :
security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider
Report Studio ne dmarre pas

Vous ne serez peut tre pas en mesure de dmarrer Cognos Report Studio si vous utilisez un logiciel de blocage des incrustations sur votre ordinateur.
454
Annexe B: Dpannage Au dmarrage de Report Studio, celui-ci ouvre une nouvelle fentre de navigateur. De plus, une nouvelle fentre de navigateur s'ouvre lorsque vous excutez un rapport et lorsqu'une erreur est dtecte. Pour rsoudre le problme, dsactivez ce logiciel lorsque vous utilisez Report Studio.
L'erreur DPR-ERR-2022 s'affiche dans le navigateur Web lors du dmarrage d'IBM Cognos 8
Lorsque vous dmarrez les services dans IBM Cognos Configuration, puis que vous essayez d'ouvrir le portail, un message semblable au suivant peut s'afficher : DPR-ERR-2022 Aucune rponse gnre. Il est possible que la configuration soit incorrecte, que l'installation soit endommage ou que l'initialisation du distributeur ne soit pas termine.
Ouverture anticipe du portail

Ce problme peut se produire si vous tentez d'ouvrir le portail avant d'avoir install les services IBM Cognos. Pour viter ce problme, aprs avoir dmarr les services dans IBM Cognos Configuration et une fois que l'outil de configuration indique que les services sont actifs, attendez quelques minutes pour laisser tous les services le temps de dmarrer avant d'ouvrir le portail.
Le fichier system.xml contient des erreurs

Le fichier system.xml a peut-tre t modifi. Remplacez le fichier system.xml dans le rpertoire emplacement_c8\templates\ps\portal directory par une copie de sauvegarde ou utilisez un diteur XML pour le modifier.
chec du tlchargement du fichier cognos.xts

Une fois que vous avez install IBM Cognos 8, vous tes invit tlcharger le fichier cognos.xts lors de l'ouverture d'IBM Cognos Connection. Les messages d'erreur suivants s'affichent : Vous avez choisi de tlcharger un fichier partir de cet emplacement. cognos.xts partir de nom_serveur Ce problme se produit lorsque les autorisations associes aux rpertoires virtuels n'ont pas t correctement dfinies. Vous devez indiquer le rpertoire virtuel cgi-bin dans les services d'information Internet de Microsoft (IIS) et dfinir des droits d'excution. Pour rsoudre ce problme, crez nouveau les rpertoires virtuels dans les services d'information Internet avec les droits suivants.
Alias
cognos8 cognos8\ cgi-bin
Chemin d'accs
emplacement_c8\Program Files\Cognos\c8\webcontent emplacement_c8\Program Files\Cognos\c8\cgi-bin
Droits
Read Lecture Excution
Annexe B: Dpannage
Alias
cognos8\help
Chemin d'accs
emplacement_c8\Program Files\Cognos\c8\webcontent\ documentation
Droits
Read
chec du script de dmarrage d'un serveur d'application

Vous pouvez tre confront des problmes d'excution des scripts de dmarrage permettant un serveur d'application de dployer l'application IBM Cognos si des composants d'IBM Cognos 8 sont installs dans un rpertoire dont le nom contient des espaces. Pour rsoudre ce problme, renommez le rpertoire et n'incluez pas d'espaces dans le nouveau nom. Si cette solution ne convient pas aux scripts de dmarrage, essayez d'ajouter des guillemets autour du nom du rpertoire incluant des espaces ou utilisez la convention de dnomination DOS 8.3.
Problmes avec IBM WebSphere 6.0 sous AIX 5.3

Des tests ont rvl des problmes avec IBM WebSphere 6.0 sous AIX 5.3. Il est recommand de mettre niveau le systme vers AIX 5.3 Technology Level 4, Service Pack 2.
nbna
chec de l'excution d'IBM Cognos 8 sous WebLogic Application Server sur AIX
L'instance du serveur IBM Cognos 8 peut passer dans l'tat FAILED_NOT_RESTARTABLE dans la console d'administration WebLogic. De nombreux fichiers principaux (Java et autres) sont enregistrs dans le rpertoire de domaine IBM Cognos 8. IBM Cognos 8 s'arrte et n'est pas accessible via le portail. Ce comportement se produit uniquement lorsque le nud gr IBM Cognos 8 est dmarr avec la console d'administration WebLogic. Dmarrez le nud gr IBM Cognos 8 l'aide des scripts de dmarrage WebLogic.
575696
chec du dploiement d'IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere
Le dploiement d'IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere peut chouer avec l'une des erreurs suivantes : Browser timeout in administration console Error Message: HTTP 500 Internal Error Error Message: Deployment failed: Base Exception: java.rmi.RemoteException (Oracle) Return to application file selection page (IBM WebSphere)
Ces erreurs se produisent, car le fichier d'application que vous tentez de dployer est trop volumineux. Pour rsoudre ce problme, procdez comme suit :
456
Annexe B: Dpannage Si vous utilisez l'Assistant Cration d'application, dslectionnez la case Inclure les fichiers statiques partir du dossier Webcontent lorsque vous slectionnez l'application crer. Cela rduira la taille du fichier d'application. Si vous avez besoin du contenu statique, vous pouvez le copier manuellement l'emplacement de l'application dploye une fois IBM Cognos 8 dploy sur le serveur d'application. Si vous dployez le fichier d'application manuellement pour un serveur d'application Oracle, tapez la commande suivante : dcmctl deployapplication -f chemin_et_nom_du_fichier_ear -a nom_application -co nom_instance_OC4J Cette commande n'est pas prise en charge pour la version 3 d'Oracle. Pour en savoir davantage sur le dploiement d'IBM Cognos 8 vers un serveur d'application, reportezvous au Guide d'installation et de configuration.
Non-fonctionnement du type de rapport multipage Microsoft Excel 2000

Pour vous assurer que les adresses URL des rapports ne puissent pas tre modifies lorsqu'elles sont transfres d'un navigateur client un serveur de rapports, IBM Cognos 8 applique des signatures aux adresses URL qu'il cre. Cependant, le format multipage Excel 2000 (xls) ne prend pas en charge les adresses URL signes. Pour utiliser le type de rapport multipage Excel 2000, vous devez dsactiver la signature numrique des adresses URL en effectuant les oprations suivantes :
Procdure de dsactivation des adresses URL signes

1. Arrtez le distributeur. 2. Dans le rpertoire emplacement_c8/configuration, renommez le fichier cafconfig.xml.sample en cafconfig.xml. 3. Ouvrez le fichier cafconfig.xml et recherchez la section suivante :
 <crn:parameter name="caf_signedReportUrls"> <crn:value xsi:type="xsd:boolean">true</crn:value> </crn:parameter>
4. Modifiez ="xsd:boolean">true</crn:value> en ="xsd:boolean">false</crn:value> 5. Redmarrez votre distributeur. 6. Rptez les tapes ci-dessus pour chaque distributeur de votre environnement, ou copiez le fichier cafconfig.xml dans chaque rpertoire emplacement_c8/configuration, puis redmarrez les distributeurs.
Annexe B: Dpannage
Impossible de dsrialiser l'attribut contextuel lors du dploiement du fichier p2pd.war vers WebLogic
Lorsque vous dployez le fichier p2pd.war vers WebLogic, le message d'erreur suivant peut s'afficher : Error [context]Could not deserialize context attribute java.io.NotSerializableException: com.cognos.logserver.LogService Cette erreur n'a aucune incidence sur le dploiement du fichier p2pd.war. Pour viter ce problme, ajoutez au moins une langue dans les prfrences d'Internet Explorer.
Une erreur s'affiche aprs la mise niveau d'IBM Cognos 8 sur un serveur d'application WebLogic
Vous utilisez WebLogic et effectuez une mise niveau d'IBM Cognos 8 partir d'une version antrieure. Aprs avoir dploy le fichier p2pd.war pour la nouvelle installation, un message semblable celui-ci s'affiche : <BEA-101215> <Malformed Request "null". Request parsing failed, Code: -10> Cela peut se produire si vous annulez le dploiement d'IBM Cognos 8 partir de WebLogic et que certains fichiers de la version prcdente ne sont pas supprims du systme. Pour remdier ce problme, utilisez les outils d'administration de votre serveur d'application pour vous assurer que le dploiement d'IBM Cognos 8 a t annul. Pour en savoir davantage sur l'annulation du dploiement d'applications, reportez-vous la documentation de votre serveur d'application. Si le rpertoire vers lequel IBM Cognos 8 tait initialement dploy n'est pas supprim pendant le processus d'annulation du dploiement, supprimez le rpertoire. Supprimez galement les fichiers .jar d'IBM Cognos 8 mis en antmmoire dans l'environnement de votre serveur d'application. Par exemple, dans WebLogic 7.0, des fichiers .jar sont parfois conservs dans %WL_HOME%\user_ projects\<nom_domaine>\<nom_serveur_gr>\.wlnotdelete\c8_p2pd_p2pd\jarfiles Vous pouvez les supprimer en supprimant le rpertoire WEB-INF. Dans WebLogic 8.1.2, l'emplacement de mise en antmmoire est %WL_HOME%\user_projects\ domains\<nom_domaine>\<nom_serveur_gr>\.wlnotdelete\extract\c8_p2pd_p2pd\jarfiles Aprs avoir supprim tous les fichiers de l'installation prcdente, vous pouvez redployer IBM Cognos 8.
Les caractres chinois, japonais et coren sont diffrents aprs la mise jour
Si vous utilisez des caractres chinois, japonais ou corens, il est possible que des diffrences apparaissent sur certains caractres aprs avoir mis IBM Cognos 8 niveau. Exemples Vous excutez un rapport. Lorsque vous comparez la sortie avec le mme rapport dans ReportNet, vous constatez que certains caractres sont diffrents. Vous effectuez une recherche et vous obtenez des rsultats qui diffrent de celle ralise dans ReportNet.
458
Annexe B: Dpannage Ces diffrences proviennent des tables de conversion utilises pour le chinois, le japonais et le coren, qui ont t modifies pour rpondre des normes internationales. Si les spcifications de votre rapport ou vos filtres de recherche contiennent des expressions utilisant des valeurs constantes, les rsultats peuvent s'en trouver affects. Si vous souhaitez utiliser la mme table de conversion que celle utilise dans ReportNet, excutez le script suivant dans le rpertoire emplacement_c8/bin : Sous UNIX, saisissez conv_compat.sh Sous Linux, saisissez conv_compat.sh Sous Windows, saisissez conv_compat.cdm
Les caractres accentus ou deux octets risquent de ne pas s'afficher correctement lors de l'installation d'IBM Cognos 8 sous Linux
Si vous utilisez issetup avec une langue associe l'encodage UTF-8, les caractres accentus ou deux octets risquent de ne pas s'afficher correctement. Pour rsoudre ce problme lors de l'installation de la version allemande ou franaise, utilisez un environnement local n'tant pas associ l'encodage UTF-8 et lancez issetup ou utilisez le programme en mode caractre issetupcc pour installer IBM Cognos 8. Pour rsoudre ce problme lors de l'installation en japonais, utilisez le programme en mode caractre issetupcc et remplacez l'encodage du module X Terminal par Shift-JIS, puis installez IBM Cognos 8.
L'erreur RSV-SRV-0066 indiquant qu'un incident soap a t renvoy ou l'erreur RQP-DEF-0114 indiquant que l'utilisateur a annul la demande s'affiche dans les environnements forte charge d'utilisateurs.
Si la charge d'utilisateurs est importante (plus de 165 utilisateurs) et que les rapports interactifs s'excutent en continu dans une installation rpartie, ces erreurs peuvent s'afficher dans le fichier cogserver.log de C8. Pour rsoudre ce problme, augmentez le paramtre async_wait_timeout_ms dans le fichier webapps/ p2pd/WEB-INF/services/reportservice.xml. Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration de Cognos 8. Augmentez galement le dlai de file d'attente 360. Pour en savoir davantage, reportez-vous au Guide d'administration et de scurit d'IBM Cognos 8.
Problmes de configuration d'IBM Cognos 8

Une fois les composants d'IBM Cognos 8 installs, vous pouvez tre confront certains problmes lors de l'enregistrement des modifications dans IBM Cognos Configuration.
Annexe B: Dpannage Assurez-vous de : configurer et de dmarrer les services sur l'ordinateur sur lequel Content Manager est install avant de configurer d'autres composants, redmarrer le service IBM Cognos 8 aprs avoir effectu les modifications de configuration.
Excution de scripts de nettoyage de base de donnes

Dans certaines situations de dpannage, il vous sera peut-tre conseill de dmarrer avec de nouvelles donnes de configuration. Vous pouvez excuter un script SQL pour supprimer toutes les tables des bases de donnees utilises par les composants d'IBM Cognos 8 suivants : la base de donnes Content Store ncessaire au fonctionnement d'IBM Cognos 8, la base de donnes de diffusion utilise pour transmettre des notifications de rapports, la base de donnes de journalisation utilise pour les messages d'analyse, la bibliothque d'indicateurs utilise pour stocker le contenu des packs d'indicateurs et les prfrences des utilisateurs de Metric Studio.
Lorsque vous supprimez une table, la dfinition de sa structure et ses donnes sont supprimes de faon permanente de la base de donnes. Il est galement possible de supprimer les objets stocks dans la base de donnes de la bibliothque d'indicateurs. Lorsque vous redmarrez le service IBM Cognos 8, un nouveau jeu de tables de base de donnes est cr automatiquement l'emplacement indiqu par les paramtres de configuration.
Procdure
1. Arrtez le service IBM Cognos 8 sur chaque ordinateur sur lequel Content Manager est install. 2. Ouvrez le rpertoire appropri : Pour supprimer les tables de la base de donnes de journalisation, ouvrez le rpertoire emplacement_c8\configuration\schemas\logging. Pour supprimer les tables de la base de donnes Content Store, ouvrez le rpertoire emplacement_c8\configuration\schemas\content. Pour supprimer les tables de la base de donnes de notification, ouvrez le rpertoire emplacement_c8\configuration\schemas\delivery. Pour supprimer les tables de la bibliothque d'indicateurs, ouvrez le rpertoire emplacement_c8\configuration\schemas\cmm.
3. Ouvrez le rpertoire de base de donnes appropri. 4. Selon le type de base de donnes, excutez l'un des scripts suivants afin de supprimer les tables :
460
Annexe B: Dpannage
Base de donnes
Type de base de donnes
Nom du script
base de donnes DB2 Content Store Derby Microsoft SQL Server Oracle Sybase Notification DB2 Derby Microsoft SQL Server Oracle Sybase Journal DB2 Derby Microsoft SQL Server Oracle Sybase Bibliothque d'indicateurs DB2
dbClean_db2.sql
dbClean_derby.sql dbClean_mssqlserver.sql
dbClean_oracle.sql dbClean_sybase.sql NC_DROP_DB2.sql NC_DROP_Derby.sql NC_DROP_MS.sql
NC_DROP_ORA.sql NC_DROP_SYBASE.sql LS_dbClean_db2.sql LS_dbClean_derby.sql LS_dbClean_mssql.sql
LS_dbClean_oracle.sql LS_dbClean_sybase.sql cmm_uninstall pseudonyme_base_de_donnes nom_utilisateur mot_de_passe Dfinissez un pseudonyme pour la base de donnes seulement si une base donnes portant le mme nom est dj catalogue.
Microsoft SQL
cmm_uninstall nom_bibliothque_indicateurs nom_base_de_ donnes nom_utilisateur_Admin mot_de_passe
Annexe B: Dpannage
Base de donnes
Type de base de donnes

Oracle
Nom du script
cmm_uninstallnom_base_de_donnes nom_utilisateur_base_ de_donnes mot_de_passe Remplacez nom_base_de_donnes par le nom qui figure dans le fichier tnsnames.ora qui fait rfrence au SID de la base de donnes pour Metric Studio
5. Dmarrez le service IBM Cognos 8.
Erreur de chiffrement lors de l'enregistrement de la configuration

Lorsque vous enregistrez la configuration l'aide de l'outil de configuration, vous pouvez voir s'afficher un message d'erreur indiquant l'chec du chiffrement des informations cryptographiques. Une erreur s'est produite lors de la demande d'un certificat l'autorit de certification. Impossible de chiffrer les informations cryptographiques. Voulez-vous enregistrer la configuration sous forme de texte brut ? Avant de chiffrer des paramtres de configuration, l'ordinateur sur lequel Content Manager est install doit tre configur et actif. Sous UNIX, copiez les fichiers .jar appropris dans l'emplacement d'installation de Java Runtime Environment. En outre, vrifiez que votre environnement Java est correctement configur, que les URI sont corrects et que le mme mot de passe d'autorit de certification est configur sur tous les ordinateurs Content Manager. Sous Linux, copiez les fichiers .jar appropris dans l'emplacement d'installation de Java Runtime Environment. Un message d'erreur semblable au suivant peut s'afficher : java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory. En gnral, une erreur cryptographique signifie que l'environnement Java n'est pas correctement configur. Vrifiez que la variable d'environnement JAVA_HOME est correctement dfinie et que les fournisseurs de scurit appropris sont installs, tels que JSSE pour JRE 1.31.
Procdure de vrification de la configuration

1. Dmarrez IBM Cognos Configuration sur l'ordinateur Content Manager. 2. Dans la fentre Explorateur, cliquez sur Environnement. 3. Dans la fentre Proprits, vrifiez les proprits suivantes : Dans la section Paramtres de la passerelle, URI de la passerelle. Dans la section Paramtres du distributeur, URI externe du distributeur et URI interne du distributeur.
462
Annexe B: Dpannage Dans la section Autres paramtres de l'URI, URI du distributeur pour des applications externes et URI de Content Manager. 4. Dans la fentre Explorateur, cliquez sur Scurit, Cryptographie, IBM Cognos. 5. Dans la section Paramtres de l'autorit de certification de la fentre Proprits, cliquez sur la valeur associe Mot de passe. Veillez ce que le mme mot de passe soit utilis sur tous les ordinateurs Content Manager. 6. Enregistrez la configuration et redmarrez IBM Cognos 8.
Problmes de gnration de cls cryptographiques dans IBM Cognos Configuration

Lorsque vous installez IBM Cognos 8, des dossiers temporaires sont crs. Rinstaller le produit au mme emplacement sans commencer par supprimer les dossiers temporaires peut causer des problmes lors d'une tentative de gnration des cls cryptographiques dans IBM Cognos Configuration. Pour rsoudre ce problme, dsinstallez IBM Cognos 8, supprimez le dossier emplacement_c8/temp/cam et rinstallez IBM Cognos 8.
CAM-CRP-1315 Erreur lors de l'enregistrement de la configuration

Lorsque vous enregistrez la configuration, le message suivant peut s'afficher : CAM-CRP-1315 La configuration actuelle pointe vers un domaine scuris autre que celui qui tait configur au dpart. Cette erreur se produit lorsque des modifications ont t apportes au domaine scuris de votre environnement. Le domaine scuris est administr par l'autorit de certification associe au Content Store. Cette erreur peut se produire si le Content Store d'origine a t supprim ou si vous avez modifi votre configuration de faon utiliser Content Manager avec un autre Content Store aprs avoir enregistr votre configuration originale. Pour rsoudre ce problme, modifiez votre configuration afin d'utiliser le Content Store original ou gnrez nouveau les cls cryptographiques.
Procdure de rgnration des cls cryptographiques

1. Sur l'ordinateur Content Manager, sauvegardez les cls cryptographiques existantes en enregistrant les rpertoires suivants dans un autre emplacement scuris : emplacement_c8/configuration/csk emplacement_c8/configuration/encryptkeypair emplacement_c8/configuration/signkeypair
2. Supprimez les rpertoires csk, encryptkeypair et signkeypair. 3. Dans IBM Cognos Configuration, enregistrez la configuration et redmarrez les services. 4. Rptez les tapes 1 3 sur tous les ordinateurs sur lesquels les composants d'IBM Cognos 8 sont installs. Guide d'installation et de configuration 463
Annexe B: Dpannage
Le changement manuel du nom du rpertoire d'installation a une incidence sur les installations s'excutant sous un serveur d'application
Vous avez install IBM Cognos 8 l'aide de l'assistant d'installation, puis renomm le rpertoire d'installation ou copi manuellement son contenu dans un autre rpertoire. Lorsque vous tentez d'excuter IBM Cognos 8 sur un serveur d'application, un des problmes suivants peut survenir : IBM Cognos 8 ne dmarre pas. Les rpertoires de journalisation sont vides. Une erreur lie un lien incorrect ou sans correspondance est consigne dans les journaux.
Lorsque vous changez manuellement le rpertoire d'installation, les informations du rpertoire racine IBM Cognos 8 deviennent incorrectes. Pour rsoudre le problme, vous devez soit mettre jour le rpertoire racine IBM Cognos 8 avant de crer le fichier d'application IBM Cognos 8 dployer sur le serveur d'application, soit rinstaller IBM Cognos 8 dans l'emplacement d'origine. Si vous rinstallez IBM Cognos 8, suivez la procdure de mise niveau.
Procdure
1. Dans le rpertoire d'installation nouveau ou renomm, ouvrez le fichier emplacement_c8/ webapps/p2pd/WEB-INF/classes/cogroot.link dans un diteur de texte. 2. Remplacez le chemin d'accs par le nouvel emplacement du rpertoire d'installation et enregistrez le fichier. 3. Pour crer le fichier d'application dployer sur le serveur d'application, dans IBM Cognos Configuration, cliquez sur Crer des fichiers d'application dans le menu Oprations. 4. Si vous avez cr et dploy un fichier d'application sur le serveur d'application avant de mettre jour le fichier cogroot.link, annulez le dploiement. 5. Dployez le nouveau fichier d'application sur le serveur d'application. Pour en savoir davantage sur la configuration d'IBM Cognos 8 pour un autre serveur d'application, reportez-vous au Guide d'installation et de configuration.
538629
Les donnes de configuration sont verrouilles par une autre instance d'IBM Cognos Configuration
Vous pouvez recevoir un message d'erreur indiquant que les donnes de configuration sont verrouilles par une autre instance d'IBM Cognos Configuration. Lorsque vous lancez IBM Cognos Configuration, celui-ci vrifie si le fichier cogstartup.lock existe dans le rpertoire emplacement_c8/configuration. Il est possible que ce fichier s'y trouve si la session prcdente ne s'est pas termine correctement ou si une autre instance d'IBM Cognos Configuration est active. Si une autre instance d'IBM Cognos Configuration est active, vous devez la fermer. Sinon, les modifications que vous apportez la configuration locale risquent d'entraner des erreurs.
464
Annexe B: Dpannage Si aucune autre instance d'IBM Cognos Configuration n'est en cours d'excution, supprimez le fichier cogstartup.lock du rpertoire emplacement_c8/configuration. Si le service IBM Cognos 8 est arrt, cliquez sur le bouton Dmarrer.
Echec de sortie d'une squence de tabulations en cas de navigation l'aide du clavier dans IBM Cognos Configuration
Si vous utilisez la touche de tabulation pour naviguer dans IBM Cognos Configuration, vous risquez d'avoir difficults pour sortir d'une squence de tabulations. Par exemple, dans la fentre Proprits, vous pouvez utiliser la touche de tabulation pour passer d'une proprit l'autre. Toutefois, IBM Cognos Configuration tant une application Java, vous devez appuyer sur les touches [Ctrl]+[Tab] pour fermer la fentre Proprits.
chec de l'enregistrement de la configuration

Il peut tre impossible d'enregistrer la configuration s'il manque une ressource. Par exemple, vous avez supprim une ressource telle que l'espace-noms d'IBM Cognos, un fournisseur cryptographique ou la base de donnes Content Store. Vous pouvez remplacer le type de base de donnes Content Store implicite par une base de donnes de type Oracle, DB2 ou Sybase. Vous ne pouvez pas remplacer l'espace-noms d'IBM Cognos. Vous pouvez le crer nouveau, mais vous devez dans ce cas crer nouveau les groupes et rles d'IBM Cognos. Pour en savoir davantage sur la cration des groupes et rles dans IBM Cognos Connection, reportez-vous au Guide d'administration et de scurit.
Procdure de recration de l'espace-noms d'IBM Cognos

1. Dmarrez IBM Cognos Configuration. 2. Dans la fentre Explorateur, dans la section Scurit, cliquez avec le bouton droit sur l'option Authentification, puis cliquez successivement sur les options Nouvelle ressource et Espace-noms. 3. Dans la zone Nom, saisissez un nom pour la ressource. 4. Dans la zone Type, slectionnez IBM Cognos, puis cliquez sur OK. L'espace-noms d'IBM Cognos s'affiche dans la fentre Explorateur. 5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Erreur Java lors du dmarrage d'IBM Cognos Configuration

Lorsque vous dmarrez IBM Cognos Configuration, vous pouvez recevoir un message d'erreur modifi par l'environnement JRE (Java Runtime Environment) signalant que les informations cryptographiques en cours ne sont pas compatibles avec le nouvel environnement JRE. Vous pouvez tre invit gnrer nouveau ces informations cryptographiques pour le nouvel environnement JRE ou rtablir la version antrieure du JRE. Cette erreur peut se produire pour l'une des raisons suivantes :
Annexe B: Dpannage Vos donnes de configuration ont t chiffres l'aide d'un JRE diffrent de celui actuellement utilis par les composants d'IBM Cognos 8. Les informations cryptographiques ont pu tre endommages.
Si vous cliquez sur Crer nouveau dans la fentre d'erreur, le service IBM Cognos 8 est arrt et les informations cryptographiques sont nouveau gnres. Si vous cliquez sur Quitter dans la fentre d'erreur, vous devez dfinir la variable d'environnement JAVA_HOME pour qu'elle pointe vers le JRE utilis pour enregistrer votre configuration. Sous Windows, si vous souhaitez que les composants d'IBM Cognos 8 utilisent l'environnement JRE install par dfaut, annulez la dfinition de JAVA_HOME ou dfinissez JAVA_HOME sur emplacement_c8/bin/jre. Remarque : Pour passer d'un JRE un autre, reportez-vous la rubrique relative au changement de version de JVM utilise par les composants d'IBM Cognos 8. Pour en savoir davantage, reportezvous au Guide d'installation et de configuration.
Erreur de chiffrement lors du dmarrage d'IBM Cognos Configuration

Lorsque vous dmarrez IBM Cognos Configuration, le message d'erreur suivant peut s'afficher : Les informations cryptographiques ont peut-tre t altres ou le fichier cogstartup.xml n'est pas valide. Vous devrez peut-tre rparer le fichier ou le supprimer du disque.. Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration. Cette erreur survient lorsque les composants d'IBM Cognos 8 dtectent une erreur dans le fichier cogstartup.xml. Cela peut se produire lorsque le fichier cogstartup.xml est modifi manuellement et que le texte modifi comporte une erreur. Pour rsoudre ce problme, remplacez le fichier cogstartup.xml par une copie se trouvant dans l'emplacement de sauvegarde.
Paramtres de configuration actuels non appliqus l'ordinateur

IBM Cognos Configuration permet de modifier les valeurs de proprit implicites ou d'ajouter une ressource une installation. Aprs avoir enregistr la configuration actuelle, il est possible que vous ne puissiez plus voir les changements ou que vous ne puissiez plus utiliser la ressource dans l'environnement d'excution. Pour appliquer les nouveaux paramres l'ordinateur, vous devez redmarrer le service IBM Cognos 8.
Procdure de redmarrage du service IBM Cognos 8

1. Dmarrez IBM Cognos Configuration. 2. Dans le menu Oprations, cliquez sur la commande approprie : Si le service IBM Cognos 8 est en cours d'excution, cliquez sur le bouton Redmarrer. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution et redmarre ceux qui l'taient. Si vous souhaitez redmarrer un service spcifique, slectio-
466
Annexe B: Dpannage nnez le noeud du service dans la fentre de l'explorateur et cliquez sur Redmarrer dans le menu Oprations. Si le service IBM Cognos 8 est arrt, cliquez sur le bouton Dmarrer. Cette opration dmarre tous les services installs qui n'taient pas en cours d'excution. Si vous souhaitez dmarrer un service spcifique, slectionnez son nud dans la fentre Explorateur et cliquez sur Dmarrer dans le menu Oprations.
CM-CFG-029 Une erreur s'est produite en tentant d'enregistrer un configuration qui indique que la source de donnes est de type SQL Server
Dans IBM Cognos Configuration, vous tentez d'enregistrer une configuration et le message d'erreur suivant s'affiche dans le fichier cogserver.log. CM-CFG-029 Content Manager ne peut pas dterminer si Content Store est initialis.. EXECUTE permission is denied on object "sp_tables", database "master", owner "dbo'. Ce message indique que vous ne disposez pas des droits d'accs ncessaires pour initialiser Content Store ou pour crer une table dans la base de donnes. Pour rsoudre ce problme, assurez-vous que l'utilisateur du Content Store dispose des droits d'accs ncessaires l'utilisation de la procdure stocke 'sp_tables' dans la base de donnes principale.
DPR-ERR-2079 Quand Content Manager est configur pour la reprise

Vous avez configur plusieurs ordinateurs en mode d'attente pour assurer la reprise pour Content Manager. Nanmoins, l'utilisateur voit s'afficher le message d'erreur suivant :
DPR-ERR-2079 Firewall Security Rejection. Your requestwas rejected by the security firewall
Ce message d'erreur risque de s'afficher si vous n'avez pas configur tous les ordinateurs en attente comme htes valides pour IBM Cognos Application Firewall. Pour rsoudre ce problme, sur chaque ordinateur rparti, dmarrez IBM Cognos Configuration et procdez comme suit : 1. Dans le volet Explorateur, cliquez sur Scurit, puis sur IBM Cognos Application Firewall. 2. Dans le volet de droite, cliquez sur la colonne Valeur en regard de Domaines ou htes valides. 3. Cliquez sur le bouton d'dition. 4. Entrez le nom de tous les ordinateurs que vous configurez pour la reprise. 5. Enregistrez et dmarrez la configuration.
Les utilisateurs sont invits fournir les rfrences d'identification Active Directory
Le mcanisme de connexion unique ne fonctionne pas lorsqu'IBM Cognos 8 est configur comme suit : Microsoft Internet Explorer s'excute sur un ordinateur Windows NT. Guide d'installation et de configuration 467
Annexe B: Dpannage L'espace-noms d'authentification est configur avec le fournisseur Active Directory. Microsoft Internet Explorer sur un serveur Windows 2000 ou Windows 2003 est configur pour l'authentification intgre de Windows.
Les utilisateurs sont alors invits fournir leurs rfrences d'identification Active Directory. Ce problme se produit car le fournisseur Active Directory d'IBM Cognos 8 utilise le protocole ADSI et la dlgation Kerberos pour l'authentification dans un environnement de connexion unique. Lorsque Microsoft Internet Explorer s'excute sous Windows NT, il ne peut pas s'authentifier auprs du serveur IIS via la dlgation Kerberos. Lorsque votre systme est configur pour l'authentification intgre de Windows, pour que la connexion unique fonctionne avec IIS, vous devez configurer IBM Cognos 8 pour communiquer avec le serveur Active Directory l'aide du fournisseur LDAP. configurer la proprit de correspondance des identits externes pour lire la variable d'environnement REMOTE_USER.
Police introuvable au dmarrage d'IBM Cognos Configuration sous UNIX

Lorsque vous dmarrez IBM Cognos Configuration, le message d'erreur suivant peut s'afficher : Police spcifie dans font.properties non trouve... Il s'agit d'un problme courant sous UNIX. Cela indique que le composant JVM (Java Virtual Machine) tente d'utiliser une ou plusieurs polices non installes sur l'ordinateur. Cependant, le composant JVM doit utiliser les valeurs systme implicites, tandis qu'IBM Cognos Configuration doit dmarrer et fonctionner normalement. Pour viter ces erreurs, ajoutez les polices manquantes Java Runtime Environment en modifiant les fichiers font.properties. Plusieurs fichiers font.properties contenant des informations d'environnement de polices standard sont installs avec le SDK Java (Software development kit). Ces fichiers se trouvent dans le rpertoire emplacement_JRE/lib. Pour en savoir davantage, reportez-vous la documentation sur Java.
Impossible de charger la bibliothque Essbase/DB2 OLAP dans Framework Manager

Si vous installez une version cliente Essbase/DB2 OLAP antrieure celle configure pour IBM Cognos 8, l'erreur suivante peut s'afficher : DB2-ERR-0028 Impossible de charger la bibliothque DB2 OLAP suivante : "C:\ibm\db2olap\bin\ essapin.dll" Par exemple, vous avez install l'application cliente DB2 OLAP 8.1 et le fichier qfs_config.xml dans IBM Cognos 8 est configur pour utiliser la version 8.2 de la bibliothque DB2 OLAP.
468
Annexe B: Dpannage Pour rsoudre ce problme, vous devez modifier le fichier qfs_config.xml et renommer la bioblothque de la version cliente que vous installez.
Procdure
1. Dans le rpertoire emplacement_c8\configuration, modifiez le fichier qfs_config.xml. 2. Recherchez le code suivant :
<provider name="DB2OlapODP" libraryName="doodp82"connectionCode="DO"/>
3. Renommez la bibliothque doodp82 ou doodp81 et enregistrez les modifications. La configuration cliente par dfaut est Hyperion Essbase version 9.3.1. Si vous installez l'application cliente DB2 OLAP pour la version 8.1 ou 8.2, vous devez modifier le fichier qfs_config.xml et renommer la bibliothque de la version cliente que vous installez.
Procdure
1. Dans le rpertoire emplacement_c8\configuration, modifiez le fichier qfs_config.xml. 2. Recherchez le code suivant :
<provider name="DB2OlapODP" libraryName="essodp93" connectionCode="DO"/>
3. Renommez la bibliothque essodp93 en doodp81 ou doodp82 et enregistrez les modifications.
Une adhsion un groupe manque dans l'espace-noms Active Directory

Si un espace-noms Active Directory est configur pour la mme arborescence et qu'un utilisateur est authentifi l'aide de rfrence d'identification, l'adhsion au groupe manquera. L'identit de processus d'IBM Cognos 8, dans le cadre d'une excution en tant que compte systme local ou utilisateur de domaine, doit disposer de ces privilges : Emprunter l'identit d'un client aprs l'authentification Agir en tant que partie du systme d'exploitation
Si ce n'est pas le cas, aucune adhsion de groupe n'existe pour l'utilisateur authentifi. Pour rsoudre ce problme, suivez les tapes suivantes :
Procdure
1. Dans le menu Dmarrer, cliquez sur Paramtres, puis sur Panneau de configuration. 2. Cliquez sur Outils d'administration, puis cliquez deux fois sur Stratgie de scurit locale. 3. Dans l'arborescence de la console, cliquez sur Paramtres de scurit, puis surStratgies locales. 4. Cliquez sur Attribution des droits utilisateur. 5. Ajoutez l'identit de processus d'IBM Cognos 8 l'une des stratgies suivantes : Emprunter l'identit d'un client aprs l'authentification La valeur implicite est Administrateurs, SERVICE.
Annexe B: Dpannage Pour en savoir davantage, allez l'adresse suivante : http://technet2.microsoft.com/ WindowsServer/en/Library/fe1fb475-4bc8-484b-9828-a096262b54ca1033.mspx Agir en tant que partie du systme d'exploitation La valeur implicite est Systme local. Pour en savoir davantage, allez l'adresse suivante : http://technet2.microsoft.com/ WindowsServer/en/Library/ec4fd2bf-8f91-4122-8968-2213f96a95dc1033.mspx Ces deux privilges permettent un compte d'agir pour le compte d'un autre utilisateur. Le privilge Emprunter l'identit d'un client aprs l'authentification est similaire au privilge Agir en tant que partie du systme d'exploitation ceci prs qu'il permet un processus d'emprunter l'identit aprs l'authentification, alors que ce dernier permet un processus de le faire avant l'authentification. Pour en savoir davantage, allez l'adresse suivante : http://www.microsoft.com/technet/ prodtechnol/windowsserver2003/technologies/security/tkerbdel.mspx
Dploiement d'IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere

Vous dployez IBM Cognos 8 vers un serveur d'application Oracle ou IBM WebSphere et vous recevez les messages d'erreur suivants : Browser timeout in administration console Error Message: HTTP 500 Internal Error Error Message: Deployment failed: Base Exception: java.rmi.RemoteException (Oracle) Return to application file selection page (IBM WebSphere)
Cette erreur se produit, car le fichier d'application que vous tentez de dployer est trop volumineux. Pour rsoudre ce problme, sur le serveur d'application Oracle, vous pouvez dployer le fichier d'application manuellement en utilisant la commande suivante : dcmctl deployapplication -f <chemin d'accs et nom du fichier EAR> -a <nom de l'application> -co <nom de l'instance OC4J> Quel que soit le serveur d'application utilis (IBM WebSphere ou Oracle), dsactivez l'option Incluez les fichiers statiques partir du dossier Webcontent lorsque vous utilisez l'Assistant Cration d'application. Le fait d'exclure le contenu statique permet de rduire la taille du fichier d'application. Si vous avez besoin du contenu statique, vous pouvez le copier manuellement l'emplacement de l'application dploye une fois IBM Cognos 8 dploy sur le serveur d'application. Pour en savoir davantage sur le dploiement d'IBM Cognos 8 vers un serveur d'application, reportez-vous au Guide d'installation et de configuration.
Erreurs affiches lors du dploiement vers le serveur d'application Oracle 10G

Vous dployez IBM Cognos 8 sur un serveur d'application Oracle 10G et obtenez les messages d'erreur suivants :
470
Annexe B: Dpannage CMM-APP-3254 chec de l'initialisation de la bibliothque d'indicateurs. DIS-ERR-3115 chec de l'excution de la tche. MDS-RUN-3213 Impossible de reprer l'emplacement de l'utilitaire de chargement en bloc de la base de donnes. Veuillez installer l'outil de base de donnes appropri pour cette plate-forme ('bcp' pour SQL Server, 'sqlldr' pour Oracle) Ceci est d l'absence d'utilitaire de chargement en bloc (SQL Loader sur Oracle) dans le fichier de dploiement cr par IBM Cognos Configuration. Pour rsoudre cette erreur, vous devez utiliser le logiciel client Oracle sur l'ordinateur sur lequel vous avez install le serveur d'application Oracle 10G, afin d'installer les composants manquants. N'oubliez pas d'installer SQL Loader.
Erreur de page introuvable lors de l'excution de rapports l'aide d'IBM Cognos 8 Go! Office
Dans un document Microsoft Office configur pour IBM Cognos 8 Go! Office, vous recevez le message d'erreur La page est introuvable lorsque vous utilisez l'option Excuter le rapport. Cela peut se produire si la passerelle et le distributeur IBM Cognos 8 utilisent "localhost" comme valeur du nom de serveur sur le serveur IBM Cognos 8. Pour corriger ce problme, utilisez le nom de l'ordinateur pour les valeurs hte de la passerelle et du distributeur la place de "localhost".
Erreur d'initialisation de la base de donnes Content Store d'Oracle aprs une mise niveau partir de ReportNet
Vous crez une base de donnes Content Store dans Oracle ou mettez niveau une base de donnes Content Store ReportNet dans Oracle vers IBM Cognos 8, et vous recevez le message d'erreur suivant : Content Manager can not initialise the content store with the assistance of the initialisation file: dbupgrade2_0021-to-2_0022_oracle.sql ORA-22858 invalid alteration of datatype Cette erreur se produit si le niveau de compatibilit de la base de donnes Oracle est infrieur 9.0.1. Vous pouvez corriger ce problme en optant pour le niveau de compatibilit 9.0.1 ou un niveau suprieur et en redmarrant l'instance Oracle.
Erreur de dlai d'attente d'un script CGI lors de la connexion aux composants d'IBM Cognos 8 par le biais d'un navigateur Web
Lors des oprations ci-dessous dans votre navigateur Web, le message d'erreur suivant s'affiche : Dlai d'attente CGI expir, le processus sera supprim du serveur. L'erreur survient lorsque vous utilisez Windows Internet Information Services (IIS) comme serveur Web et que la passerelle est configure pour utiliser CGI. IIS dispose d'un dlai d'attente implicite pour les applications CGI.
Annexe B: Dpannage Pour rsoudre ce problme, vous pouvez configurer la passerelle de manire ce qu'elle utilise l'interface ISAPI. IIS ne dispose pas de dlai d'attente implicite pour les applications ISAPI. Sinon, pour continuer utiliser une passerelle CGI, vous pouvez augmenter le dlai d'attente CGI dans IIS.
Procdure de configuration de la passerelle avec l'interface ISAPI

1. Sur l'ordinateur passerelle, dmarrez IBM Cognos Configuration. 2. Dans la section Environnement, pour la proprit URI de la passerelle, modifiez la partie cognos.cgi de l'URI cognosisapi.dll 3. Dans votre navigateur Web, indiquez l'URI ISAPI : http://nom_ordinateur/cognos8/isapi
Procdure d'augmentation du dlai d'attente CGI

1. Dans les outils d'administration de Windows, ouvrez les services d'information Internet. 2. Dans la section correspondant au noeud de l'ordinateur local, cliquez avec le bouton droit de la souris sur Sites Web, puis slectionnez l'option Proprits. 3. Dans l'onglet Rpertoire de base, cliquez sur Configuration. 4. Dans l'onglet Options du processus, augmentez le dlai d'attente du script CGI.
chec du chargement de la classe de servlets dans WebLogic

Vous pouvez rencontrer des problmes lors de la configuration d'une installation de serveur rpartie et de l'utilisation de WebLogic en tant que serveur d'application pour IBM Cognos 8. Lorsque vous dployez le fichier p2pd.war pour l'ordinateur des composants d'application, vous pouvez recevoir des exceptions de servlet et le distributeur peut ne pas dmarrer. De plus, le fichier cogserver.log n'est pas cr. Les messages d'erreur suivants s'affichent dans la console du serveur WebLogic : <Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP><BEA-101249> <[ServletContext (id=19023494,name=p2pd,context-path=/p2pd)]:Servlet class com.cognos.pogo.isolation.ServletWrapper for servletcfgss could not be loaded because the requested class was not found in the classpath /host2/bea812/user_projects/domains/c8/applications/p2pd/WEB-INF/classes. java.lang.ClassNotFoundException: com.cognos.pogo.isolation.ServletWrapper.> <Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP> <BEA-101216> <Servlet: "cfgss" failed to preload on startup in Web application: "p2pd". javax.servlet.ServletException: [HTTP:101249][ServletContext(id=19023494,name=p2pd,contextpath=/p2pd)]: Servlet class com.cognos.pogo.isolation.ServletWrapperfor servlet cfgss could not be loaded because the requested class was not found in the classpath /host2/bea812/user_projects/ domains/c8/applications/p2pd/WEB-INF/classes.java.lang.ClassNotFoundException:
472
Annexe B: Dpannage com.cognos.pogo.isolation.ServletWrapper. at weblogic.servlet.internal.ServletStubImpl.prepareServlet (ServletStubImpl.java:799) at weblogic.servlet.internal.WebAppServletContext.preload Servlet(WebAppServletContext.java:3252) Pour viter ce problme, ne dployez par l'application p2pd partir du rpertoire des applications WebLogic. Crez le rpertoire p2pd dans un autre emplacement puis dployez l'application correspondante partir de ce rpertoire.
Procdure
1. Ouvrez IBM Cognos Configuration et configurez l'ordinateur des composants d'application. 2. Redmarrez l'ordinateur Content Manager. 3. Crez un rpertoire p2pd dans un emplacement accessible par le serveur WebLogic mais ne figurant pas dans le rpertoire des applications WebLogic. Crez par exemple un rpertoire nomm p2pd l'emplacement suivant : emplacement_WebLogic/user_projects/nom_domaine 4. Crez le fichier p2pd.war. 5. Dans le rpertoire p2pd, procdez l'extraction du fichier p2pd.war vers l'installation de WebLogic l'aide de la commande suivante : %JAVA_HOME%/bin/jar xvfm "emplacement_c8/p2pd.war" . 6. Dmarrez WebLogic. 7. Dans la console du serveur WebLogic, dployez l'application p2pd.
Les icnes du bureau ou la fentre IBM Cognos Configuration scintillent sous Windows
Lorsque vous excutez IBM Cognos Configuration sous Windows, il est possible que les icnes du bureau ou la fentre IBM Cognos Configuration scintillent. Pour rsoudre ce problme, dmarrez IBM Cognos Configuration l'aide de l'option de ligne de commande -noddraw.
Annexe B: Dpannage
474
Glossaire
accs anonyme
Mthode d'accs des ressources qui ne requiert pas l'authentification des utilisateurs; tous les utilisateurs disposent des mmes droits d'accs.
algorithme de chiffrement
Lors de l'utilisation de la scurit SSL, ensemble d'algorithmes d'authentification, de chiffrement et d'intgrit des donnes utiliss dans l'change de messages entre les nuds d'un rseau. Lors d'une liaison SSL, les deux nuds ngocient afin de dterminer quel algorithme de chiffrement utiliser lors de la transmission des messages.
archive de dploiement
Fichier utilis pour le dploiement. Une archive de dploiement contient les donnes du Content Store qui sont dplaces.
authentification
Processus de vrification de lidentit des utilisateurs lors de leur connexion. Les utilisateurs doivent tre authentifis avant de pouvoir tre autoriss utiliser une ressource scurise.
autorit de certification
L'autorit de certification est le composant IBM Cognos qui met des certificats sur chaque poste de travail o sont installs des composants. Vous pouvez galement faire appel d'autres autorits de certification (non IBM Cognos).
bibliothque d'indicateurs
Base de donnes qui renferme du contenu pour les packs d'indicateurs. Une bibliothque d'indicateurs contient aussi les paramtres de Metric Studio, tels que les prfrences de l'utilisateur.
certificat
Document qui identifie quelqu'un ou quelque chose par son nom. Les certificats sont distribus par les autorits de certification. Tout poste de travail IBM Cognos dans une installation rpartie utilise un certificat diffrent. Les certificats sont utiliss pour identifier une entit. Ils sont utiliss dans les signatures numriques et les communications scurises et peuvent tre utiliss pour le chiffrement ou le dchiffrement.
composants tiers de l'application

Lors de l'installation, les processeurs qui accdent aux bases de donnes de requtes pour recueillir des informations et afficher les rsultats sous forme de rapports en format PDF ou HTML et sous forme d'indicateurs. Les composants tiers de l'application envoient aussi les demandes Content Manager et affichent les rsultats que Content Manager extrait du Content Store.
Glossaire
connexion
Information nomme qui dfinit le type de source de donnes, son emplacement physique et toute exigence en termes de code daccs. Une source de donnes peut disposer de plusieurs connexions.
Content Manager
Service IBM Cognos 8 qui gre le stockage des applications client, incluant la scurit propre aux applications, les donnes de configuration, les modles, les indicateurs, les rapports et les versions de rapports. Content Manager est ncessaire pour publier des modles, extraire ou stocker des spcifications de rapports, grer des informations de planification ou encore grer l'espace-noms d'IBM Cognos.
Content Store
Base de donnes qui contient les donnes ncessaires au fonctionnement d'IBM Cognos 8, telles que les spcifications de rapports, les modles publis et les packs qui les contiennent, les informations de connexion aux sources de donnes, les informations relatives l'espace-noms externe et celui d'IBM Cognos, ainsi que les informations concernant les calendriers de production de rapports et la diffusion de rapports en rafale. Les modles de conception et les fichiers journaux ne sont pas stocks dans Content Store. Le service IBM Cognos 8 qui utilise la base de donnes Content Store s'appelle Content Manager.
droits d'accs
Rgles dfinissant les droits d'accs aux ressources. Les droits d'accs peuvent tre accords toute combinaison d'espaces-noms, de groupes ou d'utilisateurs. Les rapports et les dossiers sont des exemples de ressources.
espace-noms
Il s'agit d'une instance configure d'un fournisseur d'authentification, pour l'authentification et le contrle de l'accs. Donne accs aux informations d'utilisateurs et de groupes. Dans XML, collection de noms, identifis par une rfrence URI, qui sont utiliss dans les documents XML comme types d'lments et noms d'attributs. Dans Framework Manager, les espaces-noms servent identifier de faon unique des lments de requte, des sujets de requte, etc. Importez des bases de donnes diffrentes dans des espaces-noms distincts pour viter l'apparition de noms en double.
fichier de rponse
Fichier ASCII qui contient les donnes de configuration ncessaires l'automatisation de l'installation. Pour les installations IBM Cognos, le fichier de rponse automatise seulement le processus de copie des fichiers avec la configuration implicite.
fournisseur d'authentification
Mcanisme de communication avec une source d'authentification externe. Les fonctions d'authentification des utilisateurs, d'inscription des groupes et de recherche d'espaces-noms sont disponibles par l'intermdiaire des fournisseurs d'authentification.
476
Glossaire
fournisseur de scurit
Voir Fournisseur d'authentification.
glyphe
Image dun caractre dans une police. Les lettres sont des glyphes, mais dans la plupart des cas, le terme est utilis dans le cadre de systmes dcriture non alphabtiques.
groupe
En matire de scurit, liste d'utilisateurs ou d'autres groupes utilise pour la dfinition des droits d'accs. Il peut s'agir de groupes provenant d'autres sources d'authentification ou d'une source locale d'IBM Cognos 8. La gestion des groupes locaux se fait dans le portail d'administration. La liste des groupes auxquels appartient un utilisateur d'authentification est contenue dans le passeport de l'utilisateur lors d'une session IBM Cognos 8. En matire de reporting, il s'agit du regroupement des valeurs communes d'un lment de requte afin de ne les afficher qu'une seule fois. Les en-ttes et cartouches apparaissent souvent aprs chaque occurrence dune valeur commune dans une colonne groupe.
HTTPS
Version scurise du protocole HTTP (Hypertext Transfer Protocol) qui intgre la scurit SSL (Secure Sockets Layer). Les produits IBM Cognos utilisent les protocoles HTTPS et SSL pour chiffrer et transmettre des mots de passe en toute scurit par Internet.
interface de passerelle commune (CGI)

(CGI) Norme qui dcrit comment les serveurs Web devraient accder aux autres programmes afin de crer un document qui puisse tre affich dans un navigateur. Par exemple, les serveurs Web utilisent souvent des programmes CGI pour traiter des formulaires.
invite
lment de rapport qui demande des valeurs avant lexcution du rapport.
langue du produit
Code ou paramtre qui indique la langue ou les paramtres rgionaux utiliser pour certaines sections de linterface du produit, telles que les commandes de menu.
pack d'indicateurs
Reprsentation d'une application Metric Studio dans IBM Cognos Connection. Un pack d'indicateurs contient des informations de connexion, des rapports et des tches de gestion des indicateurs pour cette application.
Glossaire
paramtres rgionaux
Code utilis pour dfinir la langue ou le dialecte utiliser dans le navigateur, le contenu d'un rapport, etc.; ainsi que les prfrences rgionales, notamment le format de la date, de l'heure et de la monnaie. Pour les produits IBM Cognos, vous pouvez indiquer les paramtres rgionaux propres linterface du produit (paramtres rgionaux du produit) et dautres propres aux donnes du rapport (paramtres rgionaux du contenu).
paramtres rgionaux
Code utilis pour dfinir la langue ou le dialecte utiliser dans le navigateur, le contenu d'un rapport, etc.; ainsi que les prfrences rgionales, notamment le format de la date, de l'heure et de la monnaie. Pour les produits IBM Cognos, vous pouvez indiquer les paramtres rgionaux propres linterface du produit (paramtres rgionaux du produit) et dautres propres aux donnes du rapport (paramtres rgionaux du contenu).
passeport
Informations de session relatives aux utilisateurs authentifis. Un passeport est cr la premire fois qu'un utilisateur accde IBM Cognos 8. Il est conserv jusqu la fin de la session, soit lorsque lutilisateur se dconnecte, soit aprs une priode dinactivit donne. Les informations de passeport sont stockes dans la mmoire de Content Manager. Les rfrences d'identification sont chiffres, puis stockes. Un passeport est stock dans un tmoin de navigation tout au long de la session.
passerelle
Extension dun programme de serveur Web qui transfre les informations depuis le serveur Web vers un autre serveur. Les passerelles sont souvent des programmes CGI, mais peuvent suivre dautres normes, telles que ISAPI et Apache.
portlet
Mcanisme d'affichage du contenu Web sous forme de page dans le portail.
pseudonymes
Dans le domaine de la modlisation et des bases de donnes, il s'agit d'un autre nom pour dsigner une table de base de donnes. Les pseudonymes sont utiliss pour crer une rfrence distincte une table dans le modle, afin de crer des auto-jointures ou de rsoudre des chemins d'accs vers des requtes ambigus. Dans le domaine de la technologie de l'information des cartes, il s'agit d'un autre nom pour dsigner un lment de carte. Les pseudonymes sont utiliss pour crer une rfrence entre des noms d'lments de cartes personnaliss et des noms d'lments dans les bases de donnes.
rfrences d'identification
Informations stockes sur lidentit dun utilisateur IBM Cognos, gnralement un nom dutilisateur et un mot de passe. Vous pouvez affecter vos rfrences didentification une autre personne de sorte quelle puisse utiliser les ressources que vous tes autoriss utiliser.
478
Glossaire Les rfrences d'identification sont cres pour les composants d'IBM Cognos. Si un utilisateur planifie ou programme une action, les rfrences didentification doivent tre stockes dans Content Store.
source de donnes
Base de donnes relationnelle, cube dimensionnel, fichier ou autres bibliothques de donnes accessibles partir d'IBM Cognos 8.
spcification de rapport
Dfinition des requtes, des invites, des prsentations et des styles qui constituent un rapport. Une spcification de rapport est combine des donnes par une opration d'excution pour crer des sorties de rapports. Vous crez des spcifications de rapports l'aide de Report Studio, Query Studio, Analysis Studio ou l'aide du Software Development Kit.
tche
La plus petite partie dun travail pouvant tre excute sparment. Habituellement, une tche est un rapport. Une tche peut galement tre un autre travail.
travail
Groupe d'objets excutables, tels que des rapports, des agents et d'autres travaux que vous programmez et que vous excutez par lots.
utilisateur
Personne qui accde une application IBM Cognos 8. Des informations utilisateur, telles que l'emplacement des dossiers personnels ou les formats favoris d'affichage des rapports, sont stockes dans IBM Cognos 8. Les informations et les dfinitions relatives aux utilisateurs authentifis, telles que les mots de passe ou les codes d'utilisateurs, sont mises jour dans d'autres sources d'authentification.
Glossaire
480
Index
Symboles
.otl, fichiers, 250 algorithmes de chiffrement dfinition, 475 algorithmes de chiffrement (ciphersuites) dfinition d'une priorit pour les connexions SSL, 329 alias Web IBM Cognos 8, 133 IBM Cognos 8, 180 analyse journal, 332 Analysis Studio description des composants, 26 modifications aprs mise niveau, 21 annulation de l'inscription des distributeurs, 398 Apache Derby migration vers la base de donnes Content Manager, 95 Apache Tomcat mise au point, 421 Apache Web Servers configuration des alias, 133, 180 applications SDK observations concernant la mise niveau, 86 archivage version de rapport, 324 archives de dploiement dfinition, 475 arrt du service IBM Cognos 8 depuis la ligne de commande, 431 ASCII exigences pour le rpertoire d'installation, 450 assistant Nouveau pack d'indicateurs mise niveau de la bibliothque d'indicateurs, 146, 191 attribut contextuel impossible dsrialiser, 458 aucune rponse gnre, 455 authentification Active Directory Server, 264 arborescences de domaines d'Active Directory Server, 267 code d'accs unique pour NTLM, 298
A
AC, Voir autorit de certification acceptCount augmentation pour Apache Tomcat, 421 accs anonyme activation pour les donnes de rapport PowerPlay dans IBM Cognos 8 Go ! Office, 229 dfinition, 475 activation IBM Cognos Application Firewall, 314 services, 317 SSL pour serveur d'application, 397 Active Directory Server activation du code d'accs unique, 268 activation du protocole SSL, 267 adhsion un groupe manquante, 469 authentification dans plusieurs domaines, 267 avec un espace-noms LDAP, 279 proprits avances, 267 utilisation pour authentification, 264 Active Scripting activation dans les navigateurs Web, 73 affichage de barres obliques inverses au lieu de monnaies, 341 agent, service, 418 agrgation exemples et dimensions de temps, 238 aide obtention, 15 AIX erreur de connexion la base de donnes DB2, 449 variables d'environnement pour l'installation d'IBM Cognos 8, 123 variables d'environnement pour l'installation d'IBM Cognos 8, 156, 169, 175 version d'IBM WebSphere, 456 algorithme de confidentialit, 313
Index code d'accs unique utilisant Active Directory Server, 268 code d'accs unique utilisant eTrust SiteMinder, 296 code d'accs unique utilisant l'espace-noms IBM Cognos Series 7, 272 code d'accs unique utilisant LDAP, 292 code d'accs unique utilisant SAP, 301 configuration de l'espace-noms IBM Cognos Series 7, 270 dfinition, 475 dsactivation de la connexion anonyme, 263 eTrust Siteminder, 293, 295, 296 fonction SaferAPIGetTrustedSignon, 273 fournisseurs d'authentification personnaliss, 275 LDAP, 276, 278 LDAP utilisant Active Directory Server, 279 LDAP utilisant IBM Directory Server, 282 LDAP utilisant Novell Directory Server, 285 LDAP utilisant Sun Java System Directory Server, 287 modules d'extension Trusted Signon pour IBM Cognos Series 7, 272 NTLM, 297 proprits d'utilisateur personnalises pour LDAP, 290 proprits personnalises pour Active Directory Server, 266 SAP, 299 spcifications relatives au code d'accs unique avec Microsoft Analysis Server ou Microsoft SQL Server, 264 SSL pour eTrust Siteminder, 296 SSL utilisant LDAP, 290 suppression d'espaces-noms, 302 test des espaces-noms, 302 utilisation d'espaces-noms, 261 authentification intgre de Windows, 268 problmes, 467 autorisations pour le compte utilisateur employ pour le service IBM Cognos 8, 160, 172, 178, 306 autorit de certification configuration, 405 dfinition, 475 service de configuration, 405 autre logiciel observations relatives la mise niveau, 81 autres composants, 28 autres produits mise niveau, 110
B
base de donnes Content Manager migration partir d'Apache Derby, 95 base de donnes Content Store base de donnes de contenu d'IBM Cognos, 69 configuration de clients de base de donnes, 69 cration, 63, 121 critres pour le changement de serveur d'application, 381 DB2, 64 description des composants, 29 gestion de la connexion, 128, 160 importation de donnes, 399, 405 Microsoft SQL Server, 66 mise niveau, 87, 448 Oracle, 66 paramtres non valides, 443 Sybase Adaptive Server Enterprise, 68 base de donnes de contenu d'IBM Cognos amlioration des performances, 422 base de donnes Content Store, 69 changer les utilisateurs et mots de passe, 307 description des composants, 27 dsinstallation, 150, 194 base de donnes de notification suppression de tables, 460 base de donnes des journaux suppression de tables, 460 bases de donnes bibliothque d'indicateurs, 140, 185 client de base de donnes de journalisation, 335 Content Store, 63 exemples d'IBM Cognos, 244 journalisation, 334 journalisation, cration, 63 journalisation, test, 136, 208, 219, 227 notification, 130, 166 rtablissement l'tat d'origine dans Event Studio, 259 suppression de tables, 460
482
Index utilitaire de chargement en bloc manquant, 470 bases de donnes de journalisation cration, 63 test, 136, 208, 219, 227 bases de donnes de requtes, 29 bases de donnes SQL Server cration d'une base de donnes Content Store, 66 BEA WebLogic, 379 besoins en termes de production de rapports pour les utilisateurs de Transformer, 41 bibliothque d'indicateurs amlioration des performances, 423 configuration de clients de base de donnes, 69 configuration de variables d'environnement sous UNIX, 72 connectivit la base de donnes, 63 cration, 140, 185 cration de connexions une source de donnes, 144, 189 DB2, 143, 188 description des composants, 29 chec, 470 Microsoft SQL Server, 141, 185 mise niveau, 88, 146, 191 Oracle, 141, 143, 186, 187 pilotes JDBC, 69 bibliothque de donnes, Voir bibliothque d'indicateurs bibliothques d'indicateurs dfinition, 475 BI bus observations concernant la mise niveau, 87 blocage des incrustations, 454 caractres non pris en charge, 443 caractres spciaux dans les proprits des espaces-noms LDAP, 276 catalogues et rapports Impromptu migration vers IBM Cognos 8, 51 certificats dfinition, 475 chanes de connexion la base de donnes IBM DB2, 128, 160 Microsoft SQL Server, 128, 160 Oracle, 128, 160 changement passerelle IBM Cognos 8, 349 version Java, 402 chase_referral, fichiers, 267 chemins d'accs configuration pour les tmoins (cookies), 348 chiffrement erreurs de configuration, 462 modification des paramtres en configuration sans surveillance, 428 chinois les caractres s'affichent de faon incorrecte aprs la mise niveau, 458 clavier problmes de navigation, 465 cls cryptographiques cration pour d'autres autorits de certification, 405 gnrer nouveau, 463 sauvegarde et suppression, 382, 402 cl symtrique commune, 311 client de base de donnes conditions requises pour les modlisateurs Transformer, 360 conditions requises pour Transformer, 41 configuration pour une base de donnes de journalisation, 335 client de la base de donnes configuration, 69 client intelligent supprim d'IBM Cognos 8 Go! Office, 20 code d'accs unique activation de l'accs aux documents IBM Cognos 8 Go ! Office bass sur des rapports PowerPlay, 229 annuaire d'utilisateurs eTrust SiteMinder, 296 Guide d'installation et de configuration 483
C
calendriers mise niveau de calendriers personnaliss Metrics Manager, 109 caractre du won, 341 caractre du yen, 341 caractres encodage non pris en charge, 443 caractres accentus affichage incorrect, 459 caractres deux octets affichage incorrect, 459 caractres affichs de faon incorrecte, 459
Index espace-noms Active Directory, 268 espace-noms LDAP, 292 espace-noms NTLM, 298 espace-noms SAP, 301 utilisation de l'espace-noms IBM Cognos Series 7, 272 Cognos 8, Voir IBM Cognos 8 Cognos Software Services, site Web, 15 cogroot.link, fichier, 464 communications LDAP scurises, 290 composants, 25 Administration d'IBM Cognos, 25 Analysis Studio, 26 autre, 25 base de donnes Content Store, 29 base de donnes de contenu d'IBM Cognos, 27 bibliothque d'indicateurs, 29 composants d'application, 34, 35 Composite Information Server, 27 Content Manager, 27, 35, 46, 122 Event Studio, 26 exemples IBM Cognos 8, 27 Framework Manager, 28 IBM Cognos 8 Go! Office, 26 IBM Cognos Configuration, 26 IBM Cognos Connection, 25 IBM Cognos Viewer, 25 installation, 122 installation sur un mme ordinateur, 32 Map Manager, 28 Metric Designer, 28 Metric Studio, 26 passerelles, 27, 33, 122 Query Studio, 26 rpartition de Metric Designer, 47 Report Studio, 26 serveur de rapports, 122 sources de donnes, 29 Transformer, 28 composants d'application configuration requise, 35, 46 installation sur un ordinateur spar, 34 installation sur un ordinateur spar des composants de cration de tableaux de bord IBM Cognos 8, 45 serveur de journalisation, 332 composants de cration de tableaux de bord IBM Cognos 8 installation d'une passerelle sur un ordinateur spar, 44 installation des composants d'application sur un ordinateur spar, 45 installation sur un mme ordinateur, 43 composants de modlisation, 28 fichier d'installation pour les modlisateurs Transformer, 360 composants du serveur, 25 composants tiers de l'application dfinition, 475 Composite Information Server description des composants, 27 compte utilisateur spcifications pour l'excution du service IBM Cognos 8, 160, 172, 178, 306 conditions requises pour installer IBM Cognos 8 Go! Office, 115 configuration ajout de ressources, 426 apache_mod pour la passerelle, 202, 207 automatisation, 411 configuration requise pour Metric Designer, 49 Content Manager, 35, 46 destination des messages de journalisation, 332 donnes verrouilles, 464 chec d'enregistrement, 465 emplacement des fichiers temporaires, 316 en mode silencieux pour la mise niveau, 104 erreur de chiffrement des informations, 462 espace-noms Active Directory, 264 espace-noms eTrust SiteMinder, 295 espace-noms LDAP, 278 espace-noms LDAP pour Active Directory Server, 279 espace-noms LDAP pour IBM Directory Server, 282 espace-noms NTLM, 297 espace-noms SAP, 300 excution partir de la ligne de commande, 431 excution de plusieurs versions d'IBM Cognos 8, 110 exemples, 244 fichier de verrouillage, 438 fichiers de spcification de transfert (.ats), 411 fournisseurs d'authentification personnaliss, 275
484
Index Framework Manager, 37 Framework Manager sur un autre ordinateur, 201, 206 fuseau horaire implicite, 346 graphiques de type Carte de Report Studio, 325 IBM Cognos 8, 78 IBM Cognos 8 Go ! Office, 227 IBM Cognos 8 pour des serveurs d'application, 385 IBM Cognos 8 pour fonctionner avec d'autres produits d'IBM Cognos, 354 impossible d'ouvrir IBM Cognos Configuration, 438 impossible de chiffrer les informations cryptographiques, 462 ISAPI pour la passerelle, 202, 207 manuelle, 425 modification des paramtres implicites, 306 modification du modle, 318 navigateurs Web, 73 observations concernant la mise niveau, 89, 98 options avances, 401 ordinateur Content Manager en attente, 164 paramtres d'IBM Cognos 8, 306 paramtres d'IBM Cognos 8, 60 paramtres de Tomcat, 60 paramtres globaux, 338 paramtres implicites, 306 paramtres non appliqus, 466 passerelles, 179 pilotes JDBC, 69 polices, 319 Portal Services, 365 proprits de l'environnement pour les composants d'application, 173 proprits du serveur d'application, 390 proprits en configuration sans surveillance, 428 protocole SSL, 325 routeurs, 77 sans surveillance, 411, 415 sauvegarde, 382, 402 scurit partage avec d'autres serveurs, 328 serveur de messagerie, 130, 166 serveur Web, 133, 180 service d'autorit de certification, 405 service IBM Cognos 8, 318 servlets pour la passerelle, 202, 207 spcifications relatives au code d'accs unique avec Microsoft Analysis Server ou Microsoft SQL Server, 264 test, 136, 208, 219, 227 Transformer, 39, 213 configuration requise, 58 Framework Manager, 198 Metric Designer, 220 Transformer, 210 configuration sans surveillance configuration, 411 modification des proprits, 428 configurations sans surveillance mise niveau, 104 configurations silencieuses, Voir configurations sans surveillance configurer sans surveillance, 415 connectivit la base de donnes base de donnes Content Store, 61 bibliothque d'indicateurs, 63 bibliothque de rapports, 62 bibliothque de requtes, 62 connexion configuration de la scurit, 127, 168 masquage d'espaces -noms, 276, 297 problmes avec l'authentification intgre de Windows, 467 connexion anonyme dsactivation, 263 connexions connexions la source de donnes, 247 dfinition, 475 sources de donnes OLAP, 251 connexions la base de donnes, Voir connexions la source de donnes connexions la source de donnes bibliothques d'indicateurs, 144, 189 dfinition, 128, 160 connexions ODBC pour les sources de donnes, 76 consultation du fichier Lisezmoi avant l'installation, 58 Content Manager composant, 35, 46 conditions requises en cas d'utilisation d'IBM Cognos 8 Transformer avec un espace-noms Series 7, 122, 209, 270 Guide d'installation et de configuration 485
Index configuration, 35, 46 configuration d'une base de donnes Content Store, 63 configuration sur plusieurs ordinateurs, 164 critres pour le changement de serveur d'application, 381 dfinition, 476 description des composants, 27 en attente, 35, 46 installation, 122 modification des fuseaux horaires, 346 observations concernant la mise niveau, 87 options d'installation, 35, 46 protection de reprise, 35, 46 serveur de journalisation, 332 tentative d'inscription du distributeur, 449 Content Manager, service, 418 Content Store dfinition, 476 erreur d'initialisation dans Oracle, 471 et autres emplacements permettant le stockage des versions de rapports, 323 pilotes JDBC, 69 sauvegarde, 382, 402 suppression de tables dans une base de donnes, 460 versions compatibles de DB2 et Java, 443 Content Store DB2, 421 Content Store Oracle erreur d'initialisation, 471 niveaux de compatibilit, 471 Controller, Voir IBM Cognos 8 Controller coren les caractres s'affichent de faon incorrecte aprs la mise niveau, 458 Correspondance des identits externes, proprit caractres spciaux pour un espace-noms LDAP, 276 modification pour un espace-noms LDAP, 292 courriers lectroniques modification de l'encodage, 346 cration base de donnes Content Store, 121 bibliothque d'indicateurs, 140, 185 connexions de la source de donnes la bibliothque d'indicateurs, 144, 189 pack d'indicateurs, 144, 189 cration de tableaux de bord IBM Cognos 8 installation d'une passerelle sur un ordinateur spar, 44 installation des composants sur un mme ordinateur, 43 rpartition des composants, 42 cration de tableaux de bord IBM Cognos 8 installation des composants d'application sur un ordinateur spar, 45 cube MS, 450 cubes accs dans IBM Cognos 8, 53 conditions requises pour une conversion linguistique russie, 53 mise niveau, 116 mise niveau d'un cube scuris, 118 ouverture impossible, 450 publis depuis IBM Cognos Series 7 aprs mise niveau, 113 Series 7, 118
D
Data Manager utilisation dans IBM Cognos 8 BI, 53 date d'expiration du contenu rpertoire d'images, 133 DB2, 451 base de donnes Content Store, 64 bibliothque d'indicateurs, 143, 188 configuration de pilotes JDBC, 335 connectivit la base de donnes, 61, 62, 63 pages de codes, 137, 203, 216, 223 pilotes JDBC, 70 variables d'environnement, 64 versions Java prises en charge, 443 DB2-ERR-0028, 468 DB2 OLAP chec du chargement de la bibliothque, 468 DecisionStream conditions requises pour la mise niveau des catalogues vers IBM Cognos 8, 50 DecisionStream vers IBM Cognos 8 observations concernant la mise niveau, 50 dfinition connexions la source de donnes, 128 dlai d'attente asynchrone, 423
486
Index demandes de signature de certificat cration, 405 dmarrage chec du script, 456 chec du tlchargement de cognos.xts, 455 chec du tlchargement des ressources, 449 chec sans erreur, 443 erreur SQL1224N retourne par DB2 en cas de connexion depuis AIX, 449 fichier de verrouillage de la configuration, 438 impossible d'ouvrir IBM Cognos Connection, 452 impossible de dmarrer le service, 442 page non trouve, 451 problmes, 439 Report Studio ne dmarre pas, 454 service IBM Cognos 8, 466 service IBM Cognos 8 depuis IBM Cognos Configuration, 132 dmarrage du service IBM Cognos 8 depuis la ligne de commande, 431 dpannage, 437 journalisation, 332 dploiement chec de serveur d'application Oracle ou WebSphere, 456 IBM Cognos 8, 470 Transformer pour les modlisateurs, 362 dploiement d'IBM Cognos 8, 390 Derby taille de l'antmmoire de pages, 422 dsactivation travail de mise jour du contenu, 257 dsinstallation base de donnes de contenu d'IBM Cognos, 150, 194 Framework Manager, 149, 193 IBM Cognos 8, 147, 149 IBM Cognos 8, 192, 193 IBM Cognos 8 Go! Office, 115 Metric Designer, 149, 193 Metrics Manager, 105 service ReportNet, 112 Transformer, 149, 193 destination de journal types, 332 diagnostic, Voir dpannage diffusion rduction du dlai d'ouverture des rapports, 423 diffusion, service, 418 diffusion de rapports sur un rseau, 423 distributeur annuler l'inscription, 398 chec du dmarrage sur l'ordinateur des composants d'application, 472 distributeurs indicateurs systme, 417 documentation connexe, 13 documents protgs par copyright impression, 15 domaines arborescences de domaines d'Active Directory Server, 267 configuration pour les tmoins (cookies), 348 donnes exemples d'IBM Cognos, 244 verrouilles par IBM Cognos Configuration, 464 droits d'accs dfinition, 476 pour les modlisateurs Transformer, 360
E
chec du tlchargement de ressources, 449 cran, scintillement, 473 emplacement des fichiers temporaires configuration, 316 proprits, 316 emplacements graphiques de type Carte, 325 emplacements de fichiers conditions requises sous Windows Vista, 355 encodage des courriers lectroniques en tha critres JRE, 346 environnements pris en charge, 58 environnements pris en charge, 58 quilibrage de charge, 78 activation et dsactivation de services, 317 configuration des paramtres de serveur de messagerie, 130, 166 dfinition, 34, 45 erreur CAM-CRP-1157, 443 Guide d'installation et de configuration 487
Index erreur cryptographique, 466 erreur JRE, 465 fichier cogstartup.xml non valide, 466 problmes aprs la mise niveau, 463 erreur de contexte, 458 erreur de domaine scuris l'enregistrement de la configuration, 463 erreur de page introuvable dmarrage d'IBM Cognos 8 sous Windows 2003, 451 erreur de rpertoire introuvable, 451 erreur DPR-DPR-1035, 443 erreur du dlai d'attente CGI, 471 erreur EBA-090034 sur WebLogic 8, 454 erreur HTTP 404, 451 erreur Java lors du dmarrage de la configuration, 465 erreurs DB2-ERR-0028, 468 espace-noms masquage durant la connexion, 276, 297 espace-noms d'IBM Cognos nouvelle cration, 465 espaces de table, 421 espaces-noms adhsion un groupe manquante dans Active Directory Server, 469 authentification, 261 conditions requises pour Content Manager en cas d'utilisation de Transformer avec un espace-noms Series 7, 122, 209, 270 configuration de fournisseurs d'authentification personnaliss, 275 connexion impossible, 448 dfinition, 476 nouvelle cration, 465 suppression, 302 test, 302 espaces-noms configuration pour une passerelle, 316 Essbase, 451 exemple de cube, 250 eTrust SiteMinder activation du code d'accs unique, 296 configuration d'espaces-noms, 295 protection de l'alias Web IBM Cognos 8, 296 488 SSL, 296 utilisation pour l'authentification, 293 vrification de scripts intersites dans IBM Cognos Application Firewall, 314 tude de site, 81 Event Studio description des composants, 26 exemples, 258 rtablissement de la base de donnes son tat d'origine, 259 Excel non-fonctionnement du type de rapport multipage, 457 exemples, 27 base de donnes transactionnelles Ventes VA, 240 conception de modles, 239 configuration, 244 connexions la source de donnes, 247 cube Essbase, 250 cube MSAS, 249 Entrept de donnes VA, 239 Event Studio, 258 importation, 255 informations gnrales sur les employs, 238 informations gnrales sur les finances, 236 informations gnrales sur les ventes et le marketing, 238 Metric Designer, 244 Metric Studio, 253 modles, 257 restauration des exemples de bases de donnes, 244 sources de donnes OLAP, 251 structure de la socit Vacances et aventure, 236 suppression, 259 Vacances et aventure, 235 exemples d'IBM Cognos, 244 exemples IBM Cognos 8, 27 exigences rpertoire d'installation, 450 exportation fichiers de configuration, 415
F
fichier .jar erreur lors du dmarrage de la configuration, 465
Index fichier apache_mod configuration pour les passerelles, 202, 207 fichier cogstartup.lock, 438 fichier cogstartup.xml, 426, 431 fichier non valide, 466 modification manuelle des proprits, 428 fichier cogstartup.xml non valide, 466 fichier d'installation tlchargement pour les modlisateurs Transformer, 360 fichier d'installation de Transformer, 360 Fichier de rfrence d'utilisateur, proprit caractres spciaux pour un espace-noms LDAP, 276 fichier jar, 126, 159, 200 fichier p2pd.war pour WebLogic, 458 fichier response.ats, 411 fichiers introuvables, 451 fichiers d'archive Java, Voir fichier jar fichiers d'archives Enterprise dploiement d'IBM Cognos 8, 432 fichiers d'archives Web dploiement d'IBM Cognos 8, 432 fichiers de carte, emplacement configuration pour Windows Vista, 355 fichiers de configuration applications.xml pour Cognos Portal Services, 365 coglocale.xml, 429 cogstartup.xml, 426 exportation, 415 fichiers de dploiement, emplacement configuration pour Windows Vista, 355 fichiers de donnes, emplacement configuration pour Windows Vista, 355 fichiers de rponses dfinition, 476 fichiers des fournisseurs de scurit copie dans l'environnement JVM du serveur d'application, 126, 159, 200, 384, 404 fichiers de spcification de transfert (.ats) configuration, 411 fichiers EAR, Voir fichiers d'archives Enterprise fichiers journaux, 437 configuration de dmarrage, 438 configuration des paramtres rgionaux, 438 dsinstallation, 439 excution, 438 mode silencieux, 439 pour les erreurs de passerelle, 439 rcapitulatif des transferts, 438 transfert, 437 fichiers temporaires, emplacement configuration pour Windows Vista, 355 fichiers WAR, Voir fichiers d'archives Web Firefox paramtres du navigateur, 73 flux de travaux excution dans IBM Cognos Connection l'aide du service de transfert de donnes, 53 fournisseurs d'authentification configuration d'IBM Cognos 8 pour l'utilisation de la scurit, 127 configuration d'IBM Cognos 8 pour l'utilisation de la scurit, 168 dfinition, 476 fournisseurs d'authentification personnaliss, 275 fournisseurs de scurit dfinition, 476 Framework Manager accs IBM Cognos 8 hors d'un parefeu, 202, 207 configuration, 37 configuration des sources de donnes, 137, 203 configuration des systmes de contrle de la source, 357 configuration du client de base de donnes, 69 configuration requise, 198 configuration sur un autre ordinateur, 201, 206 description des composants, 28 dsinstallation, 149, 193 erreur de chiffrement, 441 exemples de modles, 257 impossible de charger la bibliothque DB2 OLAP, 468 installation, 197 observations concernant la mise niveau, 87 options d'installation, 37 test de l'installation et de la configuration, 208 fuseaux horaires modification, 346 fuseaux horaires du serveur modification, 346
Index
G
gestion amlioration des performances du systme, 417 gestion des vnements, service, 419 glyphes dfinition, 477 graphiques de type Carte, 325 groupes adhsion un groupe manquante dans Active Directory Server, 469 dfinition, 477 groupes d'applications, 133
H
HP-UX variables d'environnement pour l'installation d'IBM Cognos 8, 123 variables d'environnement pour l'installation d'IBM Cognos 8, 156, 169, 175 HTTPS dfinition, 477
I
IBM Cognos exemples, 244 IBM Cognos 8 changement des serveurs d'application, 379 composants, 25 connexion, 127 dpannage des installations, 437 dploiement, 390 dsinstallation, 147 distributeurs, 420 excution sur le mme ordinateur que ReportNet, 110 installation, 122 le service ne dmarre pas, 443 ne dmarre pas sur un serveur d'application, 464 options d'installation, 31 paramtres implicites, 121 partage des composants d'un mme ordinateur, 36 services, 420 IBM Cognos 8 configuration, 78 configuration requise, 58 connexion, 168 490
dsinstallation, 192 IBM Cognos 8 Controller considrations lors de mise niveau d'IBM Cognos 8 BI, 89 IBM Cognos 8 Go !Office configuration, 227 IBM Cognos 8 Go! Office dploiement des composants client, 230 description des composants, 26 dsinstallation, 115 fonctions modifies, 20 mise niveau, 114 niveau de scurit des macros pour Microsoft Office XP, 232 SSL, 232 test de l'installation des composants client, 232 IBM Cognos 8 Go ! Office fichiers de modles, 227 SSL, 228 utilisation de rapports PowerPlay, 229 IBM Cognos 8 Go! Office erreur lors de l'excution de rapports, 471 IBM Cognos 8 Go! Search utilisation pour rechercher le contenu IBM Cognos 8 BI, 54 IBM Cognos 8 Metrics Manager cration d'un pack d'indicateurs, 144 IBM Cognos 8 Metrics Manager, installation, 159, 172, 178 IBM Cognos 8 Transformer configuration des sources de donnes, 137 IBM Cognos 8 Transformer configuration des sources de donnes, 216 configuration du client de base de donnes, 69 IBM Cognos Administration description des composants, 25 IBM Cognos Application Firewall configuration, 314 IBM Cognos Configuration description des composants, 26 erreur de police introuvable sous UNIX, 468 impossible de dmarrer, 464 mode sans surveillance, 415 paramtres incorrects, 443 problme de gnration de cls cryptographiques aprs l'installation, 463
Index problmes d'enregistrement d'une configuration, 459 problmes d'ouverture, 438 problmes de navigation l'aide du clavier, 465 IBM Cognos Connection description des composants, 25 ouverture impossible, 452 IBM Cognos Controller accs aux donnes dans IBM Cognos 8, 52 IBM Cognos DecisionStream conditions requises pour la mise niveau des catalogues vers IBM Cognos 8, 50 IBM Cognos Finance accs aux donnes dans IBM Cognos 8, 52 IBM Cognos Go! Mobile rapports mobiles, 54 IBM Cognos Metrics Manager conditions requises pour la mise niveau vers IBM Cognos 8, 50 mise niveau de rapports enregistrs de la version 2.x vers IBM Cognos 8, 87 mise niveau vers IBM Cognos 8, 50, 85 IBM Cognos NoticeCast duplication des fonctions dans IBM Cognos 8, 54 IBM Cognos Office Connection, Voir IBM Cognos 8 Go! Office IBM Cognos Planning - Analyst accs aux donnes dans IBM Cognos 8, 52 IBM Cognos Planning - Contributor accs aux donnes dans IBM Cognos 8, 52 activation des rapports et agents programms, 355 migration vers IBM Cognos 8, 51 IBM Cognos Portal Services prsentation de la migration, 55 IBM Cognos PowerPlay Web conditions requises pour la mise niveau des rapports vers IBM Cognos 8, 50 IBM Cognos Query duplication des fonctions dans IBM Cognos 8, 54 IBM CognosScript prsentation de la migration, 55 IBM Cognos Series 7 activation du code d'accs unique, 272 activation du protocole SSL, 272 migration vers IBM Cognos 8, 51 modules d'extension Trusted Signon, 272 utilisation pour authentification, 270 IBM Cognos Series 7, cubes conditions requises pour une conversion linguistique russie, 53 publication aprs mise niveau, 113 IBM Cognos Series 7 Transformer, modles prparation pour la mise niveau vers IBM Cognos 8, 117 IBM Cognos Visualizer duplication des fonctions dans IBM Cognos 8, 54 IBM Cognos Web Services prsentation de la migration, 54 IBM DB2 cration de chanes de connexion, 128, 160 IBM Directory Server avec un espace-noms LDAP, 282 IBM WebSphere, 379 version AIX, 456 images chargement dans Report Studio, 133 date d'expiration du contenu, 133 importation exemples, 255 fichiers MDL depuis IBM Cognos Series 7, 117 impossible d'ouvrir IBM Cognos Configuration, 438 impossible de chiffrer les informations cryptographiques, 462 impression de documents protgs par copyright, 15 indicateur de scurit paramtre de tmoins (cookies), 348 indicateurs pour serveurs, distributeurs et services, 417 informations recherche, 14 installation dans un environnement qui inclut IBM Cognos 8 Controller, 89 exigences pour le nom de rpertoire, 450 Framework Manager, 197 IBM Cognos 8, 121, 122, 411 IBM Cognos 8 sous Linux, 459 liste contrle, 121 Metric Designer, 219 options associes Transformer, 39 options de Content Manager, 35, 46 options de Framework Manager, 37 prsentations rapides, 136, 184 Guide d'installation et de configuration 491
Index sans surveillance, 411 test, 136, 169, 174, 185, 208, 219, 227 Transformer, 21, 209 installation sans surveillance configuration, 411 installations rparties configuration de Framework Manager, 201, 206 configuration de Transformer, 213 Metric Designer, 47 scnarios, 31, 42 installations silencieuses, Voir installation sans surveillance installer installation sans surveillance, 411, 412 utilisation de fichiers de spcification de transfert (.ats), 411, 412 intgration de donnes, service, 418 interface personnalisation de la prise en charge linguistique, 339 interface de passerelle commune (CGI) dfinition, 477 remplacement, 349 interface utilisateur mise en correspondance pour la langue du produit, 345 personnalisation de la prise en charge linguistique, 339 Internet Explorer paramtres du navigateur, 73 invites dfinition, 477 IPv4, 354 IPv6, 354 ISAPI accs IBM Cognos 8, 349 configuration pour la passerelle, 202, 207 utilisation pour une passerelle, 471 configuration d'une passerelle de type servlet pour des serveurs Web compatibles Java, 352 mise jour des environnements JRE, 126, 159, 200, 384, 404 types de machine virtuelle, 401 utilisation de toutes les ressources du processeur, 443 versions prises en charge pour le Content Store DB2, 443 JAVA_HOME dfinition, 465 java.lang.NoClassDefFoundError, 441 JDBC, 69 base de donnes Content Store, 62 bases de donnes Oracle, 71 bibliothque d'indicateurs, 63 connectivit la base de donnes Content Store, 61 DB2, 70 journal traitement des messages, 332 journal d'analyse destinations, 332 Voir galement dpannage Voir galement message de journalisation journal des vnements Windows destination des messages de journalisation, 334 journalisation base de donnes, 334 client de base de donnes, 335 configuration, 336 serveurs de journalisation distants, 334 service, 419 utilisation des fichiers, 334 journal systme destination des messages de journalisation, 334 journaux des vnements, 334 JRE mise jour, 126, 159, 200, 384, 404 JVM changement, 382, 402 copie des fichiers de fournisseur de scurit, 126, 159, 200, 384, 404 paramtres de mmoire de la base de donnes de contenu d'IBM Cognos, 422
J
japonais les caractres s'affichent de faon incorrecte aprs la mise niveau, 458 Java changement de version, 402
492
Index
L
langue du produit dfinition, 477 langues incompatibilit aprs la mise niveau, 458 personnalisation de la prise en charge des paramtres rgionaux du contenu, 342 personnalisation pour l'interface utilisateur, 339 tables de conversion, 458 langues du produit mise en correspondance pour l'interface utilisateur, 345 LDAP activation du code d'accs unique, 292 activation du protocole SSL, 290 Active Directory Server, 279 configuration d'un espace-noms, 278 IBM Directory Server, 282 modification de la proprit Correspondance des identits externes, 292 Novell Directory Server, 285 proprits personnalises, 290 Sun Java System Directory Server, 287 utilisation pour authentification, 276 Lier le nom unique et le mot de passe de l'utilisateur, proprit caractres spciaux pour un espace-noms LDAP, 276 Linux affichage incorrect des caractres, 459 configuration requise, 121 connexions ODBC aux sources de donnes, 76 dmarrage et arrt du service IBM Cognos 8, 431 fonctions et composants non pris en charge, 58 messages de journalisation, 334 variables d'environnement pour IBM Cognos 8, 123 variables d'environnement pour IBM Cognos 8, 156, 169, 175 variables d'environnement pour Transformer, 211 Lisezmoi, fichier consultation avant l'installation, 58 listes d'incorporation des polices, 322 logiciel client installation, 115, 230
M
machines virtuelles, 401
Map Manager description des composants, 28 maxProcessor augmentation pour Apache Tomcat, 421 MDL, fichiers importation depuis IBM Cognos Series 7, 117 message de journalisation destinations, 332 serveur de journalisation distant, 332 Voir galement dpannage Voir galement journal d'analyse messages d'erreur CAM-CRP-1064, 448 CAM-CRP-1315 La configuration actuelle pointe vers un domaine scuris autre que celui qui tait configur au dpart, 463 CFG-ERR-0106 Cognos Configuration n'a pas reu de rponse, 440 CM-CFG-029 Content Manager ne peut pas dterminer le contexte de scurit actuel, 467 CMM-APP-3254 chec de l'initialisation de la bibliothque d'indicateurs, 470 dlai d'attente CGI, 471 demande incorrecte, 458 DIS-ERR-3115 chec de l'excution de la tche, 470 DPR-ERR-2014, 450 DPR-ERR-2022 Aucune rponse n'a t gnre, 455 DPR-ERR-2058, 449, 452 DPR-ERR-2079, 467 chec du chargement de la classe de servlets sur le serveur WebLogic, 472 chec du tlchargement des ressources spcifies, 449 Erreur HTTP 404, 451 Impossible d'quilibrer la charge pour la demande, 450 impossible de chiffrer des informations cryptographiques, 462 impossible de dsrialiser l'attribut contextuel, 458 informations cryptographiques altres, 466 Java Runtime Environment, 465 MDS-RUN-3213 Impossible de reprer l'emplacement de l'utilitaire de chargement en bloc de la base de donnes, 470 page non trouve, 451 PRS-CSE-1255, 448 Guide d'installation et de configuration 493
Index RQP-DEF-0114, 459 RSV-SRV-0066, 459 SoapSocketException, 449 SQL1224N, 449 vous avez choisi de tlcharger un fichier, 455 Messages d'erreur dans Content Manager, 467 messages de journalisation activation pour IBM Cognos Application Firewall, 314 Metric Designer configuration des sources de donnes, 137, 223 configuration requise, 220 configuration systme requise, 49 description des composants, 28 dsinstallation, 149, 193 installation, 219 rpartition des composants, 47 test de l'installation et de la configuration, 227 Metrics Manager dsinstallation, 105 mise niveau, 105 mise niveau de calendriers personnaliss, 109 mise niveau des informations de scurit, 106 Metrics Manager, installation, 159, 172, 178 Metrics Manager, service, 419 Metric Studio description des composants, 26 Microsoft mmoire affecte par une mise jour de scurit, 443 Microsoft .NET Framework, 230 mise jour, 115, 230 Microsoft Analysis Server spcifications relatives aux espaces-noms, 264 Microsoft Analysis Services code d'accs unique aux sources de donnes MSAS, 268 configuration d'exemples de cubes MSAS, 249 configuration de l'environnement de la source de donnes, 137, 203, 216, 223 Microsoft Office service de donnes de production de rapports, 420 Microsoft Office Excel non-fonctionnement du type de rapport multipage, 457 Microsoft SQL Server base de donnes Content Store, 66 494 bibliothque d'indicateurs, 141, 185 connectivit la base de donnes, 61, 62, 63 cration de chanes de connexion, 128, 160 spcifications relatives aux espaces-noms, 264 migration partir d'autres produits d'IBM Cognos vers IBM Cognos 8, 51, 84 migration, service, 419 mise jour environnement java, 126, 159, 200, 384, 404 IBM Cognos 8 Go! Office, 115, 230 mise niveau partir d'autres produits d'IBM Cognos vers IBM Cognos 8, 49 partir de Metrics Manager, 79 partir de ReportNet, 79 partir de Series 7, 79, 84 autres produits, 110 bibliothque d'indicateurs, 88, 146, 191 Content Store, 448 cubes IBM Cognos Series 7 publis, 113 cubes Series 7 scuriss, 118 dans un environnement qui inclut IBM Cognos 8 Controller, 89 IBM Cognos 8, 89 IBM Cognos 8 Go! Office, 114 IBM Cognos 8 sur un serveur d'application, 399 impossible de dsinstaller le service ReportNet, 112 incidence sur les caractres chinois, japonais ou corens, 458 Metrics Manager, 105 Metrics Manager et informations de scurit, 106 modification du comportement des produits, 21 planification du passage du systme de test l'environnement de production, 84 prparation, 80 problmes de cls cryptographiques, 463 ReportNet, 85 ReportNet vers IBM Cognos 8, 98 ressources, 80 utilisation de la configuration silencieuse, 104 mise niveau d'essai, 83 planification du passage l'environnement de production, 84 mise au point Content Store DB2, 421
Index paramtres Apache Tomcat, 421 modle modification de la taille du modle, 318 modles exemples de bases de donnes, 257 importation depuis IBM Cognos Series 7 Transformer, 117 modification pour les exemples, 255 modles Architect migration vers IBM Cognos 8, 51 modlisateurs dploiement de Transformer, 362 modlisation exemples de modles et de packs, 239 mode sans surveillance, 411 mode silencieux, Voir mode sans surveillance modification encodage des courriers lectroniques, 346 modle de configuration, 318 paramtres de configuration implicites, 306 type de JVM, 401 URI, 309 module d'extension COM pour IBM Cognos 8 Go! Office mise jour, 230 monnaie personnalisation de la prise en charge, 340 won, 341 yen, 341 monnaie corenne, 341 monnaie japonaise, 341 mots de passe changement pour la base de donnes de contenu d'IBM Cognos, 307 modification en configuration sans surveillance, 428 MSAS, 451 MSAS, Voir Microsoft Analysis Services multi_domain_tree, 267 Netezza configuration de connexions ODBC, 76 Netscape paramtres du navigateur, 73 NetWeaver de SAP, 379 nouvelle cration de l'espace-noms d'IBM Cognos, 465 Novell Directory Server avec un espace-noms LDAP, 285 NTLM, 297 activation du code d'accs unique, 298 configuration, 297 NTLM, Voir galement scurit native Windows (NTLM)
O
oprations de cration excution dans IBM Cognos Connection l'aide du service de transfert de donnes, 53 Oracle base de donnes Content Store, 66 bibliothque d'indicateurs, 141, 143, 186, 187 connectivit la base de donnes, 61, 62, 63 cration de chanes de connexion, 128, 160 erreurs de dploiement, 470 pilotes JDBC, 71 pilotes JDBC de base de donnes, 335 prise en charge multilingue, 137, 203, 216, 223 serveur d'application, 394, 395 variables d'environnement, 66 variables d'environnement de la bibliothque d'indicateurs sous UNIX, 72 variables d'environnement pour une source de donnes, 199 Oracle Application Server chec du dploiement d'IBM Cognos 8, 456 ordinateur Content Manager en attente, 35, 46 configuration, 164
P N
navigateurs Web configuration, 73 erreurs au dmarrage du portail Web, 452, 455 paramtres de scurit, 58 Netegrity SiteMinder, Voir eTrust SiteMinder packs d'indicateurs cration, 144, 189 dfinition, 477 pages de codes des sources de donnes, 137, 203, 216, 223 panne de rseau chec du dmarrage des services, 448 Guide d'installation et de configuration 495
Index paramtres non valides base de donnes Content Store, 443 IBM Cognos Configuration, 443 paramtres rgionaux dfinition, 478 paramtres rgionaux de l'utilisateur mise en correspondance avec les paramtres rgionaux du contenu, 343 paramtres rgionaux du contenu dfinition, 477 mise en correspondance avec les paramtres rgionaux de l'utilisateur, 343 personnalisation, 342 pare-feu accs entre Framework Manager et IBM Cognos 8, 202, 207 accs entre Transformer et IBM Cognos 8, 213 observations concernant l'installation, 37, 40, 48 passage de la mise niveau d'essai l'environnement de production, 84 passeports dfinition, 478 passerelle fichier journal, 439 paramtres recommands pour Microsoft IIS, 471 utilisation d'ISAPI, 471 passerelle de servlet configuration, 352 passerelles ajout sur un rseau afin de rduire le dlai de diffusion, 423 configuration, 179 configuration d'apache_mod, 202, 207 configuration d'un servlet, 202, 207 configuration ISAPI, 202, 207 configuration pour IBM Cognos 8, 349 configuration pour l'utilisation d'un espacenoms, 316 configuration pour Transformer, 213 configuration requise, 34, 45 dfinition, 478 description des composants, 27 installation, 122 installation sur un ordinateur distinct, 33 installation sur un ordinateur spar des composants de cration de tableaux de bord IBM Cognos 8, 44 496 passerelles Apache configuration, 350 performances amlioration pour Apache Tomcat, 421 priphriques mobiles utilisation pour accder aux rapports, 54 pilotes JDBC configuration de bases de donnes DB2, 335 configuration de bases de donnes Oracle, 335 planification d'une mise niveau, 80 polices configuration, 319 introuvables au dmarrage d'IBM Cognos Configuration sous UNIX, 468 liste de polices incorpores des rapports PDF, 322 modification des paramtres implicites, 321 modification pour les rapports PDF, 321 polices incorpores, 322 polices PDF mise en correspondance avec les polices PDF intgres pour une impression plus rapide des rapports, 320 portail erreurs au dmarrage, 452, 455 Portal Services, 365 disponibilit sous Linux, 58 indication du fichier applications.xml, 365 portlets dfinition, 478 ports excution de plusieurs versions d'IBM Cognos 8, 110 modification, 309 paramtres de configuration implicites, 60 ports dj utiliss, 442 PowerPlay activation de l'accs anonyme pour IBM Cognos 8 Go ! Office, 229 considrations pour la mise niveau vers IBM Cognos 8, 50, 84 migration de rapports PowerPlay Web vers IBM Cognos 8, 51 PowerPlay Web conditions requises pour la mise niveau des rapports vers IBM Cognos 8, 50 prsentation, service, 420
Index prsentations rapides installation, 136, 184 utilisation, 14 problmes d'installation et de configuration chec du chargement de la bibliothque DB2 OLAP, 468 problmes d'ouverture d'IBM Cognos Configuration, 438 problmes de configuration, 459 problmes de portail ouverture impossible, 452 production de rapports, service, 421 production de rapports par lots, service, 418 programmes de correction de dcoupage serveurs d'application, 381 proprits configuration pour serveur d'application, 390 emplacement des fichiers temporaires, 316 modification en configuration sans surveillance, 428 proprits d'environnement, 127 proprits d'utilisateur personnalises Active Directory Server, 266 LDAP, 290 protection de reprise, 35, 46 protocole adresse IP, 354 protocole SSL configuration, 325 pseudonymes configuration sur Apache Web Server, 350 configuration sur des serveurs Web, 133, 180 dfinition, 478 public concern par le document, 13 rduction du dlai de diffusion, 423 test avant mise niveau, 83 rapports Impromptu Web Reports migration vers IBM Cognos 8, 51 recherche informations, 14 recherche du contenu IBM Cognos 8 BI, 54 rfrences d'identification dfinition, 478 rfrences d'identification de l'utilisateur modification en configuration sans surveillance, 428 rpertoire d'installation problmes conscutifs un changement de nom ou un dplacement, 464 rpertoire racine pour l'enregistrement des versions de rapports en dehors d'IBM Cognos 8, 323 rpertoires temporaires suppression avant la rinstallation, 463 rpertoires virtuels IBM Cognos 8, 133 IBM Cognos 8, 180 ReportNet conditions requises pour la mise niveau vers IBM Cognos 8, 50 excution sur le mme ordinateur qu'IBM Cognos 8, 110 fichier de mise niveau vers IBM Cognos 8, 439 impossible de dsinstaller le service, 112 mise niveau, 50, 85 mise niveau vers IBM Cognos 8, 85 Report Studio chargement d'images, 133 description des composants, 26 chec du dmarrage, 454 modification de l'emplacement des graphiques de type Carte, 325 modifications aprs mise niveau, 21 ressources ajout, 426 restauration exemples de bases de donnes, 244 routeurs configuration, 77
Q
qualit de la protection dans le cadre de connexions SSL, 329 Query Studio description des composants, 26 modifications aprs mise niveau, 21
R
rapports modification de la police implicite, 321 personnalisation de la prise en charge linguistique, 342
Index
S
SaferAPIGetTrustedSignon, fonction utilisation pour l'authentification, 273 SAP activation du code d'accs unique, 301 utilisation pour authentification, 299 SAP BW connectivit, 300 paramtres d'autorisation pour les administrateurs IBM Cognos 8, 300 paramtres d'autorisation pour les utilisateurs d'IBM Cognos 8, 299 sauvegarde informations IBM Cognos 8, 382, 402 scintillement, 473 scripts pour amliorer les performances de la bibliothque d'indicateurs, 423 suppression de tables dans des bases de donnes, 460 scripts de dmarrage, Voir galement serveurs d'application scripts Java activation dans les navigateurs Web, 73 Secure Socket Layer, Voir protocole SSL scurit activation, 127, 168 mise niveau de Metrics Manager, 106 paramtres des navigateurs Web, 58 problmes avec l'authentification intgre de Windows, 467 scurit native Windows (NTLM) activation du code d'accs unique, 298 utilisation pour authentification, 297 scurit partage configuration entre IBM Cognos 8 et d'autres serveurs, 328 squences d'assemblage sensibilit la casse, 443 Series 7 mise niveau vers IBM Cognos 8, 84 Series 7, cubes conditions requises pour une conversion linguistique russie, 53 Series 7, cubes scuriss mise niveau, 118 ouverture, 118 498
Series 7 IQD Bridge composant Transformer, 28 installation, 209 Series 7 PowerPlay mise niveau de rapports enregistrs de ReportNet vers IBM Cognos 8, 87 Series 7 Transformer, modles prparation pour la mise niveau vers IBM Cognos 8, 117 serveur d'application Oracle, 379 dploiement d'IBM Cognos 8, 470 serveur d'application WebLogic chec d'IBM Cognos 8, 456 serveur d'application WebSphere dploiement d'IBM Cognos 8, 470 serveur de messagerie configuration, 130, 166 serveur IBM Cognos 8 chec du dmarrage, 443 serveurs indicateurs systme, 417 serveurs bass sur des rles considrations pour Transformer, 41 serveurs d'application changement de la configuration implicite, 379 configuration, 390 chec du chargement de la classe de servlets dans WebLogic, 472 chec du script de dmarrage, 456 mise niveau d'IBM Cognos 8, 399 passerelles du servlet, 352 problmes lis l'excution d'IBM Cognos 8, 464 scripts de dmarrage, 387 scripts de dmarrage pour le serveur d'application Oracle, 394, 395 scripts de dmarrage pour le serveur d'application Sun Java System, 396 serveurs de journalisation distants, 334 configuration, 336 serveurs de rapports installation, 122 serveurs virtuels configuration pour IBM Cognos 8, 133 serveurs Web, 37, 40, 48 activation SSL, 330
Index code d'accs unique utilisant Active Directory et le serveur Web IIS, 268 configuration, 133, 180 dfinition du temps de chargement de Report Studio, 133 passerelles du servlet, 352 serveurs Web Apache configuration en tant que passerelle, 350 serveurs Web IIS code d'accs unique pour les documents IBM Cognos 8 Go ! Office bass sur des rapports PowerPlay, 229 code d'accs unique utilisant Active Directory, 268 serveurs Web Windows IIS paramtres de passerelle recommands, 471 serveur Web Java System configuration des alias, 133, 180 service de donnes d'excution de rapports, 420 service de prsentation conditions requises, 417 service de production de rapports liste de polices incorpores des rapports PDF, 322 Service de production de rapports conditions requises, 417 service de production de rapports par lots liste de polices incorpores des rapports PDF, 322 service de transfert de donnes utilisation dans IBM Cognos Connection, 53 service IBM Cognos 8 configuration, 318 dmarrage depuis IBM Cognos Configuration, 132 serveur non disponible, 443 service IBM Cognos 8 arrt depuis la ligne de commande, 431 dmarrage, 466 dmarrage depuis la ligne de commande, 431 spcifications relatives au compte utilisateur employ pour le service, 160, 172, 178, 306 services activation et dsactivation, 317 agent, 418 ajustement pour amliorer les performances, 417 arrt depuis la ligne de commande, 431 Content Manager, 418 dmarrage depuis la ligne de commande, 431 dsinstallation, 147, 192 diffusion, 418 donnes de production de rapports, 420 chec du dmarrage aprs une panne de rseau, 448 gestion des vnements, 419 IBM Cognos 8, 420 impossible de dmarrer, 442 indicateurs systme, 417 intgration de donnes, 418 journalisation, 419 Metrics Manager, 419 migration, 419 prsentation, 417, 420 production de rapports, 417, 421 production de rapports par lots, 418 suivi, 420 systme, 421 travail, 419 Solaris variables d'environnement pour l'installation d'IBM Cognos 8, 123 variables d'environnement pour l'installation d'IBM Cognos 8, 156, 169, 175 sources de donnes connexions ODBC, 76 dfinition, 479 description des composants, 29 exemples de connexions, 247 pour Framework Manager, 137, 203 pour IBM Cognos 8 Transformer, 137 pour IBM Cognos 8 Transformer, 216 pour Metric Designer, 137, 223 sources de donnes OLAP, 450, 451 connexions, 251 membres manquants ou inaccessibles, 469 sources de donnes relationnelles membres manquants ou inaccessibles, 469 spcifications de rapport dfinition, 479 SSL activation pour serveur d'application, 397 activation sur les serveurs Web, 330 Active Directory Server, 267 annuaire d'utilisateurs eTrust SiteMinder, 296 configuration de la scurit partage avec d'autres serveurs, 328 configuration pour IBM Cognos 8 Go! Office, 232 Guide d'installation et de configuration 499
Index configuration pour IBM Cognos 8 Go ! Office, 228 espace-noms LDAP, 290 tapes supplmentaires pour la configuration sur WebLogic 8, 454 qualit de la protection, 329 utilisation de l'espace-noms IBM Cognos Series 7, 272 suivi, service, 420 Sun Java System serveur d'application, 396 Sun Java System Directory Server avec un espace-noms LDAP, 287 suppression exemples d'IBM Cognos, 259 Sybase pilotes de base de donnes, 71 Sybase Adaptive Server Enterprise base de donnes Content Store, 68 Sybase IQ configuration de connexions ODBC, 76 systme, service, 421 systme de fichiers enregistrement d'une version de rapport, 323 systmes d'exploitation incidences sur la mise niveau, 88 systmes de contrle de la source configuration de Framework Manager, 357 test de l'installation, 169, 174, 185 Tomcat mise au point, 421 paramtres de configuration implicites, 60 touche de tabulation problmes dans IBM Cognos Configuration, 465 traitement des messages de journalisation, 332 Transformer accs IBM Cognos 8 hors d'un pare-feu, 213 accs aux donnes dans IBM Cognos 8, 53 composant pour la liaison des fichiers IQD depuis Series 7, 28 conditions requises pour Content Manager en cas d'utilisation d'un espace-noms Series 7, 122, 209, 270 configuration, 39, 213 configuration requise, 210 dploiement pour les modlisateurs, 362 description des composants, 28 dsinstallation, 149, 193 installation, 209 mise niveau des cubes, 116 nouvelles fonctionnalits dans IBM Cognos 8, 21 options d'installation, 39 prparation de modles Series 7 pour la mise niveau vers IBM Cognos 8, 117 procdure de test de l'installation, 219 variables d'environnement sous Linux et UNIX, 211 Transformer, modles importation depuis IBM Cognos Series 7, 117 travail, service, 419 travaux dfinition, 479
T
tables suppression dans une base de donnes, 460 tches dfinition, 479 taille de l'antmmoire de pages Derby, 422 tmoins (cookies) activation dans les navigateurs Web, 73 paramtres, 348 personnalisation, 348 tmoins HTML, Voir tmoins (cookies) temps d'attente amlioration, 423 test configuration, 136, 208, 219, 227 installation, 136, 208, 219, 227 installation d'IBM Cognos 8 Go! Office, 232 500
U
UDB, Voir DB2 UNIX configuration de variables d'environnement pour la bibliothque d'indicateurs, 72 configuration requise, 121 connexions ODBC aux sources de donnes, 76 dmarrage et arrt du service IBM Cognos 8, 431 erreur de police non trouve, 468 messages de journalisation, 334 variables d'environnement pour IBM Cognos 8, 123
Index variables d'environnement pour IBM Cognos 8, 156, 169, 175 variables d'environnement pour Transformer, 211 variables d'environnement pour une source de donnes Oracle, 199 Upfront migration de contenu vers IBM Cognos 8, 51 URI modification, 309 paramtres de configuration implicites, 60 URI de Content Manager, 164, 173 UTF-8 encodage pour les courriers lectroniques, 346 utilisateurs changement pour la base de donnes de contenu d'IBM Cognos, 307 dfinition, 479 rutilisation, 324 versions mises niveau ReportNet prises en charge, 85 visualiseur IBM Cognos description des composants, 25
W
WebLogic dploiement du fichier p2pd.war, 458 chec du chargement de la classe de servlets, 472 chec du script de dmarrage, 456 impossible de dsrialiser l'attribut contextuel, 458 script de dmarrage, 387 serveur d'application, 391, 396 WebLogic 8 problme de configuration du protocole SSL, 454 WebSphere serveur d'application, 390 WebSphere Application Server chec du dploiement d'IBM Cognos 8, 456 chec du script de dmarrage, 456 Windows configuration requise, 121 Windows IIS paramtres de passerelle recommands, 471 Windows Vista conditions requises pour les emplacements de fichiers, 355 incidences sur la mise niveau, 88
V
Vacances et aventure, Voir exemples d'IBM Cognos Vacances et aventure, exemples, 27, 235 variables d'environnement base de donnes Content Store, 63 conditions requises sous Windows Vista, 355 configuration pour les composants d'application, 173 configuration pour Metric Designer, 222 configuration pour serveurs d'application, 383 configuration sous UNIX pour la bibliothque d'indicateurs, 72 DB2, 64 Oracle, 66 pour l'installation d'IBM Cognos 8 sous UNIX ou Linux, 123 pour l'installation d'IBM Cognos 8 sous UNIX ou Linux, 156, 169, 175 pour Transformer sous Linux et UNIX, 211 pour une source de donnes Oracle, 199 vrification de scripts intersites configuration dans IBM Cognos Application Firewall, 314 version de l'adresse IP, 354 version de rapport enregistrement dans un systme de fichiers, 323 partage avec des utilisateurs en dehors d'IBM Cognos 8, 323

Inst CR Winux

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Inst CR Winux

Cargado por

Copyright:

Formatos disponibles

IBM Cognos 8 Business Intelligence

GUIDE D'INSTALLATION ET DE CONFIGURATION

Informations sur le produit

Table des matires

Partie 1: IBM Cognos 8 Business Intelligence Chapitre 1: Nouveauts

Guide d'installation et de configuration 3

Table des matires Chapitre 9: Exemples

Guide d'installation et de configuration 7

Table des matires Annexe B: Dpannage

Guide d'installation et de configuration 11

Guide d'installation et de configuration 13

Guide de l'utilisateur d'IBM Cognos 8 Go! Office

IBM Cognos 8 Transformer Guide de l'utilisateur

Utilisation des prsentations rapides

Impression de documents protgs par les droits d'auteur

Guide d'installation et de configuration 15

Nouveauts de la version 8,4

Prise en charge des adresses IPv6

Masquage de l'espace-noms de la vue des utilisateurs durant la connexion

Guide d'installation et de configuration 17

IBM Cognos Apache 2.2 Web Server

Fonctions modifies dans la version 8,4

IBM Cognos 8 Go! Office

IBM Cognos 8 Portal Services

Prise en charge multilingue des sources de donnes Microsoft Analysis Services

Fonctions obsoltes dans la version 8,4

Fonctions supprimes dans la version 8,4

Nouveauts de la version 8.3

IBM Cognos 8 Transformer

Tlchargement du programme d'installation de Transformer 8

Series 8 IQD Bridge

Guide d'installation et de configuration 19

Proprit d'emplacement des archives

Portal Services pour Microsoft SharePoint

Prise en charge de Windows Vista

Fonctions modifies dans la version 8.3

IBM Cognos 8 Go! Office

Comportement des produits aprs une mise niveau

Guide d'installation et de configuration 21

Exemples IBM Cognos 8

Prsentations rapides d'IBM Cognos 8

Fonctions obsoltes dans la version 8.3

Configuration de Content Manager

Configuration du fichier cogformat.xml : avis de changement

Fonctions supprimes dans la version 8.3

Dploiement du client intelligent pour IBM Cognos 8 GO! Office

Guide d'installation et de configuration 23

Chapitre 2: Composants utiliss par IBM Cognos 8

IBM Cognos Connection

Administration d'IBM Cognos

IBM Cognos Viewer

Guide d'installation et de configuration 25

Chapitre 2: Composants utiliss par IBM Cognos 8

IBM Cognos 8 Go! Office

IBM Cognos Configuration

Chapitre 2: Composants utiliss par IBM Cognos 8

Base de donnes de contenu d'IBM Cognos

Composite Information Server

Exemples IBM Cognos 8

Guide d'installation et de configuration 27

Chapitre 2: Composants utiliss par IBM Cognos 8

IBM Cognos 8 Transformer

Series 7 IQD Bridge