Professional Documents
Culture Documents
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.
13
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
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
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
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)
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.
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.
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).
Chapitre 1: Nouveauts
Chapitre 1: Nouveauts
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).
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).
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).
Chapitre 1: Nouveauts nalises, reportez-vous la section "Mise niveau partir d'une version antrieure d'IBM Cognos 8" (p. 89).
Chapitre 1: Nouveauts
24
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 :
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.
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.
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).
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 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.
32
Framework Manager
Content Manager
Content Store
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).
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
Content Store
Configuration requise
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
Content Store
Configuration requise
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,
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.
Configuration requise
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).
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.
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.
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.
Configuration requise
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.
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.
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.
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.
Configuration requise
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.
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.
Content Store
Bibliothques d'indicateurs
Configuration requise
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,
44
Content Store
Bibliothques d'indicateurs
Configuration requise
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.
Installation de plusieurs instances de Content Manager avec des composants d'IBM Cognos8 Scorecarding
Composants d'application
Content Store
Bibliothque d'indicateurs
Configuration requise
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,
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.
Configuration requise
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.
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.
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.
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.
Configuration requise
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.
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.
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.
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.
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.
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.
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 CognosScript
Vous pouvez dupliquer les fonctions d'automatisation l'aide d'IBM Cognos 8 Software Development Kit.
56
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.
Configuration requise
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
Configuration requise
RAM Spcifications pour le systme d'exploitation Espace disque
Spcifications
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.
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
Configuration requise
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
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.
http://localhost:9300/p2pd/servlet/dispatch
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
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.
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
Base de donnes de Inclus avec les composants IBM Cognos. Aucun autre logiciel n'est contenu d'IBM Cognos requis.
62
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.
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.
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.
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.
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.
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
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.
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.
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.
72
Navigateur
Paramtre
Internet Explorer Autoriser les tmoins de connexion (paramtres pour les (cookies) studios et les porActive Scripting tails) META REFRESH autoris
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
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.
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.
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.
78
Planification
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
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.
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.
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.
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.
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).
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.
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.
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.
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
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
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.
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.
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.
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
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
114
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.
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.
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.
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.
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).
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
122
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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:
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.
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
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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.
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.
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.
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.
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.
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
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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.
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.
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
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
Objet d'autorisation
S_RFC
Zone
Valeur
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 (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports S_RS_COMP1 Activit *
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
Objet d'autorisation
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.
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.
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.
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.
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.
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.
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.
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
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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.
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
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).
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.
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.
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).
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.
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.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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.
Chapitre 6: Installation et configuration des composants d'IBM Cognos 8 sur un seul ordinateur
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.
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.
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
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
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.
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.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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).
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.
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.
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.
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
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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.
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
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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.
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
11. Sous Linux, attribuez le nom de votre imprimante la variable d'environnement PRINTER
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.
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).
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.
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.
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
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
11. Sous Linux, attribuez le nom de votre imprimante la variable d'environnement PRINTER
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.
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).
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.
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).
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.
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.
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.
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
Vous pouvez tester l'installation l'aide d'un navigateur Web.
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.
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.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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.
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.
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
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
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.
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.
Les autorisations CREATE TABLE et CREATE TRIGGER doivent tre accordes directement au compte utilisateur et non un rle.
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.
Les autorisations CREATE TABLE et CREATE TRIGGER doivent tre accordes directement au compte utilisateur et non un rle.
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
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
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).
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.
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.
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.
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.
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.
Chapitre 7: Installation des composants serveur d'IBM Cognos 8 sur diffrents ordinateurs
196
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
Systme d'exploitation RAM
Spcifications
Windows
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
Composant
Passerelle
Implicite
http://localhost:80/cognos8/cgi-bin/cognos.cgi
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
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.
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
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.
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.
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.
Objet d'autorisation
S_RFC
Zone
Valeur
204
Objet d'autorisation
Zone
Valeur
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 (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports S_RS_COMP1 Activit *
Objet d'autorisation
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.
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.
Conditions pralables
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).
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.
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
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
Configuration requise
Autre
Spcifications
Microsoft Data Access Component (MDAC), version 2.6 ou ultrieure, utiliser avec les exemples de produits.
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.
212
Composant
Passerelle
Implicite
http://localhost:80/cognos8/cgi-bin/cognos.cgi
Description
Indique l'URI de la passerelle IBM Cognos 8. Indique l'URI du distributeur.
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.
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).
Conditions pralables
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.
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.
Objet d'autorisation
S_RFC
Zone
Valeur
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
Objet d'autorisation
S_TABU_DIS
Zone
Valeur
03 &NC& 03, 05 *
S_USER_GRP
S_RS_COMP
Nom (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports S_RS_COMP1 Activit *
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
Objet d'autorisation
S_RS_ICUBE
Zone
Valeur
03 DATA DFINITION
InfoArea 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.
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
Systme d'exploitation
Spcifications
Windows (interface et moteur de conception) UNIX (moteur uniquement) : Sun Solaris HP-UX IBM AIX
RAM
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
Composant
Passerelle
Implicite
http://localhost:80/cognos8/cgi-bin/cognos.cgi
Description
Indique l'URI de la passerelle. Indique l'URI du distributeur.
http://localhost:9300/p2pd/servlet/dispatch
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.
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 :
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.
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
Objet d'autorisation
S_RFC
Zone
Valeur
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 (identificateur) des com- * posants de cration de rapports Type des composants de cra- * tion de rapports S_RS_COMP1 Activit *
Objet d'autorisation
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.
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.
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.
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
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.
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.
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.
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.
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).
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
Chapitre 9: Exemples
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 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
Chapitre 9: Exemples
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.
Oprations (1800)
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.
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.
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.
240
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.
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).
Chapitre 9: Exemples
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.
244
Chapitre 9: Exemples
Nom de fichier
GOSALES.zip GOSALES.zip GOSALESDW. zip GOSALES.zip GOSALES.zip
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).
246
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.
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.
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).
Chapitre 9: Exemples
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.
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.
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.
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.
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.
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).
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.
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.
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).
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.
Chapitre 9: Exemples
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.
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
Chapitre 9: Exemples
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.
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
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.
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.
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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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
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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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]*/
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
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.
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.
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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
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.
Valeur LDAP
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
Valeur LDAP
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.
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.
Valeur LDAP
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
Valeur LDAP
Paramtres rgionaux du Langue contenu Description Courrier lectronique Tlcopieur/tlphone Prnom Tlphone priv Tlphone mobile Nom description mail facsimiletelephonenumber givenname homephone mobile cn
286
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
Valeur LDAP
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.
Valeur LDAP
288
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
Valeur LDAP
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
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\\","")}
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).
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)
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.
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.
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.
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.
Objet d'autorisation
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
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
Objet d'autorisation
S_RFC Contrle d'autorisation pour l'accs RFC
Zone
Activit
Valeur
16
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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
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.
Chapitre 10: Configuration des composants d'IBM Cognos 8 pour un fournisseur d'authentification
304
Chapitre 11: Options de configuration Configuration d'un systme de contrle de la source. Configuration d'IBM Cognos 8 Transformer.
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.
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;
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;
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.
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
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.
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.
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.
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
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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
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.
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 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.
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 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
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.
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 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.
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.
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
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
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.
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.
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.
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.
/* 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.
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.
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.
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.
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.
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)
Jeu de caractres
Coren (ISO 2022-KR) Coren (KSC-5601) Tha (Windows-874) Tha (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.
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.
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 :
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
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
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>
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.
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.
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
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.
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
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
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.
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.
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.
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.
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).
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
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.
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.
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.
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.
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.
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.
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
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
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.
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.
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.
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat
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
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.
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.
Systme d'exploitation
Windows AIX Solaris et Linux HP-UX
Variable d'environnement
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.
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
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.
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.
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
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
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.
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.
Chapitre 13: Configuration d'IBM Cognos 8 pour un serveur d'application autre que Tomcat
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.
Systme d'exploitation
Windows AIX Solaris HP-UX
Variable d'environnement
PATH LIBPATH LD_LIBRARY_PATH SHLIB_PATH
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.
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.
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.
Systme d'exploitation
Windows AIX Solaris HP-UX
Variable d'environnement
PATH LIBPATH LD_LIBRARY_PATH SHLIB_PATH
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.
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.
Systme d'exploitation
Windows AIX Solaris HP-UX
Variable d'environnement
PATH LIBPATH LD_LIBRARY_PATH SHLIB_PATH
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-
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.
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.
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.
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.
Alias
racine_contexte (par exemple, p2pd)
Emplacement
emplacement_c8/webcontent
Autorisation
Read
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.
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.
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
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
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.
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.
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.
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.
Commande
Mode de fonctionnement principal -c -i Modificateurs de fonctionnement -s -e -T Indicateurs d'informations -d -r -t -p -a
Description
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
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
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
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.
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.
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.
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
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
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.
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
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
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
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 :
<!-- Define a non-SSL Coyote HTTP/1.1 Connector onport 8080 -->
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
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
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
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
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.
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.
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) :
<!--===============================================(Begin of) DB2 template-><crn:instance ...>...</crn:instance><!--End of) DB2 template===============================================-->
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.
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>
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.
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.
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.
expand
expand_without_webcontent
expand_without_docsamples
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
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/rpertoire Chemin d'accs au rpertoire dans lequel les La valeur implicite est fichiers d'application ../../temp/expand vont tre dvelopps.
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.
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
Prdfinition d'une valeur de racine de contexte pour l'application. Chemin d'accs et nom du fichier WAR crer.
-Dwar_name=valeur
-Dear_name=valeur
-Dexpand_location=valeur
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 :
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
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.
mod (module Apache 1.3), mod2 (module Apache 2.0) ou isapi) : gwinterface_passerelle.log (par ex., gwcgi.log)
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.
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.
440
Annexe B: Dpannage
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.
442
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.
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.
444
Annexe B: Dpannage
Base de donnes
Oracle 9i
Encodage de caractres
AL32UTF8 AL32UTF16
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.
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.
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.
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.
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.
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.
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.
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 >.
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
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
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.
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 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.
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.
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.
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
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
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
Annexe B: Dpannage
Base de donnes
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
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.
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.
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.
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.
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.
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"/>
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
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.
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.
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.
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.
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