Inst CR Winux

Cognos(R) 8 Business Intelligence
GUIDE D'INSTALLATION ET DE
CONFIGURATION
Cognos(R) 8 Business Intelligence - Lisezmoi

Cognos(R) 8 - Guide d'installation et de configuration
GUIDE D'INSTALLATION ET DE CONFIGURATION
TM
THE NEXT LEVEL OF PERFORMANCE
Renseignements sur le produit
(R)
Ce document s'applique à Cognos 8 Version 8.1.2 MR2 et peut s'appliquer aux versions subséquentes de ce produit. Pour vérifier s'il existe
une version plus récente du document, visitez le site Web Cognos Global Customer Services (http://support.cognos.com).
Copyright
Copyright (C) 2006 Cognos Incorporated.
Portions of Cognos(R) software products are protected by one or 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,995 B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2.
Cognos et le logo Cognos sont des marques de Cognos Incorporated aux États-Unis et dans d'autres pays. Tous les autres noms de pro-
duits sont des marques, déposées ou non, de leurs sociétés respectives.
Bien que tout ait été mis en oeuvre pour assurer le caractère exact et complet des informations contenues dans le présent document, il est
possible que des erreurs typographiques ou des inexactitudes techniques subsistent. Cognos Incorporated ne peut être tenu pour responsa-
ble des dommages ou pertes, quels qu'ils soient, pouvant découler de l'exploitation de ces informations.
La date de publication figure ci-après. Cognos Incorporated se réserve le droit de modifier le contenu du présent document sans préavis.
Toute amélioration ou autre modification apportée au logiciel ou au document sera consignée dans les éditions ultérieures.
Disposition supplémentaire à l'intention du gouvernement des États-Unis. Le gouvernement des États-Unis jouit de droits restrictifs à l'égard
de l'exploitation du logiciel et de la documentation qui l'accompagne : leur utilisation, duplication et divulgation sont soumises aux termes des
alinéas (C)(1)(ii) de la clause 252.227-7013, dite Rights in Technical Data and Computer Software, du Defense Federal Acquisition Regula-
tion Supplement (DFARS), ou aux alinéas (C) (1) et (2) de la clause 48CFR52.227-19, dite Commercial Computer Software – Restricted
Rights, du Code of Federal Regulations, le cas échéant. Le contractant est Cognos Corporation, sis au 15 Wayside Road, Burlington, MA
01803 (ÉtatsUnis).
Les informations figurant dans le présent document et le logiciel auquel il se rapporte sont la propriété exclusive de Cognos Incorporated.
Tous droits réservés. Il est interdit de décompiler le logiciel à des fins de rétroingénierie. De plus, aucune partie du logiciel ou de la documen-
tation ne peut être copiée, photocopiée ou reproduite de quelque autre façon, enregistrée dans un système de stockage de données, trans-
mise sous quelque forme ou par quelque moyen que ce soit, ou traduite, sans l'autorisation écrite préalable de Cognos Incorporated.
Table des matières
Introduction 9
Chapitre 1 : Composants utilisés par Cognos 8 11
Composants du serveur 11
Composants de modélisation 12
Composants tiers 13
Cognos 8 avec des applications Cognos Series 7 14
Chapitre 2 : Options de répartition de Cognos 8 15
Répartition des composants de création de rapports de Cognos 8 15
Installation de tous les composants sur un même ordinateur 15
Installation des passerelles sur différents ordinateurs 16
Installation des composants d'application et des applications Content Manager sur diffé-
rents ordinateurs 17
Installation des produits de Cognos 8 sur le même ordinateur 19
Répartition des composants de Framework Manager 19
Répartition des composants de création de tableaux de bord de Cognos 8 21
Installation de tous les composants sur un même ordinateur 21
Installation des passerelles sur différents ordinateurs 22
Installation des composants d'application et des applications Content Manager sur diffé-
rents ordinateurs 23
Installation des produits de Cognos 8 sur le même ordinateur 24
Répartition des composants de Metric Designer 24
Cognos 8 avec d'autres produits de Cognos 26
Produits de Cognos pouvant être mis à niveau vers Cognos 8 26
Produits Cognos Series 7 pouvant migrer vers Cognos 8 27
Produits de Cognos fonctionnant avec Cognos 8 28
Contenu Cognos Series 7 pouvant être créé à nouveau dans Cognos 8 28
Chapitre 3 : Flux de travail dans Cognos 8 31
Installation de Cognos 8 avec Metric Studio 31
Installation de Cognos 8 sans Metric Studio 33
Ajout de Metric Studio à une installation Cognos 8 35
Chapitre 4 : Mise à niveau vers Cognos 8 37
Mise à niveau à partir de Cognos Series 7 37
(R)
Mise à niveau depuis ReportNet , Metrics Manager, ou des versions antérieures de
Cognos 8 38
Mise à niveau à partir d'une version antérieure de Cognos 8 39
Nouveaux noms de fichiers et de répertoires après la mise à niveau à partir de
ReportNet 44
Mise à niveau de ReportNet vers Cognos 8 45
Mise à niveau à l'aide de l'option de configuration silencieuse 49
Mise à niveau de Metrics Manager vers Cognos 8 50
Exécution simultanée de ReportNet et de Cognos 8 53
Mise à niveau des documents Cognos Office Connection 54
Chapitre 5 : Installation de Cognos 8 57
Vérification de la configuration système requise 57
Configuration de la connectivité à la base de données de création de rapports 59
Configuration de la connectivité à la base de données Content Store 59
Configuration de la connectivité à la base de données de la bibliothèque d'indicateurs 60
Guide d'installation et de configuration 3

Étude des environnements pris en charge 60
Installation des composants du serveur 60
Paramètres implicites de Cognos 8 63
Installation de Framework Manager 64
Paramètres implicites pour Framework Manager 66
Installation de Metric Designer 66
Paramètres implicites de Metric Designer 67
Désinstallation de Cognos 8 68
Désinstallation de Cognos 8 sous UNIX ou Linux 68
Désinstallation de Cognos 8 sous Windows 68
Chapitre 6 : Configuration de l'environnement 71
Création de la base de données Content Store 71
Création de la bibliothèque d'indicateurs 75
Configuration du client de base de données 78
Configuration des variables d'environnement sous UNIX pour la bibliothèque
d'indicateurs 79
Mise à jour de l'environnement Java 81
Configuration du serveur Web 81
Activation SSL sur le serveur Web 82
Configuration de navigateurs Web 83
Configuration du routeur pour tester la disponibilité d'un distributeur 85
Configuration de l'environnement de sources de données ou de sources d'importation 85
Chapitre 7 : Configuration de Cognos 8 89
Démarrage de Cognos Configuration 89
Configuration d'installations à un seul ordinateur 90
Définition des propriétés de connexion à la base de données Content Store 90
Définition d'un compte de serveur de messagerie et d'une base de données de
notification 92
Création d'un pack d'indicateurs 93
Test de l'installation et de la configuration 95
Finalisation de la configuration 96
Configuration d'installations réparties 96
Configuration des ordinateurs Content Manager 98
Configuration des ordinateurs des composants d'application 104
Configuration des passerelles 106
Création d'un pack d'indicateurs 107
Configuration des ordinateurs Framework Manager 109
Configuration de Metric Designer 112
Test de l'installation et de la configuration 113
Modification des paramètres de configuration implicites 115
Modification d'un URI 115
Configuration des paramètres cryptographiques 117
Configuration des composants de Cognos 8 pour Cognos Application Firewall 119
Configuration des propriétés des fichiers temporaires 120
Configuration de la passerelle pour l'utilisation d'un espace-noms 120
Activation et désactivation de services 120
Définition des ressources du service Cognos 8 121
Configuration des polices 122
Modification de la police implicite pour les rapports PDF 123
Modification de l'emplacement des graphiques type Carte pour Report Studio 124
Configuration du protocole SSL 124
Configuration du protocole SSL pour Cognos 8 124
Configuration de la sécurité partagée entre les serveurs Cognos et d'autres serveurs 126
Sélection et classement des algorithmes de chiffrement (ciphersuites) pour SSL 127
Configuration des messages de journalisation 128
4
Configuration du client de base de données pour une base de données de
journalisation 129
Indication de la destination des messages de journalisation 130
Modification des paramètres globaux 131
Personnalisation de la prise en charge linguistique de l'interface utilisateur 132
Personnalisation de la prise en charge de la monnaie 132
Personnalisation de la prise en charge des paramètres régionaux du contenu 133
Mise en correspondance des paramètres régionaux (contenu) 133
Mise en correspondance des langues du produit 135
Personnalisation du fuseau horaire du serveur 136
Modification de l'encodage pour les courriers électroniques 136
Personnalisation de témoins (cookies) 136
Changement de passerelle 137
Configuration de la passerelle pour le module Cognos Apache Web Server 137
Configuration d'une passerelle de type servlet 139
Configuration de Cognos 8 pour fonctionner avec d'autres produits de Cognos 141
Activation des rapports et agents programmés pour les sources de données de Cognos
Planning Contributor 141
Chapitre 8 : Configuration de Cognos Office Connection 143
Création d'un répertoire virtuel pour Cognos Office Connection 144
Mise à jour des types de contenu reconnus par le serveur Web 144
Activation du support SSL pour l'interface HTTPS de PowerPlay 145
Activation de l'accès anonyme pour PowerPlay 146
Configuration des fichiers Microsoft Office pour Cognos Office Connection 146
Déploiement du client Cognos Office Connection 148
Installation de Microsoft .NET Framework 150
Ajout de la fonction Microsoft .NET Framework aux composants Microsoft Office 150
Activation de la sécurité Microsoft .NET Framework pour les utilisateurs du client
intelligent 151
Définition du niveau de sécurité des macros pour Microsoft Office XP 152
Activation ou désactivation de la fonction Cognos Office Connection pour les utilisateurs
du supplément COM 152
Test de Cognos Office Connection 153
Chapitre 9 : Configuration de Cognos Portal Services 155
Indication de l'emplacement du fichier Applications.xml 155
Configuration de la sécurité de Cognos Portal Services 156
Désactivation de l'accès anonyme aux composants de Cognos 8 156
Activation du code d'accès unique avec le secret partagé 157
Activation du code d'accès unique pour SAP EP avec le permis de connexion SAP 160
Activation du code d'accès unique pour SAP EP avec mise en correspondance des
utilisateurs 161
Activation de la communication sécurisée entre le portail SAP EP et les composants de
Cognos 8 162
Activation du code d'accès unique pour le portail WebSphere à l'aide du serveur
d'application 163
Activation du code d'accès unique pour le portail Plumtree à l'aide de l'authentification
de base 163
Activation du code d'accès unique pour le portail Plumtree à l'aide de SiteMinder 164
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur
d'authentification 165
Désactivation de l'accès anonyme 166
Restriction de l'accès à l'espace-noms Cognos 166
Configuration des composants de Cognos 8 pour Active Directory Server 167
Configuration d'un espace-noms Active Directory 167

Mise à disposition des propriétés d'utilisateur personnalisées d'Active Directory pour les
composants de Cognos 8 168
Activation de la communication sécurisée pour Active Directory Server 169
Inclusion ou exclusion de domaines à l'aide des propriétés avancées 169
Activation du code d'accès unique entre Active Directory Server et les composants de
Cognos 8 170
Configuration de Cognos 8 pour l'espace-noms Cognos Series 7 171
Configuration d'un espace-noms Cognos Series 7 171
Activation de la communication sécurisée pour le serveur d'annuaire utilisé par
l'espace-noms Series 7 172
Activation du code d'accès unique entre Cognos Series 7 et Cognos 8 172
Espaces-noms Cognos Series 7 et module d'extension Cognos Series 7 Trusted
Signon 173
Configuration de Cognos 8 pour l'utilisation d'un fournisseur d'authentification
personnalisé 175
Configuration d'un espace-noms d'authentification personnalisé 175
Configuration des composants de Cognos 8 pour LDAP 175
Configuration d'un espace-noms LDAP 176
Configuration d'un espace-noms LDAP pour Active Directory Server 177
Configuration d'un espace-noms LDAP pour IBM Directory Server 179
Configuration d'un espace-noms LDAP pour Novell Directory Server 180
Mise à disposition des propriétés d'utilisateur personnalisées de LDAP pour les compo-
sants de Cognos 8 182
Activation de la communication sécurisée pour le serveur LDAP 182
Activation du code d'accès unique entre LDAP et les composants de Cognos 8 182
Opération de remplacement 183
Configuration des composants de Cognos 8 pour SiteMinder de Netegrity 183
Configuration d'un espace-noms SiteMinder 184
Activation de la communication sécurisée pour l'annuaire d'utilisateurs SiteMinder 185
Activation du code d'accès unique entre SiteMinder et Cognos 8 186
Protection de l'alias Web de Cognos 186
Configuration des composants de Cognos 8 pour un espace-noms NTLM 186
Configuration d'un espace-noms NTLM 186
Activation du code d'accès unique entre NTLM et les composants de Cognos 8 187
Configuration de Cognos 8 pour l'utilisation de SAP 187
Configuration d'un espace-noms SAP 188
Activation du code d'accès unique entre SAP et Cognos 8 189
Test des espaces-noms 189
Suppression d'un fournisseur d'authentification 190
Chapitre 11 : Changement de serveur d'application 191
Vérification de la configuration des composants de Cognos 192
Sauvegarde des informations Cognos 193
Définition des variables d'environnement 194
Copie des fichiers du fournisseur de sécurité de Cognos 195
Configuration des composants de Cognos pour une exécution dans le serveur
d'application 196
Modification du script de démarrage du serveur d'application 197
Configuration des propriétés du serveur d'application et déploiement des composants de
Cognos 198
Activation du protocole SSL 202
Configuration du serveur Web 202
Annulation de l'inscription des distributeurs 202
Importation des données de la base de données Content Store 203
Mise à niveau de ReportNet vers Cognos 8 dans un environnement de serveur
d'application 203
6
Mise à niveau de Metrics Manager vers Cognos 8 dans un environnement de serveur
d'application 203
Chapitre 12 : Options de configuration avancées 205
Changement du type de JVM utilisée par Cognos 8 205
Changement de la version de Java Runtime Environment utilisée par les composants de
Cognos 8 206
Sauvegarde des informations Cognos 206
Copie des fichiers du fournisseur de sécurité de Cognos 207
Importation des données de la base de données Content Store 208
Configuration des composants de Cognos 8 pour l'utilisation d'une autorité de certification
tierce 208
Création de clés et de demandes de signature de certificat 209
Configuration des composants de Cognos 8 pour exécution dans une autorité de certifica-
tion tierce 211
Chapitre 13 : Configuration des exemples 213
Restauration des fichiers de sauvegarde des exemples de bases de données 213
Création de connexions entre la source de données et les exemples de bases de données
relationnelles 215
Configuration des exemples de cubes de Microsoft Analysis Services 216
Configuration de l'exemple de cube DB2 216
Création de connexions à la source de données vers des sources de données OLAP 216
Configuration de l'exemple de Metric Studio 218
Sources pour différentes langues 219
Importation des exemples 220
Exemples de modèles de bases de données 222
Exemple - Exécution de l'exemple d'agent ELM Returns Agent avec des données
modifiées 222
Exemple - Simulation de l'élément déclencheur d'événements initiaux 223
Exemple - Simulation du passage du temps et de la résolution de certains
événements 223
Exemple - Modification des données afin que l'agent ELM Returns Agent ne détecte pas
d'événements 223
Suppression des exemples de bases de données de Cognos 8 224
Chapitre 14 : Exécution d'une installation et d'une configuration sans surveillance 225
Exécution d'une installation sans surveillance 225
Exécution d'une configuration sans surveillance 227
Annexe A : Configuration manuelle de Cognos 8 229
Configuration manuelle de Cognos 8 sous UNIX et Linux 229
Modification manuelle des paramètres de configuration implicites sur les ordinateurs
UNIX et Linux 230
Modification manuelle des paramètres globaux sur les ordinateurs UNIX et Linux 232
Exécution de Cognos Configuration en mode silencieux sur les ordinateurs UNIX et
Linux 234
Création manuelle du fichier d'archive de Cognos 234
Annexe B : Dépannage 237
Fichiers journaux 237
Problèmes d'installation et de configuration 239
Problèmes de démarrage de Cognos 8 239
Problèmes de configuration de Cognos 8 251
Glossaire 261
Index 267

8
Introduction
Ce guide contient des instructions d'installation, de mise à niveau, de configuration et de test de

Cognos 8, ainsi que des instructions relatives au changement des serveurs d'application et à la
définition des exemples.
Cognos 8 est un produit Web qui intègre des fonctionnalités d'exécution de rapports, d'analyse, de
création de tableaux de bord et de gestion d'événements.
Pour utiliser ce guide, vous devez avoir les connaissances suivantes :
• concepts de production de rapports
• concepts de tableaux de bord
• concepts de base de données et d'entrepôt de données
• problèmes reliés à la sécurité
• connaissances de base d'administration de systèmes Windows et UNIX
• l'environnement serveur et l'infrastructure de sécurité de votre organisation
Les documents suivants contiennent des informations connexes auxqelles on peut faire référence
dans le présent document. Pour afficher ces documents, contactez votre administrateur afin
d'obtenir des informations sur l'emplacement de la documentation Cognos en ligne ou effectuez
une recherche dans la base de connaissance du site Web de support client mondial (http://sup-
port.cognos.com/kb-app/knowledgebase). Si vous avez besoin de références d'identification de
connexion, contactez votre administrateur ou envoyez un courrier électronique à l'adresse
suivante : support.america@cognos.com.
Document Description
Cognos 8 - Guide Gestion des serveurs, de la sécurité, des rapports et des
d'administration et de sécurité services du portail; configuration des exemples Cognos et
personnalisation de Cognos 8
Cognos 8 - Guide de dépannage Aide les administrateurs à rapidement identifier et résoudre

des problèmes
Cognos Configuration - Guide de Utilisation de Cognos Configuration pour configurer Cognos

l'utilisateur 8
Cognos 8 Architecture and Planification de l'architecture de Cognos 8, développement

Planning Guide des stratégies d'installation et optimisation des performances
du système
Framework Manager User Guide Création et publication des modèles dans Framework
Manager
Metric Studio - Guide de Création de tableaux de bord et suivi des indicateurs qu'ils
l'utilisateur pour les auteurs contiennent
Metric Studio - Guide de Suivi des indicateurs d'un tableau de bord

l'utilisateur
Metric Designer User Guide Création d'extraits qui mettent en correspondance des
informations et qui les transfèrent de sources de données
relationnelles et dimensionnelles vers Metric Studio

Introduction
Document Description
Cognos Office Connection - Utilisation de Cognos Office Connection pour extraire du
Guide de l'utilisateur contenu des produits de reporting de Cognos et de l'utiliser
dans Microsoft Office
Cognos 8 and Composite Installation, configuration et utilisation du module

Information Server Getting Composite Information Server avec Cognos 8 et Framework
Started Manager; donne accès à des sources d'informations réparties
Pour en savoir davantage à propos de ce produit, visitez le site Web de support client mondial de
Cognos (http://support.cognos.com). Pour en savoir davantage à propos de la formation, cliquez
sur le lien Training dans ce site.
Ce document est disponible sous forme d'aide en ligne et de manuel en ligne.
À partir de l'aide en ligne, vous pouvez cliquer sur le lien suivant pour ouvrir une version impri-
mable de ce document (PDF).
Notre documentation comprend des guides d'utilisation, des didacticiels, des livres de référence et
du matériel complémentaire destinés à répondre aux besoins de notre audience variée.
Aide en ligne
Toutes les informations sont disponibles dans l'aide en ligne. Vous pouvez accéder à l'aide en ligne
en cliquant sur le bouton d'aide dans un navigateur Web, ou bien sur le menu Aide, puis sur le
bouton Aide dans les produits Windows. Vous pouvez également télécharger l'aide en ligne à par-
tir du site de support client mondial de Cognos (http://support.cognos.com).
Manuels à imprimer
Les informations de chaque système d'aide en ligne sont accessibles au format PDF. Toutefois, il
est possible que le contenu d'un système d'aide donné soit réparti sur plusieurs livres en ligne. Uti-
lisez des livres en ligne pour imprimer un document ou pour y effectuer une recherche.
Vous pouvez imprimer des pages précises, une section ou le manuel au complet. Cognos vous
octroie une licence non exclusive et non cessible vous permettant d'utiliser, de copier et de repro-
duire le matériel protégé par copyright sous forme imprimée ou électronique, uniquement à des
fins de formation interne, d'utilisation et de maintenance du logiciel de Cognos.
Vous pouvez également lire les fichiers Lisezmoi des produits et les guides d'installation qui se
trouvent sur les CD des produits Cognos.
10
Chapitre 1 : Composants utilisés par Cognos 8
Cognos 8 est une solution Web d'information décisionnelle qui intègre des fonctionnalités d'exé-
cution de rapports, d'analyse, de création de tableaux de bord et de gestion d'événements. Cognos
8 comprend Cognos 8 Business Intelligence Server et Cognos 8 Business Intelligence Modeling.
Cognos 8 s'intègre aisément dans votre infrastructure existante en exploitant les ressources qui se
trouvent dans votre environnement. Certaines de ces ressources sont indispensables, telles qu'un
composant Java Virtual Machine pour les installations UNIX. D'autres sont facultatives, telles que
l'utilisation d'une base de données tierce pour la base de données Content Store ou d'un fournis-
seur de sécurité tiers pour l'authentification.
Par défaut, Cognos 8 utilise Tomcat comme serveur d'application. Vous pouvez configurer les pro-
duits de Cognos 8 pour qu'ils s'exécutent sur les serveurs d'application pris en charge dans votre
environnement.
Composants du serveur
Les composants du serveur offrent à l'utilisateur des interfaces pour la création de rapports et de
tableaux de bord, pour l'analyse et pour la gestion d'événements, ainsi que des fonctionnalités de
serveur permettant d'acheminer et de traiter les requêtes des utilisateurs. Les composants du ser-
veur incluent les outils suivants :
Cognos Connection
Cognos Connection est un portail Web fourni avec Cognos 8 ; il offre un point d'accès unique aux
données d'entreprise disponibles pour ses produits. Il offre un point d'entrée unique pour interro-
ger, analyser et organiser les données, ainsi que pour créer des rapports, des tableaux de bord et
des événements. Les utilisateurs peuvent exécuter toutes leurs applications Web de Cognos 8 par
l'intermédiaire de Cognos Connection. Les autres applications d'information décisionnelle, ainsi
que les adresses URL vers d'autres applications, peuvent être intégrées à Cognos Connection.
Visualiseur Cognos
Le visualiseur Cognos est un portlet à travers lequel vous pouvez interagir avec tous types de con-
tenus publiés de Cognos. Vous pouvez y accéder par l'intermédiaire de Cognos Connection et de
tout portail d'entreprise existant.
Report Studio
Report Studio permet aux auteurs de créer, de modifier et de distribuer une large gamme de rap-
ports de qualité professionnelle. Ils peuvent également définir des modèles de rapports standard
pour l'entreprise à utiliser dans Query Studio, ainsi que modifier des rapports créés dans Query
Studio ou Analysis Studio.
Query Studio
Query Studio permet aux utilisateurs disposant de connaissances limitées de concevoir, de créer et
d'enregistrer des rapports qui répondent aux besoins non couverts par les rapports standards de
qualité professionnelle créés dans Report Studio.
Analysis Studio
Dans Analysis Studio, les utilisateurs peuvent explorer, analyser et comparer les données dimen-
sionnelles. Analysis Studio offre un accès aux sources de données dimensionnelles et OLAP
(Online Analytical Processing), ainsi qu'aux sources de données relationnelles modélisées sous
forme de dimension. Les analyses créées dans Analysis Studio peuvent être ouvertes dans Report
Studio et servir à élaborer des rapports de qualité professionnelle.

Event Studio
Dans Event Studio, vous définissez des agents pour suivre vos données et exécuter des tâches lors-
que vous devez faire face à des conditions exceptionnelles ou des événements qui s'y rapportent.
Lorsqu'un événement survient, les utilisateurs sont alertés afin qu'ils puissent réagir. Les agents
peuvent publier des informations détaillées sur le portail, envoyer des alertes par courrier électro-
nique, exécuter et distribuer des rapports basés sur les événements, 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 déclencher un événement, à savoir l'envoi d'un courrier électronique aux
personnes concernées.
Metric Studio
Dans Metric Studio, vous pouvez créer et proposer un environnement personnalisé composé de
tableaux de bord pour surveiller et analyser les indicateurs à l'échelle de votre entreprise. Les utili-
sateurs peuvent surveiller et analyser les informations critiques et créer des rapports en utilisant
des tableaux de bord basés sur des indicateurs interfonctionnels.
Cognos Office Connection

Cognos Office Connection permet aux utilisateurs de Microsoft Office d'accéder aux données des
produits de création de rapports de Cognos dans les applications Microsoft Office.
Les composants de Cognos Office Connection sont automatiquement installés avec Cognos 8.
Cognos Office Connection n'est pas installé avec Cognos 8 Metrics Manager.
Cognos Configuration
Cognos Configuration est un outil qui sert à configurer Cognos 8, ainsi qu'à en démarrer et en
arrêter les services.
Passerelle
Dans Cognos 8, les communications Web s'effectuent généralement par l'intermédiaire de passe-
relles qui résident sur un ou plusieurs serveurs Web. Une passerelle est une extension de pro-
gramme de serveur Web qui transfère 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 de Cognos 8 qui gère le stockage des données d'application de
l'utilisateur, notamment la sécurité, les données de configuration, les modèles, les indicateurs, ainsi
que les spécifications et les sorties de rapports. Content Manager est nécessaire pour publier des
modèles, extraire ou stocker des spécifications de rapports, gérer des informations de planification
ou encore gérer l'espace-noms de Cognos.
Content Manager stocke des informations dans une base de données Content Store.
Composite Information Server

Composite Information Server permet d'accéder à d'autres sources de données telles que LDAP,
JDBC, Open XML et WSDL, et améliore les performances lors de l'interrogation de données
issues de plusieurs sources.
Composants de modélisation
Les composants de modélisation modélisent des données dans des sources de données afin de
structurer et de présenter ces données de façon à ce qu'elles puissent être appréhendées par l'utili-
sateur. Les composants de modélisation incluent les outils suivants :
12
Framework Manager
Framework Manager est l'outil de modélisation de Cognos 8 permettant de créer et de gérer des
métadonnées d'entreprise utilisées dans les analyses et les rapports Cognos 8. Les métadonnées
sont publiées de façon à être utilisées par des outils de création de rapports sous forme de pack,
offrant ainsi une vue intégrée unique d'un éventail de sources de données.
Metric Designer
Metric Designer est l'outil de modélisation de Cognos 8 qui sert à créer des extraits utilisés dans
les applications de création de tableaux de bord Cognos 8. Les extraits servent à mettre en corres-
pondance et à transférer des informations à partir de sources de métadonnées existantes telles que
des fichiers Framework Manager et Impromptu Query Definition (.iqd).
Transformer
Transformer est un outil de modélisation qui permet de créer des cubes utilisables dans Cognos
Series 7 et Cognos 8.
Pour en savoir davantage sur l'installation et la configuration de Transformer, reportez-vous à la
documentation fournie avec votre version de Transformer.
Map Manager
Les administrateurs et les modéliseurs font appel à un utilitaire Windows, Map Manager, pour
importer les cartes et mettre à jour leurs libellés dans Report Studio. Pour certaines fonctions des
cartes, telles que les noms de pays et de villes, ceux-ci peuvent définir d'autres noms, afin d'adap-
ter le texte qui s'affiche dans la carte pour les versions multilingues.
Pour en savoir davantage sur l'utilisation de Map Manager, reportez-vous au manuel Map Mana-
ger Installation and User Guide.
Composants tiers
Outre les outils fournis avec Cognos 8, les composants suivants créés par des fabricants tiers sont
également requis.
Content Store
Le Content Store est une base de données relationnelle qui contient des données dont Cognos 8 a
besoin pour fonctionner. Il s'agit de spécifications de rapports, de modèles publiés et des packs qui
les contiennent, ainsi que des informations de connexion pour les sources de données, des infor-
mations sur l'espace-noms externe et celui de Cognos, et des informations sur la planification et la
diffusion de rapports en rafale. Il doit s'agir de la base de données relationnelle d'un fournisseur
pris en charge.
Les modèles de conception et les fichiers journaux ne sont pas stockés dans Content Store.
Le service Cognos 8 qui utilise la base de données Content Store s'appelle Content Manager.
Bibliothèque d'indicateurs
Une bibliothèque d'indicateurs est une base de données relationnelle contenant des données relati-
ves aux packs d'indicateurs. Elle contient également des paramètres d'application Metric Studio,
tels que les préférences de l'utilisateur.
Vous pouvez créer plusieurs bibliothèques d'indicateurs. Par exemple, une bibliothèque d'indica-
teurs peut disposer de contenu pour une application de type ventes, tandis qu'une autre proposera
du contenu destiné à une application financière.
Sources de données
Les sources de données sont des bases de données relationnelles, des cubes, des fichiers ou d'autres
types de bibliothèques de données accessibles par l'intermédiaire de Cognos 8. Les composants
d'application utilisent des connexions spécifiques pour accéder aux sources de données.

Cognos 8 avec des applications Cognos Series 7

Si vous configurez Cognos 8 pour utiliser l'espace-noms Cognos Series 7, vous pouvez voir des
entrées Series 7 dans Cognos Connection. Lorsque vous exécutez un rapport Series 7, celui-ci
s'exécute dans l'application utilisée pour le créer.
Pour en savoir davantage sur l'accès aux entrées Series 7, reportez-vous au Guide d'administration
et de sécurité.
Vous pouvez accéder aux entrées Series 7 à partir des applications Series 7 suivantes :
Cognos Series 7 Upfront

Les rapports et cubes Series 7 peuvent être publiés sur le portail Cognos 8. Vous pouvez alors uti-
liser les outils de création de PowerPlay Series 7 pour créer et modifier des rapports PowerPlay
Series 7.
PowerPlay Cognos Series 7

Vous pouvez accéder aux index et classeurs de la version Series 7 version de Cognos Upfront à
partir de Cognos Connection.
Cognos Contributor
Vous pouvez accéder à des cubes Cognos Contributor non publiés et sécurisés par rapport à un
espace-noms Series 7.
Cognos Finance
Vous pouvez accéder à des cubes Cognos Finance qui sont sécurisés par rapport à un espace-noms
Series 7.
Transformer
Vous pouvez accéder aux cubes Cognos créés à l'aide de Transformer 7.1 et versions ultérieures.
14
Chapitre 2 : Options de répartition de Cognos 8
Avant de mettre en œuvre Cognos 8, déterminez la façon dont vous allez l'installer dans votre
environnement. Vous pouvez installer tous les composants de Cognos 8 sur un seul ordinateur ou
les répartir à l'échelle du réseau. Le choix du mode de répartition dépend de vos besoins en
matière d'exécution de rapports ou d'utilisation de tableaux de bord, de vos ressources et de vos
préférences. La configuration requise varie selon que vous installez tous les composants sur un ou
plusieurs ordinateurs.
Cognos 8 est compatible avec d'autres produits de Cognos. Si d'autres produits de Cognos sont
installés dans votre environnement, vous devez étudier la façon dont Cognos 8 va s'intégrer à cet
environnement.
Répartition des composants de création de rapports de

Cognos 8
Lors de l'installation des composants de création de rapports de Cognos 8, vous devez préciser
l'emplacement où les passerelles, les composants d'application et Content Manager doivent être
installés. Vous pouvez installer ces composants à l'aide de l'une des options suivantes :
• Installer tous les composants sur un ordinateur.
Cette option est habituellement utilisée pour une démonstration ou dans un environnement de
banc d'essai.
• Installer la passerelle sur un ordinateur distinct.
Si vous choisissez cette option, la passerelle et le serveur Web se trouvent sur le même ordina-
teur, et les composants de Cognos restants figurent sur d'autres ordinateurs. Vous pouvez
sélectionner cette option si vous disposez de serveurs Web capables de gérer les demandes des
composants de 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
sécurité en fonction des caractéristiques de traitement de votre organisation.
• Installer les composants de création de rapports de Cognos 8 sur le même ordinateur que celui
où sont installés les autres produits de Cognos 8.
Cognos 8 partage les composants de création de rapports et de tableaux de bord, tels que
Content Manager. Si vous prévoyez d'installer les composants de création de rapports et de
tableaux de bord de Cognos 8 sur le même ordinateur, il est conseillé d'utiliser le même empla-
cement d'installation.
Après avoir installé les composants de création de rapports de 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 modélisation des métadonnées
pour les informations décisionnelles. Quel que soit le scénario d'installation de Cognos choisi,
vous pouvez installer Framework Manager et la base de données Content Store sur un autre ordi-
nateur que celui où sont installés les composants d'application.
Installation de tous les composants sur un même ordinateur

Vous pouvez installer tous les composants de création de rapports de Cognos 8 sur un seul ordina-
teur. Optez pour ce scénario pour les environnements de banc d'essai ou de démonstration où la
charge des utilisateurs est faible.

Étant donné que la passerelle doit être installée sur le même ordinateur que le serveur Web, l'ordi-
nateur isolé doit également exécuter un serveur Web. Si le serveur Web tourne sous UNIX ou
Linux, vous devez installer Framework Manager pour Windows sur un ordinateur séparé fonc-
tionnant sous Windows.
Dans le diagramme suivant, tous les composants de création de rapports de Cognos 8, à l'excep-
tion de Framework Manager, sont installés sur le même ordinateur. La base de données Content
Store, les bases de données de requêtes et Framework Manager se trouvent sur des ordinateurs
séparés.
,QVWDOODWLRQGHVFRPSRVDQWVGX
)UDPHZRUN0DQDJHU VHUYHXU&RJQRVVXUXQVHXO
RUGLQDWHXU
6HUYHXU:HE
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU
%DVHGHGRQQpHV %DVHVGHGRQQpHV
&RQWHQW6WRUH GHUHTXrWHV
Configuration requise
Si vous installez tous les composants de création de rapports de Cognos 8 sur le même ordinateur,
vous devez :
• configurer votre serveur Web pour afficher le contenu de Cognos,
• indiquer les informations de connexion à la base de données Content Store.
• configurer un compte de courrier électronique pour les notifications (si vous avez l'intention
d'envoyer des rapports par courrier électronique).
Installation des passerelles sur différents ordinateurs

La passerelle gère les communications entre les composants de création de rapports de Cognos 8.
Elle peut résider sur un ou plusieurs serveurs Web.
Vous pouvez installer la passerelle et un serveur Web sur un même ordinateur, puis installer les
composants restants de création de rapports de Cognos 8 sur d'autres ordinateurs. Si vous dispo-
sez d'une ferme Web, vous pouvez installer une passerelle sur chaque serveur Web. L'utilisation de
plusieurs serveurs Web pour gérer les demandes entrantes permet d'offrir un meilleur niveau de
service.
Si vous installez uniquement le composant de passerelle sur le même ordinateur que le serveur
Web, celui-ci gère les services Web principaux sans traiter les demandes d'utilisateurs. Cette sépa-
ration du traitement s'impose si un pare-feu est installé entre le serveur Web et les ordinateurs des
composants d'application.
16
Dans le diagramme ci-dessous, une passerelle est installée sur chacun des deux serveurs Web. Les
demandes entrantes sont transmises à l'une des passerelles, puis transférées vers l'ordinateur des
,QVWDOODWLRQGH
6HUYHXU:HE 6HUYHXU:HE SOXVLHXUVSDVVHUHOOHV
3DVVHUHOOH 3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU
Si vous installez une ou plusieurs passerelles sur des ordinateurs séparés, assurez-vous que vous
pouvez consulter le contenu de Cognos et que les passerelles peuvent communiquer avec les autres
composants de Cognos. Sur chacun des ordinateurs où la passerelle est installée, vous devez :
• configurer les propriétés cryptographiques,
• configurer les URI du distributeur.
Installation des composants d'application et des applications Content Manager

sur différents ordinateurs
Un ou plusieurs serveurs de rapports utilisent l'interface de Cognos Connection pour équilibrer les
charges, accéder aux données, effectuer les requêtes, programmer les travaux et afficher les rap-
ports. Content Manager conserve l'ensemble des spécifications de rapports, des résultats, des
packs, des dossiers et des travaux dans la base de données Content Store.
Vous pouvez installer les composants d'application et Content Manager sur un ou plusieurs ordi-
nateurs. L'installation sur plusieurs ordinateurs peut améliorer les performances, la disponibilité
et la capacité.
Dans un souci d'amélioration de la modularité dans un environnement où le volume de demandes
de rapports à traiter est généralement important, vous pouvez installer les composants d'applica-
tion sur plusieurs ordinateurs réservés au traitement des demandes entrantes. En installant les
composants d'application sur plusieurs ordinateurs, vous répartissez et équilibrez les charges entre
ordinateurs. Vous bénéficiez également d'une accessibilité et d'un débit accrus par rapport à une
installation sur un seul ordinateur, de même que d'une prise en charge des reprises.
Dans le diagramme ci-dessous, les demandes entrantes sont acheminées vers une passerelle. La
passerelle transmet la demande à l'un des ordinateurs des composants d'application. Le serveur de
rapports transfère la demande à Content Manager qui adresse une requête à la base de données
Content Store et renvoie les résultats au serveur de rapports pour affichage.

,QVWDOODWLRQGHSOXVLHXUV
FRPSRVDQWVG
DSSOLFDWLRQ
)UDPHZRUN0DQDJHU
6HUYHXU:HE
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
2UGLQDWHXUV&RQWHQW0DQDJHU
HQDWWHQWH
&RQWHQW0DQDJHU
DFWLISDUGpIDXW
Si vous installez un ou plusieurs composants d'application sur un ordinateur séparé, pour vous
assurer qu'ils peuvent communiquer avec les composants de création de rapports de Cognos 8,
vous devez :
• définir tous les URI de Content Manager.
• définir les URI du distributeur.
• définir l'URI du distributeur des applications externes,
Installation de plusieurs applications Content Manager

Vous pouvez installer un nombre quelconque d'installations de Content Manager, mais une seule
est activée à tout instant. Chacune des autres installations agit en tant que Content Manager en
attente. Une installation est activée uniquement si l'ordinateur sur lequel l'instance active de Con-
tent Manager est installée subit une défaillance. Pour prendre en charge la reprise, il est recom-
mandé d'installer Content Manager sur au moins deux ordinateurs.
La base de données Content Store stocke les données nécessaires au fonctionnement de Cognos 8,
notamment des spécifications de rapports, des modèles publiés et les packs les contenant, des
informations de connexion pour les sources de données, des informations relatives à
l'espace-noms externe, l'espace-noms de Cognos lui-même et des informations concernant la pro-
grammation de rapports et leur diffusion en rafale. Content Store est un système de gestion de
bases de données relationnelles (RDBMS). À chaque installation de Cognos n'est associée qu'une
seule base de données Content Store.
Vous pouvez installer Content Manager indépendamment des composants d'application si vos
données contiennent des informations sensibles. Les données sont conservées au niveau correspon-
dant, avec les informations de sécurité.
Lorsqu'un Content Manager actif échoue, toutes les données de session non enregistrées sont per-
dues. Lorsque le nouveau Content Manager actif prend le relais, les utilisateurs peuvent être invi-
tés à se connecter.
18
Sur chaque ordinateur sur lequel vous avez installé Content Manager, vous devez :
• définir l'URI du distributeur des applications externes,
• configurer un compte de courrier électronique pour les notifications (si vous avez l'intention
d'envoyer des rapports par courrier électronique).
Installation des produits de Cognos 8 sur le même ordinateur

Les produits de Cognos 8 sont conçus pour partager certains composants, tels que la passerelle,
Content Manager, la base de données Content Store, Cognos Connection et Cognos Configura-
tion. Si vous installez plusieurs produits de Cognos 8 sur un même ordinateur, nous vous con-
seillons de les installer dans un même emplacement. Le programme d'installation vérifie si d'autres
composants de Cognos 8 se trouvent déjà dans l'emplacement d'installation. S'il y a déjà un com-
posant et qu'il peut être partagé, il n'est pas réinstallé.
Répartition des composants de Framework Manager

Framework Manager peut être installé sur un ordinateur contenant d'autres composants de créa-
tion de rapports de Cognos 8 ou sur un ordinateur séparé.
Framework Manager conserve des modèles d'exécution sur l'ordinateur des composants d'appli-
cation. Il peut communiquer avec le serveur par les deux routes suivantes :
• en se connectant au distributeur de composants d'application avec l'URI interne du distribu-
teur. Cette route est recommandée.
• en se connectant à une passerelle dédiée qui est configurée pour se connecter au distributeur
avec l'URI interne du distributeur.
Remarque : Ne modifiez pas votre passerelle principale pour utiliser l'URI interne du distribu-
teur. Cela diminuerait le niveau de sécurité des studios et du portail Cognos 8.
L'emplacement où vous installez Framework Manager et la manière dont vous le configurez
dépendent de la taille des modèles de métadonnées et du serveur Web utilisé.
Serveurs Web autres que Microsoft IIS

Pour les serveurs Web autres que Microsoft Internet Information Services (IIS), il n'existe pas de
différence fonctionnelle entre les deux routes de communication avec l'outil de modélisation et le
distributeur des composants d'application. Pour chaque route, l'outil de modélisation utilise l'API
SOAP BI Bus. Si vous utilisez la route du serveur Web alors que les modèles sont de taille moyenne
à grande (près de 1 Mo), les modèles sont fractionnés en éléments plus petits (blocs) avant trans-
mission.
Si vous utilisez un serveur Web autre que Microsoft IIS, nous vous conseillons de configurer l'outil
de modélisation pour communiquer à l'aide de la passerelle du serveur Web (Route 1). Cela vous
évite de devoir configurer des canaux de communication supplémentaires si vous utilisez des
pare-feu pour séparer l'outil de modélisation, le serveur Web et les composants d'application.
Pour en savoir davantage sur la configuration de Framework Manager, reportez-vous à la section
« Configuration des ordinateurs Framework Manager » (p. 109).
Observations concernant le pare-feu

Lorsque l'outil de modélisation communique directement avec le distributeur, des problèmes de
communication peuvent se poser. Si l'outil de modélisation est installé en dehors d'un pare-feu
réseau qui protège les composants d'application, vous devez prendre des mesures afin que la com-
munication puisse passer par ce pare-feu réseau.

)UDPHZRUN0DQDJHU
SDUHIHXUpVHDX
6HUYHXU:HE
3DVVHUHOOH

SDUHIHXUpVHDX
&RPSRVDQWV
G
DSSOLFDWLRQ &RPPXQLFDWLRQDYHFOHV
FRPSRVDQWVG
DSSOLFDWLRQ

Pour contourner cette exigence, vous pouvez installer l'outil de modélisation dans le même niveau
architectural que les composants d'application.
SDUHIHXUpVHDX
6HUYHXU:HE
3DVVHUHOOH

SDUHIHXUpVHDX
&RPSRVDQWV
G
DSSOLFDWLRQ )UDPHZRUN
0DQDJHU

Framework Manager communique avec les composants d'application, que vous pouvez installer
sur un ou plusieurs serveurs Web. Pour publier des modèles, vous devez configurer Framework
Manager pour qu'il communique avec le distributeur, soit directement, soit au moyen de la passe-
relle dédiée.
Veillez à ce que Framework Manager puisse communiquer avec les composants de création de
rapports de Cognos 8. Sur l'ordinateur où Framework Manager est installé, configurez les pro-
priétés cryptographiques et les propriétés d'environnement suivantes :
• URI de la passerelle
• URI du distributeur des applications externes
20
Répartition des composants de création de tableaux de bord

de Cognos 8
Lors de l'installation des composants de création de tableaux de bord de Cognos 8, vous devez
préciser l'emplacement où les passerelles, les composants d'application et Content Manager doi-
vent être installés. Vous pouvez installer ces composants à l'aide de l'une des options suivantes :
• Installer tous les composants sur un ordinateur.
Cette option est habituellement utilisée pour une démonstration ou dans un environnement de
banc d'essai.
• Installer la passerelle sur un ordinateur distinct.
Si vous choisissez cette option, la passerelle et le serveur Web se trouvent sur le même ordina-
teur, et les composants de Cognos restants figurent sur d'autres ordinateurs. Vous pouvez
sélectionner cette option si vous disposez de serveurs Web capables de gérer les demandes des
composants de 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
sécurité en fonction des caractéristiques de traitement de votre organisation.
• Installer les composants de création de tableaux de bord de Cognos 8 sur le même ordinateur
que celui où sont installés les autres produits de Cognos 8.
Les produits de Cognos 8 partagent certains composants, tels Content Manager. Si vous pré-
voyez d'installer les composants de création de tableaux de bord de Cognos 8 sur le même
ordinateur que les autres produits de Cognos 8, il est conseillé d'utiliser le même emplacement
d'installation.
Après avoir installé les composants de création de tableaux de bord de 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. 66), qui constitue l'application de modélisation des métadon-
nées pour la création de tableaux de bord. Quel que soit le scénario d'installation de Cognos
choisi, vous pouvez installer Metric Designer et la base de données Content Store sur un autre
ordinateur que celui où sont installés les composants d'application.
La bibliothèque d'indicateurs est généralement installée sur le même ordinateur que Content
Manager. Elle peut également être installée sur un ordinateur différent.
Installation de tous les composants sur un même ordinateur

Vous pouvez installer tous les composants de création de tableaux de bord de Cognos 8 sur un
seul ordinateur. Optez pour ce scénario pour les environnements de banc d'essai ou de démonstra-
tion où la charge des utilisateurs est faible.
Étant donné que la passerelle doit être installée sur le même ordinateur que le serveur Web, l'ordi-
nateur isolé doit également exécuter un serveur Web. Si le serveur Web est installé sous UNIX,
vous devez installer Metric Designer pour Windows sur un ordinateur séparé fonctionnant sous
Windows.
Dans le diagramme suivant, tous les composants de création de tableaux de bord de Cognos 8, à
l'exception de Metric Designer, sont installés sur le même ordinateur. La base de données Content
Store et la bibliothèque d'indicateurs sont installées sur différents ordinateurs.

,QVWDOODWLRQGHVFRPSRVDQWVGHFUpDWLRQ
6HUYHXU:HE GHWDEOHDX[GHERUG&RJQRV
VXUXQVHXORUGLQDWHXU
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU
%DVHGHGRQQpHV %LEOLRWKqTXHV
&RQWHQW6WRUH G
LQGLFDWHXUV
Si vous installez tous les composants de création de tableaux de bord de Cognos 8 sur le même
ordinateur, vous devez :
Installation des passerelles sur différents ordinateurs

La passerelle gère les communications entre les composants de création de tableaux de bord de
Cognos 8. Elle peut résider sur un ou plusieurs serveurs Web.
Vous pouvez installer la passerelle et un serveur Web sur un même ordinateur, puis installer les
composants restants de création de tableaux de bord de Cognos 8 sur d'autres ordinateurs. Si vous
disposez d'une ferme Web, vous pouvez installer une passerelle sur chaque serveur Web. L'utilisa-
tion de plusieurs serveurs Web pour gérer les demandes entrantes permet d'offrir un meilleur
niveau de service.
Si vous installez uniquement le composant de passerelle sur le même ordinateur que le serveur
Web, celui-ci gère les services Web principaux sans traiter les demandes d'utilisateurs. Cette sépa-
ration du traitement s'impose si un pare-feu est installé entre le serveur Web et les autres compo-
sants de création de tableaux de bord de Cognos 8.
Dans le diagramme ci-dessous, une passerelle est installée sur chacun des deux serveurs Web. Les
demandes entrantes sont transmises à l'une des passerelles, puis transférées vers l'ordinateur des
composants d'application en vue de leur traitement.
,QVWDOODWLRQGH
6HUYHXU:HE SOXVLHXUVSDVVHUHOOHV
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU
&RQWHQW6WRUH G
LQGLFDWHXUV
22
Si vous installez une ou plusieurs passerelles sur un ordinateur séparé, assurez-vous que vous pou-
vez consulter le contenu de Cognos et que les passerelles peuvent communiquer avec les autres
composants de Cognos. Sur chacun des ordinateurs où la passerelle est installée, vous devez :
• configurer les URI du distributeur.
Installation des composants d'application et des applications Content Manager

sur différents ordinateurs
Les composants d'application traitent les demandes de Cognos, équilibrent les charges, exécutent
des tâches et créent des tableaux de bord. Content Manager stocke et extrait des informations, tel-
les que les connexions à la source de données dans la base de données Content Store.
Vous pouvez installer les composants d'application et Content Manager sur un ou plusieurs ordi-
nateurs. L'installation sur plusieurs ordinateurs peut améliorer les performances, la disponibilité
et la capacité.
Dans un souci d'amélioration de la modularité dans un environnement où le volume de demandes
de rapports à traiter est généralement important, vous pouvez installer les composants d'applica-
tion sur plusieurs ordinateurs réservés au traitement des demandes entrantes. Ce faisant, vous
répartissez et équilibrez les charges entre ordinateurs. Vous bénéficiez également d'une accessibi-
lité et d'un débit accrus par rapport à une installation sur un seul ordinateur, de même que d'une
prise en charge des reprises.
Dans le diagramme ci-dessous, les demandes entrantes sont acheminées vers une passerelle. La
passerelle transmet la demande à l'un des composants d'application en vue de son traitement.
,QVWDOODWLRQGHSOXVLHXUV
FRPSRVDQWVG
DSSOLFDWLRQ
6HUYHXU:HE
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
2UGLQDWHXUV&RQWHQW
0DQDJHUHQDWWHQWH
&RQWHQW0DQDJHU
DFWLISDUGpIDXW
&RQWHQW6WRUH G
LQGLFDWHXUV
Si vous installez un ou plusieurs composants d'application sur un ordinateur séparé, veillez à ce
qu'ils puissent communiquer avec les autres composants de Cognos 8. Vous devez :


Installation de plusieurs applications Content Manager

Vous pouvez installer un nombre quelconque d'installations de Content Manager, mais une seule
est activée à tout instant. Chacune des autres installations agit en tant que Content Manager en
attente. Une installation est activée uniquement si l'ordinateur sur lequel l'instance active de Con-
tent Manager est installée subit une défaillance. Pour prendre en charge la reprise, il est recom-
mandé d'installer Content Manager sur au moins deux ordinateurs.
La base de données Content Store stocke les données nécessaires au fonctionnement de Cognos 8,
notamment des spécifications de rapports, des modèles publiés et les packs les contenant, des
informations de connexion pour les sources de données, des informations relatives à
l'espace-noms externe, l'espace-noms de Cognos lui-même et des informations concernant la pro-
grammation de rapports et leur diffusion en rafale. Content Store est un système de gestion de
bases de données relationnelles (RDBMS). À chaque installation de Cognos n'est associée qu'une
seule base de données Content Store.
Vous pouvez installer Content Manager indépendamment des composants d'application si vos
données contiennent des informations sensibles. Les données sont conservées au niveau correspon-
dant, avec les informations de sécurité.
Lorsqu'un Content Manager actif échoue, toutes les données de session non enregistrées sont per-
dues. Lorsque le nouveau Content Manager actif prend le relais, les utilisateurs peuvent être invi-
tés à se connecter.
Sur chaque ordinateur sur lequel vous avez installé Content Manager, vous devez :
Installation des produits de Cognos 8 sur le même ordinateur

Les produits de Cognos 8 sont conçus pour partager certains composants, tels que la passerelle,
Content Manager, la base de données Content Store, Cognos Connection et Cognos Configura-
tion. Si vous installez plusieurs produits de Cognos 8 sur un même ordinateur, nous vous con-
seillons de les installer dans un même emplacement. Le programme d'installation vérifie si d'autres
composants de Cognos 8 se trouvent déjà dans l'emplacement d'installation. S'il y a déjà un com-
posant et qu'il peut être partagé, il n'est pas réinstallé.
Répartition des composants de Metric Designer

Dans Metric Studio, pour définir et charger un grand nombre d'indicateurs à partir de sources de
données relationnelles et dimensionnelles (notamment des cubes, des packs Framework Manager
ou des fichiers .iqd de définitions de requêtes Impromptu), installez Metric Designer pour extraire
ces données.
Installez Metric Designer une fois tous les autres composants de Cognos 8 installés et configurés.
Si les composants de Cognos 8 fonctionnent dans un environnement UNIX, vous devez installer
Metric Designer pour Windows sur un ordinateur fonctionnant sous Windows.
Si Metric Designer est installé sur un ordinateur Windows différent de celui où sont installés les
autres composants de Cognos 8, les communications peuvent emprunter l'une de ces deux routes :
• en se connectant au distributeur de composants d'application avec l'URI interne du distribu-
teur. Cette route est recommandée.
• en se connectant à une passerelle dédiée qui est configurée pour se connecter au distributeur
avec l'URI interne du distributeur.
24
Remarque : Ne modifiez pas votre passerelle principale pour utiliser l'URI interne du distribu-
teur. Cela diminuerait le niveau de sécurité des studios et du portail Cognos 8.
L'emplacement où vous installez Metric Designer et la manière dont vous le configurez dépendent
de la taille des modèles de métadonnées et du serveur Web utilisé.
Serveurs Web autres que Microsoft IIS

Pour les serveurs Web autres que Microsoft Internet Information Services (IIS), il n'existe pas de
différence fonctionnelle entre les deux routes de communication avec l'outil de modélisation et le
distributeur des composants d'application. Pour chaque route, l'outil de modélisation utilise l'API
SOAP BI Bus. Si vous utilisez la route du serveur Web alors que les modèles sont de taille moyenne
à grande (près de 1 Mo), les modèles sont fractionnés en éléments plus petits (blocs) avant trans-
mission.
Si vous utilisez un serveur Web autre que Microsoft IIS, nous vous conseillons de configurer l'outil
de modélisation pour communiquer à l'aide de la passerelle du serveur Web (Route 1). Cela vous
évite de devoir configurer des canaux de communication supplémentaires si vous utilisez des
pare-feu pour séparer l'outil de modélisation, le serveur Web et les composants d'application.
Pour en savoir davantage sur la configuration de Metric Designer, reportez-vous à la section
« Configuration de Metric Designer » (p. 112).
Observations concernant le pare-feu

Lorsque l'outil de modélisation communique directement avec le distributeur, des problèmes de
communication peuvent se poser. Si l'outil de modélisation est installé en dehors d'un pare-feu
réseau qui protège les composants d'application, vous devez prendre des mesures afin que la com-
munication puisse passer par ce pare-feu réseau.
0HWULF'HVLJQHU
SDUHIHXUpVHDX
6HUYHXU:HE
3DVVHUHOOH

SDUHIHXUpVHDX
&RPSRVDQWV
G
DSSOLFDWLRQ &RPPXQLFDWLRQDYHFOHV
FRPSRVDQWVG
DSSOLFDWLRQ

Pour contourner cette exigence, vous pouvez installer l'outil de modélisation dans le même niveau
architectural que les composants d'application.

SDUHIHXUpVHDX
6HUYHXU:HE
3DVVHUHOOH

SDUHIHXUpVHDX
&RPSRVDQWV
G
DSSOLFDWLRQ
0HWULF
'HVLJQHU

Metric Designer communique avec les composants d'application, que vous pouvez installer sur un
ou plusieurs serveurs Web. Pour publier des extraits, vous devez configurer Metric Designer pour
qu'il communique avec le distributeur, soit directement, soit au moyen de la passerelle dédiée.
Vous devez veiller à ce que Metric Designer puisse communiquer avec les autres composants de
création de tableaux de bord de Cognos 8. Sur l'ordinateur où Metric Designer est installé, confi-
gurez les propriétés cryptographiques et les propriétés d'environnement suivantes :
• URI du distributeur des applications externes
Des tâches de configuration supplémentaires sont requises après l'installation de Metric Designer,
de façon à ce que ce dernier puisse accéder à certains types de sources de données (p. 112).
Cognos 8 avec d'autres produits de Cognos

Vous pouvez installer Cognos 8 dans un environnement incluant d'autres produits de Cognos.
L'assistant d'installation de Cognos 8 reconnaît les répertoires compatibles et affiche un avertisse-
ment en cas de conflits. Une fois que Cognos 8 est installé, vous pouvez accéder dans ce produit à
des objets créés dans un autre produit de Cognos. Les conditions requises pour l'accès dépendent
du mode d'exécution choisi pour les deux produits.
Produits de Cognos pouvant être mis à niveau vers Cognos 8

Les produits de Cognos suivants correspondent à des versions antérieures des composants faisant
maintenant partie de Cognos 8 : ReportNet, Cognos Metrics Manager, DecisionStream et Power-
Play Web. Lorsque vous mettez à niveau ces produits vers Cognos 8, vous pouvez continuer à exé-
cuter simultanément des versions antérieures dans le même environnement jusqu'à ce que la
transition vers Cognos 8 vous convienne.
ReportNet
Pour que ReportNet et Cognos 8 s'exécutent simultanément, chaque version doit disposer de
ports, d'une base de données Content Store, d'alias et de paramètres de témoin (cookie) uniques.
Si vous utilisez les paramètres implicites, la configuration est requise uniquement pour sélection-
ner de nouveaux ports et une nouvelle base de données Content Store pour Cognos 8. Vous ne
pouvez pas exploiter les données ReportNet directement dans Cognos 8 tant que vous ne mettez
pas à niveau ReportNet. Lorsque vous procédez à la mise à niveau vers Cognos 8, la base de don-
nées Content Store est également mise à niveau pour utiliser le schéma Cognos 8. Vous pouvez
mettre à niveau des rapports simultanément ou ultérieurement si la compatibilité avec des applica-
tions SDK existantes est requise.
26
Pour obtenir des instructions concernant l'exécution simultanée et la mise à niveau, consultez le
chapitre traitant de la mise à niveau dans le Guide d'installation et de configuration.
Cognos Metrics Manager

Pour utiliser le contenu de la bibliothèque de données de Cognos Metrics Manager dans
Cognos 8, vous devez le mettre à niveau en l'exportant, en installant Cognos 8, puis en l'impor-
tant dans la bibliothèque d'indicateurs Cognos 8. Notez que le sélecteur de cube (permettant de
faire correspondre des indicateurs spécifiques avec des intersections de cubes) de Cognos Metrics
Manager n'est pas disponible dans Cognos 8.
Pour obtenir des instructions concernant la mise à niveau, consultez le chapitre correspondant
dans le Guide d'installation et de configuration.
Cognos DecisionStream
Vous pouvez continuer à exécuter Cognos DecisionStream Series 7 simultanément avec les pro-
duits Cognos 8. Cognos 8 Data Manager offre de nouvelles fonctions nécessitant la mise à niveau
des catalogues créés à l'aide de DecisionStream Series 7.
Pour obtenir des instructions concernant l'exécution simultanée et la mise à niveau des catalogues
DecisionStream vers l'environnement Cognos 8 Data Manager, consultez le chapitre traitant de la
mise à niveau d'un catalogue dans le manuel Data Manager User Guide.
Cognos PowerPlay Web

Vous pouvez continuer à utiliser des rapports PowerPlay Web dans les interfaces utilisateur
PowerPlay 7 du portail Cognos 8. Il est également possible d'utiliser la fonction d'accès au détail
entre PowerPlay Web et Cognos 8. Vous pouvez procéder à une publication depuis PowerPlay
Enterprise Server vers Cognos 8, à condition d'utiliser le même nom d'hôte ou la même adresse IP
pour identifier l'espace-noms Series 7 dans Cognos Series 7 et dans Cognos 8.
Vous avez également la possibilité de mettre à niveau des rapports PowerPlay Web vers Cognos 8
au moyen des outils de migration et de mise à niveau. Ces outils sont disponibles sur le site Web
Cognos Global Customer Services (support.cognos.com).
Pour obtenir des instructions concernant la mise à niveau, consultez le manuel Migration and
Upgrade User Guide.
Produits Cognos Series 7 pouvant migrer vers Cognos 8

Vous pouvez migrer des métadonnées et des applications vers Cognos 8 qu'à partir de Cognos
Series 7 version 2 (7.1) ou Cognos Series 7 version 3 (7.3). Les éléments pouvant faire l'objet
d'une migration incluent le contenu Web provenant de Windows et d'UNIX, les catalogues et rap-
ports de clients Impromptu créés dans Windows ainsi que les modèles Architect conçus dans Win-
dows.
Pour en savoir davantage, reportez-vous au manuel Migration and Upgrade User Guide.
Vous pouvez télécharger les outils de migration et la documentation associée à partir du site Web
Cognos Global Customer Services (support.cognos.com).
Architect
Vous pouvez migrer des modèles Architect afin de les utiliser comme source de métadonnées pour
Framework Manager.
Impromptu
Vous pouvez migrer des catalogues afin de les utiliser comme source de métadonnées pour Fra-
mework Manager. Vous avez ensuite la possibilité de migrer et de déployer des rapports
Impromptu. Il est impossible de migrer des fichiers .iqd (Impromptu Query Definition).
Upfront
Vous pouvez migrer un contenu Upfront vers Cognos 8 à l'aide des outils de migration, en utili-
sant un pack Deployment Manager comme source de migration.

Rapports Impromptu Web Reports

Vous pouvez migrer des rapports Impromptu Web Reports en utilisant un pack Deployment
Manager comme source de migration. Avant les rapports, vous devez migrer les métadonnées de
catalogues Impromptu qui sont utilisées par les rapports.
Produits de Cognos fonctionnant avec Cognos 8

Certains produits de Cognos offrent des fonctions non disponibles dans Cognos 8. Vous pouvez
continuer à utiliser ces produits dans le même environnement que Cognos 8 et accéder aux diffé-
rents types de cubes dans le portail Cognos 8.
Cognos Planning - Analyst

Vous pouvez accéder aux données de plans publiés dans Cognos 8 à l'aide de l'assistant Generate
Framework Manager Model, qui requiert Cognos Planning - Analyst 7.3 MR1 ou ultérieure.
Pour en savoir davantage, reportez-vous au Guide de l'utilisateur d'Analyst.
Cognos Planning - Contributor

Vous pouvez accéder aux cubes Contributor (en temps réel) dans Cognos 8 en procédant à une
installation personnalisée du composant Cognos 8 - Contributor Data Server qui est fourni avec
Cognos Planning - Contributor 7.3 MR1 ou ultérieure. Vous pouvez accéder aux données de plans
publiés dans Cognos 8 à l'aide de l'extension d'administration Generate Framework Manager
Model, qui requiert Cognos Planning - Analyst 7.3 MR1 ou ultérieure.
Pour en savoir davantage, reportez-vous au manuel Contributor Administration Guide.
Cognos Finance
Vous pouvez accéder aux cubes Cognos Finance sécurisés par rapport à un espace-noms Series 7
au moyen du service d'API réseau Cognos Finance. Il est également possible d'exporter des don-
nées et des métadonnées à partir de Cognos Finance pour les utiliser dans Framework Manager.
Cognos Controller
Vous pouvez accéder à Cognos 8 pour créer des rapports standard Cognos Controller au moyen
d'un modèle Framework Manager prédéfini qui est créé lors de l'installation de Cognos Controller
8.1. Vous avez également la possibilité d'accéder à des structures et des données Controller
publiées dans Framework Manager pour produire des analyses et des rapports personnalisés.
Transformer
Vous pouvez utiliser directement dans Cognos 8 les cubes Cognos et les modèles Transformer
créés par Transformer 7.1 ou ultérieure. Les cubes et modèles sont compatibles avec les versions
ultérieures et ne requièrent pas d'outil de migration ou de mise à niveau. Vous pouvez exécuter des
rapports et des analyses dans Cognos 8 par rapport aux cubes Cognos. Il est recommandé d'opti-
miser les cubes pour Cognos 8 au moyen de l'utilitaire pcoptimizer.
Pour en savoir davantage sur l'optimisation des cubes, reportez-vous au Guide de dépannage.
Vous pouvez utiliser des modèles Transformer directement dans Framework Manager.
Contenu Cognos Series 7 pouvant être créé à nouveau dans Cognos 8

Il est impossible de migrer ou de mettre à niveau par le biais de la programmation certains pro-
duits de Cognos avec les outils de migration ou de mise à niveau pour Cognos 8. Cognos 8 offre
deux options pour dupliquer le contenu ou les fonctions des produits décrits ci-dessous : utiliser le
portail Upfront dans le portail Cognos 8 ou dupliquer des requêtes, des visualisations ou des
objets au moyen des studios Cognos 8.
Cognos Query
Vous pouvez dupliquer la plupart des fonctions de Cognos Query dans Cognos 8. Les interroga-
tions de base sont disponibles dans Cognos 8 lorsque vous migrez un modèle Architect. Vous pou-
vez également dupliquer manuellement des requêtes enregistrées à l'aide des composants SQL de
Report Studio.
28
Cognos Visualizer
Vous pouvez dupliquer des fonctions en utilisant les options de création de graphiques, de présen-
tation et de mise en forme de Report Studio.
Cognos NoticeCast
Vous pouvez dupliquer les fonctions d'alerte et de notification en utilisant Event Studio et d'autres
composants de Cognos 8.

30
Chapitre 3 : Flux de travail dans Cognos 8
Après avoir sélectionné les options de répartition adaptées à votre environnement (p. 15), vous
devez utiliser un flux de travail spécifique pour installer et configurer Cognos 8. Par exemple, vous
pouvez utiliser un flux de travail pour installer et configurer Cognos 8 sur un seul ordinateur et un
autre pour installer et configurer Cognos 8 dans une installation répartie.
La disponibilité de Metric Studio dépend de la solution Cognos 8 achetée par votre entreprise. Des
flux de travail sont fournis pour les opérations suivantes :
• installation de Cognos 8 avec Metric Studio,
• installation de Cognos 8 sans Metric Studio,
• ajout de Metric Studio à une installation de Cognos 8 existante.
Les flux de travail impliquent une exécution des tâches dans l'ordre indiqué. La plupart des tâches
effectuées pour une installation répartie sont les mêmes que celles associées à une installation sur
un seul ordinateur. Des tâches supplémentaires sont toutefois requises pour les installations répar-
ties, afin de permettre aux composants de communiquer entre eux.
Les flux de travail ne précisent ni les tâches de configuration supplémentaires (p. 115), ni les chan-
gements de serveur d'application (p. 191).
Il est recommandé d'imprimer le flux de travail que vous comptez utiliser. L'impression vous ser-
vira de liste de contrôle pour vous assurer que vous avez bien effectué toutes les tâches.
Installation de Cognos 8 avec Metric Studio

Vous pouvez installer Cognos 8 et Metric Studio simultanément. Les flux de travail ci-dessous
indiquent les tâches nécessaires à une installation et une configuration sur un seul ordinateur, ou
dans le cadre d'une installation répartie.
Pour en savoir davantage sur l'installation de Cognos 8 sans Metric Studio ou sur l'installation de
Framework Manager, reportez-vous à la section « Installation de Cognos 8 sans Metric
Studio » (p. 33). Pour en savoir davantage sur l'ajout de Metric Studio à une installation existante
de Cognos 8 ou sur l'installation de Metric Designer, reportez-vous à la section « Ajout de Metric
Studio à une installation Cognos 8 » (p. 35).

Installation sur un seul ordinateur

,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ
,QVWDOODWLRQGH &UpDWLRQG
XQH 'pILQLWLRQGHV
&RJQRV EDVHGHGRQQpHV SURSULpWpVGHFRQQH[LRQ
&RQWHQW6WRUH jODEDVHGHGRQQpHV
&RQWHQW6WRUH
XQH
0HWULF6WXGLR ELEOLRWKqTXH
&RQILJXUDWLRQG
XQFRPSWH
G
LQGLFDWHXUV
GHVHUYHXUGHPHVVDJHULH
HWG
XQHEDVHGHGRQQpHV
GHQRWLILFDWLRQ
9pULILFDWLRQGHV &RQILJXUDWLRQGHV
SDUDPqWUHV FOLHQWVGHEDVH
LPSOLFLWHV GHGRQQpHV
&UpDWLRQG
XQSDFN
G
LQGLFDWHXUV
pILQLWLRQGHV
'
YDULDEOHV
G
HQYLURQQHPHQWGH
ODELEOLRWKqTXH
G
LQGLFDWHXUVVRXV81,; 7HVWGHO
LQVWDOODWLRQ
HWGHODFRQILJXUDWLRQ
0LVHjMRXUGH
O
HQYLURQQHPHQWMDYD
)LQGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGX
VHUYHXU:HE
&RQILJXUDWLRQGHV
QDYLJDWHXUV:HE
32
Installation répartie
XQH &RQILJXUDWLRQ
&RJQRV EDVHGHGRQQpHV GHVRUGLQDWHXUV
VXUXQRXSOXVLHXUV &RQWHQW6WRUH &RQWHQW0DQDJHU
RUGLQDWHXUV
XQH
0HWULF ELEOLRWKqTXH &RQILJXUDWLRQGHV
6WXGLRVXUXQRX G
LQGLFDWHXUV RUGLQDWHXUVGHV
SOXVLHXUVRUGLQDWHXUV FRPSRVDQWV
G
DSSOLFDWLRQ
&RQILJXUDWLRQGHV
9pULILFDWLRQGHV FOLHQWVGHEDVHGH
SDUDPqWUHV GRQQpHV
LPSOLFLWHV &RQILJXUDWLRQGHV
RUGLQDWHXUV
SDVVHUHOOH
'pILQLWLRQGHVYDULDEOHV
G
HQYLURQQHPHQWGHOD
ELEOLRWKqTXHG
LQGLFDWHXUV
VRXV81,; &UpDWLRQG
XQSDFN
G
LQGLFDWHXUV
0LVHjMRXUGH
O
HQYLURQQHPHQW
MDYD 7HVWGHO
LQVWDOODWLRQ
HWGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGX
VHUYHXU:HE
)LQGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGHV
QDYLJDWHXUV:HE
* En plus des ordinateurs Metric Studio sur lesquels les composants d'application sont installés,
les composants d'application de Metric Studio doivent également être installés sur tous les ordina-
teurs sur lesquels les composants d'application des autres produits de Cognos 8 sont installés.
Installation de Cognos 8 sans Metric Studio

Vous pouvez installer Cognos 8 sans Metric Studio. Ces flux de travail décrivent les tâches néces-
saires à l'installation et la configuration d'applications sur un même ordinateur ou dans le cadre
d'une installation répartie. Un flux de travail est également fourni pour l'installation et la configu-
ration de Framework Manager
Pour en savoir davantage sur l'installation de Cognos 8 avec Metric Studio, reportez-vous à la sec-
tion « Installation de Cognos 8 avec Metric Studio » (p. 31). Pour en savoir davantage sur l'ajout
de Metric Studio à une installation existante de Cognos 8 ou sur l'installation de Metric Designer,
reportez-vous à la section « Ajout de Metric Studio à une installation Cognos 8 » (p. 35).


'pILQLWLRQGHV
&UpDWLRQG
XQH
,QVWDOODWLRQGH SURSULpWpVGH
EDVHGHGRQQpHV
&RJQRV FRQQH[LRQjOD
&RQWHQW6WRUH
EDVHGHGRQQpHV
&RQWHQW6WRUH
9pULILFDWLRQ &RQILJXUDWLRQGHV
&RQILJXUDWLRQG
XQ
GHVSDUDPqWUHV FOLHQWVGHEDVH
FRPSWHGHVHUYHXU
GHPHVVDJHULH
HWG
XQHEDVH
GHGRQQpHV
GHQRWLILFDWLRQ
0LVHjMRXUGH
O
HQYLURQQHPHQW
-DYD
7HVWGHO
LQVWDOODWLRQ
HWGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGX
VHUYHXU:HE
)LQDOLVDWLRQGH
ODFRQILJXUDWLRQ
&RQILJXUDWLRQGHV
QDYLJDWHXUV:HE
,QVWDOODWLRQGHV &UpDWLRQG
XQHEDVH &RQILJXUDWLRQ
FRPSRVDQWV GHGRQQpHV GHVRUGLQDWHXUV
&RJQRVVXU &RQWHQW6WRUH &RQWHQW0DQDJHU
GHX[RUGLQDWHXUV
RXSOXV
&RQILJXUDWLRQGHV
FOLHQWVGHEDVH &RQILJXUDWLRQGHV
9pULILFDWLRQ GHGRQQpHV RUGLQDWHXUVGHV
GHVSDUDPqWUHV FRPSRVDQWV
LPSOLFLWHV G
DSSOLFDWLRQ
0LVHjMRXUGH
O
HQYLURQQHPHQW
-DYD
&RQILJXUDWLRQGHV
RUGLQDWHXUV
SDVVHUHOOH
&RQILJXUDWLRQGX
VHUYHXU:HE
7HVWGHO
LQVWDOODWLRQ
HWGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGHV
QDYLJDWHXUV:HE
)LQDOLVDWLRQGH
ODFRQILJXUDWLRQ
34
Installation de Framework Manager

&RQILJXUDWLRQ ,QVWDOODWLRQ &RQILJXUDWLRQ
9pULILFDWLRQGH 3RXUXQHLQVWDOODWLRQ
,QVWDOODWLRQGH
O
LQVWDOODWLRQHWGX UpSDUWLH
)UDPHZRUN
ERQIRQFWLRQQHPHQW FRQILJXUDWLRQ
0DQDJHUVXUXQ
GHVDXWUHV GHVSURSULpWpV
RUGLQDWHXU:LQGRZV
FRPSRVDQWV G
HQYLURQQHPHQW
GH&RJQRV
9pULILFDWLRQ $XEHVRLQ
GHVSDUDPqWUHV PLVHjQLYHDX
LPSOLFLWHV GHVSURMHWV
Ajout de Metric Studio à une installation Cognos 8

Vous pouvez choisir d'ajouter Metric Studio à une installation existante de Cognos 8. Les flux de
travail ci-dessous décrivent les tâches nécessaires à l'installation et la configuration d'applications
sur un même ordinateur ou dans le cadre d'une installation répartie, dans laquelle Cognos 8 est
déjà installé. Un flux de travail est également fourni pour l'installation et la configuration de
Metric Designer.
Pour en savoir davantage sur l'installation simultanée de Cognos 8 et de Metric Studio, repor-
tez-vous à la section « Installation de Cognos 8 avec Metric Studio » (p. 31). Pour en savoir
davantage sur l'installation de Cognos 8 sans Metric Studio, reportez-vous à la section
« Installation de Cognos 8 sans Metric Studio » (p. 33).

&UpDWLRQG
XQHEDVH
,QVWDOODWLRQGH GHGRQQpHV &UpDWLRQG
XQ
0HWULF6WXGLR GHELEOLRWKqTXH SDFNG
LQGLFDWHXUV
G
LQGLFDWHXUV
9pULILFDWLRQ &RQILJXUDWLRQGHV
7HVWGHO
LQVWDOODWLRQ
GHVSDUDPqWUHV FOLHQWVGHEDVH
HWGHOD
FRQILJXUDWLRQ
'pILQLWLRQGHV
YDULDEOHV
)LQDOLVDWLRQGH
G
HQYLURQQHPHQW
ODFRQILJXUDWLRQ
GHODELEOLRWKqTXH
G
LQGLFDWHXUVVRXV
81,;

,QVWDOODWLRQGHV &UpDWLRQG
XQHEDVH
GHGRQQpHV &RQILJXUDWLRQGHV
FRPSRVDQWV RUGLQDWHXUVGHV
GH0HWULF6WXGLRVXU GHELEOLRWKqTXH
G
LQGLFDWHXUV FRPSRVDQWV
GHX[RUGLQDWHXUV G
DSSOLFDWLRQ
RXSOXV
&RQILJXUDWLRQGHV
FOLHQWVGHEDVH
9pULILFDWLRQGHV GHGRQQpHV &UpDWLRQG
XQ
SDUDPqWUHV SDFNG
LQGLFDWHXUV
LPSOLFLWHV
'pILQLWLRQGHV
YDULDEOHV
G
HQYLURQQHPHQW
GHODELEOLRWKqTXH 7HVWGHO
LQVWDOODWLRQ
G
LQGLFDWHXUVVRXV HWGHOD
81,; FRQILJXUDWLRQ
)LQDOLVDWLRQGH
ODFRQILJXUDWLRQ
Installation de Metric Designer

&RQILJXUDWLRQ ,QVWDOODWLRQ &RQILJXUDWLRQ
9pULILFDWLRQGH 3RXUXQHLQVWDOODWLRQ
,QVWDOODWLRQGH
O
LQVWDOODWLRQHWGX UpSDUWLH
0HWULF'HVLJQHU
ERQIRQFWLRQQHPHQW FRQILJXUDWLRQGHV
VXUXQRUGLQDWHXU
GHVDXWUHV SURSULpWpV
:LQGRZV
FRPSRVDQWV G
HQYLURQQHPHQW
GH&RJQRV
9pULILFDWLRQ $XEHVRLQ
9pULILFDWLRQGH GHVSDUDPqWUHV PLVHjQLYHDX
O
LQVWDOODWLRQHWGX LPSOLFLWHV GHVSURMHWV
ERQIRQFWLRQQHPHQW
GHVDSSOLFDWLRQV
DVVRFLpHVDX[
VRXUFHVGH
PpWDGRQQpHVTXL
YRQWrWUHXWLOLVpHV
36
Chapitre 4 : Mise à niveau vers Cognos 8
Si vous possédez des données Cognos Series 7, vous pouvez en transférer une partie vers Cognos 8
à l'aide des outils de migration et de mise à niveau disponibles dans une installation séparée.
Si vous utilisez des versions antérieures de ReportNet(R), Metrics Manager ou Cognos Office Con-
nection, vous pouvez effectuer une mise à niveau de votre contenu vers Cognos 8.
Reportez-vous aux rubriques suivantes pour en savoir davantage sur la mise à niveau :
• Mise à niveau à partir de Cognos Series 7
• Mise à niveau depuis ReportNet(R), Metrics Manager, ou des versions antérieures de Cognos 8
• Mise à niveau des documents Cognos Office Connection
Mise à niveau à partir de Cognos Series 7

Si vous transférez votre contenu depuis Cognos Series 7, vous devez installer les outils de migra-
tion et de mise à niveau de Cognos afin de mettre à niveau votre contenu Cognos Series 7 vers
Cognos 8.
Vous ne pouvez transférer votre contenu vers Cognos 8 qu'à partir de Cognos Series 7 version 2
(7.1) ou Cognos Series 7 version 3 (7.3). Si vous utilisez une version antérieure de Cognos Series 7,
vous devez d'abord mettre à niveau le logiciel et les données vers Cognos Series 7 version 2 pour
pouvoir transférer votre contenu vers Cognos 8. Étant donné que PowerPlay fait partie de
Cognos 8, le transfert de rapports PowerPlay de Cognos Series 7 vers Cognos 8 est considéré
comme une mise à niveau. Le transfert de tout autre type de contenu Cognos Series 7 vers
Cognos 8 est considéré comme une migration.
Vous pouvez transférer les types de contenu suivants vers Cognos 8 :
• Contenu Web de Cognos Series 7, tel que des rapports PowerPlay Web Explorer, provenant de
Windows ou UNIX.
• Contenu Upfront, tel que des classeurs et des index, provenant de Windows ou UNIX.
• Rapports et catalogues Impromptu provenant de Windows.
• Modèles Architect provenant de Windows.
Les outils de migration et de mise à niveau sont disponibles sur le site Web du support technique
de Cognos (http://support.cognos.com). La documentation relative à l'installation et l'utilisation
de ces outils est fournie avec le téléchargement.
Si vous avez publié des rapports PowerPlay Web dans Cognos Connection, version ReportNet ou
Cognos 8, vous pouvez toujours ouvrir ces rapports PowerPlay Web dans PowerPlay Web Explo-
rer ou Upfront ou bien les mettre à niveau vers Cognos 8.
Pour mettre à niveau les rapports PowerPlay Web publiés dans Cognos Connection, après avoir
installé les outils de migration et de mise à niveau, vous devez activer les options qui permettent
aux utilisateurs d'ouvrir les rapports Cognos Series 7 dans Report Studio ou Analysis Studio. Pour
activer ces options, utilisez Cognos Connection. Pour en savoir davantage, reportez-vous au
Guide d'administration et de sécurité.

Mise à niveau depuis ReportNet(R), Metrics Manager, ou des

versions antérieures de Cognos 8
Vous devez mettre à niveau le logiciel pour passer d'une version antérieure de Cognos 8, de Repor-
tNet ou de Metrics Manager à Cognos 8. Vous devez mettre à niveau chacun des composants. Les
composants provenant de versions différentes ne sont pas compatibles.
Vous pouvez effectuer une mise à niveau directe vers Cognos 8 à partir des versions de produits
suivantes :
• Cognos 8 8.1 ou ultérieur
• ReportNet 1.1 MR1, MR2 ou MR3
• Metrics Manager 2.0 ou ultérieur
Si vous avez une version antérieure de ReportNet, vous devez d'abord effectuer une mise à niveau
vers ReportNet 1.1 MR1 ou MR2, puis vers Cognos 8.
Vous pouvez exécuter plusieurs versions du logiciel sur votre ordinateur en même temps, dans la
mesure où vous les installez dans des répertoires séparés et que vous les configurez de façon à uti-
liser une base de données Content Store différente et un jeu de ports et d'URL distinct pour cha-
que version.
Avant de procéder à la mise à niveau, vous devez prévoir votre stratégie de mise à niveau. La stra-
tégie dépend des données que vous souhaitez utiliser et de la personnalisation que vous avez effec-
tuée lors de la configuration d'origine.
Pour utiliser le répertoire de configuration existant lorsque vous effectuez une mise à niveau à par-
tir de ReportNet, assurez-vous que les données de configuration de ReportNet sont copiées dans le
répertoire d'installation de Cognos 8. Cela comprend la sauvegarde de données existantes, la con-
figuration de Cognos 8 de façon à utiliser la base de données Content Store existante ou une copie
de celle-ci, la copie des fichiers de données de configuration vers le répertoire d'installation de
Cognos 8 et l'application des modifications ou personnalisations manuelles appliquées dans la
version précédente.
Si ReportNet et Metrics Manager sont installés sur le même ordinateur et que vous prévoyez
d'effectuer une mise à niveau vers Cognos 8, mettez d'abord à niveau ReportNet, puis Metrics
Manager.
Après avoir procédé à la mise à niveau vers Cognos 8, des tâches de configuration supplémentaires
sont requises si vous souhaitez utiliser les nouvelles fonctions. Pour en savoir davantage sur les
nouvelles fonctions de Cognos 8, reportez-vous au manuel Nouveautés de Cognos 8.
Applications SDK
Vous devez utiliser le SDK de Cognos 8 avec Cognos 8 Business Intelligence.
Lorsque vous effectuez une mise à niveau, vous devez réaliser certaines modifications sur votre
programme SDK pour qu'il fonctionne avec la version Cognos 8 du fichier WSDL. Toutefois, cer-
taines méthodes, classes et propriétés ont été désapprouvées dans Cognos 8. Les fonctions désap-
prouvées continuent à fonctionner comme auparavant, mais seront supprimées dans les versions
ultérieures. D'autres méthodes, classes et propriétés sont périmées et ont été supprimées du SDK
de Cognos 8.
Pour en savoir davantage sur les changements apportés aux méthodes, aux classes, aux propriétés
et aux ensembles d'énumérations, reportez-vous aux annexes comportant les notes de mise à jour
dans le manuel SDK Developer Guide de Cognos 8.
De nouvelles spécifications de rapports ont été ajoutées à Cognos 8. Si vous exécutez un rapport
ReportNet dans Cognos 8, il est automatiquement mis à niveau au format Cognos 8. Une fois mis
à niveau vers Cognos 8, un rapport ne peut pas repasser au format ReportNet. Les utilisateurs
ayant la possibilité de mettre à niveau des spécifications de rapports dont peuvent dépendre des
applications SDK, il est conseillé de définir les droits d'accès de ces rapports de manière à en limi-
ter l'accès aux utilisateurs. Pour en savoir davantage sur la définition de droits d'accès, repor-
tez-vous au Guide d'administration et de sécurité de Cognos 8.
38
Ne mettez pas à niveau vos spécifications de rapports si vous disposez d'applications SDK permet-
tant de créer, de modifier ou d'enregistrer des spécifications de rapports. Vous devez d'abord met-
tre à jour vos applications SDK pour qu'elles soient conformes au schéma de spécifications de
rapports de Cognos 8. Sinon, vos applications SDK risquent de ne pas être en mesure d'accéder
aux spécifications mises à niveau. Pour en savoir davantage sur la mise à niveau de spécifications
de rapports, reportez-vous au manuel SDK Developer Guide de Cognos 8.
Il est conseillé de ne pas mettre à jour vos spécifications de rapports si vous n'êtes pas certain de
disposer d'applications SDK permettant de créer, de modifier ou d'enregistrer des spécifications de
rapports. Contactez votre administrateur SDK pour en savoir davantage concernant vos applica-
tions SDK.
Content Manager
Lors de la mise à niveau de ReportNet, Content Manager met automatiquement à niveau le
schéma et le contenu de la base de données Content Store. Une fois que vous avez effectué la mise
à niveau, vous ne pouvez pas utiliser la base de données Content Store mise à niveau avec Repor-
tNet car elle n'est pas rétrocompatible. Pour protéger les données de la base de données Content
Store d'origine, vous devez configurer Cognos 8 de façon à utiliser une copie de la base de données
Content Store. Vous pouvez créer une copie de sauvegarde en enregistrant la base de données Con-
tent Store d'origine et en restaurant les données dans une nouvelle base de données Content Store.
Cognos 8 peut lire des archives de déploiement produites par ReportNet.
Framework Manager
Vous pouvez utiliser les mêmes modèles et les mêmes projets dans Framework Manager pour
Cognos 8 que ceux utilisés avec la version antérieure. Pour mettre un projet à niveau, ouvrez-le et
enregistrez-le dans la nouvelle version de Framework Manager. Pour en savoir davantage, repor-
tez-vous au manuel Framework Manager User Guide.
Si vous disposez d'applications SDK qui dépendent d'une version antérieure des spécifications de
rapports, vous ne pouvez pas utiliser Framework Manager pour publier votre modèle sans perdre
la rétrocompatibilité.
Bibliothèques de données Metrics Manager

Dans les versions antérieures, Metrics Manager utilisait une bibliothèque de données pour stocker,
organiser et extraire les informations. Dans Cognos 8, cette base de données est appelée bibliothè-
que d'indicateurs. Pour utiliser le contenu de la bibliothèque de données d'une version antérieure,
vous pouvez l'exporter à partir de la bibliothèque de données, installer Cognos 8 puis importer ce
contenu dans la bibliothèque d'indicateurs.
Il n'est pas possible d'utiliser la bibliothèque d'indicateurs avec une version antérieure de Metrics
Designer car elle n'est pas rétrocompatible. Avant d'exporter le contenu de la bibliothèque de don-
nées, effectuez une copie de sauvegarde, au cas où vous auriez besoin de revenir à la version anté-
rieure.
Metric Designer
Si vous souhaitez utiliser les projets des versions antérieures de Metrics Manager avec l'applica-
tion Metric Designer de Cognos 8 (p. 113), il vous suffit de les mettre à niveau.
Les projets mis à niveau ne peuvent être utilisés avec une version antérieure car ils ne sont pas
rétrocompatibles. Avant de mettre à niveau un projet, effectuez une copie de sauvegarde, au cas où
vous auriez besoin de revenir à la version antérieure.
Mise à niveau à partir d'une version antérieure de Cognos 8

Vous pouvez mettre à niveau Cognos 8 dans le même répertoire qu'une version antérieure, ou
dans un autre répertoire.
Si vous souhaitez mettre à niveau Cognos 8 dans le même répertoire, assurez-vous que les projets
de Framework Manager ne sont pas activés dans un système de contrôle de la source.
Si vous procédez à l'installation sur un nouvel ordinateur, reportez-vous à la section « Procédure
d'installation dans un nouveau répertoire » (p. 47).

Lorsque vous effectuez une copie de sauvegarde des données de configuration, vous les stockez
dans un répertoire sécurisé. Ce répertoire doit être protégé contre tout accès non autorisé ou inap-
proprié.
Une autre méthode de mise à niveau consiste à exporter l'intégralité de la base de données Content
Store dans une archive de déploiement puis à importer cette archive dans Cognos 8 après la mise à
niveau. Pour en savoir davantage sur le déploiement, reportez-vous au Guide d'administration et
de sécurité. Une mise à niveau par déploiement est requise si vous souhaitez modifier le type de
base de données Content Store utilisé. Si vous optez pour la méthode de mise à niveau par déploie-
ment, seules les étapes d'exportation et de restauration des données de configuration diffèrent.
Toutes les autres étapes sont identiques à celles décrites dans la présente section.
Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous ne souhaitez pas
utiliser Tomcat, vous devez suivre une autre procédure de mise à niveau. Pour en savoir davan-
tage, reportez-vous à la section « Mise à niveau de ReportNet vers Cognos 8 dans un environne-
ment de serveur d'application » (p. 203).
Lorsque vous effectuez une mise à niveau, l'administrateur de rapports n'a plus accès à l'outil
d'administration du contenu. Il ne sera donc pas en mesure de créer des définitions de déploiement
dans Cognos 8.
Fichiers personnalisés Cognos 8

Si vous avez modifié manuellement des fichiers de configuration, ces modifications seront rempla-
cées lors de la mise à niveau. Vous devez appliquer les modifications à nouveau. Il est vivement
conseillé de conserver un enregistrement de toutes les personnalisations afin de garantir qu'elles
pourront être appliquées à nouveau après la mise à niveau. Vous devriez également enregistrer ces
fichiers afin de pouvoir restaurer la version d'origine en cas de besoin.
Il est possible que vous ayez modifié des fichiers autres que ceux situés dans le dossier de configu-
ration. Dans ce cas, vous devez également sauvegarder ces autres fichiers avant de procéder à la
mise à niveau.
Le service de présentation de 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'intégrer manuellement les modifications après la mise à niveau. Les fichiers system.xml sont
écrasés lors de l'installation de Cognos 8. Par conséquent, vous devez enregistrer les versions per-
sonnalisées de ces fichiers et les copier dans le répertoire après la mise à niveau de Cognos 8. La
mise à niveau automatique s'exécutera lorsque vous démarrerez le service Cognos 8.
Les fichiers system.xml concernés par la mise à niveau automatique se trouvent dans les répertoi-
res 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 personnalisés
en appliquant de nouveau les modifications après l'installation du nouveau logiciel. La mise à
niveau automatique des fichiers system.xml ne doit être utilisée que lorsque vous avez réalisé
d'importantes modifications sur ces fichiers.
Procédure d'installation dans le même répertoire

1. À l'aide des outils de bases de données, enregistrez votre base de données Content Store exis-
tante.
Pour en savoir davantage sur la réalisation de cette tâche, reportez-vous à la documentation
de votre base de données.
2. Enregistrez une copie de sauvegarde des fichiers suivants dans un emplacement sécurisé :
• coglocale.xml dans le répertoire emplacement_c8/configuration
• server.xml dans le répertoire emplacement_c8/tomcat4.1.27/conf
• system.xml dans le répertoire correspondant, le cas échéant
Veillez à noter le chemin d'accès au répertoire. Par exemple :
emplacement_c8/templates/ps
40
3. Dans Cognos Configuration, exportez les données de configuration dans ce même répertoire
sécurisé.
Pour que le processus de mise à niveau puisse utiliser les données, nommez le fichier cogstar-
tup.xml.
Important : Veillez à ce que l'emplacement soit sécurisé car le fichier crnstartup.xml exporté
contient des mots de passe non chiffrés.
4. Dans un emplacement sécurisé, effectuez une copie de sauvegarde des fichiers modifiés
manuellement dans le répertoire emplacement_c8/configuration ou dans d'autres répertoires.
5. Arrêtez tous les services Cognos.
6. Important : Si vous utilisez un système de contrôle de la source tel que CVS, assurez-vous que
tous les projets de Framework Manager à mettre à niveau sont extraits avant de procéder à la
mise à niveau.
Les projets qui sont activés lorsque vous effectuez la désinstallation ne sont pas mis à niveau.
7. Désinstallez Cognos 8 de tous les ordinateurs Cognos 8.
8. Installez la nouvelle version de Cognos 8 dans le même répertoire que celui utilisé pour
Cognos 8 sur chaque ordinateur (p. 57).
9. Copiez les fichiers .xml situés dans les emplacements de sauvegarde sécurisés suivants :
• Copiez les fichiers cogstartup.xml et coglocale.xml dans le répertoire
emplacement_c8/configuration.
• Copiez le fichier server.xml dans le répertoire emplacement_c8/tomcat4.1.27/conf.
• Copiez le fichier system.xml dans le répertoire correspondant, le cas échéant
Par exemple :
Si vous êtes invité à remplacer les fichiers existants, cliquez sur Oui.
10. Pour les fichiers modifiés manuellement dans une version antérieure de Cognos 8, modifiez
ces mêmes fichiers dans le répertoire emplacement_c8 et appliquez à nouveau les modifica-
tions apportées aux fichiers personnalisés d'origine.
Ne copiez pas les fichiers personnalisés dans les répertoires emplacement_c8, car il est proba-
ble que les versions antérieures de ces fichiers ne soient pas compatibles.
11. Dans Cognos Configuration, vérifiez la configuration puis enregistrez-la.
Lorsque vous enregistrez la configuration, une boîte de dialogue de mise à niveau s'affiche et
vous demande si vous souhaitez mettre à niveau les spécifications de votre rapport. Par défaut,
les spécifications du rapport ne sont pas mises à niveau.
Important : Ne mettez pas à niveau vos spécifications de rapports si vous disposez d'applica-
tions SDK permettant de créer, de modifier ou d'enregistrer des spécifications de rapports.
Vous devez d'abord mettre à jour vos applications SDK pour qu'elles soient conformes au
schéma de spécifications de rapports de Cognos 8. Sinon, vos applications SDK risquent de ne
pas être en mesure d'accéder aux spécifications 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 spécifications de rapports, reportez-vous au manuel SDK Developer Guide
de Cognos 8.
12. Démarrez Cognos 8.
Cognos 8 met automatiquement à niveau la base de données Content Store. Les fichiers sys-
tem.xml sont mis à niveau, le cas échéant, vers une version compatible de Cognos 8.
13. Installez (p. 64) et configurez (p. 109) Framework Manager.
14. Mettez à niveau les projets et les rapports Framework Manager (p. 111) de façon appropriée.
Pour obtenir des instructions, reportez-vous au manuel Framework Manager User Guide.
Les utilisateurs de Report Studio doivent vider l'antémémoire de leur navigateur Web pour
obtenir les images les plus récentes.
15. Si vous utilisez des pages créées dans les versions antérieures de Cognos 8, vous devrez
peut-être configurer à nouveau les propriétés suivantes :
• Titre
• Ouvrir des liens d'opération vers l'extérieur d'un portail
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

16. 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 à la documentation iView de Cognos SAP EP.
Procédure d'installation dans un nouveau répertoire

1. À l'aide des outils de bases de données, copiez votre base de données Content Store existante
dans une nouvelle base de données Content Store.
• coglocale.xml dans le répertoire emplacement_c8/configuration
• server.xml dans le répertoire emplacement_c8/tomcat4.1.27/conf
• Dans Cognos Configuration, exportez les données de configuration dans ce même réper-
toire sécurisé.
Pour que le processus de mise à niveau puisse utiliser les données, nommez le fichier cogs-
tartup.xml.
Important : Veillez à ce que l'emplacement soit sécurisé car le fichier cogstartup.xml
exporté contient des mots de passe non chiffrés.
• Dans un emplacement sécurisé, effectuez une copie de sauvegarde des fichiers modifiés
manuellement dans le répertoire emplacement_c8/configuration ou dans d'autres réper-
toires.
3. Installez Cognos 8 dans un nouveau répertoire (p. 57).
4. Copiez les fichiers .xml situés dans l'emplacement de sauvegarde sécurisé vers le répertoire
suivant :
• Copiez les fichiers cogstartup.xml et coglocale.xml dans le répertoire
• Copiez le fichier system.xml dans le nouvel emplacement, dans le même répertoire qu'il
occupait dans une version antérieure, le cas échéant.
Par exemple :
5. Pour les fichiers modifiés manuellement, modifiez ces mêmes fichiers dans le répertoire
emplacement_c8 et appliquez à nouveau les modifications apportées aux fichiers personnali-
sés d'origine.
ble que les versions antérieures de ces fichiers ne soient pas compatibles avec Cognos 8.
6. Configurez les nouveaux alias de serveur Web (p. 81).
7. Dans Cognos Configuration, configurez Cognos 8 de façon à pointer vers la nouvelle base de
données Content Store, configurez les nouveaux ports et les nouvelles adresses URL, utilisez
un autre chemin d'accès aux paramètres de témoin (cookie), puis enregistrez la configuration
(p. 53).
Afin d'éviter tout conflit, assurez-vous que les numéros de port et le nom du service associés à
cette installation sont différents de ceux utilisés par les versions antérieures.
Vérifiez que les paramètres d'authentification de sécurité sont inchangés. Par exemple, les
espaces-noms doivent être les mêmes pour que les stratégies, les utilisateurs, les rôles et les
groupes fonctionnent correctement.
42
de Cognos 8.
Cognos 8 met automatiquement à niveau la nouvelle base de données Content Store. Les
fichiers system.xml sont mis à niveau, le cas échéant, vers une version compatible de Cognos
8.
11. Ouvrez le portail d'administration et annulez l'inscription des distributeurs utilisés avec des
versions antérieures de Cognos 8.
Lorsque vous ouvrez le portail d'administration dans Cognos 8, vous pouvez voir les distribu-
teurs inscrits pour les deux versions.
12. Si vous utilisez des pages créées dans ReportNet, vous devrez peut-être configurer à nouveau
les propriétés suivantes :
• Titre
14. Lorsque vous êtes prêt à désinstaller la version antérieure de Cognos 8, procédez comme suit :
• Arrêt du service Cognos 8.
• Désinstallez Cognos 8 de tous les ordinateurs.
Pour en savoir davantage, reportez-vous à la section « Désinstallation de Cognos
8 » (p. 68).
Lorsque vous effectuez les tâches de mise à niveau, Cognos 8 est intégralement configuré, à
l'exception des nouvelles fonctionnalités, des nouvelles propriétés et des fonctions liées aux
tableaux de bord.
Si vous utilisez des caractères chinois, japonais ou coréen, il est possible que vous constatiez quel-
ques différences au niveau des caractères une fois la mise à niveau effectuée. Pour en savoir davan-
tage, reportez-vous au Guide de dépannage.
Si vous utilisez une base de données DB2 comme Content Store, vous pouvez mettre au point la
base de données afin de tirer profit des fonctions de DB2. Pour en savoir davantage, reportez-vous
au manuel Architecture and Planning Guide.
Pour garantir la sécurité et l'intégrité de Cognos 8, il est important de protéger le répertoire d'ins-
tallation contre tout accès non autorisé ou inapproprié.

Nouveaux noms de fichiers et de répertoires après la mise à niveau à partir de

ReportNet
Après la mise à niveau de ReportNet à Cognos 8, certains noms de fichiers, répertoires et com-
mandes seront différents. Si vous installez Cognos 8 dans un répertoire différent de ReportNet, les
noms de répertoires implicites sont modifiés lorsque vous installez Cognos 8. Si vous installez
Cognos 8 dans le même répertoire que ReportNet, le nom des répertoires existants restera
inchangé. Certains noms de fichiers sont modifiés lors de l'installation de Cognos 8 et d'autres
modifications surviennent lors de l'enregistrement de la configuration de Cognos 8. Vous devez
modifier manuellement l'alias du répertoire virtuel, le cas échéant.
Les noms ci-après sont concernés :
ReportNet Cognos 8 Description

crn c8 Répertoire implicite d'installation
crn cognos8 Alias du navigateur Web implicite ou du

répertoire virtuel
crnstartup.xml cogstartup.xml Fichier des données de configuration utilisé lors

du démarrage de Cognos Configuration
crnstartup_ cogstartup_ Fichier des données de configuration qui stocke

aaaammjjhhmm.xml aaaammjjhhmm.xml les préférences lors de chaque enregistrement de
la configuration
crnlocale.xml coglocale.xml Fichier des données de configuration qui stocke

les codes des paramètres de configuration
internationaux
crnlocale_ coglocale_ Fichier des données de configuration qui stocke

aaaammjjhhmm.xml aaaammjjhhmm.xml les préférences lors de chaque enregistrement des
paramètres de configuration internationaux
crnformat.xml cogformat.xml Fichier des données de configuration qui stocke

le format des données numériques, de la date et
de l'heure
crnserver.log cogserver.log Fichier de journalisation implicite
crconfigw.exe cogconfigw.exe Fichier de démarrage de Cognos Configuration

sous Windows
crconfig.bat cogconfig.bat Fichier de démarrage de Cognos Configuration

sous Windows en mode silencieux
crconfig.sh cogconfig.sh Fichier de démarrage de Cognos Configuration

sous UNIX et Linux
crconfig.prefs cogconfig.prefs Fichier des données de configuration qui stocke

les préférences de l'utilisateur dans Cognos
Configuration
crconfig_ réponse.csv cogconfig_ Fichier de journalisation en mode silencieux qui

réponse.csv stocke les activités lors du fonctionnement de
Cognos Configuration en mode silencieux.
xstartup issetup Commande permettant de démarrer l'assistant

d'installation sous X Windows
44
ReportNet Cognos 8 Description

xwsetup issetupcc Commande permettant de démarrer l'assistant
d'installation sous UNIX et Linux
xwsetup.exe issetup.exe Fichier pour démarrer l'assistant d'installation

sous Windows
ReportNetService_ CognosService_ Exemple de fichier pour les configurations

codelangue.xml codelangue.xml moyennes ou étendues
Mise à niveau de ReportNet vers Cognos 8

Vous pouvez installer et mettre à niveau Cognos 8 dans le même répertoire que ReportNet ou dans
un répertoire différent.
Pour installer Cognos 8 dans le même répertoire, vous devez au préalable désinstaller ReportNet.
Avant de procéder à la désinstallation, assurez-vous que les projets de Framework Manager ne
sont pas activés dans un système de contrôle de la source.
Pour installer Cognos 8 dans un nouveau répertoire, vous pouvez conserver ReportNet actif
jusqu'à ce que la nouvelle version fonctionne de façon appropriée.
Si vous procédez à l'installation sur un nouvel ordinateur, reportez-vous à la section « Procédure
d'installation dans un nouveau répertoire » (p. 47).
Lorsque vous effectuez une copie de sauvegarde des données de configuration, vous les stockez
dans un répertoire sécurisé. Ce répertoire doit être protégé contre tout accès non autorisé ou inap-
proprié.
Une autre méthode de mise à niveau consiste à exporter l'intégralité de la base de données Content
Store dans une archive de déploiement de ReportNet puis à importer cette archive dans Cognos 8.
Pour en savoir davantage sur le déploiement, reportez-vous au Guide d'administration et de sécu-
rité. Une mise à niveau par déploiement est requise si vous souhaitez modifier le type de base de
données Content Store utilisé. Si vous optez pour la méthode de mise à niveau par déploiement,
seules les étapes d'exportation et de restauration des données de configuration diffèrent. Toutes les
autres étapes sont identiques à celles décrites dans la présente section.
Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous mettez à niveau
ReportNet et que vous ne souhaitez pas utiliser Tomcat, vous devez suivre une autre procédure de
mise à niveau. Pour en savoir davantage, reportez-vous à la section « Mise à niveau de ReportNet
vers Cognos 8 dans un environnement de serveur d'application » (p. 203).
Lorsque vous effectuez une mise à niveau de ReportNet 1.1 vers Cognos 8, l'administrateur de
rapports n'a plus accès à l'outil d'administration du contenu. Il ne sera donc pas en mesure de
créer des définitions de déploiement dans Cognos 8.
Fichiers ReportNet personnalisés

Si vous avez modifié manuellement des fichiers de configuration, ces modifications seront rempla-
cées lors de la mise à niveau. Vous devez à nouveau appliquer ces modifications dans l'environne-
ment Cognos 8. Il est vivement conseillé de conserver un enregistrement de toutes les
personnalisations afin de garantir qu'elles pourront être appliquées à nouveau après la mise à
niveau. Vous devriez également enregistrer ces fichiers afin de pouvoir restaurer la version d'ori-
gine en cas de besoin.
Il est possible que vous ayez modifié des fichiers autres que ceux situés dans le dossier de configu-
ration. Dans ce cas, vous devez également sauvegarder ces autres fichiers avant de procéder à la
mise à niveau.

Le service de présentation de Cognos 8 prend en charge la mise à niveau automatique de certains

fichiers system.xml de ReportNet. Si vous avez effectué de nombreuses modifications de personna-
lisation sur des fichiers system.xml dans ReportNet, vous pouvez utiliser cette fonction de mise à
niveau automatique au lieu d'intégrer manuellement les modifications après la mise à niveau. Les
fichiers system.xml sont écrasés lors de l'installation de Cognos 8. Par conséquent, vous devez
enregistrer les versions ReportNet de ces fichiers et les copier dans le répertoire après l'installation
de Cognos 8. La mise à niveau automatique s'exécutera lorsque vous démarrerez le service Cognos
8.
Les fichiers system.xml concernés par la mise à niveau automatique se trouvent dans les répertoi-
res 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 personnalisés
en appliquant de nouveau les modifications après l'installation du nouveau logiciel. La mise à
niveau automatique des fichiers system.xml ne doit être utilisée que lorsque vous avez réalisé
d'importantes modifications sur ces fichiers.
Procédure d'installation dans le même répertoire

1. À l'aide des outils de bases de données, enregistrez votre base de données Content Store exis-
tante.
• crnlocale.xml dans le répertoire emplacement_crn/configuration
• server.xml dans le répertoire emplacement_crn/tomcat4.1.27/conf
emplacement_crn/templates/ps
3. Dans Cognos Configuration, exportez les données de configuration dans ce même répertoire
sécurisé.
Pour que le processus de mise à niveau puisse utiliser les données, nommez le fichier crnstar-
tup.xml.
Important : Veillez à ce que l'emplacement soit sécurisé car le fichier crnstartup.xml exporté
contient des mots de passe non chiffrés.
4. Dans un emplacement sécurisé, effectuez une copie de sauvegarde des fichiers modifiés
manuellement dans le répertoire emplacement_crn/configuration ou dans d'autres répertoires.
5. Arrêtez tous les services Cognos.
6. Important : Si vous utilisez un système de contrôle de la source tel que CVS, assurez-vous que
tous les projets de Framework Manager à mettre à niveau sont extraits avant de désinstaller
ReportNet.
Les projets qui sont activés lorsque vous effectuez la désinstallation ne sont pas mis à niveau.
7. Désinstallez ReportNet de tous les ordinateurs ReportNet.
Pour en savoir davantage, reportez-vous aux instructions de l'ancienne version de ReportNet.
8. Installez Cognos 8 dans le même répertoire que celui utilisé pour ReportNet sur chaque ordi-
nateur (p. 57).
9. Copiez les fichiers .xml situés dans les emplacements de sauvegarde sécurisés suivants :
• Copiez les fichiers crnstartup.xml et crnlocale.xml dans le répertoire
emplacement_crn/configuration.
• Copiez le fichier server.xml dans le répertoire emplacement_crn/tomcat4.1.27/conf.
• Copiez le fichier system.xml dans le répertoire correspondant, le cas échéant
Par exemple :
46
10. Pour les fichiers modifiés manuellement dans ReportNet, modifiez ces mêmes fichiers dans le
répertoire emplacement_crn et appliquez à nouveau les modifications apportées aux fichiers
personnalisés d'origine.
Ne copiez pas les fichiers personnalisés dans les répertoires emplacement_crn, car il est proba-
11. Dans Cognos Configuration, vérifiez la configuration puis enregistrez-la.
de Cognos 8.
Cognos 8 met automatiquement à niveau la base de données Content Store. Les fichiers sys-
tem.xml sont mis à niveau, le cas échéant, vers une version compatible de Cognos 8.
• Titre
Procédure d'installation dans un nouveau répertoire

1. À l'aide des outils de bases de données, copiez votre base de données Content Store existante
dans une nouvelle base de données Content Store.
• crnlocale.xml dans le répertoire emplacement_crn/configuration
• server.xml dans le répertoire emplacement_crn/tomcat4.1.27/conf
• Dans Cognos Configuration, exportez les données de configuration dans ce même réper-
toire sécurisé.
Pour que le processus de mise à niveau puisse utiliser les données, nommez le fichier crns-
tartup.xml.
Important : Veillez à ce que l'emplacement soit sécurisé car le fichier crnstartup.xml
exporté contient des mots de passe non chiffrés.

• Dans un emplacement sécurisé, effectuez une copie de sauvegarde des fichiers modifiés
manuellement dans le répertoire emplacement_crn/configuration ou dans d'autres réper-
toires.
3. Installez Cognos 8 dans un nouveau répertoire (p. 57).
4. Copiez les fichiers .xml situés dans l'emplacement de sauvegarde sécurisé vers le répertoire
suivant :
• Copiez les fichiers crnstartup.xml et crnlocale.xml dans le répertoire
• Copiez le fichier system.xml dans le nouvel emplacement, dans le même répertoire qu'il
occupait dans ReportNet, le cas échéant.
Par exemple :
5. Pour les fichiers modifiés manuellement dans ReportNet, modifiez ces mêmes fichiers dans le
répertoire emplacement_c8 et appliquez à nouveau les modifications apportées aux fichiers
personnalisés d'origine.
6. Configurez les nouveaux alias de serveur Web (p. 81).
7. Dans Cognos Configuration, configurez Cognos 8 de façon à pointer vers la nouvelle base de
données Content Store, configurez les nouveaux ports et les nouvelles adresses URL, utilisez
un autre chemin d'accès aux paramètres de témoin (cookie), puis enregistrez la configuration
(p. 53).
Afin d'éviter tout conflit, assurez-vous que les numéros de port et le nom du service associés à
Cognos 8 sont différents de ceux utilisés par ReportNet.
Vérifiez que les paramètres d'authentification de sécurité sont inchangés. Par exemple, les
espaces-noms doivent être les mêmes pour que les stratégies, les utilisateurs, les rôles et les
groupes fonctionnent correctement.
de Cognos 8.
Cognos 8 met automatiquement à niveau la nouvelle base de données Content Store. Les
fichiers system.xml sont mis à niveau, le cas échéant, vers une version compatible de Cognos
8.
11. Ouvrez le portail d'administration dans Cognos 8 et annulez l'inscription des distributeurs
utilisés avec ReportNet.
Lorsque vous ouvrez le portail d'administration dans Cognos 8, celui-ci affiche les distribu-
teurs inscrits pour les deux versions.
48
• Titre
14. Lorsque vous êtes prêt à désinstaller ReportNet, procédez comme suit :
• Arrêtez ReportNet.
• Désinstallez ReportNet de tous les ordinateurs ReportNet.
Pour en savoir davantage, reportez-vous aux instructions de l'ancienne version de Repor-
tNet.
Lorsque vous effectuez les tâches de mise à niveau, Cognos 8 est intégralement configuré, à
l'exception des nouvelles fonctionnalités, des nouvelles propriétés et des fonctions liées aux
tableaux de bord.
Si vous utilisez des caractères chinois, japonais ou coréen, il est possible que vous constatiez quel-
ques différences au niveau des caractères une fois la mise à niveau vers Cognos 8 effectuée. Pour
en savoir davantage, reportez-vous au Guide de dépannage.
Si vous utilisez une base de données DB2 comme Content Store, vous pouvez mettre au point la
base de données afin de tirer profit des fonctions de DB2. Pour en savoir davantage, reportez-vous
au manuel Architecture and Planning Guide.
Mise à niveau à l'aide de l'option de configuration silencieuse

Vous pouvez exécuter une configuration silencieuse pour mettre à niveau la configuration de
ReportNet vers Cognos 8 Avant de démarrer la configuration silencieuse, vérifiez la configuration
de l'option de mise à niveau des spécifications de rapports. Si vous avez installé Cognos 8 dans un
nouveau répertoire, vous devez également modifier les paramètres des ports et les alias de serveurs
Web.
Si vous souhaitez mettre à niveau la configuration en mode silencieux, suivez la procédure de la
section précédente et arrêtez-vous à l'étape de la configuration de Cognos 8 :
• Dans la procédure d'installation dans le même répertoire, arrêtez-vous à l'étape 11.
• Dans la procédure d'installation dans un nouveau répertoire, arrêtez-vous à l'étape 7.
Lorsque vous atteignez cette étape, ne démarrez pas Cognos Configuration. Au lieu de cela, procé-
dez comme suit et retournez à la procédure de la section précédente.
• Modifiez le fichier crnstartup.xml situé dans le répertoire emplacement_crn/configuration ou
emplacement_c8/configuration et recherchez les lignes suivantes :
<crn:parameter
name="doReportSpecUpgrade">
<crn:value xsi:type="xsd:boolean">false</crn:value>
</crn:parameter>
• Définissez la valeur de la mise à niveau de la spécification de rapport :
• Pour ne pas effectuer la mise à niveau des spécifications de rapports, conservez la valeur
False.
• Pour mettre à niveau les spécifications de rapports, remplacez la valeur par True.
• Modifiez les autres paramètres selon les besoins.
Si vous avez installé Cognos 8 dans un nouveau répertoire, reportez-vous à la section
« Exécution simultanée de ReportNet et de Cognos 8 » (p. 53) pour connaître les paramètres
à modifier.
• Saisissez la commande de configuration :
• Sous UNIX ou Linux, saisissez

./cogconfig.sh -s
• Sous Windows, saisissez
cogconfig.bat -s
Mise à niveau de Metrics Manager vers Cognos 8

Vous devez installer Metrics Manager et le mettre à niveau vers Cognos 8 dans un répertoire diffé-
rent de celui contenant sa version antérieure. Vous pouvez conserver Metrics Manager actif
jusqu'à ce que Cognos 8 fonctionne de façon appropriée.
Si ReportNet et Metrics Manager sont installés sur le même ordinateur et que vous prévoyez
d'effectuer une mise à niveau vers Cognos 8, mettez d'abord à niveau ReportNet, puis Metrics
Manager.
Cognos 8 et les versions antérieures de Metrics Manager utilisent des modèles de sécurité diffé-
rents. Si vous souhaitez mettre à niveau les informations de sécurité d'une version précédente de
Metrics Manager, vous devez suivre une autre procédure de mise à niveau. Pour en savoir davan-
tage, reportez-vous à la section « Mise à niveau de Metrics Manager et des informations de
sécurité » (p. 50).
Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous mettez à niveau
Metrics Manager et que vous ne souhaitez pas utiliser Tomcat, vous devez suivre une autre procé-
dure de mise à niveau. Pour en savoir davantage, reportez-vous à la section « Mise à niveau de
Metrics Manager vers Cognos 8 dans un environnement de serveur d'application » (p. 203).
Procédure
1. Exportez le contenu de la bibliothèque de données que vous souhaitez utiliser avec 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 Cognos 8 :
• Si vous mettez à niveau uniquement Metrics Manager, installez Cognos 8 dans un réper-
toire différent de celui de l'ancienne version de Metrics Manager (p. 57).
• Si ReportNet est installé sur le même ordinateur que Metrics Manager, suivez la procé-
dure de mise à niveau de ReportNet vers Cognos 8 (p. 45).
3. Configurez l'environnement (p. 71).
Si vous avez exporté le contenu d'une ou plusieurs bibliothèques de données à l'étape 1, créez
une bibliothèque d'indicateurs (p. 71) pour chaque bibliothèque de données. Pour chaque
bibliothèque d'indicateurs, configurez le client de base de données (p. 78) et les variables
d'environnement sous UNIX (p. 79).
4. Créez un pack d'indicateurs (p. 93).
5. Si vous avez exporté du contenu des bibliothèques de données à l'étape 1, importez le contenu
de toutes ces bibliothèques de données dans une autre bibliothèque d'indicateurs.
Pour en savoir davantage sur l'importation de données, reportez-vous au Guide de l'utilisa-
teur de Metric Studio pour les auteurs.
6. Installez (p. 66) et configurez (p. 112) Metric Designer sous Windows.
7. Effectuez la mise à niveau des projets et extraits de Metric Designer de façon appropriée
(p. 113).
8. Lorsque vous êtes prêt, arrêtez l'ancienne version de Metrics Manager et désinstallez-la
comme indiqué dans la documentation fournie.
Pour garantir la sécurité et l'intégrité de Cognos 8, protégez le répertoire d'installation contre tout
accès non autorisé ou inapproprié.
Mise à niveau de Metrics Manager et des informations de sécurité

Cognos 8 et les versions antérieures de Metrics Manager utilisent des modèles de sécurité diffé-
rents. Avant d'effectuer la mise à niveau vers Cognos 8, prenez connaissance des informations
relatives à la sécurité de Cognos 8 afin de vous assurer qu'elle correspond à vos besoins. Pour en
savoir davantage, reportez-vous au Guide d'administration et de sécurité.
50
Un utilitaire de mise à niveau est à votre disposition si le modèle de sécurité de Cognos 8 ne satis-
fait pas à vos besoins et que vous devez mettre à niveau les informations de sécurité. Utilisez cet
utilitaire pendant le processus de mise à niveau pour établir les correspondances entre les anciens
droits d'accès pour les tableaux de bord et les types d'indicateurs et les nouveaux droits d'accès
dans Cognos 8.
L'utilitaire de mise à niveau n'établit pas de correspondance pour les éventuels refus de droits
d'accès utilisés dans l'ancienne version de Metrics Manager. Par exemple, imaginons un utilisateur
appartenant à deux classes d'utilisateurs. Pour un même tableau de bord, l'une des classes d'utili-
sateurs dispose de droits en lecture tandis que l'autre classe est interdite d'accès. Après l'exécution
de l'utilitaire de mise à niveau, l'utilisateur disposera uniquement de l'accès en lecture au tableau
de bord.
L'utilitaire de mise à niveau établit les correspondances des informations de sécurité pour une
bibliothèque de données qui utilise ces informations dans un fichier de contrôle créé par vous. Ce
fichier est au format texte. Si vous envisagez de mettre à niveau le contenu de plusieurs bibliothè-
ques de données, vous devez créer un fichier de contrôle pour chacune d'entre-elles et exécuter
l'utilitaire de mise à niveau sur chaque fichier de contrôle.
Le tableau ci-dessous décrit les propriétés qui doivent être définies dans le fichier de contrôle. Un
exemple de fichier de contrôle vous est fourni sous le tableau.
Propriété Description
scorecard_file Une liste, dont les éléments sont séparés 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
bibliothèque d'indicateurs de Cognos 8. Seuls les tableaux de bord
sont importés, les autres objets contenus dans ces fichiers sont
ignorés.
policy_file Une liste, dont les éléments sont séparés par une virgule, des fichiers
source object_link_stage (.cml) de l'ancienne version de Metrics
Manager qui contiennent les règles à mettre à niveau. Cette liste de
fichiers doit contenir tous les liens des règles que vous souhaitez
importer dans la bibliothèque d'indicateurs de Cognos 8. Seuls les
liens des règles sont importés, les autres objets contenus dans ces
fichiers sont ignorés.
input_file_encoding Jeu de caractères des fichiers en entrée.

Cette propriété est facultative. Par défaut, le jeu de caractères
implicite de la plate-forme est utilisé.
flat_file_version Version du fichier plat de l'ancienne version de Metrics Manager. La

valeur peut être égale à 2.0 ou 2.2.
Cette propriété est facultative. La valeur implicite est 2.2.
output_file Nom du fichier dans lequel les règles créées dans Cognos 8 seront
écrites.
Cette propriété est facultative. Le nom implicite du fichier en sortie
est policies.cms.
output_file_encoding Jeu de caractères souhaité pour le fichier en sortie.

Cette propriété est facultative. Par défaut, le jeu de caractères
implicite de la plate-forme est utilisé.

Propriété Description
read_mapping Une liste, dont les éléments sont séparés par une virgule, des
autorisations Cognos 8 à attribuer pour les droits en lecture définis
dans l'ancienne version de Metrics Manager.
L'un des suffixes suivants peut être ajouté afin de préciser les
autorisations pour un type d'objet spécifique : metric ou .scorecard.
write_mapping Une liste, dont les éléments sont séparés par une virgule, des
autorisations Cognos 8 à attribuer pour les droits en écriture définis
dans l'ancienne version de Metrics Manager.
administrator_mapping Une liste, dont les éléments sont séparés par une virgule, des
autorisations Cognos 8 à attribuer pour les droits en administration
définis dans l'ancienne version de Metrics Manager.
Ces autorisations incluent :
• Lecture
• Write
• Setpolicy
• Readannotations
• Annotate
• Writeproject
• Writeactual
• Writetarget
• Writetolerance
• Writeudc
Exemple
Observez l'exemple de fichier de contrôle 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
Procédure
1. Exportez le contenu de la bibliothèque de données 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.
• Si vous mettez à niveau uniquement Metrics Manager, installez Cognos 8 dans un réper-
toire différent de celui de l'ancienne version de Metrics Manager (p. 57).
• Si ReportNet est installé sur le même ordinateur que Metrics Manager, suivez la procé-
dure de mise à niveau de ReportNet vers Cognos 8 (p. 45).
3. Configurez l'environnement (p. 71).
52
Assurez-vous que vous créez une bibliothèque d'indicateurs (p. 71) et que vous configurez le
client de base de données de la bibliothèque d'indicateurs (p. 78) et les variables d'environne-
ment sous UNIX (p. 79).
Assurez-vous également que l'espace-noms Series 7 est configuré et accessible dans l'environ-
nement Cognos 8.
4. Créez un fichier de contrôle pour référencer les fichiers object stage (.cmo), qui contiennent la
définition des tableaux de bord, ainsi que les fichiers object link stage (.cml), qui contiennent
la définition des autorisations générées à l'étape 1.
Le fichier de contrôle est au format texte. Consultez le tableau et l'exemple ci-dessus pour
faciliter la création de votre fichier de contrôle.
5. Modifiez le répertoire en emplacement_c8\bin et saisissez la commande suivante dans l'invite
de commande :
cmm_migrate_policies nom_fichier_contrôle
6. Créez un pack d'indicateurs (p. 93).
7. Importez dans la bibliothèque d'indicateurs la bibliothèque de données que vous avez expor-
tée lors de l'étape 1.
Vous n'avez pas besoin d'importer les fichiers object link stage (.cml) contenant la définition
des autorisations. Dans l'exemple ci-dessus, le fichier contenant la définition 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 défini à 8.1.2MR2.
9. Installez (p. 66) et configurez (p. 112) Metric Designer sous Windows.
10. Effectuez la mise à niveau des projets et extraits de Metric Designer de façon appropriée
(p. 113).
11. Lorsque vous êtes prêt, arrêtez l'ancienne version de Metrics Manager et désinstallez-la
comme indiqué dans la documentation fournie.
Pour garantir la sécurité et l'intégrité de Cognos 8, protégez le répertoire d'installation contre tout
accès non autorisé ou inapproprié.
Mise à niveau de calendriers personnalisés Metrics Manager

Si vous souhaitez mettre à niveau un calendrier Metrics Manager 2.2 utilisant des dates de début
et de fin de période personnalisées, vous devez créer un calendrier standard dans Cognos 8 qui
reflète le mieux possible votre calendrier personnalisé. Vous devez ensuite exporter ce calendrier
standard et modifier les fichiers d'importation de périodes (.cal), d'importation de niveaux
temporels (.lvl) et de noms localisés de période (.tlt) de façon à ce que le calendrier soit identique
au calendrier Metrics Manager 2.2.
Exécution simultanée de ReportNet et de Cognos 8

Pour exécuter Cognos 8 et la version antérieure de ReportNet en même temps et sur le même ordi-
nateur, vous devez modifier les ports et l'alias du serveur Web.
D'autres modifications de la configuration peuvent se révéler nécessaires en fonction de votre envi-
ronnement. Si vous utilisez Portal Services, vous devez indiquer l'emplacement du fichier applica-
tions.xml. Si vous utilisez une passerelle ISAPI sur un serveur Web IIS 6.0, vous devez isoler la
passerelle Cognos 8 pour empêcher tout conflit avec la passerelle ReportNet. Isolez la passerelle
en paramétrant à Élevée la protection de l'application pour les sites Web et les répertoires virtuels.
Procédure
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
3. Dans la section Paramètres du distributeur de la fenêtre Propriétés, cliquez sur la valeur cor-
respondant à l'URI interne du distributeur :

4. Sélectionnez le numéro de port et saisissez le nouveau numéro de port.

5. Le cas échéant, modifiez le numéro de port des URI ci-dessous, de manière à ce qu'ils corres-
pondent au nouveau numéro de port que vous avez indiqué pour la propriété URI interne du
distributeur.
• Dans la section Paramètres du distributeur, modifiez le port associé à la propriété URI
externe du distributeur.
• Dans la section Autres paramètres de l'URI, modifiez le port associé aux propriétés URI
du distributeur pour des applications externes et URI de Content Manager.
La propriété URI de Content Manager ne s'affiche pas sur un ordinateur passerelle.
6. Dans la section Paramètres de la passerelle, cliquez sur la valeur correspondant à la propriété
URI de la passerelle et vérifiez que l'URI contient l'alias de serveur Web adapté à Cognos 8.
Par exemple, remplacez crn par cognos8.
7. Si vous utilisez Portal Service, mettez à jour le fichier applications.xml.
• Dans la fenêtre Explorateur, cliquez sur les options Environnement puis Portal Services.
• Dans la fenêtre Propriétés, vérifiez que le numéro de port associé à la propriété Emplace-
ment du fichier 'applications.xml' correspond à celui des propriétés des autres URI.
8. Dans la fenêtre Explorateur, cliquez sur Accès aux données, sur Content Manager, puis sur
Content Store.
9. Dans la fenêtre Propriétés, configurez Cognos 8 de façon à utiliser la nouvelle base de données
Content Store :
• Pour la propriété Nom de la base de données, indiquez le nom de la nouvelle base de don-
nées Content Store.
• Pour la propriété Code d'utilisateur et mot de passe, cliquez sur le bouton d'édition et
indiquez le code d'utilisateur et le mot de passe permettant d'accéder à la nouvelle base de
données Content Store.
10. Modifiez le chemin d'accès aux paramètres de témoin (cookie) :
• Dans le menu Opérations, cliquez sur l'option Modifier la configuration globale.
• Dans la fenêtre Configuration globale, cliquez sur l'option Paramètres de témoin (cookie).
• Sélectionnez un chemin d'accès différent de celui utilisé par ReportNet.
• Cliquez sur OK.
11. Enregistrez la configuration et démarrez Cognos 8.
12. Si vous utilisez une passerelle ISAPI sur un serveur Web IIS 6.0, modifiez les paramètres de
protection de l'application :
• Dans IIS Manager, cliquez avec le bouton droit de la souris sur le site Web par défaut et
cliquez sur Properties.
• Cliquez sur l'onglet Home Directory.
• Dans la zone Application Protection, cliquez sur High, puis sur OK.
• Répétez les trois étapes de la procédure ci-dessus pour chaque répertoire virtuel de
Cognos 8, en cliquant sur l'onglet Virtual Directory au lieu de l'onglet Home Directory.
Lors de la prochaine requête de la passerelle de Cognos 8, celle-ci exécutera un espace
mémoire distinct.
Vous pouvez à présent exécuter ReportNet et Cognos 8 simultanément.
Remarque : Lorsque vous modifiez des ports implicites sous Windows, le numéro de port est auto-
matiquement ajouté au nom du service. Le nom du service dans Cognos Configuration n'indique
pas le numéro de port. Le nom du service et le numéro de port sont affichés dans la section Servi-
ces, dans les outils d'administration de Windows.
Mise à niveau des documents Cognos Office Connection

Pour mettre à niveau des documents Cognos Office Connection, vous devez avoir recours à un uti-
litaire de ligne de commande. Cet utilitaire permet de modifier des documents en y ajoutant de
nouvelles propriétés personnalisées, en modifiant leurs propriétés existantes ou en supprimant les
propriétés qui ne sont plus requises.
54
Pour pouvoir faire appel à cet utilitaire, vous devez d'abord définir les valeurs à modifier dans un
fichier de configuration, puis exécuter l'utilitaire.
Dans la version Cognos 8 de Cognos Office Connection, certaines propriétés personnalisées ont
changé. Pensez à vérifier les propriétés personnalisées décrites à la section « Configuration de
Cognos Office Connection » (p. 143) avant d'exécuter l'utilitaire de mise à niveau.
L'utilitaire peut mettre à jour des documents contenus dans un répertoire ou dans la base de don-
Il est recommandé d'effectuer une copie de sauvegarde des fichiers avant de procéder à leur mise à
niveau.
Procédure
1. Modifiez le fichier changespec.xml se trouvant dans le répertoire emplacement_c8\webcon-
tent\coc avec les valeurs suivantes :
Valeur Description
searchPath Emplacement des documents à mettre à jour. Vous pouvez utiliser
un chemin d'accès, tel que C:\MyDocuments or
\\servername\documents. Si les documents sont publiés dans
Cognos Connection, utilisez la passerelle de Cognos 8. Par
exemple, http://servername/cognos8/cgi-bin/cognos.cgi.
Si vous utilisez un chemin d'accès et que certains documents se
trouvent dans des sous-répertoires, définissez la propriété
includeSubDirs sur true pour que ces documents soient
également mis à jour.
applicationTypes Type des fichiers à mettre à jour.

Les deux valeurs possibles sont EXCEL et POWERPOINT.
operation Indique l'opération à effectuer pour la propriété indiquée.

Les trois valeurs possibles sont add, change et remove.
name Nom de la propriété à mettre à jour.
value Valeur du nom à mettre à jour.
newName Nouveau nom, dans le cas d'un changement de nom de la propriété.

Par exemple, la propriété CCSLocation n'est plus utilisée dans la
version Cognos 8 de Cognos Office Connection. Vous pouvez
remplacer le nom CCSLocation par CognosGateway : effectuez une
opération de modification, définissez CCSLocation comme name et
CognosGateway comme newName.
newValue Nouvelle valeur, dans le cas d'un changement de valeur de la

propriété.
Par exemple, pour ajouter une propriété pour CognosGateway, vous devez inclure une ligne
telle que :
<action operation="add" name="CognosGateway" value="http://server/path"/>
Pour remplacer la propriété CCSLocation utilisée dans la version précédente de Cognos
Office Connection par la propriété CognosGateway associée à la version Cognos 8, utilisez
une ligne telle que :
<action operation="change" name="CCSLocation" value="http://oldserver/path"
newName="CognosGateway" newValue="http://newserver/path" />
D'autres exemples sont fournis dans le fichier changespec.xml. Veillez à associer un commen-
taire aux lignes n'étant plus requises ou à les supprimer avant d'exécuter l'utilitaire de mise à
niveau.

2. Enregistrez le fichier.
Si vous avez d'autres documents à mettre à jour, vous souhaitez sûrement conserver le fichier
changespec.xml d'origine. Pour ce faire, enregistrez-le sous un autre nom.
3. Dans une ligne de commande, accédez au répertoire emplacement_c8\webcontent\coc et exé-
cutez la commande suivante :
COCUpdater /f=changespec.xml [/u=nom_utilisateur] [/p=mot_de_passe] [/n=espace_noms]
Les valeurs nom_utilisateur, mot_de_passe et espace_noms sont utilisées si vous mettez à
niveau des documents Cognos Office Connection stockés dans la base de données
Content Store. Si vos documents se trouvent dans un répertoire, ces valeurs ne sont pas néces-
saires.
Pour afficher l'aide relative à l'utilitaire, sur la ligne de commande, saisissez :
COCUpdater
56
Chapitre 5 : Installation de Cognos 8
Pour installer plusieurs composants de Cognos 8 sur un même ordinateur, nous vous conseillons
de les installer au même endroit, afin d'éviter tout conflit entre ports ou autres paramètres implici-
tes.
Si vous installez Cognos 8 dans un environnement de serveur d'application, vous devez connaître
les conditions requises pour d'installation. Pour en savoir davantage, reportez--vous à la section
« Changement de serveur d'application » (p. 191).
Si vous effectuez une mise à niveau à partir d'une version précédente des produits de Cognos, vous
devez respecter la procédure de mise à niveau. Pour en savoir davantage sur la mise à niveau à par-
tir de ReportNet ou de Metrics Manager, reportez-vous à la section « Mise à niveau vers
Cognos 8 » (p. 37).
Utilisez la liste de contrôle suivante pour vous aider à effectuer les tâches d'installation :
❑ Vérification du fait que l'ordinateur présente les configurations matérielles et logicielles requi-
ses
❑ Configuration de la connectivité à la base de données de création de rapports
❑ Configuration de la connectivité à la base de données Content Store
❑ Configuration de la connectivité à la base de données de la bibliothèque d'indicateurs
❑ Étude des environnements pris en charge
❑ Installation des composants du serveur
❑ Installation de Framework Manager
❑ Installation de Metric Designer
Après avoir installé Cognos 8, vous devez configurer votre environnement.
Ce chapitre comprend également des informations sur la désinstallation de Cognos 8. Pour en
savoir davantage, reportez-vous à la section « Désinstallation de Cognos 8 » (p. 68).
Vérification de la configuration système requise

Utilisez le tableau ci-dessous pour connaître les configurations matérielle et logicielle minimales
requises pour installer et exécuter les composants de Cognos 8 sur un ordinateur. D'autres res-
sources peuvent s'avérer nécessaires pour les environnements répartis ou les environnements de
production.
Configuration requise Spécifications

Système d'exploitation Windows
UNIX :
• Sun Solaris
• HP-UX
• IBM AIX
Red Hat Enterprise Linux sur x86 compatible Intel (certains
composants de Cognos 8 ne sont pas pris en charge sous Linux)
RAM Minimum : 2 Go


Spécifications pour le système Limite de descripteur de fichier fixée à 1024 sur Solaris
d'exploitation (recommandé)
Espace disque Minimum : 2.5 Go d'espace libre pour installer le logiciel et

1 Go sur le lecteur contenant le répertoire temporaire utilisé par
les composants de Cognos.
Pour Metric Studio, la taille de la bibliothèque d'indicateurs
s'accroît au fil du temps. Prévoyez suffisamment d'espace
disque pour la suite.
Serveur Web Serveur Web installé et démarré
JRE Java Runtime Environment (JRE)

JRE est automatiquement installé avec Cognos 8 sous
Windows.
Si vous utilisez un serveur d'application, utilisez le module JRE
qui y est installé.
Base de données Une des bases de données suivantes doit être disponible pour
stocker des données Cognos :
• Oracle
• DB2
• Microsoft SQL Server
Connectivité TCP/IP à Microsoft SQL Server
• Sybase
Pour Metric Studio, les bases de données suivantes sont prises
en charge par la bibliothèque d'indicateurs :
• Oracle
• DB2
Connectivité TCP/IP à Microsoft SQL Server
Navigateur Web Pour tous les navigateurs Web, les éléments suivants doivent
être activés :
• Témoins (cookies)
• JavaScript
Pour Microsoft Internet Explorer uniquement, les fonctions
suivantes doivent être activées :
• Exécuter les contrôles ActiveX et les plug-ins
• Contrôles ActiveX reconnus sûrs pour l'écriture de scripts
• Active Scripting
• META REFRESH autorisé
Autre Pour qu'un émulateur de terminal installe Cognos 8 sous UNIX,

émulation définie 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.
58

SAP BW Les composants frontaux SAP suivants, installés sur chaque
serveur Cognos 8 :
• Interface utilisateur graphique SAP 6.20
• Compléments BW
Configuration de la connectivité à la base de données de

création de rapports
Pour Cognos 8, le seul service qui accède à la base de données de requête (également appelée base
de données d'exécution de rapports) est le moteur exécutant les rapports.
Pour configurer la connectivité à la base de données de création de rapports, procédez comme
suit :
• Veillez à installer le logiciel API de base de données pour les sources d'exécution de rapports
sur chaque serveur Cognos 8.
Sous Windows, le serveur de rapports prend en charge la connectivité à la base de données
native ou ODBC. Sous UNIX et Linux, le serveur de rapports prend en charge la connectivité
à la base de données native.
Sous UNIX, pour Microsoft SQL Server uniquement, le serveur de rapports prend en charge le
pilote Data Direct ODBC. Ce pilote est disponible auprès de Data Direct.
Cognos 8 nécessite une connectivité TCP/IP avec Microsoft SQL Server.
Configuration de la connectivité à la base de données Content

Store
Le logiciel client de base de données doit être installé et configuré sur chaque ordinateur sur lequel
vous avez installé Content Manager.
Pour configurer la connectivité à la base de données Content Store, procédez comme suit :
• Installez le pilote JDBC correspondant à votre base de données Content Manager, comme
indiqué ci-dessous :
Base de données Pilote JDBC

Oracle Pilote JDBC Thin, classes12.jar
DB2 Pilote JDBC nécessitant l'installation du

client DB2
Microsoft SQL Fourni avec les composants de Cognos et

Server aucun autre logiciel n'est requis.
Cognos 8 nécessite une connectivité TCP/IP
avec Microsoft SQL Server.
Sybase Pilote JDBC, jconn2.jar

Configuration de la connectivité à la base de données de la

bibliothèque d'indicateurs
Pour Metric Studio, les composants d'application doivent être en mesure d'accéder à la bibliothè-
que d'indicateurs. Le logiciel client de base de données pour la bibliothèque d'indicateurs doit être
installé et configuré sur chaque ordinateur sur lequel les composants d'application sont installés.
Pour configurer la connectivité à la base de données de la bibliothèque d'indicateurs, procédez
comme suit :
• Installez le pilote JDBC approprié.
Base de données Pilote JDBC

Oracle Pilote JDBC OCI
DB2 Pilote JDBC nécessitant l'installation du

client DB2
Microsoft SQL Fourni avec les composants de Cognos et

Server aucun autre logiciel n'est requis.
Cognos 8 nécessite une connectivité TCP/IP
avec Microsoft SQL Server.
Étude des environnements pris en charge

Afin de garantir le bon fonctionnement de vos produits, veillez à appliquer tous les programmes
de correction requis au système d'exploitation et à n'utiliser que les versions de logiciel tiers prises
en charge par le produit de Cognos.
Pour consulter une liste à jour des environnements pris en charge par les produits de Cognos, tels
que les systèmes d'exploitation, les programmes de correction, les navigateurs, les serveurs Web,
les serveurs d'annuaire, les serveurs de bases de données et les serveurs d'application :
• Visitez le site Web du support technique de Cognos (http://support.cognos.com).
Il est important de noter que le système d'exploitation Linux est disponible dans plusieurs ver-
sions et prend en charge plusieurs plates-formes. Assurez-vous que le système d'exploitation et
la combinaison de matériel que vous utilisez sont pris en charge.
Lorsque vous installez Cognos 8 sous Linux, Framework Manager n'est pas installé. BMTS-
criptPlayer est un utilitaire de ligne de commande qui offre une interface avec le moteur Fra-
mework Manager, permettant d'exécuter les journaux d'opération de Framework Manager.
Le fichier BMTScriptPlayer ne peut pas être exécuté car Framework Manager n'est pas ins-
tallé.
Installation des composants du serveur

Utilisez l'Assistant d'installation pour sélectionner les composants du serveur que vous souhaitez
installer, ainsi que l'emplacement de votre ordinateur approprié pour l'installation. Seuls les com-
posants que vous décidez d'installer sont copiés du CD sur l'ordinateur. Vous pouvez installer les
composants de la passerelle, des composants d'application et de Content Manager sur plusieurs
ordinateurs.
Sous UNIX, vous pouvez installer les composants du serveur à l'aide soit d'une interface en texte
intégral, soit d'une interface graphique utilisateur. Pour une installation en mode graphique, la
console connectée à votre ordinateur UNIX doit prendre en charge les interfaces graphiques utili-
sateur de type Java.
60
Sous UNIX, Cognos 8 respecte le masque de création de mode fichier (umask) du compte exécu-
tant le programme d'installation. Cela n'a une incidence que sur les répertoires d'installation, et
non sur les droits d'accès aux fichiers à l'intérieur de ces répertoires. Toutefois, les fichiers créés en
cours d'exécution, tels que les journaux, respectent le masque. Nous recommandons umask 022
pour le répertoire d'installation.
Sous Windows, assurez-vous que vous disposez de droits d'administration sur l'ordinateur Win-
dows où vous souhaitez faire l'installation. Assurez-vous également que l'ordinateur dispose d'une
variable système TEMP pointant vers le répertoire où vous voulez stocker les fichiers temporaires.
Durant l'installation, les fichiers du CD sont copiés temporairement dans ce répertoire.
Important : Pour une reprise correcte entre les ordinateurs Content Manager, assurez-vous que
leurs horloges système sont synchronisées.
Pour en savoir davantage sur l'installation de Framework Manager, reportez-vous à la section
« Installation de Framework Manager » (p. 64).
Pour en savoir davantage sur l'installation de Metric Designer, reportez-vous à la section
« Installation de Metric Designer » (p. 66).
Procédure pour UNIX et Linux

1. Si vous procédez à l'installation dans un répertoire contenant d'autres composants de Cognos
8, arrêtez le service Cognos 8.
2. Définissez la variable d'environnement JAVA_HOME de façon à ce qu'elle pointe vers
l'emplacement d'installation de Java Runtime Environment (JRE).
Voici un exemple d'emplacement d'installation de Java Runtime Environment : /direc-
tory/java/version_java/jre.
Cognos 8 nécessite que Sun Java soit exécuté sous Linux.
3. Sous HP-UX, définissez la variable d'environnement _M_ARENA_OPTS comme suit :
_M_ARENA_OPTS 1:4
Cette opération augmente l'allocation de mémoire pour HP-UX afin qu'elle corresponde
mieux à celle des autres plates-formes UNIX.
4. Montez le CD de votre produit Cognos avec les extensions de fichier Rock Ridge.
Important : Pour monter le CD de Cognos sous HP-UX, procédez comme suit :
• Ajoutez le répertoire pfs_mount dans le chemin d'accès.
Par exemple :
PATH=/usr/sbin/:$PATH
export PATH
• Pour démarrer les démons NFS requis et les exécuter en arrière-plan, saisissez bg
pfs_mountd, puis bg pfsd.
• Pour monter le lecteur, saisissez :
pfs_mount -t rrip <périphérique><rép_mont> -o xlat=unix
Par exemple :
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Vous pouvez à présent procéder à l'installation ou copier des fichiers en tant qu'utilisateur
non-racine, en insérant un CD de Cognos dans ce lecteur.
• Une fois l'installation terminée, saisissez pfs_umount /cdrom et arrêtez les démons pfsd et
pfs_mountd pour démonter le CD.
5. Accédez au répertoire du CD-ROM correspondant à votre système d'exploitation.
Pour Solaris, par exemple, accédez au répertoire solaris.
6. Démarrer l'assistant d'installation ?
• Si vous utilisez X Windows, saisissez :
./issetup
• Si vous n'utilisez pas X Windows, saisissez :
./issetupcc

7. Suivez les instructions de l'Assistant d'installation et copiez les fichiers requis sur votre ordina-
teur.
Installez Cognos 8 dans un répertoire dont le nom du chemin d'accès contient uniquement des
caractères ASCII. Certains serveurs Web UNIX et Linux ne prennent pas en charge les caractè-
res non-ASCII dans les noms de répertoires.
Si vous installez Cognos 8 sur un ordinateur sur lequel est installé ReportNet tout en conser-
vant ce dernier, vous devez installer Cognos 8 dans un répertoire différent.
Si vous l'installez dans un répertoire contenant déjà d'autres composants de Cognos 8, le sys-
tème vous demande de préciser l'emplacement d'un répertoire dans lequel seront stockées les
copies de sauvegarde des fichiers remplacés.
8. Sélectionnez la façon dont vous souhaitez poursuivre la procédure dans la page Terminer de
l'Assistant d'installation :
• Il est déconseillé de configurer Cognos 8 immédiatement, car il convient d'abord d'effec-
tuer d'autres tâches pour s'assurer que l'environnement est correctement configuré. Tou-
tefois, si la console connectée à l'ordinateur prend en charge les interfaces graphiques
utilisateur de type Java, vous pouvez cliquer sur l'option Démarrer Cognos Configuration
• Si vous voulez prendre connaissance des informations les plus récentes sur Cognos 8,
sélectionnez Afficher le fichier Lisezmoi, puis cliquez sur le bouton Terminer.
Conseil : En cas d'installation en mode texte intégral sous UNIX et Linux, fermez le
fichier texte Lisezmoi en appuyant simultanément sur les touches [Ctrl] + [C] (ou q).
• Si la console connectée à l'ordinateur ne prend pas en charge les interfaces graphiques uti-
lisateur de type Java ou si vous souhaitez configurer Cognos 8 ultérieurement, cliquez sur
le bouton Terminer.
Vous pourrez configurer Cognos 8 ultérieurement à l'aide de Cognos Configuration, en
lançant la commande cogconfig.sh dans le répertoire emplacement_c8/bin ou en modi-
fiant le fichier cogstartup.xml dans le répertoire emplacement_c8/configuration.
9. Ajoutez le répertoire emplacement_c8/bin à la variable d'environnement de chemin d'accès à
la bibliothèque appropriée :
• Pour Solaris et Linux, LD_LIBRARY_PATH
• Pour AIX, LIBPATH
• Pour HP-UX, SHLIB_PATH
10. Sous Linux, attribuez le nom de votre imprimante à la variable d'environnement PRINTER
Si vous utilisez Oracle, DB2 ou Sybase, vous pouvez à présent configurer le client de base de don-
nées pour la base de données Content Store et pour la bibliothèque d'indicateurs (p. 78).
Vous devez également mettre à jour votre structure de sécurité Java (p. 81) avant de configurer
Cognos 8. Sinon, vous risquez de voir s'afficher le message d'erreur suivant :
[Cryptography]
1. [ ERROR ] java.lang.NoClassDefFoundError:
javax/net/ServerSocketFactory:
Procédure pour Windows

2. Insérez le CD de votre produit Cognos.
La page Bienvenue de l'Assistant d'installation doit s'afficher.
Si la page Bienvenue ne s'affiche pas, dans le répertoire win32 du CD, cliquez deux fois sur le
fichier issetup.exe.
3. Sélectionnez la langue d'installation.
4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers nécessaires
sur votre ordinateur.
vant ce dernier actif, vous devez installer Cognos 8 dans un répertoire différent.
62
Si vous procédez à l'installation dans un répertoire contenant déjà d'autres composants de

Cognos 8, le système vous demande de préciser l'emplacement d'un répertoire dans lequel
seront stockées les copies de sauvegarde des fichiers remplacés.
5. Dans la page Terminer de l'Assistant d'installation, procédez comme suit :
• si vous souhaitez configurer les composants de Cognos immédiatement, cliquez sur
l'option Démarrer Cognos Configuration,
• Si vous voulez prendre connaissance des informations les plus récentes sur les composants
de Cognos, cliquez sur l'option Afficher le fichier Lisezmoi.
6. Cliquez sur Terminer.
Utilisez le menu Démarrer de Windows pour démarrer Cognos Configuration depuis le dos-
sier des raccourcis.
Si vous utilisez Oracle, DB2 ou Sybase, vous pouvez à présent configurer le client de base de don-
nées pour la base de données Content Store et pour la bibliothèque d'indicateurs (p. 78).
Paramètres implicites de Cognos 8

Le tableau ci-dessous répertorie les ports et les paramètres d'URI implicites de Cognos 8. Après
installation, vous pouvez utiliser l'outil de configuration pour modifier ces paramètres (p. 115).
Vous pouvez également les modifier en éditant le fichier cogstartup.xml situé dans le répertoire
emplacement_c8\configuration.
Paramètre Implicite Description

URI de Content Manager http://localhost:9300/p2pd/ Indique l'URI de Content
servlet Manager.
URI de la passerelle http://localhost:80/cognos8/ Indique l'URI de la passerelle.

cgi-bin/cognos.cgi
URI du distributeur http://localhost:9300/p2pd/ Indique l'URI du distributeur.

servlet/dispatch
(Interne, externe)
URI du distributeur des http://localhost:9300/p2pd/ Indique l'URI du distributeur.

applications externes servlet/dispatch
URI du distributeur pour la http://localhost:9300/p2pd/ URI du distributeur principal

passerelle servlet/dispatch/ext utilisé par la passerelle
Ports du serveur de 9362 Indique le port utilisé par le

journalisation serveur de journalisation
local.
Le tableau ci-dessous présente les paramètres implicites utilisés par Cognos 8 pour Tomcat. Les
connecteurs SSL et non-SSL sont automatiquement mis à jour dans le fichier server.xml lorsque
vous utilisez Cognos Configuration pour modifier le port du distributeur (p. 115) ou pour activer
le protocole SSL (p. 124). Cognos Configuration permet de directement mettre à jour le port à
désactiver.
Paramètre Port Description

Connecteur non SSL Coyote 9300 Port utilisé par Tomcat pour transmettre
HTTP/1.1 des demandes du serveur Web à Cognos 8
Connecteur SSL Coyote HTTP/1.1 9334 Port que Tomcat utilise pour écouter les
connexions sécurisées

Paramètre Port Description

Port des arrêts 9399 Port que Tomcat utilise pour écouter les
commandes d'arrêt
Installation de Framework Manager

Vous pouvez installer Framework Manager (l'outil de modélisation de métadonnées de Cognos 8
pour la création de rapports) sur le même ordinateur que celui sur lequel les composants de
Cognos 8 sont installés ou sur un autre ordinateur. Tous les fichiers requis sont copiés sur un
même ordinateur. Les paramètres implicites sélectionnés par Cognos sont utilisés pour la configu-
ration. Toutefois, vous pouvez les modifier si les conditions rendent les choix implicites inadéquats
ou si vous avez installé Cognos 8 sur un autre ordinateur.
Si vous effectuez une mise à niveau de Framework Manager à partir d'une version précédente,
vous devez d'abord désinstaller la version précédente de Framework Manager (p. 68).
Avant d'installer l'outil de modélisation, nous vous conseillons de fermer tous les programmes en
cours d'exécution pour vous 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 sou-
haitez faire l'installation. Si vous n'êtes pas administrateur, demandez à votre administrateur sys-
tème de vous ajouter au groupe Administrateurs sur votre ordinateur.
Nous vous conseillons d'installer et de configurer tous les composants du serveur Cognos 8 avant
d'installer l'outil de modélisation.
Si vous installez l'outil de modélisation dans le même répertoire que Cognos 8 sans arrêter les ser-
vices Cognos 8, vous êtes invité à le faire pendant l'installation.
Configuration système requise pour Framework Manager

Avant d'installer Framework Manager, assurez-vous que l'ordinateur Windows présente les confi-
gurations matérielles et logicielles requises pour Cognos 8. La taille des modèles que vous créez a
une incidence sur la configuration matérielle requise. Des ressources supplémentaires peuvent être
requises, telles que de l'espace disque, en fonction de la taille des modèles.
Le tableau ci-dessous répertorie les configurations matérielle et logicielle minimales requises pour
exécuter Framework Manager.

Système d'exploitation Windows
RAM Minimum : 512 Mo

Recommandé : 1 Go
Espace disque Minimum : 500 Mo d'espace libre sur le lecteur contenant

le répertoire temporaire utilisé par Cognos 8
Base de données Logiciel client de base de données installé sur le même

ordinateur que Framework Manager (Oracle, DB2 ou
Sybase uniquement)
Connectivité aux bases de données
Autre Microsoft Data Access Component (MDAC), version 2.6 ou

ultérieure, à utiliser avec les exemples de produits.
64
Procédure
1. Si vous utilisez une base de données Oracle comme source de données pour vos rapports, défi-
nissez la variable d'environnement NLS_LANG en saisissant la commande suivante sur cha-
que ordinateur où Framework Manager et les composants d'application sont installés :
NLS_LANG = language_territory.character_set
Par exemple, NLS_LANG = JAPANESE_JAPAN.UTF8
La valeur de la variable détermine le comportement de Cognos 8 par rapport aux paramètres
régionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les données
numériques et les conventions de calendrier peuvent en effet s'adapter automatiquement à la
langue et aux paramètres régionaux.
Si les composants d'application sont installés sur un ordinateur UNIX, la variable
NLS_LANG doit être définie pour l'utilisateur qui est propriétaire du service Cognos 8 et qui
le démarre.
3. Insérez le CD de votre produit de modélisation de Cognos dans le lecteur.
4. Sélectionnez la langue d'installation.
vant ce dernier actif, vous devez installer Cognos 8 dans un répertoire différent.
Si vous procédez à l'installation dans un répertoire contenant déjà d'autres composants de
Cognos 8, le système vous demande de préciser l'emplacement d'un répertoire dans lequel
seront stockées les copies de sauvegarde des fichiers remplacés.
Si vous utilisez Oracle, DB2 ou Sybase comme serveur de base de données Content Store dans une
installation répartie, vous devez maintenant installer le logiciel client de base de données (p. 78)
sur l'ordinateur sur lequel vous avez installé Framework Manager.
Une fois que Framework Manager est installé sur votre ordinateur Windows, certaines tâches de
configuration peuvent être nécessaires pour lui permettre de fonctionner dans votre environne-
ment de création de rapports (p. 109).

Paramètres implicites pour Framework Manager

Le tableau ci-dessous présente les paramètres implicites des ports et URI de Cognos 8 utilisés par
Framework Manager. Après installation, vous pouvez utiliser l'outil de configuration pour modi-
fier ces éléments. Vous pouvez également les modifier en éditant le fichier cogstartup.xml situé
dans le répertoire emplacement_c8\configuration.
Composant Implicite Description

Passerelle http://localhost:80/cognos8/ Indique l'URI de la
cgi-bin/cognos.cgi passerelle Cognos 8.
URI du distributeur des http://localhost:9300/p2pd/ Indique l'URI du

applications externes servlet/dispatch distributeur.
Port du serveur de 9362 Indique le port utilisé par le

journalisation serveur de journalisation
local.
Installation de Metric Designer

Vous pouvez installer Metric Designer, l'outil de modélisation de métadonnées de Metric Studio,
sur le même ordinateur que celui sur lequel les composants de Cognos 8 sont installés ou sur un
autre ordinateur. Tous les fichiers requis sont copiés sur un même ordinateur. Les paramètres
implicites sélectionnés par Cognos sont utilisés pour la configuration. Toutefois, vous pouvez les
modifier si les conditions rendent les choix implicites inadéquats ou si vous avez installé Cognos 8
sur un autre ordinateur.
Avant d'installer l'outil de modélisation, nous vous conseillons de fermer tous les programmes en
cours d'exécution pour vous 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 sou-
haitez faire l'installation. Si vous n'êtes pas administrateur, demandez à votre administrateur sys-
tème de vous ajouter au groupe Administrateurs sur votre ordinateur.
Nous vous conseillons d'installer et de configurer tous les composants du serveur Cognos 8 avant
d'installer l'outil de modélisation.
Si vous installez l'outil de modélisation dans le même répertoire que Cognos 8 sans arrêter les ser-
vices Cognos 8, vous êtes invité à le faire pendant l'installation.
Il est également conseillé d'installer et de configurer l'application cible sur laquelle vous chargerez
les données et métadonnées.
Configuration système requise pour Metric Designer

Avant d'installer Metric Designer, assurez-vous que l'ordinateur Windows présente les configura-
tions matérielle et logicielle requises pour Cognos 8. La taille des modèles que vous créez a une
incidence sur la configuration matérielle requise. Des ressources supplémentaires peuvent être
requises, telles que de l'espace disque, en fonction de la taille des modèles.
Le tableau ci-dessous présente les configurations matérielles et logicielles minimales requises pour
exécuter Metric Designer.

Système d'exploitation Windows (interface et moteur de conception)
UNIX (moteur uniquement) :
Sun Solaris HP-UX IBM AIX
66

RAM Minimum : 512 Mo
Recommandé : 1 Go
Espace disque Minimum : 500 Mo d'espace libre sur le lecteur contenant

le répertoire temporaire
Autre Microsoft Data Access Component (MDAC), version 2.6 ou

ultérieure, à utiliser avec les exemples de produits.
Procédure
2. Insérez le CD de votre produit de modélisation de Cognos dans le lecteur.
3. Sélectionnez la langue à utiliser pour exécuter l’Assistant d'installation.
Si vous utilisez Oracle ou DB2 comme serveur de base de données pour la bibliothèque d'indica-
teurs dans une installation répartie, vous devez maintenant installer le logiciel client de base de
données (p. 78) sur l'ordinateur sur lequel vous avez installé Metric Designer.
Une fois que Metric Designer est installé sur votre ordinateur Windows, certaines tâches de confi-
guration peuvent être nécessaires pour lui permettre de fonctionner dans votre environnement de
création de tableaux de bord (p. 112).
Paramètres implicites de Metric Designer

Le tableau ci-dessous présente les paramètres implicites des ports et URI utilisés par Metric Desi-
gner. Après installation, vous pouvez utiliser Cognos Configuration pour modifier ces paramètres.
Vous pouvez également les modifier en éditant le fichier cogstartup.xml situé dans le répertoire
emplacement_c8\configuration.
Composant Implicite Description

Passerelle http://localhost:80/cognos8/ Indique l'URI de la
cgi-bin/cognos.cgi passerelle.
URI du distributeur des http://localhost:9300/p2pd/ Indique l'URI du

applications externes servlet/dispatch distributeur.

Désinstallation de Cognos 8
Il est important d'utiliser les programmes de désinstallation afin de supprimer totalement l'ensem-
ble des fichiers et des modifications apportées aux fichiers système.
Pour désinstaller Cognos 8, vous devez désinstaller les composants du serveur, ainsi que Fra-
mework Manager ou Metric Designer.
Si vous exécutez Cognos 8 dans un environnement de serveur d'application, utilisez l'outil d'admi-
nistration proposé par le fournisseur du serveur pour arrêter l'application si elle est en cours
d'exécution et annuler le déploiement de la partie Java des composants de Cognos 8. De nom-
breux serveurs d'application ne suppriment pas intégralement les répertoires ou les fichiers
d'application déployés lors de l'annulation d'un déploiement ; par conséquent, vous devrez
peut-être effectuer cette opération manuellement. Après avoir annulé le déploiement des compo-
sants de Cognos 8, suivez la procédure décrite dans le présent chapitre pour procéder à la désins-
tallation sous UNIX (p. 68) et sous Windows (p. 68).
Désinstallation de Cognos 8 sous UNIX ou Linux

Si vous n'avez plus besoin de Cognos 8 ou si vous procédez à une mise à niveau, désinstallez
Cognos 8.
Si vous procédez à une mise à niveau à partir d'une version précédente de ReportNet vers Cognos
8, suivez la procédure de désinstallation décrite dans la documentation de l'ancienne version de
ReportNet.
Procédure
1. Si la console connectée à l'ordinateur ne prend pas en charge les interfaces graphiques utilisa-
teur de type Java, déterminez le PID (numéro d'identification de processus) du processus
Cognos 8 en saisissant la commande suivante :
ps -ef grep cogbootstrapservice
2. Arrêtez le processus Cognos 8 :
• Si vous utilisez XWindows, démarrez Cognos Configuration puis, dans le menu Opéra-
tions, cliquez sur l'option Arrêter.
kill -TERM numéro_identification_processus
3. Pour désinstaller Cognos 8, accédez au répertoire emplacement_c8/uninstall et saisissez la
commande appropriée :
• Si vous utilisez X Windows, saisissez :
./uninst -u
./uninstcc -u
4. Suivez les invites pour achever la désinstallation.
5. Supprimez tous les fichiers Internet temporaires.
La désinstallation ne supprime pas tous les fichiers modifiés depuis l'installation, tels que les
fichiers de configuration et les fichiers de données utilisateur. L'emplacement d'installation reste
sur l'ordinateur. Tant que vous ne supprimez pas ces fichiers manuellement, ils sont conservés.
Important : Ne supprimez pas les fichiers de configuration et de données si vous procédez à une
mise à niveau de Cognos 8 et voulez utiliser les données de configuration avec la nouvelle version.
Désinstallation de Cognos 8 sous Windows

Si vous n'avez plus besoin de Cognos 8 ou si vous procédez à une mise à niveau, désinstallez tous
les composants de Cognos 8 et le service Cognos 8.
68
Si vous avez installé plusieurs composants dans le même emplacement, l'assistant de désinstalla-
tion vous permet de choisir les packs à désinstaller. Tous les composants du pack seront désinstal-
lés. Vous devez répéter le processus de désinstallation sur chaque ordinateur contenant des
Il n'est pas nécessaire de sauvegarder les fichiers de configuration et de données sous Windows.
Ces fichiers sont conservés pendant la désinstallation.
Il est recommandé de fermer tous les programmes avant de désinstaller Cognos 8. Dans le cas con-
traire, il est possible que certains fichiers ne soient pas supprimés.
La désinstallation ne supprime pas tous les fichiers modifiés depuis l'installation, tels que les
fichiers de configuration et les fichiers de données 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 données si vous procédez à une
mise à niveau de Cognos 8 et voulez utiliser les données de configuration avec la nouvelle version.
Procédure pour Cognos 8

1. Dans le menu Démarrer, cliquez successivement sur les options Programmes, Cognos 8 et
Désinstaller Cognos 8.
L'assistant de désinstallation s'affiche.
Conseil : 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 désinstallation des composants.
Le fichier cognos_uninst_log.htm enregistre les activités effectuées par l'Assistant durant la
désinstallation des fichiers.
Conseil : Pour trouver le fichier journal, cherchez dans le répertoire Temp.
Pour en savoir davantage, reportez-vous à la documentation sur le navigateur Web.
Procédure pour Framework Manager

2. Suivez les instructions pour désinstaller le programme.
Le fichier Cognos_uninst_log.htm enregistre les activités effectuées par l'Assistant durant la
Procédure pour Metric Designer

2. Suivez les instructions pour désinstaller le programme.
Le fichier Cognos_uninst_log.htm enregistre les activités effectuées par l'Assistant durant la

70
Chapitre 6 : Configuration de l'environnement
Après avoir installé Cognos 8, vous devez configurer des ressources dans votre environnement,
afin que les composants puissent fonctionner. Pour Cognos 8, vous devez créer la base de données
à utiliser en tant que Content Store (bibliothèque de contenu). Pour Metric Studio, vous devez
créer au moins une base de données à utiliser en tant que bibliothèque d'indicateurs. Pour la créa-
tion de rapports avec Cognos 8, vous devez créer les sources de données pour Framework Mana-
ger.
Veillez à ce que Java Runtime Environment (JRE) soit disponible. Assurez-vous qu'un navigateur
Web et un serveur Web sont configurés pour permettre l'accès aux composants de Cognos. Si vous
utilisez un routeur, vous devez le configurer pour qu'il prenne en charge les fonctionnalités de
Cognos.
Utilisez la liste de contrôle suivante comme guide de configuration :
❑ Création de la base de données Content Store et, si vous utilisez Metric Studio, d'une biblio-
thèque d'indicateurs.
❑ Configuration du client de base de données Content Store (Oracle, DB2 et Sybase) et, si vous
utilisez Metric Studio, d'une bibliothèque d'indicateurs (Oracle et DB2).
❑ Configuration des variables d'environnement sous UNIX pour la bibliothèque d'indicateurs,
si vous utilisez Metric Studio.
❑ Mise à jour de l'environnement Java, le cas échéant.
❑ Configuration du serveur Web.
❑ Configuration des navigateurs Web.
❑ Configuration du routeur pour tester la disponibilité d'un distributeur, le cas échéant.
❑ Configuration de l'environnement des sources de données pour Framework Manager, le cas
échéant.
❑ Configuration du client de base de données pour Framework Manager, le cas échéant.
❑ Configuration des sources d'importation pour Metric Designer, le cas échéant.
❑ Configuration du client de base de données pour Metric Designer, le cas échéant.
Une fois ces tâches accomplies, vous devez configurer les composants de Cognos (p. 89) pour
qu'ils fonctionnent dans votre environnement.
Création de la base de données Content Store

Le Content Store est une base de données que Content Manager utilise pour stocker des données
de configuration globales, des paramètres généraux (par exemple, la langue et l'unité monétaire
utilisées dans l'interface), des connexions à des sources de données et du contenu spécifique aux
produits. Les modèles de conception et les fichiers journaux ne sont pas stockés dans Content
Store.
Par défaut, les produits Cognos 8 partagent la base de données Content Store. Vous devez créer
cette base de données à l'aide d'une des applications suivantes :
• Oracle
• DB2
• Sybase Adaptive Server Enterprise (ASE)
Sous Linux, vous pouvez utiliser une base de données de contenu Oracle ou DB2 en tant que base
de données Content Store.

Une base de données Oracle ou Microsoft SQL Server peut utiliser l'encodage UTF-8 ou UTF-16.
Une base de données DB2 ou Sybase doit utiliser l'encodage UTF-8. Toutes les bases de données
doivent utiliser le protocole TCP/IP, requis par Cognos 8 pour accéder aux données.
Il est à noter que Cognos 8 utilise un seul ordre de tri spécifiant les règles que la base de données
utilise pour interpréter, collecter, comparer et présenter les données de texte. Un ordre de tri défi-
nit, par exemple, si la lettre 'a' a une valeur de position inférieure, égale ou supérieure à la lettre
'b', si l'assemblage est sensible à la casse et à l'accentuation. Pour en savoir davantage sur l'assem-
blage et les séquences d'assemblage, reportez-vous à la documentation du fournisseur relative à la
base de données.
Si vous utilisez Metric Studio, vous pouvez appliquer la procédure suivante pour créer la biblio-
thèque d'indicateurs. Vous pouvez également utiliser des scripts fournis avec l'installation. Pour en
savoir davantage sur l'utilisation de scripts pour créer la bibliothèque d'indicateurs, reportez-vous
à la section « Création de la bibliothèque d'indicateurs » (p. 75).
Conseils :
• L'administrateur de base de données doit sauvegarder régulièrement les bases de données
Cognos 8 car elles contiennent toutes les données de Cognos.
• Pour garantir la sécurité et l'intégrité des bases de données, il est également important de les
protéger contre tout accès non autorisé ou inapproprié.
• Si vous procédez à une mise à niveau depuis ReportNet, vous pouvez utiliser votre base de
données Content Store existante avec Cognos 8. Une fois que la base de données Content
Store a été mise à niveau vers Cognos 8, vous ne pouvez plus l'utiliser avec ReportNet.
• Si vous procédez à une mise à niveau et que vous souhaitez conserver la version existante de
ReportNet, vous devez créer une base de données Content Store pour Cognos 8.
Vous devez suivre la procédure de mise à niveau adéquate (p. 47) lorsque vous créez la base de
Procédure pour Microsoft SQL Server

1. Veillez à ce que votre installation de Microsoft SQL Server soit configurée selon les propriétés
suivantes :
• L'encodage UTF-8 ou UTF-16 est utilisé.
Pour en savoir davantage sur les jeux de caractères, l'encodage et l'assemblage, repor-
tez-vous à la documentation de Microsoft SQL.
• La séquence d'assemblage est sensible à la casse.
Dans le cadre d'une installation personnalisée, vous choisissez un assemblage, qui com-
prend des jeux de caractères et un ordre de tri, lors de la configuration de SQL Server.
Dans le cadre d'une installation standard, l'installation utilise les paramètres régionaux
identifiés par le programme d'installation pour l'assemblage. Par la suite, ce paramètre ne
pourra pas être modifié.
• Le protocole TCP/IP est activé.
Ce protocole est requis par Cognos 8 pour accéder aux données.
2. Créez la base de données.
3. Si la base de données Content Store utilise l'authentification de Windows, vous devez vous
assurer que le type de base de données Base de données Microsoft SQL Server (Authentifica-
tion Windows) est sélectionné pour la base de données Content Store dans Cognos Configura-
tion. Pour en savoir davantage, reportez-vous à la section « Définition des propriétés de
connexion à la base de données Content Store » (p. 90).
4. Indiquez quel compte utilisateur sera utilisé pour accéder à la base de données.
Conseil : Pour héberger plusieurs bases de données Content Store sur l'instance de Microsoft
SQL Server et les utiliser simultanément, utilisez un compte utilisateur différent pour chaque
base de données Content Store, de façon à ce que les instances de Cognos 8 soient parfaite-
ment indépendantes les unes des autres.
Si vous utilisez Metric Studio, utilisez un compte utilisateur différent pour les bibliothèques
d'indicateurs.
5. Accordez, créez et annulez les droits d'accès à la base de données pour le compte utilisateur.
72
Assurez-vous que le compte utilisateur est membre des rôles db_ddladmin, db_datareader et
db_datawriter.
Vérifiez que l'utilisateur est propriétaire de leur schéma implicite.
Procédure pour Oracle

1. Assurez-vous que le paramètre du niveau de compatibilité de l'instance de base de données de
Content Store est défini à 9.0.1 ou plus.
Pour en savoir davantage sur la modification du paramètre de configuration d'une instance,
reportez-vous à la documentation Oracle.
2. Déterminez si la base de données est Unicode.
Conseil : L'une des méthodes consiste à saisir l'instruction select suivante :
select * from NLS_DATABASE_PARAMETERS
Les résultats indiquent que NLS_CHARACTERSET est UTF-8, UTF-16, AL32UTF8,
AL16UTF16 ou non Unicode.
Pour la bibliothèque d'indicateurs, le NLS_NCHAR_CHARACTERSET doit être UTF-8 ou
AL16UTF16.
Si l'ensemble de résultats renvoie un élément NLS_CHARACTERSET non Unicode, créez une
base de données en indiquant AL32UTF8 ou UTF-8 comme paramètres du jeu de caractères
de la base de données.
Pour la bibliothèque d'indicateurs, créez la base de données en indiquant UTF-8 ou
AL16UTF16 comme NLS_NCHAR_CHARACTERSET.
Conseil : Pour héberger plusieurs bases de données Content Store sur l'instance d'Oracle et les
utiliser simultanément, utilisez un compte utilisateur différent pour chaque base de données
Content Store, de façon à ce que les instances de Cognos 8 soient parfaitement indépendantes
les unes des autres.
4. Assurez-vous que le compte utilisateur qui accède à la base de données dispose des autorisa-
tions appropriées pour effectuer les opérations suivantes :
• Connexion à la base de données
• Création, modification et annulation des tables, des éléments déclencheurs, des vues, des
procédures et des séquences
Pour une bibliothèque d'indicateurs, vous devez également vous assurer que ce compte
utilisateur dispose des autorisations appropriées pour créer des types et s'exécuter dans les
packs DBMS_LOCK et DBMS_UTILITY. Toutes les autorisations doivent directement
être accordées au compte utilisateur, non au rôle.
• Insertion, mise à jour et suppression de données dans les tables de la base de données
Procédure pour DB2

1. Définissez les variables d'environnement appropriées pour DB2.
Variable d'environnement Description

DB2DIR Répertoire de niveau supérieur qui contient le logiciel client
de base de données ou l'installation complète de la base de
données.
Chemin d'accès à la bibliothèque de chargement. Vous

devez ajouter l'emplacement du pilote.
Exemples :
Sous Solaris : Exemple Solaris : LD_LIBRARY_PATH= $DB2DIR/lib :

LD_LIBRARY_PATH $LD_LIBRARY_PATH
Sous AIX : LIBPATH Exemple AIX : LIBPATH=$DB2DIR/lib: $LIBPATH

Variable d'environnement Description

Sous HP-UX : SHLIB_PATH Exemple HP-UX : SHLIB_PATH=$DB2DIR/lib:
$SHLIB_PATH
DB2INSTANCE Connexion au serveur de base de données implicite.
DB2CODEPAGE L'affectation de la valeur 1208 à cette variable

d'environnement facultative permet la prise en charge de
bases de données multilingues.
Pour en savoir davantage sur l'usage de cette variable
d'environnement, reportez-vous à la documentation sur
DB2.
2. Déterminez si l'encodage de la base de données est Unicode en saisissant ce qui suit dans
l'invite de commande :
db2 get database configuration for nom_base_de_données
L'encodage de la page de codes est Unicode si sa valeur est 1208.
3. Si l'encodage de la page de codes n'est pas Unicode, créez une base de données dont la valeur
de page de codes est 1208.
4. Veillez à définir les paramètres de configuration suivants :
Propriété Paramètre
Taille de segment mémoire de l'application 1024 Ko
(applheapsz)
Délai d'attente de verrouillage 4 mn (ou 240 s)

Ne définissez pas de délai d'attente infini pour
cette propriété.
5. Créez un groupe de mémoire tampon d'une taille de page de 16 Ko.

6. Créez un espace de table système temporaire d'une taille de page de 16 Ko.
7. Créez un espace de table utilisateur temporaire d'une taille de page de 4 Ko.
Les tables temporaires globales sont créées dans l'espace de table utilisateur temporaire.
8. Créez un espace de table utilisateur régulier d'une taille de page de 4 Ko.
9. Si vous avez déjà créé la base de données Content Store et que vous créez maintenant une base
de données de journalisation, définissez un autre espace de table standard avec une taille de
page de 8 Ko.
10. Indiquez quel compte utilisateur sera utilisé par Cognos 8 pour accéder à la base de données.
Conseil : Pour héberger plusieurs bases de données Content Store sur l'instance de DB2 et les
utiliser simultanément, utilisez un compte utilisateur différent pour chaque base de données
Content Store, de façon à ce que les instances de Cognos 8 soient parfaitement indépendantes
les unes des autres.
Si vous utilisez Metric Studio, utilisez un compte utilisateur différent pour les bibliothèques
d'indicateurs.
Assurez-vous que le compte utilisateur dispose des droits d'accès CREATETAB, CONNECT
et IMPLICITSCHEMA pour la base de données.
Pour la bibliothèque d'indicateurs, le compte utilisateur doit disposer des droits d'accès
DBADMIN.
Assurez-vous que le compte utilisateur dispose des droits d'accès USE pour l'espace de table
USER TEMPORARY et pour les autres espaces de table appropriés associés à la base de don-
nées.
74
Pour Windows XP, assurez-vous que le compte utilisateur dispose de droits GRANT pour
l'espace de table USER TEMPORARY.
Procédure pour Sybase Adaptive Server Enterprise

1. Sur le serveur Sybase, créez une instance de serveur avec une page serveur de 8 Ko.
Pour en savoir davantage, reportez-vous à la documentation de Sybase.
2. Au besoin, installez jConnect version 5.5.
Cet outil établit la communication entre le pilote JDBC et l'instance de Sybase Adaptive Ser-
ver.
Pour en savoir davantage, reportez-vous à la documentation de Sybase.
Si votre version de Sybase n'inclut pas JConnect 5.5, vous devez télécharger le programme
d'installation à partir du site Web de Sybase.
3. Ajoutez le jeu de caractères UTF-8 à l'instance de serveur.
4. Au besoin, définissez-le comme jeu de caractères implicite du serveur.
5. Créez une instance de base de données.
Conseil : Définissez log_segment sur une valeur minimum de 10 Mo.
6. Définissez-la comme instance de base de données par défaut.
Les informations relatives à la nouvelle base de données seront stockées dans la nouvelle ins-
tance de base de données. Conservez une copie de sauvegarde de l'instance de base de données
en vue d'une éventuelle récupération.
7. Créez la base de données.
Conseil : Pour héberger plusieurs bases de données Content Store sur votre instance de serveur
Sybase tout en les exploitant, employez un compte utilisateur différent pour chaque base de
données Content Store, de façon à ce que toutes les instances de Cognos 8 soient parfaitement
indépendantes les unes des autres.
Vérifiez que le compte utilisateur dispose des droits d'accès suivants à la base de données :
création de valeurs implicites, de procédures, de règles, de tables et de vues.
10. Pour la base de données, définissez la propriété Select into sur Vrai et redémarrez le serveur.
Création de la bibliothèque d'indicateurs

Une bibliothèque d'indicateurs est une base de données contenant des données relatives aux packs
d'indicateurs. Elle contient également des paramètres d'application de tableaux de bord, tels que
les préférences de l'utilisateur. Vous devez créer une base de données pour la bibliothèque d'indica-
teurs à l'aide d'Oracle, de Microsoft SQL Server ou de DB2.
Il est à noter que Cognos 8 utilise un seul ordre de tri spécifiant les règles que la base de données
utilise pour interpréter, collecter, comparer et présenter les données de texte. Un ordre de tri défi-
nit, par exemple, si la lettre 'a' a une valeur de position inférieure, égale ou supérieure à la lettre
'b', si l'assemblage est sensible à la casse et à l'accentuation.
L'administrateur de base de données doit sauvegarder régulièrement les bases de données Cognos
8 car elles contiennent toutes les données de Cognos. Pour garantir la sécurité et l'intégrité des
bases de données, il est également important de les protéger contre tout accès non autorisé ou
inapproprié.
La procédure suivante décrit comment utiliser les scripts fournis avec l'installation pour créer une
bibliothèque d'indicateurs. Toutefois, la procédure décrite à la section « Création de la base de
données Content Store » (p. 71) peut également être utilisée pour créer la bibliothèque d'indica-
teurs.
Procédure pour Microsoft SQL Server

1. Dans le répertoire emplacement_c8/configuration/schemas/cmm/sqlserver, exécutez le script
cmm_create_db.cmd en saisissant la commande suivante :

chemin_accès_script cmm_create_db
nom_hôtenom_base_de_donnéesnom_utilisateurmot_de_passe [utilisateur_à_créer]
Utilisez les valeurs suivantes dans la commande :
Valeur Paramètre
nom_hôte Nom de l'ordinateur sur lequel la base de données sera créée.
nom_base_de_données Nom de la base de données qui sera créée.
nom_utilisateur Code d'utilisateur disposant des autorisations pour créer la

base de données. Le code d'utilisateur doit disposer des
autorisations pour créer la base de données, par exemple sa
(administrateur).
password Mot de passe correspondant à l'élément nom_utilisateur.
utilisateur_à_créer Utilisateur créé par le script et auquel les droits de propriétaire

de la base de données sont attribués. Cette valeur est
facultative.
2. Indiquez quel compte utilisateur sera utilisé par Metric Studio pour accéder à la base de don-
nées.
Le compte utilisateur doit être le propriétaire de la base de données ou un pseudonyme de ce
dernier.
Procédure pour Oracle si la base de données n'existe pas

1. Vérifiez que vous êtes connecté au serveur Oracle en tant qu'utilisateur membre du groupe
ORA_DBA sous Windows ou du groupe dba sous UNIX.
2. Depuis le répertoire emplacement_c8/configuration/schemas/cmm/oracle, exécutez le script
chemin_accès_script cmm_create_db sidchemin_accèsversion_base_de_données
[utilisateur_à_créer]
Valeur Paramètre
chemin_accès_script Chemin d'accès au script. Par exemple,
emplacement_c8/configuration/schemas/cmm/oracle/
sid SID de la base de données qui sera créée.
chemin_accès Chemin d'accès aux fichiers de données qui seront créés.
version_base_de_données Version d'Oracle installée. Par exemple, oracle9 ou oracle10.
utilisateur_à_créer Utilisateur créé par le script et auquel les droits de propriétaire

de la base de données sont attribués. Cette valeur est
facultative.
nées.
Si vous avez inclus l'utilisateur facultatif à l'étape précédente, il s'agit du compte que vous uti-
liserez pour accéder à la base de données. Si vous n'avez pas inclus d'utilisateur, vous devez
ajouter un nom d'utilisateur de base de données Oracle valide disposant d'autorisations pour
effectuer les opérations ci-après.
• Connexion à la base de données
76
• Création, modification et annulation des tables, des éléments déclencheurs, des vues, des
procédures et des séquences
Pour une bibliothèque d'indicateurs, vous devez également vous assurer que ce compte
utilisateur dispose des autorisations appropriées pour créer des types et s'exécuter dans les
packs DBMS_LOCK et DBMS_UTILITY. Toutes les autorisations doivent directement
être accordées au compte utilisateur, non au rôle.
• Insertion, mise à jour et suppression de données dans les tables de la base de données
Procédure pour DB2

1. Dans le répertoire emplacement_c8/configuration/schemas/cmm/db2, exécutez le script
Sous Windows, saisissez
cmm_create_db instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd
Sous UNIX, saisissez
cmm_create_db.sh instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd
Valeur Paramètre
instance_bd Nom de l'instance de DB2 sur laquelle la base de données sera
créée.
nom_utilisateur Code d'utilisateur disposant des autorisations pour créer la base

de données. Le code d'utilisateur doit disposer des droits d'accès
SYSADM ou SYSCTRL, ainsi que des droits d'accès DBADM
pour créer le schéma.
password Mot de passe correspondant à l'élément nom_utilisateur.
nom_bd Nom de la base de données qui sera créée. Le nom doit compter
un maximum de 8 caractères et ne peut pas commencer par un
chiffre.
lecteur/chemin_accès Sous Windows, lecteur sur lequel les objets de la base de données
seront créés. Sous UNIX, chemin d'accès aux objets de la base de
données qui seront créés.
pseudonyme_bd Pseudonyme de la base de données. Cette valeur est facultative.
Remarque : L'administrateur de base de données peut vérifier les scripts pour s'assurer qu'ils
conviennent à votre environnement. Le script initializedb.db2 est appelé par le script
cmm_create_db.cmd et définit les groupes de mémoire tampon et les espaces de table.
nées.
Le compte utilisateur doit disposer des droits d'accès DBADM.
Remarque : Si la version du serveur DB2 est antérieure à 8.2 et compile des procédures stoc-
kées à l'aide d'un compilateur C tiers spécifique à une plate-forme, ce compilateur doit être
installé sur chaque ordinateur du serveur DB2 utilisé par la bibliothèque d'indicateurs.

Configuration du client de base de données

Si vous utilisez Oracle, DB2 ou Sybase comme serveur de base de données Content Store, des éta-
pes supplémentaires sont requises entre l'installation et la configuration de Cognos 8. Configurez
les pilotes suivants sur tous les ordinateurs sur lesquels Content Manager ou Framework Manager
est installé :
Base de données Tâches complémentaires

Oracle Configurez le pilote JDBC.
DB2 Configurez le logiciel client de base de données et le pilote JDBC 2.0.
Sybase Configurez le pilote JDBC.
Microsoft SQL Server Aucune tâche supplémentaire n'est requise. Par défaut, le fichier
JSQLConnect.jar est installé dans l'emplacement approprié.
Si vous utilisez Oracle ou DB2 pour les bibliothèques d'indicateurs, vous devez configurer les élé-
ments suivants sur chaque ordinateur sur lequel les composants d'application de Metric Studio ou
Metric Designer sont installés.
Base de données Tâches complémentaires

Oracle Configurez le pilote OCI JDBC.
Installez l'utilitaire SQL Loader.
DB2 Configurez le logiciel client de base de données et le pilote JDBC 2.0.
Microsoft SQL Server Par défaut, le fichier JSQLConnect.jar est installé dans l'emplacement
approprié.
Vous devez installer l'utilitaire bcp.
Si vous utilisez Oracle pour votre bibliothèque d'indicateurs, vous devez installer l'utilitaire SQL
Loader sur chaque ordinateur sur lequel les composants d'application de Metric Studio ou Metric
Designer sont installés.
Si vous utilisez Microsoft SQL Server, vous devez installer l'utilitaire bcp sur chaque ordinateur
sur lequel les composants d'application de Metric Studio ou Metric Designer sont installés.

1. Sur l'ordinateur où Oracle est installé, accédez au répertoire ORACLE_HOME/jdbc/lib.
2. Copiez le fichier classes12.jar dans le répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib
des ordinateurs sur lesquels Content Manager est installé.
Ce fichier contient le pilote requis par la base de données Content Store.
Procédure pour DB2

1. Installez le logiciel client DB2 sur les ordinateurs appropriés.
2. Si la base de données Content Store se trouve sur un autre ordinateur que celui sur lequel
Content Manager est installé, configurez un pseudonyme de base de données pour Content
Store en exécutant l'assistant de configuration du client DB2 :
Sous UNIX ou Linux, utilisez l'interface de ligne de commande DB2.
Si la base de données Content Store et Content Manager se trouvent sur le même ordinateur,
le nom de Content Store devient automatiquement le pseudonyme.
Lorsque vous configurez les ordinateurs Content Manager, assurez-vous qu'ils sont tous confi-
gurés pour utiliser la même base de données Content Store .
78
3. Sous Windows, arrêtez 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
répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib.
5. Renommez le fichier db2java.zip en db2java.jar.
6. Sous Windows, redémarrez les services DB2 et le serveur de recherche HTML.
7. Répétez l'intégralité de la procédure sur les ordinateurs Cognos 8 sur lesquels le logiciel doit
être installé.
Vous pouvez mettre au point la base de données afin de tirer profit des fonctions de DB2. Pour en
savoir davantage, reportez-vous au manuel Architecture and Planning Guide.
Procédure pour Sybase

1. Sur l'ordinateur où Sybase est installé, accédez au répertoire emplacement_Sybase/jCon-
nect-5_5/classes.
2. Copiez le fichier jconn2.jar dans le répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib
de tous les ordinateurs sur lesquels Content Manager est installé.
Si l'installation est terminée, vous devez effectuer certaines tâches de configuration pour garantir
le bon fonctionnement de Cognos 8 (p. 89) et de Framework Manager (p. 109) dans votre envi-
ronnement.
Pour en savoir davantage sur la configuration de Metric Designer, reportez-vous à la section
(p. 112).
Configuration des variables d'environnement sous UNIX pour

la bibliothèque d'indicateurs
Pour Cognos 8, vous devez définir des variables d'environnement pour pouvoir utiliser une base
de données DB2 ou Oracle comme bibliothèque d'indicateurs.
La syntaxe correcte pour créer des variables d'environnement dépend de l'interpréteur de com-
mandes.
Oracle
Pour les bases de données Oracle, vous devez définir et exporter les variables d'environnement de
la base de données pour l'utilisateur de la bibliothèque d'indicateurs avant de démarrer les proces-
sus Cognos. Cognos 8 utilise ces variables pour se connecter à votre base de données. Pour définir
ces variables d'environnement, vous pouvez inclure ces commandes dans le script .profile ou .login
de l'utilisateur qui démarre les services Cognos.
Lors de la définition des chemins d'accès à la bibliothèque de chargement, assurez-vous que les
bibliothèques Oracle 32 bits se trouvent sur le chemin d'accès à la bibliothèque (généralement le
répertoire $ORACLE_HOME/lib ou $ORACLE_HOME/lib32 si vous installez un client Oracle
64 bits).

Le tableau ci-dessous décrit les variables d'environnement des bases de données Oracle. Contactez
votre administrateur de base de données ou de réseau pour obtenir les valeurs adaptées à votre
système.
Variable
d'environnement Description
ORACLE_HOME Répertoire de niveau supérieur qui contient le logiciel client de base de
données ou l'installation complète de la base de données.
Exemple : /usr/oracle
Il est possible d'utiliser un script Oracle pour créer les variables
d'environnement. Pour en savoir davantage, reportez-vous à la
documentation Oracle.
Exemple : /usr/local/bin/coraenv
TNS_ADMIN Répertoire contenant le fichier Oracle tnsnames.ora, permettant les appels

vers la base de données Oracle pour déterminer les connexions serveur
requises.
Exemple :
$ORACLE_HOME/network/admin
PATH Variable permettant de localiser les fichiers exécutables.

Exemple :
$PATH:$ORACLE_HOME/bin
Chemin d'accès à la bibliothèque de chargement.
Sous Solaris : Exemples Solaris :

LD_LIBRARY_ LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
PATH
LD_LIBRARY_PATH=$ORACLE_HOME/lib32:$LD_LIBRARY_PATH
Sous AIX : Exemples AIX :

LIBPATH LIBPATH=$ORACLE_HOME/lib:$LIBPATH
LIBPATH=$ORACLE_HOME/lib32:$LIBPATH
Sous HP-UX : Exemples HP-UX :

SHLIB_PATH SHLIB_PATH=$ORACLE_HOME/lib:$SHLIB_PATH
SHLIB_PATH=$ORACLE_HOME/lib32:$SHLIB_PATH
DB2
Pour les bases de données IBM DB2, vous devez définir les variables en exécutant les scripts d'ins-
tallation d'environnement inclus dans le programme d'installation de DB2. Pour les interpréteurs
de commandes Bourne et Korn, exécutez la commande suivante ou ajoutez-la au script .profile :
répertoire_installation_DB2/db2profile
Contactez votre administrateur de base de données ou de réseau pour obtenir les valeurs adaptées
à votre système.
80
Mise à jour de l'environnement Java

Les services cryptographiques de Cognos 8 utilisent des fichiers .jar (Java Archive) spécifiques
dans votre environnement JRE (Java Runtime Environment) afin de déterminer la puissance auto-
risée du JRE. Cognos 8 fournit les fichiers de stratégie juridictionnelle .jar nécessaires au cas où
votre JRE ne posséderait pas la puissance cryptographique minimale requise.
Si vous ne disposez pas d'une variable JAVA_HOME déjà définie sous Windows ou si la variable
JAVA_HOME pointe vers une version de Java non compatible avec Cognos 8, les fichiers JRE
fournis avec l'installation seront utilisés et vous n'aurez pas besoin de mettre à jour les fichiers de
votre environnement.
Si vous souhaitez utiliser votre propre JRE et définir la variable JAVA_HOME sur l'emplacement
correspondant sous Windows ou si vous effectuez l'installation sous UNIX, vous devrez peut-être
mettre à jour l'environnement Java pour les services cryptographiques.
La nécessité de mettre à jour votre environnement Java dépend de la puissance relative des fichiers
de stratégie juridictionnelle .jar contenus dans votre environnement. Ainsi, si vous possédez dans
votre environnement des fichiers plus puissants que ceux fournis avec Cognos 8, vous n'avez pas
besoin de mettre à jour l'environnement. Dans ce genre de situation, cela pourrait entraîner un
dysfonctionnement des autres applications.
Si vous mettez à jour votre environnement Java, il est recommandé d'effectuer une copie de sauve-
garde des fichiers que vous allez remplacer. Si d'autres applications échouent, vous devrez
peut-être remplacer les fichiers .jar d'origine.
Sous Windows, vous pouvez définir JAVA_HOME en tant que variable système ou variable utili-
sateur. Si vous la définissez en tant que variable système, vous devrez probablement redémarrer
votre ordinateur pour qu'elle prenne effet. Si vous la définissez en tant que variable utilisateur, fai-
tes en sorte que l'environnement dans lequel s'exécute Tomcat puisse y accéder.
Java 1.3.1 est la version JRE minimale prise en charge par Cognos 8. Vérifiez que vous avez ins-
tallé le JRE adapté à votre matériel. Les fichiers .jar de chiffrement fournis avec l'installation sont
destinés à Java 1.4.2. Ils ne fonctionneront pas avec Java 1.3.1.
Procédure
1. Vérifiez que la variable d'environnement JAVA_HOME est définie de façon à pointer vers
l'emplacement du JRE.
2. Copiez les fichiers suivants du répertoire emplacement_c8/bin/jre/version/lib/security dans le
répertoire emplacement_Java/version/lib/security :
• local_policy.jar
• US_export_policy.jar
3. Copiez le fichier bcprov-jdk13-125.jar suivant du répertoire emplacement_c8/bin/jre/ver-
sion/lib/ext dans le répertoire emplacement_Java/version/lib/ext.
4. Si vous utilisez Sun JRE 1.4.2 sous UNIX, veillez à utiliser le fichier de démarrage correct
pour le périphérique /dev/random.
Vous devez utiliser /etc/init.d ou /etc/rc3.d/f20random.
Pour en savoir davantage, reportez-vous à la documentation UNIX.
Configuration du serveur Web

Pour toutes les installations, avant d'utiliser des pages Web créées par Cognos 8, vous devez confi-
gurer votre serveur Web. Vous devez configurer des répertoires virtuels, également appelés alias
Web, correspondant aux répertoires qui contiennent les fichiers HTML et Web destinés à Cognos
8. Pour la création de rapports avec Cognos 8, vous devez également définir la date d'expiration
applicable au contenu du répertoire d'images de votre serveur Web pour que le navigateur ne con-
trôle pas l'état de ces dernières après le premier accès.

Sous UNIX et Linux, le compte sous lequel le serveur Web s'exécute doit disposer de droits de lec-
ture sur le fichier cogstartup.xml qui se trouve dans le répertoire emplacement_c8/configuration.
Par défaut, le fichier cogstartup.xml a des droits de lecture sur d'autres fichiers. Si vous exécutez le
serveur Web sous un groupe spécifique, vous pouvez modifier les droits du fichier cogstartup.xml
pour être certain qu'il appartienne au même groupe que le serveur Web. Vous pouvez supprimer
les droits de lecture sur d'autres fichiers.
Procédure
1. Créez les répertoires virtuels suivants :
Alias Emplacement Droit d'accès

cognos8 emplacement_c8/webcontent Lecture
cognos8/cgi-bin emplacement_c8/cgi-bin Exécution
Vous pouvez utiliser un nom autre que cognos8 dans les alias. Cependant, vous devez utiliser
cgi-bin en tant que deuxième partie de l'alias et vous devez modifier le répertoire virtuel dans
la propriété URI de la passerelle pour correspondre au nouvel alias de Cognos. Pour en savoir
davantage sur la modification de l'URI de la passerelle, reportez-vous à la section (p. 115).
Si vous procédez à une mise à niveau à partir de ReportNet, vous pouvez continuer à utiliser
les alias existants. Si vous installez les composants de création de rapports de Cognos 8 dans
un emplacement différent 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 différents pour Cognos 8.
Pour le serveur Web Apache, définissez l'alias cognos8/cgi-bin avant l'alias cognos8 dans le
fichier httpd.conf situé dans le répertoire installation_Apache/conf. L'alias cognos8/cgi-bin
doit être défini comme ScriptAlias.
Pour un serveur Web Java System, veillez à définir l'alias cognos8/cgi-bin avant l'alias
cognos8.
Remarque : Le serveur Web Java System était auparavant nommé serveur Web Sun ONE ou
serveur Web iPlanet.
2. Si vous souhaitez utiliser le navigateur d'images de Report Studio, activez le protocole Web-
DAV (Web Distributed Authoring and Versioning) sur le serveur Web.
Si vous utilisez un serveur Web Apache, définissez un répertoire dans lequel activer WebDAV.
Pour en savoir davantage sur la configuration du protocole WebDAV, reportez-vous à la docu-
mentation sur le serveur Web.
Remarque : iPlanet ne prend pas en charge le protocole WebDAV.
3. Pour la création de rapports avec Cognos 8, définissez la date d'expiration du contenu dans le
répertoire virtuel emplacement_c8/pat/images du serveur Web.
Chaque fois qu'un utilisateur ouvre Report Studio, son navigateur Web vérifie auprès du ser-
veur Web si les images sont actualisées. Étant donné qu'il existe plus de 600 images, ce con-
trôle peut engendrer un trafic réseau excessif. Vous pouvez le différer jusqu'à une date définie
au moyen de la fonction de spécification de la date d'expiration du contenu du serveur Web.
Pour en savoir davantage sur la spécification de la date d'expiration du contenu, repor-
tez-vous à la documentation de votre serveur Web.
Remarque : Lors de la mise à niveau, les utilisateurs de Report Studio doivent vider l'antémé-
moire du navigateur Web pour obtenir les images les plus récentes.
Si vous utilisez des alias Web autres que cognos8, si votre serveur Web se trouve sur un autre ordi-
nateur ou si vous utilisez Microsoft Internet Application Interface (ISAPI), apache_mod ou une
passerelle servlet, modifiez l'URI de la passerelle (p. 137) lors de la configuration des composants
de Cognos.
Activation SSL sur le serveur Web

Activez le protocole SSL (Secure Socket Layer) pour chiffrer la communication d'un utilisateur
avec le serveur Web.
82
Pour activer le protocole SSL sur votre serveur Web, vous devez obtenir un certificat du serveur
Web signé par une autorité de certification et l'installer sur votre serveur Web. Le certificat ne doit
pas être auto-signé, car ce type de certificat n'est pas approuvé par les composants Cognos.
Pour permettre aux composants Cognos d'utiliser un serveur Web avec sécurité SSL activée, vous
devez disposer de copies du certificat racine approuvé (le certificat de l'autorité de certification
racine qui a signé le certificat du serveur Web) et de tout autre certificat composant la chaîne
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-signés. Les certificats doivent être installés 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.
Procédure
1. Configurez le serveur Web pour le protocole SSL et démarrez 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 Cognos Configuration, puis
enregistrez la configuration.
Important : Ne démarrez pas encore le service Cognos 8.
3. Sur chaque ordinateur des composants d'application, pointez sur le répertoire
emplacement_c8/bin et importez tous les certificats composant la chaîne d'approbation, en
commençant par le certificat racine de l'autorité d'accréditation, vers la bibliothèque d'appro-
bations de Cognos.
Importez les certificats en saisissant la commande suivante :
Sous UNIX ou LINUX, saisissez
ThirdPartyCertificateTool.sh -T -i -r nomFichier_certificat -D ../configuration/signkey-
pair/jCAKeystore -p mot_de_passe
ThirdPartyCertificateTool.bat -T -i -r nomFichier_certificat -D ../configuration/signkey-
pair/jCAKeystore -p mot_de_passe
Remarque : Le mot de passe doit déjà avoir été défini. Dans le cas contraire, le mot de passe
implicite est NoPassWordSet.
4. Sur chaque ordinateur des composants d'application, démarrez le service Cognos 8 dans
Cognos Configuration.
Conseils :
• Vous pouvez vérifier l'approbation en créant et en exécutant un rapport PDF contenant des
images qui ne sont pas stockées en local, et que la passerelle doit récupérer à partir d'un ordi-
nateur distant. Si les images s'affichent, l'approbation est établie.
• Pour éviter de recevoir une alerte de sécurité à chaque nouvelle session, installez le certificat
dans l'une des bibliothèques de certificats de votre navigateur Web.
En outre, vous pouvez configurer des connexions SSL entre les composants de Cognos et d'autres
serveurs. Vous devez vous assurer que le protocole SSL est configuré pour les autres serveurs, puis
configurer une sécurité partagée entre les composants de Cognos et ces autres serveurs. Pour en
savoir davantage, reportez-vous à la section « Configuration du protocole SSL » (p. 124).
Configuration de navigateurs Web

Cognos 8 utilise les configurations de navigateur implicites de Microsoft, Netscape et Firefox.
Dans tous les navigateurs, vous devez vous assurer que les paramètres des témoins (cookies) et des
scripts Java sont bien activés. Les paramètres supplémentaires requis sont spécifiques au naviga-
teur.

Le tableau suivant indique les paramètres qui doivent être activés dans les navigateurs Web pris en
charge :
Navigateur Configuration Composant Cognos

Internet Explorer Autoriser les témoins de connexion Cognos Connection
(cookies) Visualiseur Cognos
Active Scripting Report Studio
META REFRESH autorisé
Query Studio
Analysis Studio
Event Studio
Metric Studio
Internet Explorer Exécuter les contrôles ActiveX et les Report Studio

plug-ins Query Studio
Contrôles ActiveX reconnus sûrs pour Analysis Studio
l'écriture de scripts
Netscape Autoriser les témoins de connexion Cognos Connection

(cookies)
Query Studio
JavaScript
Event Studio
Metric Studio
Firefox Autoriser les témoins de connexion Cognos Connection

(cookies)
Visualiseur Cognos
Activer Java Query Studio
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 activée car Microsoft l'utilise pour implémenter le langage XML. Cognos 8 ne fournit ni ne
télécharge de contrôles ActiveX. Seuls les contrôles ActiveX installés en même temps qu'Internet
Explorer sont activés pour cette configuration.
Cognos 8 utilise les témoins (cookies) suivants pour stocker des informations utilisateur :
Cookie Type Objectif

AS_TICKET Session temporaire Il est créé si Cognos 8 est configuré de façon à
utiliser un espace-noms Cognos Series 7.
Cam_passport Session temporaire Contient une référence à une session utilisateur

stockée sur le serveur Content Manager.
cc_session Session temporaire Conserve des informations spécifiques à

Cognos Connection relatives à la session.
cc_state Session temporaire Conserve des informations pendant les

opérations de modification (par exemple,
couper, copier, coller).
84
Cookie Type Objectif

CRN Session temporaire Contient des informations régionales sur le
produit et le contenu. Défini pour tous les
utilisateurs de Cognos.
CRN_RS Permanent Enregistre le choix effectué par l'utilisateur

pour « Afficher le dossier des membres » dans
Report Studio.
PAT_CURRENT_ Permanent Contient le chemin du dossier actuel si l'accès

FOLDER au fichier local est utilisé. Mis à jour après
utilisation de la boîte de dialogue Ouvrir ou
Enregistrer.
qs Permanent Enregistre les paramètres sélectionnés par

l'utilisateur pour les éléments d'interface
utilisateur tels que les menus et les barres
d'outils.
caf Session temporaire Contient des informations sur l'état de la

sécurité.
Après avoir mis à niveau ou installé un nouveau logiciel, redémarrez le navigateur Web et deman-
dez aux utilisateurs de vider l'antémémoire du navigateur.
Configuration du routeur pour tester la disponibilité d'un

distributeur
Si vous utilisez un routeur pour distribuer des demandes aux distributeurs de Cognos 8 et si ce
routeur peut tester la disponibilité d'un serveur à l'aide d'une URL test, vous pouvez le configurer
pour qu'il teste la disponibilité d'un distributeur de Cognos 8.
Pour tester la disponibilité d'un distributeur, procédez comme suit :
• Configurez le routeur pour qu'il utilise une URL dont le chemin d'accès est /p2pd/servlet/ping.
Si le distributeur n'est pas prêt, la réponse suivante est envoyée :
503 Service non disponible
Si le distributeur est prêt, la réponse suivante est envoyée :
200 OK
Configuration de l'environnement de sources de données ou

de sources d'importation
Les outils de modélisation de Cognos 8 permettent de créer et de gérer des métadonnées. Fra-
mework Manager crée et gère des métadonnées pour les fonctions de création de rapports, tandis
que Metric Designer crée et gère les métadonnées requises pour les fonctions de création de
tableaux de bord. Étant donné que les métadonnées sont dérivées de sources de données d'envi-
ronnements multilingues ou à plusieurs plates-formes, vous devez prendre en compte plusieurs
points ou effectuer différentes opérations lors de la configuration de l'environnement de sources
de données pour Framework Manager ou de l'environnement de sources d'importation pour
Metric Designer. Généralement, ces opérations dépendent de la technologie tierce utilisée pour
votre source de données ou d'importation.
Si vous utilisez une source de données Sybase, ces étapes ne sont pas nécessaires.

Si vous avez procédé à une mise à niveau à partir d'une version antérieure de Framework Mana-
ger, aucun élément n'a besoin d'être configuré dans l'environnement de sources de données. Vous
devez configurer l'environnement de sources de données uniquement si vous avez installé Fra-
mework Manager dans un emplacement différent de celui de la version précédente.
Veillez à installer les packs linguistiques appropriés pour la prise en charge des jeux de caractères
et des symboles monétaires que vous utilisez.
Procédure
1. Paramétrez la variable d'environnement pour une prise en charge multilingue :
• Pour Oracle, définissez la variable d'environnement NLS_LANG (prise en charge de la
langue nationale) sur chaque ordinateur sur lequel Framework Manager ou Metric Desi-
gner et le serveur Cognos 8 sont installés, à l'aide de la commande suivante :
NLS_LANG = language_territory.character_set
Par exemple : NLS_LANG = JAPANESE_JAPAN.UTF8
La valeur de la variable détermine le comportement de Cognos 8 par rapport aux paramè-
tres régionaux. Les messages d'erreur, l'ordre de tri, la date, l'heure, la monnaie, les don-
nées numériques et les conventions de calendrier peuvent en effet s'adapter
automatiquement à la langue et aux paramètres régionaux.
• Pour DB2, attribuez la valeur 1252 à la variable d'environnement DB2CODEPAGE.
Pour en savoir davantage sur l'usage de cette variable d'environnement facultative, repor-
tez-vous à la documentation sur DB2.
Aucun paramètre n'est requis pour SAP BW. SAP prend en charge une seule page de codes sur
les systèmes SAP BW non-Unicode.
2. Pour Oracle, ajoutez $ORACLE_HOME/lib au chemin d'accès LD_LIBRARY_PATH.
3. Pour Oracle, copiez le fichier classes12.jar situé dans l'emplacement
ORACLE_HOME/jdbc/lib dans le répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib.
4. Pour SAP BW, configurez les objets d'autorisation ci-dessous de façon à ce que l'outil de
modélisation puisse extraire les métadonnées.
Certaines valeurs affichées, telles que * sont les valeurs implicites que vous pouvez modifier
pour votre environnement.
Objet d'autorisation Zone Valeur

S_RFC Activité 16
Nom de RFC à protéger SYST, RSOB, SUGU, RFC1,

RS_UNIFICATION, RSAB,
SDTX, SU_USER
Type d'objet RFC à protéger FUGR
S_TABU_DIS Activité 03
Groupe d'autorisation &NC&
S_RFC Activité 16
Nom de RFC à protéger SYST, RSOB, SUGU, RFC1,

RS_UNIFICATION, RSAB,
SDTX, SU_USER
S_TABU_DIS Activité 03
Groupes d'autorisation &NC&
S_USER_GRP Activité 03, 05
86

Groupe d'utilisateurs pour *
maintenance principale des
utilisateurs
S_RS_COMP Activité *
InfoArea Nom technique InfoArea
InfoCube Nom technique InfoCube
Nom (identificateur) des *

composants de création de
rapports
Type des composants de *

S_RS_COMP1 Activité *
Nom (identificateur) des *

composants de création de
rapports
Type des composants de *

Propriétaire (personne *
responsable)
S_RS_HIER Activité 71
Nom de hiérarchie Nom de hiérarchie
InfoObject Nom technique InfoObject
Version Version de hiérarchie
S_RS_ICUBE Activité 03
Sous-objet d'InfoCube DATA

DÉFINITION
InfoArea Nom technique InfoArea
InfoCube Nom technique InfoCube
&NC& représente toute table n'ayant pas de groupe d'autorisation. Pour plus de sécurité,
créez un nouveau groupe d'autorisation et attribuez-lui la table RSHIEDIR. Le nouveau
groupe d'autorisation empêche l'utilisateur d'accéder uniquement à la table ci-dessus, néces-
saire à l'outil de modélisation. Créez le nouveau groupe d'autorisation en tant que personnali-
sation dans le système SAP.
Pour en savoir davantage sur les objets d'autorisation SAP BW, reportez-vous à Transaction
SU03.
Une fois ces tâches accomplies, vous devez configurer les composants de Cognos 8 (p. 89) pour
qu'ils fonctionnent dans votre environnement.

88
Chapitre 7 : Configuration de Cognos 8
Après avoir installé un ou plusieurs composants de Cognos 8 sur votre ordinateur, vous devez les
configurer afin d'assurer leur bon fonctionnement dans votre environnement Cognos. Initiale-
ment, les paramètres de propriété implicites sélectionnés par Cognos servent à configurer les com-
posants. Toutefois, vous pouvez modifier ces paramètres implicites si les conditions rendent les
choix implicites inadéquats ou si vous souhaitez qu'ils soient plus adaptés à votre environnement.
Pour toutes les installations sous Windows et la plupart des installations sous UNIX et Linux, uti-
lisez Cognos Configuration pour configurer les paramètres. Toutefois, si la console rattachée à
l'ordinateur UNIX ou Linux sur lequel vous installez les composants de Cognos 8 ne prend pas en
charge une interface utilisateur graphique Java, vous devez modifier manuellement le fichier cogs-
tartup.xml qui se trouve dans le répertoire emplacement_c8\configuration et exécuter Cognos
Configuration en mode silencieux.
Certaines tâches de configuration sont requises pour tous les types d'installation (p. 15). Par
exemple, vous devez configurer le serveur Web et indiquer les propriétés de connexion à la base de
Si vous répartissez des composants de Cognos 8 sur plusieurs ordinateurs, vous devez effectuer des
tâches de configuration supplémentaires pour vous assurer que les composants peuvent communi-
quer entre eux. L'ordre dans lequel vous configurez et démarrez les composants est également
important.
D'autres tâches de configuration sont facultatives et dépendent de votre environnement Cognos.
Utilisez ces tâches facultatives pour personnaliser votre configuration afin que Cognos 8 s'intègre
aisément à l'environnement existant. Par exemple, vous pouvez configurer les fonctions de Cognos
Application Firewall ou indiquer la quantité de ressources utilisées par Cognos 8. Vous pouvez
également afficher le contenu de Cognos à l'aide d'un portail tiers en configurant Portal Services.
Vous pouvez configurer Cognos 8 pour l'utilisation d'autres ressources, telles que l'emploi d'un
fournisseur d'authentification et l'activation du code d'accès unique pour les utilisateurs et la con-
nexion à la base de données.
Si vous utilisez un système d'équilibrage de charge dans votre environnement, vous pouvez modi-
fier les paramètres pour améliorer les performances. Par exemple, vous pouvez équilibrer des
demandes parmi les distributeurs en modifiant leur capacité de traitement ou en définissant le
nombre maximal et minimal de processus et de connexions. Pour en savoir davantage sur l'optimi-
sation des performances des serveurs, reportez-vous au Guide d'administration et de sécurité.
Si vous effectuez une mise à niveau à partir de ReportNet, vous avez le choix entre plusieurs
options de configuration, selon que vous souhaitez continuer à utiliser votre installation existante.
Pour en savoir davantage sur les options de mise à niveau, reportez-vous à la section Observations
concernant la mise à niveau de Cognos 8.
Démarrage de Cognos Configuration

Utilisez l'outil Cognos Configuration pour configurer Cognos 8 ou pour démarrer et arrêter les
services Cognos.
Le compte sous lequel Cognos 8 fonctionne doit avoir accès à toutes les ressources requises, telles
que des imprimantes et des serveurs Web. Par exemple, sous Windows, pour imprimer des rap-
ports à l'aide d'une imprimante réseau, il faut que le compte ait accès à celle-ci, ou que vous attri-
buiez un compte de connexion au service Cognos 8. Sous Windows, vous pouvez configurer le
service Cognos 8 pour qu'il utilise un compte d'utilisateur spécial en sélectionnant le service
Cognos 8 dans la liste de services affichée dans la fenêtre Services.
Avant de démarrer Cognos Configuration, vérifiez que l'environnement d'exploitation est confi-
guré correctement. Ainsi, assurez-vous que toutes les variables ont été définies.

Vous devez démarrer Cognos Configuration à la dernière page de l'Assistant d'installation sous
Windows, UNIX ou Linux si aucune configuration complémentaire n'est requise. Par exemple, si
vous utilisez un serveur de base de données autre que Microsoft SQL comme base de données
Content Store, nous vous conseillons de copier les pilotes JDBC vers l'emplacement approprié
avant de démarrer l'outil de configuration.
Pour démarrer Cognos Configuration sur un ordinateur Windows :
• Dans le menu Démarrer, cliquez sur Programmes, sélectionnez Cognos 8 et cliquez sur
Pour démarrer Cognos Configuration sur un ordinateur UNIX ou Linux :
• Ouvrez le répertoire emplacement_c8/bin et saisissez
./cogconfig.sh
Configuration d'installations à un seul ordinateur

Si vous installez tous les composants du serveur Cognos sur un même ordinateur, certaines tâches
de configuration sont indispensables pour que ces composants fonctionnent dans votre environne-
ment Cognos.
Des tâches de configuration supplémentaires sont requises si l'un des outils de modélisation de
Windows, Framework Manager ou Metric Designer, est installé sur un ordinateur distinct.
Si vous modifiez la valeur d'une propriété, vous devez enregistrer la configuration et redémarrer le
service Cognos 8 pour appliquer les nouveaux paramètres à votre ordinateur.
Avant de configurer Cognos 8, vérifiez les points suivants :
• tous les composants du serveur Cognos sont installés sur un même ordinateur,
• un serveur Web est installé, configuré et actif sur le même ordinateur que les composants de
Cognos 8,
• vous avez créé la base de données Content Store et, si vous utilisez Metric Studio, vous avez
créé les bases de données associées aux bibliothèques d'indicateurs sur un ordinateur disponi-
ble du réseau,
• un navigateur Web est installé et configuré sur le même ordinateur que Cognos 8.
❑ Définition des propriétés de connexion à la base de données Content Store
❑ Configuration d'un compte de serveur de messagerie
❑ Création d'un pack d'indicateurs, s'il y a lieu
❑ Test de l'installation et de la configuration
❑ Finalisation de la configuration
Une fois ces tâches de configuration effectuées, vous pouvez modifier le comportement implicite
de Cognos 8 (p. 115) afin de mieux l'adapter à votre environnement Cognos. Vous pouvez égale-
ment configurer les outils de modélisation Windows, Framework Manager (p. 109) et Metric
Designer (p. 112).
Définition des propriétés de connexion à la base de données Content Store

Pour toutes les installations qui n'utilisent pas la base de données de contenu de Cognos, vous
devez fournir des informations sur le serveur de base de données pour vous assurer que Content
Manager peut se connecter à la base de données Content Store. Content Manager utilise la con-
nexion à la base de données pour accéder à Content Store. Après avoir défini les propriétés de
connexion à la base de données, vous pouvez tester la connexion entre Content Manager et la base
Assurez-vous que vous avez utilisé l'un des serveurs de base de données pris en charge pour créer
la base de données Content Store.
90
Remarque : Certains serveurs de base de données sont disponibles avec des fonctions avancées.
Lorsque vous sélectionnez une base de données avancée, Cognos 8 utilise les fonctions du serveur
de base de données pour gérer la connexion. Si vous sélectionnez la base de données Oracle avan-
cée, par exemple, Cognos 8 utilise les fonctions orientées entreprise d'Oracle pour sélectionner un
écouteur, passer à un autre écouteur si le premier échoue, se reconnecter automatiquement à la
base de données si la connexion échoue ou encore équilibrer les demandes de connexion parmi les
écouteurs et parmi les distributeurs.
Cognos 8 requiert le protocole TCP/IP pour accéder aux données et à la base de données Content
Store. Assurez-vous que le protocole TCP/IP est défini pour le serveur de base de données.
Si vous effectuez une mise à niveau à partir de ReportNet, configurez Cognos 8 pour qu'il pointe
vers la base de données Content Store existante. Après avoir enregistré la configuration et démarré
le service Cognos 8, la base de données Content Store est automatiquement mise à niveau et ne
peut plus être utilisée par ReportNet. Si ReportNet continue à s'exécuter, vous devez configurer
Cognos 8 pour qu'il pointe vers une nouvelle base de données Content Store.
Procédure pour Microsoft SQL Server, Oracle, DB2 et Sybase

1. Sur l'ordinateur où vous avez installé Content Manager, démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, dans la section Accès aux données, Content Manager, cliquez
avec le bouton droit de la souris sur l'option Content Store, puis sélectionnez Supprimer.
Cette opération supprime la ressource implicite. Content Manager doit être configuré de
façon à accéder à une seule base de données Content Store.
3. Cliquez avec le bouton droit de la souris sur l'option Content Manager, puis cliquez sur Nou-
velle ressource et Base de données.
4. Dans la zone Nom, saisissez un nom pour la ressource.
5. Dans la zone Type, sélectionnez le type de base de données, puis cliquez sur le bouton OK.
Si vous procédez à une mise à niveau et que vous souhaitez utiliser une base de données Con-
tent Store existante, veillez à sélectionner le type de base de données utilisé pour la version
précédente de ReportNet.
Si vous avez installé plusieurs versions de Cognos 8, vous devez utiliser une base de données
Content Store différente pour chaque version. Lorsqu'une base de données Content Store est
utilisée par une nouvelle version de Cognos 8, elle ne peut pas être utilisée par une version
antérieure de ReportNet.
Conseil : Si vous utilisez la paire Net8 de type « mot-clé et valeur » d'Oracle pour gérer la
connexion à la base de données, sélectionnez Base de données Oracle (options avancées).
6. Dans la fenêtre Propriétés, fournissez des valeurs en fonction du type de base de données :
• Si vous utilisez une base de données Microsoft SQL Server, saisissez les valeurs appro-
priées pour les propriétés Serveur de base de données et numéro de port et Nom de la base
de données.
Vous pouvez utiliser un numéro de port, tel que 1433 ou une instance nommée, en tant
que valeur de la propriété Serveur de base de données et numéro de port.
Pour vous connecter à une instance nommée, vous devez indiquer son nom en tant que
propriété URL JDBC ou source de données. Si aucune propriété de nom d'instance n'est
indiquée, une connexion à l'instance implicite est créée.
Par exemple, une URL JDBC
jdbc:JSQLConnect://localhost\\instance1/user=sa/<autres propriétés si nécessaire>
• Si vous utilisez une base de données DB2, pour la propriété Nom de la base de données,
saisissez le pseudonyme de la base de données.
• Si vous utilisez une base de données Oracle, saisissez les valeurs appropriées pour les pro-
priétés Serveur de base de données et numéro de port et Nom du service.
• Si vous utilisez une base de données Oracle avancée, pour la propriété Identificateur de
base de données, saisissez la paire Net8 de type « mot-clé et valeur » d'Oracle pour la
connexion.
Par exemple :
(description=(address=(host=myhost)(proto-
col=tcp)(port=1521)(connect_data=(sid=(orcl)))

• Si vous utilisez une base de données Sybase, saisissez les valeurs appropriées pour les pro-
priétés Serveur de base de données et numéro de port et Nom de la base de données.
7. Si vous souhaitez modifier les références d'identification de connexion, précisez un code d'uti-
lisateur et un mot de passe :
• Cliquez sur la zone Valeur en regard de la propriété Code d'utilisateur et mot de passe,
puis cliquez sur le bouton d'édition quand il s'affiche.
• Dans la boîte de dialogue Valeur - Code d'utilisateur et mot de passe, saisissez les valeurs
appropriées, puis cliquez sur le bouton OK.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Les références d'identification pour la connexion sont immédiatement chiffrées.
9. Testez la connexion entre Content Manager et la base de données Content Store. Dans la fenê-
tre Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle base de données, puis
cliquez sur Tester.
Content Manager se connecte à la base de données, vérifie les droits d'accès de celle-ci, puis
crée une table et la complète. La table n'est pas supprimée et est utilisée à chaque exécution du
test.
Content Manager peut désormais créer les tables requises dans la base de données Content Store
lors du premier démarrage du service Cognos 8. Si les propriétés de connexion ne sont pas correc-
tement définies, les tables ne sont pas créées et vous ne pouvez pas vous connecter à Cognos Con-
nection.
Si vous procédez à une mise à niveau à partir de ReportNet, Content Manager peut désormais
accéder aux tables requises dans la base de données Content Store utilisée pour la version précé-
dente.
Définition d'un compte de serveur de messagerie et d'une base de données de

notification
Si vous désirez envoyer des rapports par courrier électronique, vous devez configurer un compte
de serveur de messagerie. Vous devez également préciser l'emplacement de la base de données uti-
lisée par le serveur de notification pour stocker les données relatives aux travaux et aux calen-
driers.
Si vous utilisez une installation répartie (par exemple pour l'équilibrage de la charge), vous devez
configurer tous les ordinateurs Content Manager et ceux des composants d'application pour qu'ils
utilisent la même base de données pour la notification.
Par défaut, le serveur de notification utilise la même base de données que celle utilisée par Content
Manager comme base de données Content Store. Vous pouvez utiliser une autre base de données
pour la notification. Si vous le faites, assurez-vous que la base de données de notification existe et
que tous les ordinateurs Content Manager sont configurés pour son utilisation.
Une fois que vous avez fini de configurer un compte de serveur de messagerie et une base de don-
nées de notification, vous pouvez tester les connexions à ces deux éléments.
Conseil : Pour être en mesure d'ouvrir des rapports envoyés par courrier électronique, vous devez
remplacer la partie correspondant au nom d'hôte localhost dans l'URI de la passerelle par
l'adresse IP ou par le nom de l'ordinateur. Sinon, l'adresse URL du courrier électronique contien-
dra la chaîne localhost, ce qui empêchera les utilisateurs distants d'ouvrir le rapport.
Si vous procédez à une mise à niveau à partir de ReportNet, Cognos 8 utilise les paramètres et le
compte de serveur de messagerie définis pour ReportNet.
Procédure
1. Démarrez Cognos Configuration sur chaque ordinateur où est installé Content Manager.
2. Dans la fenêtre Explorateur, dans la section Accès aux données, cliquez sur l'option Notifica-
tion.
3. Dans la fenêtre Propriétés, pour la propriété Serveur de messagerie SMTP, saisissez le nom
d'hôte et le port du serveur de messagerie SMTP (sortant).
4. Cliquez sur la zone Valeur à côté de la propriété Code d'utilisateur et mot de passe, puis cli-
quez sur le bouton d'édition quand il s'affiche.
92
5. Saisissez les valeurs appropriées dans la boîte de dialogue Valeur - Compte et mot de passe,
puis cliquez sur le bouton OK.
Conseil : Si les références d'identification de connexion ne sont pas requises pour le serveur
SMTP, supprimez les informations implicites pour la propriété Code d'utilisateur et mot de
passe. Lorsque vous êtes invité à confirmer que cette propriété 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 fenêtre Propriétés, saisissez les valeurs appropriées pour le compte de l'expéditeur
implicite.
Conseil : Si vous utilisez la base de données de notification implicite, vous n'avez pas besoin
d'exécuter les étapes suivantes.
7. Identifiez la base de données utilisée pour la notification :
• Dans la fenêtre de l'Explorateur, cliquez avec le bouton droit de la souris sur l'option
Notification, puis sélectionnez Nouvelle ressource et Base de données.
• Saisissez un nom pour la ressource de base de données.
• Sélectionnez le type de base de données dans le menu déroulant.
• Cliquez sur le bouton OK.
8. Dans la fenêtre Propriétés, saisissez les valeurs pour la ressource de base de données de notifi-
cation.
Si vous utilisez une base de données Microsoft SQL Server, vous pouvez utiliser un numéro de
port, tel que 1433 ou une instance nommée, en tant que valeur de la propriété Serveur de base
de données et numéro de port.
Pour vous connecter à une instance nommée, vous devez indiquer son nom en tant que pro-
priété URL JDBC ou source de données. Si aucune propriété de nom d'instance n'est indiquée,
une connexion à l'instance implicite est créée.
10. Testez les connexions aux serveurs de notification et de messagerie. Dans la fenêtre Explora-
teur, cliquez avec le bouton droit de la souris sur Notification, puis cliquez sur l'option Tester.
Cognos 8 teste la connexion à la base de données et la connexion au serveur de messagerie.
Important : Veillez à ce que les valeurs utilisées pour identifier la ressource de base de données de
notification soient les mêmes sur tous les ordinateurs Content Manager. Pour utiliser la base de
données de notification implicite, vous n'avez pas besoin de modifier les valeurs de la fenêtre Pro-
priétés.
Création d'un pack d'indicateurs

Pour que les utilisateurs puissent exploiter Metric Studio, vous devez créer au moins un pack
d'indicateurs à l'aide de l'Assistant Nouveau pack d'indicateurs. Un pack d'indicateurs est une
représentation Cognos Connection d'une application Metric Studio. Il contient des informations
de connexion, des rapports et des tâches de gestion des indicateurs pour cette application. Le con-
tenu d'un pack d'indicateurs est stocké dans une bibliothèque d'indicateurs.
L'Assistant Nouveau pack d'indicateurs s'affiche automatiquement la première fois que vous accé-
dez à Metric Studio. Cet assistant vous permet d'attribuer un nom au pack d'indicateurs et de défi-
nir la connexion à la source de données de la bibliothèque d'indicateurs. Dans le cas d'une
nouvelle bibliothèque d'indicateurs, vous fournissez également les informations nécessaires à l'ini-
tialisation de la base de données, notamment les dates de début et de fin de l'exercice fiscal. Si la
base de données était utilisée avec une version antérieure à Metric Studio 8.1, vous pouvez mettre
à jour la bibliothèque d'indicateurs à l'aide de l'assistant.
Pour pouvoir utiliser l'assistant Nouveau pack d'indicateurs, vous devez disposer de droits d'accès
à une bibliothèque d'indicateurs employée avec Metrics Manager version 2.0 ou ultérieure, ou
bien créer une base de données pour une nouvelle bibliothèque d'indicateurs (p. 75).

Procédure
1. Démarrez Cognos Connection.
2. Cliquez sur Metric Studio.
L'assistant Nouveau pack d'indicateurs s'affiche.
3. Saisissez le nom et la description représentant ce pack d'indicateurs pour l'application Metric
Studio, puis cliquez sur Suivant.
4. Cliquez sur Nouvelle source de données.
5. Saisissez le nom et la description de la connexion à la source de données correspondant à la
bibliothèque d'indicateurs contenant les données de ce pack d'indicateurs, puis cliquez sur
Suivant.
6. Dans la zone Type, sélectionnez le type de base de données, puis cliquez sur Suivant.
7. Fournissez les informations requises pour ce type de base de données :
• Pour une base de données Microsoft SQL Server, saisissez le nom du serveur de base de
données et celui de la base de données elle-même. Dans la section Codes d'accès, cochez
les cases Mot de passe et Créer un code d'accès pour le groupe 'Tous', puis saisissez le
code d'utilisateur et le mot de passe du compte utilisateur ayant accès à cette base de don-
nées.
• Pour une base de données Oracle, saisissez la chaîne de connexion. Dans la section Code
d'utilisateur, cochez les cases Mot de passe et Créer un code d'accès pour le groupe
'Tous', puis saisissez le code d'utilisateur et le mot de passe du compte utilisateur ayant
accès à cette base de données.
• Pour une base de données DB2, saisissez le nom de la base de données et la chaîne de con-
nexion. Sélectionnez l'option Code d'utilisateur, cochez les cases Mot de passe et Créer un
code d'accès pour le groupe 'Tous', puis saisissez le code d'utilisateur et le mot de passe
du compte utilisateur ayant accès à cette base de données.
Conseil : Pour tester si les paramètres sont corrects, cliquez sur le bouton Tester.
8. Cliquez sur les boutons Suivant puis Terminer.
9. Sélectionnez la nouvelle source de données, puis cliquez sur Suivant.
10. Cliquez sur Suivant et suivez les invites pour saisir les informations nécessaires à l'initialisa-
tion de la base de données. Lorsque vous arrivez sur la page de récapitulatif des détails de la
source de données et des paramètres de la bibliothèque d'indicateurs, cliquez sur l'option Ini-
tialiser.
11. Cliquez sur le bouton Terminer.
Metric Studio s'ouvre et le nouveau pack d'indicateurs s'affiche dans Cognos Connection. Pour en
savoir davantage sur la gestion de la bibliothèque d'indicateurs, et notamment sur la méthode de
chargement des données, reportez-vous au Guide d'administration et de sécurité de Cognos 8.
Procédure avec une bibliothèque d'indicateurs existante

Suivant.
nées.
94
10. Cliquez sur l'option Mettre à niveau.
L'assistant met à niveau les schémas et autres informations de la base de données.
savoir davantage sur la gestion de la bibliothèque d'indicateurs, reportez-vous au Guide d'admi-
nistration et de sécurité.
Test de l'installation et de la configuration

Vous pouvez tester vos paramètres de configuration en exécutant la fonction de test avant de
démarrer le service Cognos 8. Vous avez ensuite la possibilité de tester l'installation en démarrant
le service Cognos 8, puis en ouvrant Cognos Connection. Si vous avez installé Framework Mana-
ger ou Metric Designer, vous pouvez tester ces applications en les lançant et en créant un projet.
Si vous avez installé Metric Studio et créé un pack, vous avez déjà testé votre installation et votre
configuration. Vous pouvez créer un pack d'indicateurs uniquement si Metric Studio est installé et
configuré correctement.
Pour pouvoir utiliser Framework Manager ou Metric Designer, vous devez démarrer le service
Cognos 8. Sous Windows, le service Cognos 8 est configuré par défaut pour démarrer automati-
quement. Sous UNIX et Linux, vous devez configurer le processus Cognos 8 comme démon pour
qu'il démarre automatiquement. Pour en savoir davantage, reportez-vous à la documentation sur
le système d'exploitation.
Vous devez installer et configurer Framework Manager et les composants du serveur Cognos 8
pour pouvoir utiliser Cognos 8 pour la production de rapports.
Remarque : Cognos 8 ne peut accéder à aucune des données du rapport avant qu'elles ne soient
organisées en packs et publiées dans Framework Manager.
Procédure
2. Veillez à enregistrer la configuration, sans quoi vous ne serez pas en mesure de démarrer le
service Cognos 8.
Lorsque vous procédez à une mise à niveau, un message indiquant la détection de fichiers de
configuration et leur mise à niveau s'affiche.
3. Dans le menu Opérations, cliquez sur l'option Tester.
Cognos Configuration vérifie la disponibilité des clés symétriques communes (CSK), teste la
configuration de l'espace-noms et contrôle les connexions à la base de données Content Store
et à la base de données de journalisation.
Si vous utilisez la base de données de notification et le serveur de messagerie, Cognos Configu-
ration les teste également.
Conseil : Si l'option Tester ne peut pas être sélectionnée, cliquez sur Configuration locale dans
la fenêtre Explorateur.
4. Si le test échoue, reconfigurez les propriétés concernées, puis exécutez à nouveau le test.
Démarrez le service uniquement lorsque tous les tests ont abouti.
5. Dans le menu Opérations, cliquez sur l'option Démarrer.
Le démarrage du service Cognos 8 peut prendre quelques minutes.

Cette opération démarre tous les services installés qui n'étaient pas en cours d'exécution. Si
vous souhaitez démarrer un service spécifique, sélectionnez le nœud du service dans la fenêtre
Explorateur et cliquez sur Démarrer dans le menu Opérations.
6. Ouvrez un navigateur Web.
7. Démarrez Cognos Connection en saisissant ce qui suit, où cognos8 correspond au répertoire
virtuel que vous avez créé pendant la configuration du serveur Web :
• Pour la passerelle CGI :
http://nom_hôte:port/cognos8
• Pour une passerelle ISAPI :
http://nom_hôte:port/cognos8/isapi
• Pour le connecteur Apache sous Windows :
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.dll
• Pour le connecteur Apache sous Solaris et AIX :
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.so
• Pour le connecteur Apache sous HP-UX :
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.sl
• Pour un servlet de passerelle :
http://nom_hôte:port/racine_contexte/servlet/ Gateway
L'ouverture de la page Web peut prendre quelques minutes. Si la page Bienvenue de Cognos
Connection s'affiche, cela signifie que l'installation fonctionne.

1. Démarrez le service Cognos 8.
2. Pour démarrer Framework Manager, dans le menu Démarrer, cliquez successivement sur les
options Programmes, Cognos 8 et Framework Manager.
Si la version du schéma de modèle est antérieure à 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 fonc-
tionne.

2. Pour démarrer Metric Designer, dans le menu Démarrer, cliquez successivement sur les
options Programmes, Cognos 8 et Metric Designer.
Si la page d'accueil de Metric Designer s'affiche, cela signifie que l'installation fonctionne.
Finalisation de la configuration
Après avoir effectué les tâches de configuration requises, vous pouvez exécuter des tâches de con-
figuration supplémentaires pour personnaliser le comportement de Cognos 8 afin de l'adapter à
votre environnement Cognos (p. 115). Vous avez également la possibilité d'ajouter des ressources
et notamment de configurer Cognos 8 pour l'utilisation d'un fournisseur d'authentification
(p. 165).
Il est recommandé d'indiquer la quantité de ressources utilisée par le service Cognos 8 pour garan-
tir l'optimisation des performances.
Configuration d'installations réparties

Pour améliorer les performances ou la sécurité, vous pouvez installer l'un des composants suivants
sur un ordinateur séparé :
• passerelle
• composants d'application
• Content Manager
96
• Base de données de contenu de Cognos

Pour en savoir davantage sur la planification d'une installation répartie, reportez-vous au manuel
Architecture and Planning Guide.
Vous pouvez installer la passerelle, les composants d'application et Content Manager sur plusieurs
ordinateurs.
Si vous procédez à une mise à niveau à partir de ReportNet, tous les composants répartis doivent
correspondre à la même version de Cognos 8. Si vous installez Cognos 8 dans de nouveaux empla-
cements, vous devez les mettre à jour à l'aide de Cognos Configuration.
Si vous installez les composants de Cognos 8 sur plusieurs ordinateurs, vous devez configurer les
propriétés de l'environnement afin que les composants répartis puissent communiquer entre eux :
• Les ordinateurs Content Manager doivent connaître l'emplacement de la base de données
Content Store, des autres ordinateurs Content Manager et de la base de données utilisée pour
la notification.
• L'ordinateur passerelle doit connaître l'emplacement d'au moins un distributeur.
Le distributeur doit être situé sur un serveur de rapports.
• L'ordinateur des composants d'application doit connaître l'emplacement des ordinateurs
Content Manager et de la base de données à utiliser pour les données relatives aux travaux et
aux calendriers.
Vous devez également configurer les propriétés cryptographiques pour vous assurer que chaque
ordinateur utilise les mêmes paramètres.
Dans un environnement réparti, l'ordre dans lequel vous configurez les ordinateurs est important.
Vous devez configurer et démarrer les services sur au moins un ordinateur sur lequel Content
Manager est installé avant de configurer d'autres ordinateurs dans votre environnement Cognos.
Vous devez configurer l'ordinateur passerelle en dernier pour que les clés cryptographiques soient
partagées et que la communication sécurisée s'effectue entre les trois composants. Le serveur indi-
qué pour la propriété URI externe du distributeur sur l'ordinateur passerelle doit être le dernier
serveur que vous démarrez.
D'autres tâches de configuration, telles que l'utilisation d'un fournisseur d'authentification
(p. 165) ou bien l'activation et la désactivation de services (p. 120), sont facultatives et modifient
le comportement implicite des composants de Cognos 8 afin de mieux l'adapter à vos objectifs en
matière de production de rapports ou de tableaux de bord.
❑ Configuration des ordinateurs Content Manager
❑ Configuration des ordinateurs des composants d'application
❑ Configuration des ordinateurs passerelle
❑ Création d'un pack d'indicateurs, s'il y a lieu
❑ Configuration des ordinateurs Framework Manager, s'il y a lieu
❑ Configuration des ordinateurs Metric Designer, s'il y a lieu
❑ Test de l'installation et de la configuration
❑ Finalisation de la configuration
Une fois ces tâches de configuration effectuées, vous pouvez modifier le comportement implicite
des composants de Cognos 8 (p. 115) afin de mieux l'adapter à votre environnement Cognos.
Vous avez également la possibilité d'ajouter des ressources et notamment de configurer Cognos 8
pour l'utilisation d'un fournisseur d'authentification (p. 165).
Il est recommandé d'indiquer la quantité de ressources utilisée par le service Cognos 8 pour garan-
tir l'optimisation des performances.

Configuration des ordinateurs Content Manager

Dans une installation répartie, au moins un des ordinateurs sur lequel vous avez installé Content
Manager doit être configuré, actif et accessible avant que vous ne configuriez d'autres ordinateurs
dans votre environnement 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
Cognos.
Il est possible que votre installation comprenne plusieurs applications Content Manager, chacune
sur un ordinateur différent. Un ordinateur Content Manager peut être activé et un ou plusieurs
autres en attente. Les ordinateurs Content Manager en attente sont destinés à la protection de
reprise. Si l'ordinateur Content Manager activé n'est pas disponible à cause d'une panne logicielle
ou matérielle, un ordinateur Content Manager en attente est activé et les demandes sont dirigées
vers ce dernier.
En cas de défaillance du service Content Manager actif, les données de session non enregistrées
sont perdues. Lorsqu'un autre service Content Manager devient actif, les utilisateurs peuvent être
invités à se connecter.
Le premier ordinateur Content Manager à démarrer devient l'ordinateur Content Manager actif
par défaut. À l'aide de l'outil Administration, vous pouvez définir un autre ordinateur Content
Manager comme ordinateur actif par défaut. Pour en savoir davantage sur l'activation d'un ser-
vice Content Manager, reportez-vous au Guide d'administration et de sécurité.
Pour prendre en charge la protection de reprise, vous devez synchroniser les horloges système sur
les ordinateurs Content Manager.
Avant de configurer Content Manager, assurez-vous d'avoir créé la base de données Content Store
sur un ordinateur disponible du réseau.
Si vous installez la base de données de contenu de Cognos sur le même ordinateur que Content
Manager, Content Manager sera configuré pour utiliser la base de données de contenu de Cognos
de façon implicite. Si vous installez la base de données de contenu de Cognos sur un autre ordina-
teur, vous devez en configurer les propriétés de connexion à la base de données dans Content
Manager. Si vous n'installez pas la base de données de contenu de Cognos, la configuration impli-
cite de la connexion est définie pour une base de données Microsoft SQL Server.
Si vous installez la base de données de contenu de Cognos sur le même ordinateur que Content
Manager, et que vous décidez ensuite d'utiliser une autre base de données pour votre Content
Store, vous devez désinstaller la base de données de contenu de Cognos.
Si vous procédez à une mise à niveau à partir de ReportNet, vous pouvez utiliser les données de
configuration existantes. Toutefois, certaines fonctions de Cognos 8 sont nouvelles. Il est conseillé
de configurer ces nouvelles fonctions.
Utilisez la liste de contrôle suivante comme guide pour la configuration des ordinateurs Content
Manager :
❑ Définition des propriétés de connexion à la base de données Content Store
❑ Définition d'un compte de serveur de messagerie et d'une base de données de notification
❑ Configuration des propriétés d'environnement
❑ Démarrage du service Cognos 8
Définition des propriétés de connexion à la base de données Content Store

Vous devez fournir des informations sur le serveur de base de données pour vous assurer que Con-
tent Manager peut se connecter à la base de données Content Store. Content Manager utilise la
connexion à la base de données pour accéder à Content Store. Après avoir défini les propriétés de
connexion à la base de données, vous pouvez tester la connexion entre Content Manager et la base
98
Si vous avez installé la base de données de contenu de Cognos sur un ordinateur différent de celui
où vous avez installé Content Manager, vous devez définir les propriétés de connexion à la base de
données de contenu de Cognos. Si vous avez installé la base de données de contenu de Cognos sur
le même ordinateur que Content Manager, Content Manager sera configuré pour utiliser la base
de données de contenu de Cognos avec les valeurs implicites. Si vous installez la base de données
de contenu de Cognos sur le même ordinateur que Content Manager, et que vous décidez ensuite
d'utiliser une autre base de données pour votre Content Store, vous devez désinstaller la base de
données de contenu de Cognos.
Assurez-vous que vous avez utilisé l'un des serveurs de base de données pris en charge pour créer
la base de données Content Store.
Remarque : Certains serveurs de base de données sont disponibles avec des fonctions avancées.
Lorsque vous sélectionnez une base de données avancée, les composants de Cognos 8 utilisent les
fonctions du serveur de base de données pour gérer la connexion. Si vous sélectionnez la base de
données Oracle avancée, par exemple, les composants de Cognos 8 utilisent les fonctions orientées
entreprise d'Oracle pour sélectionner un écouteur, passer à un autre écouteur si le premier échoue,
se reconnecter automatiquement à la base de données si la connexion échoue ou encore équilibrer
les demandes de connexion parmi les écouteurs et parmi les distributeurs.
Les composants de Cognos 8 requièrent le protocole TCP/IP pour accéder aux données et à la base
de données Content Store. Assurez-vous que le protocole TCP/IP est défini pour le serveur de base
de données.
Si vous utilisez Oracle, il n'est pas nécessaire d'installer un client Oracle sur le même ordinateur
que Content Manager. Toutefois, Content Manager requiert un pilote JDBC Oracle appelé
classes12.jar. Ce pilote est disponible dans le répertoire d'installation du client ou serveur Oracle ;
il peut également être téléchargé à partir du site Web Oracle Technology Network
(http://www.oracle.com/technology). Le fichier du pilote classes12.jar doit être copié dans le
répertoire emplacement_c8\p2pd\WEB-INF\lib dans lequel est installé Content Manager.
Si vous effectuez une mise à niveau à partir de ReportNet, configurez Cognos 8 pour qu'il pointe
vers la base de données Content Store existante. Après avoir enregistré la configuration et démarré
le service Cognos 8, la base de données Content Store est automatiquement mise à niveau et ne
peut plus être utilisée par ReportNet. Si vous conservez ReportNet, vous devez configurer Cognos
8 pour qu'il pointe vers une nouvelle base de données Content Store.
Procédure pour la base de données de contenu de Cognos

2. Dans la fenêtre Explorateur, dans la section Accès aux données, Content Manager, cliquez sur
l'option Content Store.
Les propriétés sont affichées.
3. Saisissez le nom de l'ordinateur sur lequel vous avez installé la base de données de contenu de
Cognos dans la propriété Serveur de base de données et numéro de port.
Par exemple, saisissez le nom de l'ordinateur à la place de localhost.
Vous n'avez pas besoin de modifier les valeurs restantes si vous n'avez pas changé les paramè-
tres implicites après l'installation de la base de données de contenu de Cognos.
tre Explorateur, cliquez avec le bouton droit de la souris sur Content Store, puis cliquez sur
l'option Tester.

Vous devez démarrer le service de la base de données de contenu de Cognos sur l'ordinateur
sur lequel vous l'avez installé pour réussir le test.
test.

de données.
connexion.
Par exemple :
100

cliquez sur Tester.
test.
Content Manager peut désormais créer les tables requises dans la base de données Content Store
lors du premier démarrage du service Cognos 8. Si les propriétés de connexion ne sont pas correc-
tement définies, les tables ne sont pas créées et vous ne pouvez pas vous connecter à Cognos Con-
nection.
Si vous procédez à une mise à niveau à partir de ReportNet, Content Manager peut désormais
accéder aux tables requises dans la base de données Content Store utilisée pour ReportNet.
Définition d'un compte de serveur de messagerie et d'une base de données de notification

driers.
Si vous utilisez une installation répartie (par exemple pour l'équilibrage de la charge), vous devez
configurer tous les ordinateurs Content Manager et ceux des composants d'application pour qu'ils
utilisent la même base de données pour la notification.
Par défaut, le serveur de notification utilise la même base de données que celle utilisée par Content
Manager comme base de données Content Store. Vous pouvez utiliser une autre base de données
pour la notification. Si vous le faites, assurez-vous que la base de données de notification existe et
que tous les ordinateurs Content Manager sont configurés pour son utilisation.
compte de serveur de messagerie définis pour la version précédente.
Procédure
tion.
implicite.

cation.
Important : Veillez à ce que les valeurs utilisées pour identifier la ressource de base de données de
notification soient les mêmes sur tous les ordinateurs Content Manager. Pour utiliser la base de
données de notification implicite, vous n'avez pas besoin de modifier les valeurs de la fenêtre Pro-
priétés.
Configuration des propriétés d'environnement pour les ordinateurs Content Manager

Après avoir installé Content Manager sur les ordinateurs que vous utilisez pour la protection de
reprise, vous devez configurer Content Manager sur ces ordinateurs. Si vous avez installé plusieurs
ordinateurs Content Manager, vous devez répertorier tous les URI de Content Manager sur cha-
que ordinateur Content Manager. Si vous procédez à une mise à niveau, vous devez également
ajouter les URI de Content Manager en attente à l'ordinateur d'origine Content Manager.
Une fois les tâches de configuration requises effectuées, le service de l'autorité de certification est
disponible pour l'émission de certificats à l'attention d'autres ordinateurs Cognos. Vous pouvez
ensuite exécuter les tâches de configuration requises sur d'autres ordinateurs, tels que l'ordinateur
des composants d'application et les ordinateurs passerelle. Vous pouvez par ailleurs continuer à
configurer les ordinateurs Content Manager en modifiant les paramètres de propriété implicites
(p. 115) afin de les adapter à votre environnement. Par exemple, vous pouvez configurer les com-
posants de Cognos 8 pour qu'ils utilisent un fournisseur d'authentification (p. 165), activer et
désactiver des services (p. 120) sur les ordinateurs Content Manager ou modifier les paramètres
globaux (p. 131).
Important : Si vous modifiez les paramètres globaux sur l'un des ordinateurs Content Manager,
vous devez effectuer les mêmes modifications sur les autres ordinateurs Content Manager.
Procédure pour le premier ordinateur Content Manager

1. Sur l'ordinateur Content Manager que vous désignez comme ordinateur actif par défaut,
démarrez Cognos Configuration.
Conseil : Il est recommandé d'utiliser l'ordinateur comportant le processeur le plus rapide en
tant qu'ordinateur Content Manager actif par défaut.
3. Dans la fenêtre Propriétés, cliquez sur la valeur de l'option URI de Content Manager, puis cli-
quez sur le bouton d'édition.
4. Indiquez les URI pour les autres ordinateurs Content Manager :
• Dans la boîte 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.
102
Ne supprimez pas la première valeur de la table. Cette valeur est nécessaire et identifie
l'ordinateur Content Manager local.
• Répétez les deux étapes précédentes (indiquées par des puces) pour chaque URI à ajouter.
Important : Vous devez inclure tous les URI de Content Manager dans la liste.
5. Dans la fenêtre Explorateur, dans la section Sécurité, cliquez sur l'option Cryptographie.
6. Dans la section Paramètres CSK de la fenêtre Propriétés, assurez-vous que l'option Vou-
lez-vous créer une bibliothèque de clés symétriques ? est définie sur la valeur Vrai.
La bibliothèque de clés doit être créée sur l'ordinateur Content Manager actif par défaut.
7. Définissez l'option Stocker la clé symétrique localement sur la valeur Vrai.
Dès que les composants de Cognos 8 démarrent, cet ordinateur devient l'ordinateur Content
Manager actif par défaut.
Procédure pour les ordinateurs Content Manager en attente

1. Assurez-vous que les propriétés d'environnement sont déjà configurées sur au moins un ordi-
nateur Content Manager et que les composants de Cognos 8 sont actifs sur cet ordinateur.
2. Démarrez Cognos Configuration sur l'ordinateur Content Manager en attente.
5. Indiquez les URI pour les autres ordinateurs Content Manager :
Manager.
Ne supprimez pas la première valeur de la table. Cette valeur est nécessaire et identifie
l'ordinateur Content Manager local.
7. Dans la fenêtre Propriétés, dans la section Paramètres CSK, définissez l'option Voulez-vous
créer une bibliothèque de clés symétriques ? sur la valeur Faux.
La bibliothèque de clés doit être créée sur l'ordinateur Content Manager actif par défaut. Une
installation de Cognos ne peut contenir qu'une seule bibliothèque de clés.
8. Dans la fenêtre Explorateur, dans la section Sécurité, Cryptographie, cliquez sur l'option
Cognos, fournisseur cryptographique implicite.
9. Dans le groupe de propriétés Paramètres de l'autorité de certification, définissez la propriété
Mot de passe de telle sorte qu'elle corresponde à celle configurée sur l'ordinateur Content
10. Assurez-vous que tous les autres paramètres cryptographiques correspondent à ceux que vous
avez configurés dans l'ordinateur Content Manager actif par défaut.
11. Dans la fenêtre Explorateur, dans la section Accès aux données, Content Manager, cliquez sur
l'option Content Store.
12. Assurez-vous que toutes les autres propriétés correspondent à celles que vous avez configurées
dans l'ordinateur Content Manager actif par défaut.

Configuration des ordinateurs des composants d'application

Vous pouvez installer les composants d'application sur un ou plusieurs ordinateurs, en fonction de
Assurez-vous que l'ordinateur sur lequel vous avez installé Content Manager est configuré et dis-
ponible avant de configurer les ordinateurs des composants d'application.
Si vous avez installé plusieurs ordinateurs Content Manager, vous devez répertorier tous les URI
de Content Manager sur chaque serveur de rapports.
Si vous effectuez une mise à niveau à partir de ReportNet, Cognos 8 applique les données de con-
figuration existantes aux ordinateurs des composants d'application. Toutefois, si vous avez ins-
tallé les composants d'application dans un nouvel emplacement, vous devez configurer toutes les
propriétés d'environnement.
Si Content Manager et les composants d'application sont installés sur des ordinateurs différents,
vous devez effectuer les opérations suivantes sur l'ordinateur des composants d'application :
❑ Définir un compte de serveur de messagerie et une base de données de notification.
❑ Configurer les propriétés d'environnement.
❑ Démarrer le service Cognos 8 (s'il est inactif).
D'autres tâches de configuration facultatives peuvent être exécutées ultérieurement.
Une fois ces tâches de configuration effectuées, l'ordinateur des composants d'application peut
fonctionner dans votre environnement.
Définition d'un compte de serveur de messagerie et d'une base de données de notification

driers.
Vous devez configurer tous les serveurs de rapports de façon à ce qu'ils utilisent la même base de
données pour la notification. Vous devez utiliser la même base de données que celle utilisée pour la
notification sur les ordinateurs Content Manager.
compte de serveur de messagerie définis pour la version précédente.
Procédure
tion.
104
implicite.
cation.
Configuration des propriétés d'environnement des ordinateurs des composants d'application

Si vous installez les composants d'application sur un ordinateur autre que Content Manager, vous
devez configurer l'ordinateur des composants d'application afin qu'il connaisse l'emplacement de
Content Manager. Les composants distribués peuvent communiquer entre eux.
Procédure
3. Dans la fenêtre Propriétés, indiquez la valeur appropriée pour l'URI de la passerelle en rem-
plaçant la chaîne localhost par le nom de l'ordinateur passerelle.
5. Modifiez la chaîne localhost de l'URI existant avec le nom de n'importe quel ordinateur Con-
tent Manager.
6. Indiquez les URI pour les ordinateurs Content Manager restants :
Manager.


11. Si vous utilisez Tomcat, dans le menu Opérations, cliquez sur Démarrer.
Après avoir effectué les tâches de configuration requises pour chaque ordinateur des composants
d'application de votre environnement, vous pouvez exécuter les tâches de configuration requises
sur les autres ordinateurs, tels les ordinateurs passerelle. Sinon, vous pouvez poursuivre la confi-
guration des ordinateurs des composants d'application en modifiant les paramètres de propriété
implicites afin de les adapter à votre environnement. Par exemple, vous pouvez activer et désacti-
ver des services (p. 120), configurer la destination des messages de journalisation (p. 128) ou défi-
nir la quantité de ressources utilisée par le service Cognos 8 (p. 121).
Configuration des passerelles

Vous pouvez installer la passerelle sur un ou plusieurs serveurs Web.
Si vous installez la passerelle sur un ordinateur autre que Content Manager ou que celui des com-
posants d'application, vous devez configurer la passerelle afin qu'elle connaisse l'emplacement
d'un distributeur. Un distributeur est installé sur chaque ordinateur Content Manager et des com-
posants d'application. Il est recommandé que la passerelle utilise le distributeur sur un ordinateur
des composants d'application.
Pour la protection de reprise, vous pouvez configurer plusieurs distributeurs pour un même ordi-
nateur passerelle. Lorsque plusieurs distributeurs sont configurés, les demandes sont normalement
acheminées vers le premier distributeur de la liste. Si le distributeur devient indisponible, la passe-
relle identifie le prochain distributeur opérationnel de la liste et lui adresse les demandes. L'état du
distributeur principal est contrôlé par la passerelle et les demandes sont réacheminées vers ce com-
posant lorsqu'il est remis en service.
Vous devez configurer les propriétés d'environnement sur l'ordinateur passerelle.
D'autres tâches de configuration facultatives peuvent être exécutées ultérieurement.
Assurez-vous que les ordinateurs sur lesquels vous avez installé Content Manager sont configurés
et que l'ordinateur Content Manager actif par défaut est disponible avant de configurer les ordina-
teurs passerelle.
Une fois les tâches de configuration effectuées, la passerelle peut fonctionner dans votre environ-
nement.
Procédure
3. Dans la section Paramètres de la passerelle de la fenêtre Propriétés, indiquez les valeurs corres-
pondant à URI du distributeur pour la passerelle :
• Cliquez dans la colonne des valeurs.
• Cliquez sur le bouton d'édition.
• Remplacez la chaîne localhost de l'URI par le nom ou l'adresse IP d'un ordinateur des
Conseil : Pour envoyer des demandes à la passerelle à partir d'une application SDK, il est
recommandé de se connecter à une passerelle réservée qui a été configurée pour se connec-
ter au distributeur à l'aide de l'URI interne du distributeur. Ne modifiez pas votre passe-
relle principale pour utiliser l'URI interne du distributeur. Cela diminuerait le niveau de
sécurité des studios et du portail Cognos 8.
106
• Pour ajouter un autre URI, cliquez sur Ajouter et remplacez la chaîne 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 après avoir ajouté les ordinateurs des composants d'application. Si vous
ajoutez le distributeur à partir de l'ordinateur Content Manager actif, vérifiez qu'il figure
en dernier dans la liste.
• Une fois tous les URI définis, cliquez sur le bouton OK.
7. Testez l'extraction de la clé symétrique. Dans la fenêtre Explorateur, cliquez avec le bouton
droit de la souris sur Cryptographie, puis cliquez sur l'option Tester.
Les composants de Cognos 8 vérifient la disponibilité des clés symétriques communes.
Après avoir effectué les tâches de configuration requises pour chaque passerelle dans votre envi-
ronnement, vous pouvez continuer à configurer les passerelles en modifiant les paramètres de pro-
priété implicites afin de les adapter à votre environnement. Par exemple, vous pouvez configurer
une passerelle de sorte qu'elle utilise un espace-noms.
Création d'un pack d'indicateurs

Pour que les utilisateurs puissent exploiter Metric Studio, vous devez créer au moins un pack
d'indicateurs à l'aide de l'Assistant Nouveau pack d'indicateurs. Un pack d'indicateurs est une
représentation Cognos Connection d'une application Metric Studio. Il contient des informations
de connexion, des rapports et des tâches de gestion des indicateurs pour cette application. Le con-
tenu d'un pack d'indicateurs est stocké dans une bibliothèque d'indicateurs.
L'Assistant Nouveau pack d'indicateurs s'affiche automatiquement la première fois que vous accé-
dez à Metric Studio. Cet assistant vous permet d'attribuer un nom au pack d'indicateurs et de défi-
nir la connexion à la source de données de la bibliothèque d'indicateurs. Dans le cas d'une
nouvelle bibliothèque d'indicateurs, vous fournissez également les informations nécessaires à l'ini-
tialisation de la base de données, notamment les dates de début et de fin de l'exercice fiscal. Si la
base de données était utilisée avec une version antérieure à Metric Studio 8.1, vous pouvez mettre
à jour la bibliothèque d'indicateurs à l'aide de l'assistant.
Pour pouvoir utiliser l'assistant Nouveau pack d'indicateurs, vous devez disposer de droits d'accès
à une bibliothèque d'indicateurs employée avec Metrics Manager version 2.0 ou ultérieure, ou
bien créer une base de données pour une nouvelle bibliothèque d'indicateurs (p. 75).
Procédure
Suivant.

nées.
10. Cliquez sur Suivant et suivez les invites pour saisir les informations nécessaires à l'initialisa-
tion de la base de données. Lorsque vous arrivez sur la page de récapitulatif des détails de la
source de données et des paramètres de la bibliothèque d'indicateurs, cliquez sur l'option Ini-
tialiser.
Procédure avec une bibliothèque d'indicateurs existante

Suivant.
nées.
10. Cliquez sur l'option Mettre à niveau.
L'assistant met à niveau les schémas et autres informations de la base de données.
savoir davantage sur la gestion de la bibliothèque d'indicateurs, reportez-vous au Guide d'admi-
nistration et de sécurité.
108
Configuration des ordinateurs Framework Manager

Après avoir installé Framework Manager sur votre ordinateur Windows, vous le configurez afin
qu'il fonctionne dans votre environnement de production de rapports.
Certaines tâches de configuration sont facultatives. Vous les exécutez pour modifier les valeurs de
propriété implicites utilisées par Framework Manager.
Si vous installez Framework Manager sur le même ordinateur que les composants de Cognos 8 ne
servant pas à la modélisation, aucune configuration n'est nécessaire lorsque vous :
• configurez votre serveur Web en utilisant les répertoires virtuels implicites,
• utilisez les ports implicites,
• utilisez les ressources implicites,
• utilisez les paramètres cryptographiques implicites.
Si vous procédez à une mise à niveau depuis une version précédente de Framework Manager, vous
pouvez utiliser les mêmes modèles et projets que vous avez utilisés avec la version précédente. Pour
mettre à niveau des projets existants, vous devez les ouvrir dans la nouvelle version de Framework
Manager.
Si vous installez Framework Manager sur un ordinateur autre que celui des composants de
Cognos 8 ne servant pas à la modélisation, vous devez effectuer les opérations suivantes :
❑ Configurer les propriétés d'environnement pour les ordinateurs Framework Manager.
❑ Configurer un système de contrôle de la source.
❑ Mettre à niveau les projets de Framework Manager, au besoin.
Configuration des propriétés d'environnement pour les ordinateurs Framework Manager

Si vous installez Framework Manager sur un ordinateur autre que celui des composants de
Cognos 8 ne servant pas à la modélisation, vous devez le configurer pour qu'il communique avec
les autres composants.
Il est recommandé d'installer et de configurer les composants de Cognos 8 avant de configurer
Framework Manager. Vous devez d'abord installer et configurer Content Manager, puis démarrer
le service Cognos 8 sur au moins un ordinateur Content Manager avant de configurer Framework
Manager. Cela garantit que le service d'autorité de certification émet un certificat pour l'ordina-
teur Framework Manager.
Vous devez également configurer les sources de données (p. 85) avant de configurer Framework
Manager.
Vérifiez que le serveur Web est configuré et actif (p. 81).
Important : Si Cognos 8 est installé dans plusieurs emplacements, vérifiez que tous les URI poin-
tent vers la version correcte de ce produit . Framework Manager doit être configuré pour la même
version de Cognos 8.
Installations avec un pare-feu

Vous pouvez configurer Framework Manager pour qu'il accède aux composants de Cognos 8 ne
servant pas à la modélisation par le biais du distributeur ou d'une passerelle dédiée. Si l'ordinateur
sur lequel vous avez installé Framework Manager n'a pas accès au distributeur de Cognos 8 en
raison d'un pare-feu, vous devez configurer Framework Manager pour qu'il accède à Cognos 8
par le biais d'une passerelle dédiée qui est configurée pour accéder au distributeur de Cognos 8.
Dans ce type d'installation, Framework Manager et la passerelle dédiée doivent être situés à l'exté-
rieur du pare-feu et le distributeur doit figurer à l'intérieur de celui-ci. De plus, Framework Mana-
ger doit avoir accès à un serveur Web prenant en charge l'encodage de transfert par bloc et se
trouvant à l'extérieur du pare-feu.
Procédure
1. Sur l'ordinateur où vous avez installé Framework Manager, démarrez Cognos Configuration.
3. Dans la zone URI de la passerelle de la fenêtre Propriétés, saisissez la valeur appropriée.
• 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,
Pour le module Apache 2.0,
http://nom_hôte:port/cognos8/cgi-bin/mod2_cognos.dll
Remarque : Vérifiez que vous avez configuré le serveur Web Apache (p. 137).
• Pour utiliser une passerelle servlet, saisissez la syntaxe suivante :
http[s]://nom_hôte:port/racine_contexte/servlet/Gateway
où racine_contexte est la valeur que vous avez attribuée à l'application Web ServletGa-
teway lors de son déploiement.
Remarque : Vérifiez que vous avez configuré le serveur Web afin qu'il prenne en charge la
passerelle servlet (p. 139).
• Si vous n'utilisez pas de serveur Web, saisissez la syntaxe suivante pour utiliser le distribu-
teur en tant que passerelle :
http[s]://nom_hôte:port/p2pd/servlet/dispatch
4. Remplacez la chaîne de nom d'hôte 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'accès anonyme, saisissez l'URI du
distributeur, en veillant à modifier le nom d'hôte localhost dans l'URI.
Si votre serveur Web prend en charge l'encodage de transfert par bloc et que Framework
Manager se trouve à l'intérieur du pare-feu, saisissez l'URI du distributeur, en veillant à modi-
fier le nom d'hôte localhost dans l'URI.
6. Dans la section Cryptographie de la fenêtre Explorateur, cliquez sur l'option Cognos, fournis-
seur cryptographique implicite.
Framework Manager est maintenant configuré pour communiquer avec les autres composants de
Cognos 8.
Vous pouvez configurer un système de contrôle de la source.
Configuration d'un système de contrôle de la source

Pour faciliter la gestion, le partage et la sécurisation des différentes versions de vos métadonnées,
vous pouvez configurer Framework Manager de façon à ce qu'il utilise un système de contrôle de
la source.
Il faut au préalable qu'un des clients de système de contrôle de la source ci-dessous soit installé sur
le même ordinateur que Framework Manager :
• Component Software Concurrent Versions System
• Visual Source Safe
Pour en savoir davantage sur l'installation et la configuration des systèmes de contrôle de la
source, reportez-vous au manuel Framework Manager User Guide.
Procédure
2. Dans la section Environnement de la fenêtre Explorateur, cliquez avec le bouton droit de la
souris sur l'option Systèmes de contrôle source, puis cliquez sur Nouvelle ressource et sur Sys-
tème de contrôle source.
L'option Système de contrôle source est disponible sur des ordinateurs Windows équipés de
Framework Manager ainsi que sur des ordinateurs Windows ou UNIX sur lesquels les compo-
sants d'application sont installés.
3. Dans la zone Nom, saisissez un nom pour le système de contrôle de la source.
110
4. Dans la zone Type, sélectionnez un système de contrôle de la source.

5. Cliquez sur le bouton OK.
6. Dans la fenêtre Propriétés, pour la propriété Emplacement du fichier exécutable du système de
contrôle 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 numéro de version CVS.
Vous pouvez tester votre installation et votre configuration. Au besoin, vous pouvez également
modifier les paramètres implicites. Vous pouvez entre autres changer de port, configurer le proto-
cole SSL, configurer les paramètres cryptographiques ou encore modifier l'URI de la passerelle
afin d'utiliser une autre passerelle.
Si vous avez procédé à une mise à niveau depuis une version précédente de Framework Manager,
vous pouvez mettre à niveau des projets existants dans la nouvelle version de Framework Mana-
ger.
Mise à niveau des projets de Framework Manager

Il est possible de mettre à niveau les métadonnées qui figurent dans une version précédente d'un
projet de Framework Manager en ouvrant ce projet dans la nouvelle version de Framework
Manager. Un message vous indique que le projet a été créé dans une version précédente de Fra-
mework Manager et vous demande si vous souhaitez indiquer un emplacement pour le fichier de
sauvegarde.
Avant de mettre le projet à niveau, il est conseillé d'effectuer les opérations suivantes :
• Mettre à niveau tout projet dépendant ou tout segment auquel le projet fait référence.
Par exemple, si le projet renferme un lien vers un segment d'un autre projet, vous devez
d'abord mettre à niveau le segment, puis ensuite mettre à niveau le projet parent.
Pour en savoir davantage, reportez-vous au manuel Framework Manager User Guide.
• Dans le logiciel de contrôle de version, sortir le projet qui doit être mis à niveau.
Pour en savoir davantage, reportez-vous à la documentation du logiciel de contrôle de version
tiers.
• Afin de mettre à niveau un modèle qui se trouve sur un réseau, copier le modèle dans un dos-
sier de l'ordinateur local. À partir de l'ordinateur local, mettre le modèle à niveau, puis reco-
pier le projet dans l'emplacement réseau d'origine.
Procédure
2. Démarrez Framework Manager.
Si la version du schéma du modèle est plus ancienne que la version prise en charge actuelle-
ment, vous pouvez être invité à indiquer un emplacement pour la copie de sauvegarde du pro-
jet. Si vous cliquez sur le bouton Annuler, Framework Manager n'ouvre pas le projet.
3. Dans la page Start, cliquez sur Open existing project.
4. Naviguez jusqu'au dossier du projet que vous voulez ouvrir, puis cliquez sur le fichier .cpf.
5. Cliquez sur le bouton Open.
6. Si vous êtes invité à fournir un emplacement de stockage de la sauvegarde, choisissez un
emplacement :
• Pour enregistrer le modèle de sauvegarde dans l'emplacement implicite, cliquez sur No.
• Pour indiquer un autre emplacement, cliquez sur Yes et accédez à l'emplacement en ques-
tion.
Vous devez à nouveau publier les packs dans la version actuelle du serveur des composants
d'application. Pour en savoir davantage, reportez-vous au manuel Framework Manager User
Guide.

Pour accéder à une présentation rapide de Cognos 8, démarrez Cognos Connection, puis sélec-
tionnez Présentation rapide. Pour en savoir davantage sur l'utilisation des différents composants
de Cognos 8, reportez-vous à la documentation correspondante.
Configuration de Metric Designer

Si vous installez Metric Designer sur le même ordinateur que les autres composants de Cognos 8,
aucune configuration n'est nécessaire.
Si vous n'installez pas Metric Designer sur le même ordinateur que les autres composants de
Cognos 8, vous devez configurer les propriétés d'environnement des ordinateurs Metric Designer.
Avant de procéder à la configuration de Metric Designer, les autres composants de Cognos 8 doi-
vent être installés et configurés, et Metric Designer doit être installé.
Si vous avez procédé à une mise à niveau depuis Metrics Manager 2.0 ou une version ultérieure,
vous pouvez utiliser les mêmes extraits et projets que vous avez utilisés avec la version précédente.
Pour mettre à niveau des projets existants, vous devez les ouvrir dans la nouvelle version de Metric
Designer et redéfinir les connexions aux sources de données et les autres références.
Configuration des propriétés d'environnement des ordinateurs Metric Designer

Si vous installez Metric Designer sur un ordinateur différent de celui des autres composants de
Cognos 8, vous devez le configurer pour qu'il communique avec les ordinateurs où la passerelle et
Content Manager sont installés.
Il est recommandé d'installer et de configurer les composants de Cognos 8 avant de configurer
Metric Designer. Vous devez d'abord installer et configurer Content Manager, puis démarrer le
service Cognos 8 sur au moins un ordinateur Content Manager avant de configurer Metric Desi-
gner. Cela garantit que le service d'autorité de certification émet un certificat pour l'ordinateur
Metric Designer.
Avant de configurer Metric Designer, vérifiez que le serveur Web est configuré et en cours d'exécu-
tion et que le service Cognos 8 fonctionne.
Si vous utilisez un serveur Web Apache, assurez-vous d'abord qu'il est configuré (p. 137).
Installations avec un pare-feu

Vous pouvez configurer Metric Designer pour qu'il accède aux composants du serveur Cognos 8
par l'intermédiaire du distributeur ou d'une passerelle dédiée. Si l'ordinateur sur lequel vous avez
installé Metric Designer n'a pas accès au distributeur de Cognos 8 en raison d'un pare-feu, vous
devez configurer Metric Designer pour qu'il accède à Cognos 8 par le biais d'une passerelle dédiée
qui est configurée pour accéder au distributeur de Cognos 8. Dans ce type d'installation, Metric
Designer et la passerelle dédiée doivent être situés à l'extérieur du pare-feu et le distributeur doit
figurer à l'intérieur de celui-ci. De plus, Metric Designer doit avoir accès à un serveur Web prenant
en charge l'encodage de transfert par bloc et se trouvant à l'extérieur du pare-feu.
Procédure
1. Sur l'ordinateur où vous avez installé Metric Designer, démarrez Cognos Configuration.
3. Dans la zone URI de la passerelle de la fenêtre Propriétés, saisissez la valeur appropriée :
• Remplacez la chaîne de nom d'hôte 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_hôte:port/cognos8/cgi-bin/module
où module correspond à :
Système
d'exploitation Module Apache 1.3 Module Apache 2.0
Windows mod_cognos.dll mod2_cognos.dll
112
Système
d'exploitation Module Apache 1.3 Module Apache 2.0
Solaris et AIX mod_cognos.so mod2_cognos.so
HP-UX mod_cognos.sl mod2_cognos.sl
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'accès anonyme, saisissez l'URI du
distributeur, en veillant à modifier le nom d'hôte localhost dans l'URI.
Si votre serveur Web prend en charge l'encodage de transfert par bloc et que Metric Designer
se trouve à l'intérieur du pare-feu, saisissez l'URI du distributeur, en veillant à modifier le nom
d'hôte localhost dans l'URI.
Metric Designer est maintenant configuré pour communiquer avec les autres composants de
Cognos 8.
Mise à niveau des projets de Metrics Designer

Il est possible de mettre à niveau les métadonnées qui figurent dans une version précédente d'un
projet de Metric Designer en ouvrant ce projet dans la version en cours de Metric Designer. Un
message vous indique que le projet a été créé dans une version précédente de Metric Designer et
vous demande si vous souhaitez indiquer un emplacement pour le fichier de sauvegarde.
Avant de mettre à niveau un projet avec un modèle qui se trouve sur un réseau local, vous devez
copier le modèle dans un dossier de l'ordinateur local. À partir de l'ordinateur local, mettre le
modèle à niveau, puis recopier le projet dans l'emplacement réseau d'origine.
Procédure
2. Démarrez Metric Designer.
3. Dans la page Start, cliquez sur Open a project.
4. Naviguez jusqu'au dossier du projet que vous voulez ouvrir, puis cliquez sur le fichier .cpf.
5. Cliquez sur le bouton Open.
6. Si vous êtes invité à fournir un emplacement de stockage de la sauvegarde, choisissez un
emplacement :
• Pour enregistrer le modèle de sauvegarde dans l'emplacement implicite, cliquez sur No.
• Pour indiquer un autre emplacement, cliquez sur Yes et accédez à l'emplacement en ques-
tion.
Si la version du schéma de modèle est antérieure à celle actuellement prise en charge, vous êtes
invité à sauvegarder le projet. Si vous cliquez sur le bouton Annuler, Metric Designer n'ouvre
pas le projet.
7. Si la connexion au pack d'indicateurs ou à la source de données qui est associée au projet
n'existe plus, vous êtes invité à choisir une connexion existante au pack ou à la source.
Test de l'installation et de la configuration

Vous pouvez tester vos paramètres de configuration en exécutant la fonction de test avant de
démarrer le service Cognos 8. Vous avez ensuite la possibilité de tester l'installation en démarrant
le service Cognos 8, puis en ouvrant Cognos Connection. Si vous avez installé Framework Mana-
ger ou Metric Designer, vous pouvez tester ces applications en les lançant et en créant un projet.
Si vous avez installé Metric Studio et créé un pack, vous avez déjà testé votre installation et votre
configuration. Vous pouvez créer un pack d'indicateurs uniquement si Metric Studio est installé et
configuré correctement.

Pour pouvoir utiliser Framework Manager ou Metric Designer, vous devez démarrer le service
Cognos 8. Sous Windows, le service Cognos 8 est configuré par défaut pour démarrer automati-
quement. Sous UNIX et Linux, vous devez configurer le processus Cognos 8 comme démon pour
qu'il démarre automatiquement. Pour en savoir davantage, reportez-vous à la documentation sur
le système d'exploitation.
Vous devez installer et configurer Framework Manager et les composants du serveur Cognos 8
pour pouvoir utiliser Cognos 8 pour la production de rapports.
Remarque : Cognos 8 ne peut accéder à aucune des données du rapport avant qu'elles ne soient
organisées en packs et publiées dans Framework Manager.
Procédure pour Cognos 8

2. Veillez à enregistrer la configuration, sans quoi vous ne serez pas en mesure de démarrer le
service Cognos 8.
Lorsque vous procédez à une mise à niveau, un message indiquant la détection de fichiers de
configuration et leur mise à niveau s'affiche.
3. Dans le menu Opérations, cliquez sur l'option Tester.
Cognos Configuration vérifie la disponibilité des clés symétriques communes (CSK), teste la
configuration de l'espace-noms et contrôle les connexions à la base de données Content Store
et à la base de données de journalisation.
Si vous utilisez la base de données de notification et le serveur de messagerie, Cognos Configu-
ration les teste également.
Conseil : Si l'option Tester ne peut pas être sélectionnée, cliquez sur Configuration locale dans
la fenêtre Explorateur.
4. Si un test échoue, reconfigurez les propriétés concernées, puis exécutez à nouveau le test.
Démarrez le service uniquement lorsque tous les tests ont abouti.
Le démarrage du service Cognos 8 peut prendre quelques minutes.
6. Ouvrez un navigateur Web.
7. Démarrez Cognos Connection en saisissant ce qui suit, où cognos8 correspond au répertoire
virtuel que vous avez créé pendant la configuration du serveur Web :
• Pour la passerelle CGI :
http://nom_hôte:port/cognos8
• Pour une passerelle ISAPI :
http://nom_hôte:port/cognos8/isapi
• Pour le connecteur Apache sous Windows :
• Pour le connecteur Apache sous Solaris et AIX :
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.so
• Pour le connecteur Apache sous HP-UX :
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.sl
• Pour un servlet de passerelle :
http://nom_hôte:port/racine_contexte/servlet/ Gateway
L'ouverture de la page Web peut prendre quelques minutes. Si la page Bienvenue de Cognos
Connection s'affiche, cela signifie que l'installation fonctionne.

2. Pour démarrer Framework Manager, dans le menu Démarrer, cliquez successivement sur les
options Programmes, Cognos 8 et Framework Manager.
114
Si la version du schéma de modèle est antérieure à 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 fonc-
tionne.

2. Pour démarrer Metric Designer, dans le menu Démarrer, cliquez successivement sur les
options Programmes, Cognos 8 et Metric Designer.
Si la page d'accueil de Metric Designer s'affiche, cela signifie que l'installation fonctionne.
Modification des paramètres de configuration implicites

Lorsque vous installez des composants de Cognos 8, l'installation utilise des paramètres de confi-
guration implicites. Si vous avez une raison de rejeter ces valeurs implicites, par exemple, si un
port est également utilisé par un autre processus, Cognos Configuration vous permet de les modi-
fier.
Si vous modifiez la valeur d'une propriété, vous devez enregistrer la configuration et redémarrer le
service Cognos 8 pour appliquer les nouveaux paramètres à votre ordinateur.
Pour les installations réparties, assurez-vous d'avoir configuré tous les ordinateurs sur lesquels
vous avez installé Content Manager avant de modifier les paramètres de configuration implicites
sur les autres ordinateurs Cognos. Par exemple, vous pouvez :
• modifier un URI,
• configurer les paramètres cryptographiques,
• configurer les composants de Cognos 8 afin qu'ils utilisent Cognos Application Firewall,
• configurer des propriétés de fichier temporaire,
• configurer la passerelle pour un espace-noms,
• activer et désactiver des services,
• indiquer la quantité de ressources utilisée par le service Cognos 8,
• configurer des polices,
• modifier la police implicite pour des rapports,
• modifier l'emplacement des graphiques de type Carte pour Report Studio.
Après avoir modifié le comportement implicite de Cognos 8 afin qu'il s'adapte mieux à votre envi-
ronnement Cognos, vous pouvez configurer Cognos Portal Services, configurer un fournisseur
d'authentification ou encore tester l'installation et la configuration. Pour Cognos 8, vous pouvez
installer et configurer Framework Manager. Pour Metric Studio, vous pouvez installer et configu-
rer Metric Designer.
Modification d'un URI

Vous pouvez modifier certains éléments d'un URI selon votre environnement. Un URI de Cognos
contient les éléments suivants :
• Pour un URI de Content Manager, un URI du distributeur destiné aux applications externes
ou un URI du distributeur
protocole://nom_hôte_ou_adresse_IP:port/racine_contexte/chemin_alias
• Pour un URI de passerelle ou un URI de contenu Web
protocole://nom_hôte_ou_adresse_IP:port/répertoire_virtuel/application_passerelle
OU

protocole://nom_hôte_ou_adresse_IP:port/racine_contexte/chemin_alias
Élément Exemples Description

protocole http ou https 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
Sécurisé).
nom d'hôte ou hôte_local ou Indique l'identité de l'hôte sur le réseau.

adresse IP 192.168.0.1 Vous pouvez utiliser une adresse IP, un nom
d'ordinateur ou un nom de domaine qualifié
complet.
Dans le cadre d'une installation répartie,
vous devez modifier l'élément localhost
d'un URI.
Dans un environnement mixte de serveurs
UNIX et Windows, assurez-vous que les
noms d'hôtes peuvent être convertis en
adresses IP par tous les serveurs présents
dans l'environnement.
port 9300 or 80 Indique le port sur lequel le système hôte

écoute les demandes.
Le port implicite de Tomcat est 9300. Le
port implicite d'un serveur Web est 80.
racine de contexte p2pd Utilisée par Tomcat ou par un serveur

d'application pour déterminer le contexte de
l'application afin que la demande puisse être
acheminée vers l'application Web appropriée
en vue de son traitement.
chemin d'alias servlet/ dispatch 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 de Cognos 8 ne
fonctionneront pas correctement.
répertoire virtuel cognos8/ Utilisé par le serveur Web pour mettre en

correspondance un répertoire virtuel ou un
alias avec un emplacement physique.
Par exemple, dans l'URI de passerelle
implicite
http://localhost:80/cognos8/cgi-bin/cognos.c
gi, le répertoire virtuel est cognos8/cgi-bin.
application passerelle cognos.cgi Indique le nom de l'application passerelle

Cognos utilisée.
Par exemple, si vous accédez aux
composants de Cognos 8 à l'aide d'une
interface CGI (Common Gateway Interface),
l'application passerelle implicite
correspondra à cognos.cgi.
116
Procédure
2. Dans la fenêtre Explorateur, cliquez sur le groupe ou le composant approprié :
• Pour changer un élément du distributeur, cliquez sur l'option Environnement.
• Pour changer un élément du serveur de journalisation local, dans la section Environne-
ment, cliquez sur l'option Journalisation.
3. Dans la fenêtre Propriétés, cliquez sur la zone Valeur à côté de la propriété d'URI que vous
voulez modifier.
4. Sélectionnez l'élément et saisissez les nouvelles informations.
Conseil : Pour changer le port utilisé par le distributeur local, vous devez modifier la valeur de
la propriété URI interne du distributeur. Étant donné que le changement a une incidence sur
tous les URI définis 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
numéro de port lorsque vous configurez des ordinateurs distants utilisant les services du distri-
buteur, de Content Manager et du kit SDK sur ce système.
Configuration des paramètres cryptographiques

Les composants de Cognos 8 ont besoin d'un fournisseur cryptographique, sans lequel ils ne peu-
vent pas fonctionner. Si vous supprimez le fournisseur cryptographique implicite, vous devez en
configurer un autre pour le remplacer.
Vous pouvez configurer le chiffrement et les paramètres du fournisseur cryptographique, notam-
ment comme suit :
• Algorithmes avancés.
Il s'agit d'algorithmes de signature et de prétraitement.
• Propriétés de la bibliothèque de clés symétriques communes (CSK).
Cognos 8 utilise la CSK pour chiffrer et déchiffrer des données.
• Propriétés de la bibliothèque de clés de signature.
La paire de clés de signature comprend la clé privée utilisée pour créer la signature numérique
et la clé publique utilisée pour vérifier l'authenticité.
• Propriétés de la bibliothèque de clés de chiffrement.
La paire de clés de chiffrement comprend la clé privée utilisée pour chiffrer les données et la
clé publique utilisée pour les déchiffrer.
Le fournisseur cryptographique implicite utilise des clés d'une longueur allant jusqu'à 56 bits pour
le chiffrement de données et le protocole SSL (Secure Socket Layer). Vous pouvez configurer
d'autres fournisseurs cryptographiques utilisant des tailles de clé supérieures à 56 bits, tels que
Enhanced Encryption Module for OpenSSL ou Enhanced Encryption Module for Entrust, dispo-
nibles auprès de Cognos. Pour en savoir davantage, reportez-vous au manuel Enhanced Encryp-
tion Module for OpenSSL Installation and Configuration Guide ou Enhanced Encryption Module
for Entrust Installation and Configuration Guide.
Important : Dans une installation répartie, les ordinateurs Cognos communiquent avec Content
Manager pour établir l'approbation et obtenir certaines clés cryptographiques de Content Mana-
ger. Si vous modifiez les clés cryptographiques dans Content Manager, en modifiant par exemple
des serveurs d'application ou en installant de nouveau Content Manager, vous devez supprimer les
clés cryptographiques des autres ordinateurs Cognos. Enregistrez ensuite la configuration de tous
les ordinateurs afin qu'ils obtiennent les nouvelles clés cryptographiques de Content Manager. Par
ailleurs, tous les composants de Cognos 8 dans une installation répartie doivent être configurés
avec les mêmes paramètres de fournisseur cryptographique.
En outre, dans une installation répartie, la clé symétrique ne doit être stockée que sur les ordina-
teurs sur lesquels Content Manager a été installé.
Procédure relative aux paramètres cryptographiques


3. Dans la fenêtre Propriétés, modifiez les valeurs implicites en cliquant sur la zone Valeur, puis
en sélectionnant la valeur appropriée :
• Sur des ordinateurs dépourvus de Content Manager, si vous ne voulez pas conserver les
CSK localement, dans la section Paramètres CSK, définissez l'option Stocker la clé symé-
trique localement sur Faux.
Lorsque l'option Stocker la clé symétrique localement est définie sur la valeur Faux, la clé
doit être obtenue auprès de Content Manager s'il y a lieu. La propriété Emplacement de la
bibliothèque de clés symétriques communes est ignorée.
• Si vous souhaitez que les ordinateurs à chaque extrémité d'une transmission prouvent leur
identité, dans la section Paramètres SSL, remplacez la valeur de Utilisation de l'authentifi-
cation mutuelle par Vrai.
Nous vous recommandons de ne pas modifier le paramètre Utilisation de la confidentia-
lité. Définissez cette propriété comme vraie pour être certain que toutes les transmissions
soient chiffrées.
• Si vous souhaitez modifier l'algorithme de prétraitement, sélectionnez une autre valeur
pour la propriété Algorithme de prétraitement.
5. Le test du fournisseur cryptographique doit être effectué sur une passerelle uniquement. Dans
la fenêtre Explorateur, cliquez avec le bouton droit de la souris sur Cryptographie, puis cli-
quez sur l'option Tester.
Les composants de Cognos 8 vérifient la disponibilité de la clé symétrique.
Après avoir configuré le fournisseur cryptographique, les mots de passe de votre configuration et
toutes les données que vous créez sont chiffrés.
Procédure relative au fournisseur cryptographique

Cognos.
• Si vous souhaitez modifier l'emplacement des clés de signature, dans la section Paramètres
de clé de signature, définissez la propriété Emplacement de la bibliothèque de clés de
signature au nouvel emplacement.
• Si vous souhaitez modifier l'emplacement des clés de chiffrement, dans la section Paramè-
tres de clé de chiffrement, définissez l'option Emplacement de la bibliothèque de clés de
chiffrement sur le nouvel emplacement.
• Si vous souhaitez utiliser une autorité de certification tierce, dans la section Paramètres de
l'autorité de certification, définissez l'option Utiliser une autorité de certification de tierce
partie sur Vrai.
Vous devez également veiller à utiliser pour le paramètre -k les valeurs employées pour les
propriétés Emplacement de la bibliothèque de clés de signature et Emplacement de la
bibliothèque de clés de chiffrement.
Pour en savoir davantage, reportez-vous à la section « Configuration des composants de
Cognos 8 pour l'utilisation d'une autorité de certification tierce » (p. 208).
Important : La valeur du paramètre Algorithme de confidentialité détermine le mode de chif-
frement des données employé par les composants de Cognos 8. Par exemple, les mots de passe
de base de données saisis dans Cognos Configuration sont chiffrés lors de l'enregistrement de
la configuration. L'algorithme sélectionné lors du chiffrement des données doit également être
disponible pour que ces mêmes données puissent par la suite être déchiffrées.
La disponibilité des algorithmes de confidentialité peut varier en cas de modifications appor-
tées à votre environnement. C'est par exemple le cas si votre environnement JRE (Java Run-
time Environment) a changé ou si vous avez installé un logiciel cryptographique tiers 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 entraîné la mise à niveau
du JRE, cela peut avoir une incidence sur les algorithmes de confidentialité. Vous devez vous
assurer que le paramètre Algorithme de confidentialité sélectionné lors du chiffrement des
données est également disponible lorsque vous souhaitez accéder à ces données.
118

Si vous utilisez un serveur d'autorité de certification tiers, vous devez à présent configurer les com-
posants de Cognos 8 en conséquence.
Configuration des composants de Cognos 8 pour Cognos Application Firewall

Cognos Application Firewall (CAF) analyse et valide les demandes HTTP et XML avant qu'elles
ne soient traitées par les serveurs Cognos. Il est possible que Cognos Application Firewall modifie
ces demandes.
Cognos Application Firewall protège les produits Web de Cognos des données malveillantes. Les
formes les plus courantes de données malveillantes sont les débordements de tampon et les atta-
ques de scripts intersites (XSS), par insertion de script dans des pages valides ou réacheminement
vers un autre site Web.
Cognos Configuration vous permet également de modifier les paramètres de prise en charge des
outils XXS tiers et d'ajouter des noms d'hôte et de domaine à la liste des noms valides de Cognos.
Vous pouvez effectuer un suivi des activités du pare-feu en consultant le fichier journal, qui con-
tient les demandes rejetées. Par défaut, les messages de journalisation sont stockés dans le fichier
situé à l'emplacement suivant : emplacement_c8\logs\cogserver.log.
Important : Tous les paramètres de CAF doivent être identiques sur tous les ordinateurs sur les-
quels les composants d'application Cognos 8 sont installés dans un environnement distribué. Par
exemple, si CAF est désactivé sur certains ordinateurs et activé sur d'autres, un comportement
inattendu et des erreurs peuvent se produire.
Procédure
1. Démarrez Cognos Configuration sur chaque ordinateur sur lequel des composants d'applica-
tion Cognos 8 ont été installés.
2. Dans la fenêtre Explorateur, dans la section Sécurité, cliquez sur l'option Cognos Application
Firewall.
3. Dans la fenêtre Propriétés, définissez les valeurs appropriées pour la propriété Module CAF
activé.
Cognos Application Firewall est actif par défaut.
Important : Cognos Application Firewall est un composant essentiel de sécurité de Cognos
contribuant à la protection contre les intrusions. La désactivation de Cognos Application
Firewall supprime cette protection. Dans des circonstances normales, nous vous conseillons de
ne pas désactiver Cognos Application Firewall.
4. Si vous utilisez un outil XSS de tierce partie qui vérifie des caractères spécifiques dans les para-
mètres de requête GET, ouvrez la fenêtre Propriétés et procédez comme suit :
• Choisissez Vrai comme valeur de la propriété Vérification XSS de tierce partie activée.
• Pour la propriété Caractères XSS de tierce partie, ajoutez les caractères supplémentaires
interdits par l'outil XSS de tierce partie. Les caractères implicites sont >, < et ’.
5. Ajoutez les noms d'hôte et de domaine à la liste de noms valides de Cognos :
• Pour la propriété Domaines ou hôtes valides, cliquez sur la valeur, puis sur le bouton
d'édition.
• Dans la boîte de dialogue Valeur - Domaines ou hôtes valides, cliquez sur Ajouter.
• Dans la ligne blanche de la table, cliquez et saisissez le nom d'hôte ou de domaine.
• Répétez les deux étapes précédentes (indiquées par des puces) pour chaque nom à ajouter.
Conseil : Si, à partir de Cognos Series 7, vous utilisez l'accès au détail des rapports sous
Cognos 8, ajoutez les noms d'hôte des serveurs de passerelles de Cognos Series 7 à la liste.

Cognos Application Firewall valide des noms d'hôte et de domaine pour protéger les URL
créées. Par défaut, Cognos Application Firewall considère les noms de domaine issus des pro-
priétés de configuration de l'environnement comme étant des noms de domaine sécurisés.
Vous pouvez ajouter manuellement des noms à la liste de domaines et d'hôtes valides. En
général, l'ajout de nom est utile si vous devez rediriger des demandes vers des ordinateurs non
Cognos à l'aide des fonctions Précédent et Annuler ou lorsque vous utilisez l'accès au détail
vers d'autres installations de produits Cognos.
6. Enregistrez la configuration.
Configuration des propriétés des fichiers temporaires

Vous pouvez modifier l'emplacement où les composants de Cognos 8 conservent les rapports con-
sultés récemment et décider de chiffrer leur contenu. Par défaut, les composants de Cognos 8 con-
servent les fichiers temporaires dans le répertoire emplacement_c8\temp, sans les chiffrer.
Il est conseillé d'interdire tout accès au répertoire temp, sauf pour le compte du service utilisé pour
démarrer le service Cognos 8. Des droits en lecture et en écriture sont requis pour le compte du
service.
Procédure
3. Dans la fenêtre Propriétés, pour la propriété Emplacement des fichiers temporaires, indiquez
le nouvel emplacement.
4. Si vous souhaitez que le contenu des fichiers temporaires soit chiffré, définissez la propriété
Chiffrement des fichiers temporaires sur Vrai.
5. Assurez-vous que le compte d'utilisateur sous lequel les composants de Cognos 8 fonctionnent
dispose des droits appropriés sur l'emplacement des fichiers temporaires. Par exemple :
• sous Windows, tous les droits de contrôle,
• sous UNIX ou Linux, les droits de lecture et d'écriture.
Configuration de la passerelle pour l'utilisation d'un espace-noms

Si les composants de Cognos 8 utilisent plusieurs espaces-noms ou si l'accès anonyme est activé et
que les composants de Cognos 8 n'utilisent qu'un seul espace-noms, vous pouvez configurer la
passerelle pour qu'elle se connecte à un seul espace-noms. Les utilisateurs connectés au serveur
Web sur lequel se trouve la passerelle ne sont pas invités à sélectionner une source d'authentifica-
tion.
Par exemple, si vous disposez de deux serveurs Web, vous pouvez les configurer Web afin qu'ils
utilisent un espace-noms différent.
Procédure
1. Sur l'ordinateur où se trouve la passerelle, démarrez Cognos Configuration.
3. Dans la fenêtre Propriétés, dans la zone Valeur située à côté de la propriété Espace-noms de la
passerelle, saisissez l'identificateur de l'espace-noms que vous voulez utiliser.
Activation et désactivation de services

Dans une installation répartie, vous pouvez envoyer certains types de demande à des ordinateurs
spécifiques en activant ou en désactivant les services installés.
Par exemple, pour dédier un ordinateur à l'exécution et à la diffusion de rapports, vous pouvez
désactiver le service de présentation sur un serveur de rapports. Pour réserver un ordinateur d'une
installation répartie au traitement des demandes de l'application Metric Studio, désactivez le ser-
vice d'intégration des données de l'ordinateur.
120
Remarque : Les valeurs implicites des services de distribution et de présentation sont définies sur
« faux » sur les ordinateurs où seul Content Manager est installé. Pour tous les autres types d'ins-
tallations, les valeurs implicites sont définies sur « vrai ».
Si vous avez installé tous les composants sur plusieurs ordinateurs, vous pouvez désactiver les ser-
vices appropriés sur chacun d'eux afin d'obtenir la configuration répartie requise. Les demandes
sont envoyées uniquement aux distributeurs sur lesquels un service donné est activé.
La désactivation d'un service empêche son chargement en mémoire. Une fois désactivés, les servi-
ces ne démarrent plus et ne consomment donc plus de ressources. Le service ne s'exécute pas tant
que vous ne l'activez pas.
Si vous désactivez le service du distributeur, tous les services qui s'exécutent sous ce dernier sont
également désactivés. Seuls les services de distributeur activés peuvent traiter des demandes.
Procédure
2. Dans la section Environnement de la fenêtre Explorateur, cliquez sur l'option Service Cognos
8.
3. Dans la fenêtre Propriétés, cliquez sur la valeur située à côté du service que vous voulez activer
ou désactiver.
Par défaut, tous les services sont activés.
4. Cliquez sur l'état approprié pour les services :
• Pour désactiver le service, cliquez sur l'option Faux.
• Pour l'activer, cliquez sur l'option Vrai.
Définition des ressources du service Cognos 8

Pour améliorer les performances dans un environnement réparti, vous pouvez modifier la quantité
de ressources utilisée par le service Cognos 8 en sélectionnant un modèle de configuration.
Par défaut, le service Cognos 8 est configuré pour utiliser un minimum de ressources mémoire afin
d'optimiser le temps de démarrage.
Le service Cognos 8 n'est disponible que sur les ordinateurs sur lesquels vous avez installé Content
Manager ou les composants d'application.
Procédure
2. Dans les sections Environnement, Service Cognos 8 de la fenêtre Explorateur, cliquez avec le
bouton droit de la souris sur l'option Cognos 8, puis cliquez sur le bouton Supprimer.
Cette opération supprime le modèle de configuration implicite pour le service.
3. Cliquez avec le bouton droit de la souris sur l'option Service 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 modèle de configuration à utiliser :
• Si vous avez préalablement modifié le paramétrage implicite et que vous souhaitez réduire
le temps de démarrage ainsi que l'utilisation de la mémoire et des ressources, cliquez sur
l'option Configuration compacte.
• Si vous souhaitez un compromis entre la rapidité de démarrage et la vitesse de fonctionne-
ment, cliquez sur l'option Configuration moyenne.
• Si vous souhaitez optimiser la vitesse de fonctionnement, que les performances ont plus
d'importance que la rapidité du démarrage et que votre ordinateur dispose de davantage
de ressources, cliquez sur l'option Configuration complète.
6. Dans la fenêtre Propriétés, modifiez les valeurs des propriétés afin de les adapter à votre envi-
ronnement.

Configuration des polices

Les composants de Cognos 8 emploient les polices pour afficher les rapports PDF sur le serveur
Cognos. Ils en utilisent également pour afficher les graphiques utilisés dans les rapports au format
PDF ou HTML.
Pour afficher une sortie correctement, les polices doivent être disponibles à l'emplacement d'affi-
chage du rapport ou du graphique. Dans le cas des graphiques et des rapports au format PDF, les
polices doivent être installées sur le serveur Cognos. Si une police n'est pas disponible, les compo-
sants de Cognos 8 la remplacent par une autre.
Étant donné que les rapports au format HTML s'affichent dans un navigateur, les polices requises
doivent être installées sur l'ordinateur de chaque utilisateur de Cognos appelé à lire le rapport au
format HTML. Si une police n'est pas disponible, le navigateur la remplace par une autre.
Si vous souhaitez utiliser une nouvelle police dans vos rapports, vous devez :
❑ ajouter la police à la liste de celles prises en charge,
❑ indiquer l'emplacement du fichier de la nouvelle police,
❑ faire correspondre la nouvelle police avec le nom de police physique, le cas échéant.
Ajout de polices à l'environnement Cognos

Si vous souhaitez créer des rapports utilisant des polices indisponibles, vous pouvez ajouter ces
polices à la liste de celles prises en charge dans votre environnement Cognos. Vous pouvez égale-
ment supprimer des polices.
Par défaut, les composants de Cognos 8 utilisent un jeu de polices universelles, disponible sur tous
les serveurs Cognos.
Procédure
1. Démarrez Cognos Configuration sur chaque ordinateur Content Manager.
2. Dans le menu Opérations, cliquez sur l'option Modifier la configuration globale.
3. Cliquez sur l'onglet Polices.
4. Cliquez sur le bouton Ajouter.
Conseil : Pour supprimer une police de la liste de celles prises en charge, cliquez sur la zone à
côté 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.
Toutes les polices universelles, y compris les nouvelles polices ajoutées, doivent être installées
sur tous les ordinateurs Cognos présents dans votre environnement.
Si une police universelle n'est pas installée sur tous les ordinateurs Cognos, vous devez mettre en
correspondance la police universelle avec une police physique installée.
Indication de l'emplacement des polices disponibles

Vous devez indiquer l'emplacement d'installation de toutes les polices, y compris celles que vous
ajoutez à la liste des polices prises en charge.
La liste des polices englobe par défaut celles installées dans le répertoire emplacement_c8\bin\fonts
de l'ordinateur Cognos. Si les composants de Cognos 8 sont installés sur un ordinateur Windows,
ils utilisent également les polices installées dans le répertoire des polices de Windows.
Vous devez indiquer l'emplacement des polices sur tous les ordinateurs sur lesquels les composants
d'application sont installés.
Procédure
1. Sur chaque ordinateur des composants d'application, démarrez Cognos Configuration.
122
3. Dans la fenêtre Propriétés, pour la propriété Emplacements des polices physiques, indiquez
l'emplacement des polices.
Conseil : S'il existe plusieurs chemins d'accès aux polices, séparez-les par un point-virgule (;).
Mise en correspondance des polices prises en charge avec les polices installées
Vous pouvez remplacer des polices universelles qui ne sont pas installées sur l'ordinateur par des
polices physiques.
Par exemple, vous ajoutez à la liste des polices prises en charge une police qui n'est pas installée
sur l'ordinateur Cognos. Vous pouvez indiquer la police à utiliser pour la remplacer.
Vous mettez en correspondance les polices sur tous les ordinateurs où est installé le serveur de rap-
ports.
Aucune mise en correspondance n'est requise si vous ajoutez une police à la liste des polices prises
en charge installées sur les ordinateurs Cognos. En revanche, vous devez indiquer l'emplacement
de la police.
Procédure
1. Sur chaque ordinateur des composants d'application, démarrez Cognos Configuration.
3. Dans la fenêtre Propriétés, cliquez sur la zone Valeur à côté de la propriété Correspondance
des polices physiques, puis sur le bouton d'édition.
La boîte de dialogue Valeur - Correspondance des polices physiques s'affiche.
Conseil : Pour supprimer une police, cochez la case située 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 ajoutée à
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 boîte de dialogue Nom de police physique, cliquez sur le bouton
Rechercher maintenant, puis sur le nom d'une police dans les résultats.
8. Répétez les étapes 4 à 7 pour chaque police universelle nécessitant une mise en correspon-
dance.
À présent, vous devez, le cas échéant, indiquer l'emplacement d'installation des polices.
Modification de la police implicite pour les rapports PDF

Vous pouvez modifier la police implicite que les composants de Cognos 8 utilisent pour les rap-
ports PDF. La police implicite est celle que vous voyez lorsque vous ouvrez un rapport.
Vous pouvez modifier la police implicite sur l'ordinateur où Content Manager est installé. Cela
fait, cette police devient la police implicite pour tous les ordinateurs de votre installation. Vous
modifiez la police utilisée pour les rapports PDF à l'aide de Cognos Configuration.
Veillez à ce que la police implicite soit installée sur tous les ordinateurs de l'installation de Cognos.
Procédure
3. Dans la fenêtre Propriétés, dans la zone Police par défaut, saisissez la police que vous voulez
utiliser de manière implicite pour les rapports.

4. Sur tous les ordinateurs des composants d'application, assurez-vous que l'emplacement d'ins-
tallation de la police implicite est précisé dans la propriété Emplacements des polices physi-
ques ou que la police se trouve dans le répertoire des polices de Windows.
Modification de l'emplacement des graphiques type Carte pour Report Studio

Cognos 8 est livré avec un ensemble de graphiques de type Carte que vous pouvez utiliser comme
exemples dans Report Studio. Par défaut, les graphiques de type Carte sont stockés dans le réper-
toire emplacement_c8\maps sur l'ordinateur des composants d'application. Vous pouvez modifier
l'emplacement des graphiques de type Carte à l'aide de Cognos Configuration.
Pour en savoir davantage sur l'utilisation des graphiques de type Carte, reportez-vous au Guide de
l'utilisateur de Report Studio.
Pour en savoir davantage sur l'utilisation des graphiques de type Carte tiers, reportez-vous au
manuel Installation and User Guide de Map Manager.
Procédure
1. Sur l'ordinateur des composants d'application, démarrez Cognos Configuration.
3. Dans la fenêtre Propriétés, cliquez sur la valeur de la propriété Emplacement des fichiers de
correspondances.
4. Cliquez sur le bouton d'édition.
5. Dans la fenêtre Sélection d'un dossier, pointez sur le répertoire de votre choix et cliquez sur
Sélectionner.
Configuration du protocole SSL

Le protocole SSL (Secure Socket Layer) sert à sécuriser les communications entre les composants
de Cognos installés sur le même ordinateur ou sur différents ordinateurs.
En outre, vous pouvez configurer des connexions SSL entre les composants de Cognos et d'autres
serveurs. Vous devez vous assurer que le protocole SSL est configuré pour les autres serveurs, puis
configurer une sécurité partagée entre les composants de Cognos et ces autres serveurs.
Après avoir configuré le protocole SSL, vous pouvez sélectionner et classer les algorithmes de chif-
frement (ciphersuites) qui contrôlent la qualité de la protection utilisée dans le cadre de la con-
nexion SSL.
Pour configurer le protocole SSL, procédez comme suit :
❑ configurez le protocole SSL pour les composants de Cognos (p. 124),
❑ configurez la sécurité partagée entre les composants de Cognos et les autres serveurs, le cas
échéant (p. 126),
❑ sélectionnez et classez les algorithmes de chiffrement (ciphersuites) à utiliser dans une con-
nexion SSL, le cas échéant (p. 127).
Configuration du protocole SSL pour Cognos 8

Vous pouvez configurer les composants de Cognos afin qu'ils utilisent le protocole SSL pour :
• les connexions internes uniquement,
• les connexions externes uniquement,
• les connexions internes et externes,
• les connexions aux serveurs de journaux locaux et distants.
124
Si vous configurez le protocole SSL uniquement pour les connexions internes, les composants de
Cognos sur l'ordinateur local communiquent à l'aide de ce protocole. Le distributeur écoute les
connexions sécurisées 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 de Cognos distants et l'ordinateur local utilisent ce protocole. Vous devez
configurer le distributeur afin qu'il écoute les demandes sécurisées 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 façon à ce qu'ils utilisent le
même protocole et le même port que le distributeur externe.
Si vous configurez le protocole SSL pour toutes les connexions, le distributeur peut utiliser le
même 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 même 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 préfixe http, alors que l'URI externe porte le préfixe https,
ou l'inverse, les deux connecteurs, non-SSL Coyote HTTP/1.1 et SSL Coyote HTTP/1.1, sont acti-
vés dans le fichier server.xml.
Si les URI des distributeurs interne et externe utilisent un protocole ou des ports différents, le port
du distributeur interne n'est accessible que pour les composants situés sur l'ordinateur local.
L'URI interne du distributeur doit également préciser le nom d'hôte localhost.
Installations sur un seul ordinateur

Dans le cadre d'une installation sur un seul ordinateur, si vous exécutez Cognos 8 sans SSL, vous
devez arrêter le service avant d'ajouter le protocole SSL à votre configuration. Une fois que vous
aurez enregistré la configuration avec les paramètres SSL, vous pourrez redémarrer le service.
Installations réparties
Dans les installations réparties, si vous utilisez le service de l'autorité de certification de Cognos,
vous devez commencer par configurer tous les ordinateurs Cognos pour qu'ils utilisent le proto-
cole non sécurisé (http) avant de configurer les composants de Cognos pour l'utilisation du proto-
cole SSL. Cette étape est nécessaire car vous ne pouvez pas configurer le protocole SSL sans avoir
préalablement établi une approbation.
Dans un environnement réparti, vous devez également veiller à respecter l'ordre de configuration
des ordinateurs. Cela signifie que vous devez d'abord configurer l'ordinateur sur lequel l'applica-
tion Content Manager active par défaut est installée, puis démarrer les services sur cet ordinateur
avant de configurer d'autres ordinateurs ou de démarrer des services sur d'autres ordinateurs. En
configurant d'abord l'ordinateur Content Manager, puis en démarrant 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 de Cognos.
Après avoir configuré tous les ordinateurs de l'installation répartie afin qu'ils utilisent le protocole
non sécurisé implicite, il est conseillé de tester l'installation pour s'assurer que les composants de
Cognos fonctionnent correctement. Après avoir testé l'installation, vous pouvez configurer le pro-
tocole SSL.
Lorsque vous configurez Cognos 8 de façon à ce qu'il utilise le protocole SSL, configurez d'abord
l'ordinateur Content Manager actif par défaut pour l'utilisation du protocole, puis démarrez les
services sur cet ordinateur Content Manager. Cela fait, vous pouvez configurer le protocole SSL
sur d'autres ordinateurs Cognos dans votre environnement.
Ajout d'un ordinateur à une installation

Si vous ajoutez un ordinateur à un environnement compatible SSL, vous êtes invité à accepter pro-
visoirement un certificat lorsque vous enregistrez la configuration. L'acceptation de ce certificat
provisoire permet la mise en place d'une accréditation permanente pour l'ordinateur Content
Manager.

Ajout d'un composant à un ordinateur

Vous pouvez ultérieurement ajouter un composant à l'emplacement d'autres composants de
Cognos. Si vous ajoutez ce composant dans un emplacement de l'ordinateur différent de celui des
autres composants Cognos, vous êtes invité à accepter provisoirement un certificat lorsque vous
enregistrez la configuration. L'acceptation de ce certificat provisoire permet la mise en place d'une
accréditation permanente entre le nouveau composant et l'ordinateur Content Manager.
Procédure
3. Dans la fenêtre Propriétés, saisissez les valeurs appropriées pour les propriétés URI interne du
distributeur et URI externe du distributeur :
• Afin de configurer le protocole SSL uniquement pour les connexions internes, pour la pro-
priété URI interne du distributeur, saisissez https, ainsi qu'un port pour la communica-
tion SSL. Pour la propriété URI externe du distributeur, saisissez http et utilisez le port
implicite ou tout autre port disponible.
• Afin de configurer le protocole SSL uniquement pour les connexions internes, pour la pro-
priété URI interne du distributeur, saisissez https, ainsi qu'un port pour la communica-
tion SSL. Pour la propriété URI externe du distributeur, saisissez http et utilisez le port
implicite ou tout autre port disponible.
Si vous utilisez Tomcat, la propriété URI interne du distributeur doit également préciser le
nom d'hôte localhost.
Les ports des deux URI du distributeur doivent être différents.
• Pour configurer le protocole SSL uniquement pour les connexions externes, pour la pro-
priété URI externe du distributeur, saisissez https et un port sécurisé. Pour la propriété
URI interne du distributeur, saisissez http et utilisez le port implicite ou tout autre port
disponible.
Si vous utilisez Tomcat, la propriété URI interne du distributeur doit également préciser le
nom d'hôte localhost.
Les ports des deux URI du distributeur doivent être différents.
• Pour configurer le protocole SSL pour toutes les connexions, saisissez le même URI pour
les deux propriétés URI interne du distributeur et URI externe du distributeur. Saisissez
https et un numéro de port sécurisé, tel que 9343.
Remarque : Vous ne devez pas nécessairement 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 passe-
relle.
• Pour les connexions internes uniquement, saisissez https dans les URI contenant la chaîne
localhost.
• Pour les connexions externes uniquement, saisissez https dans les URI ne contenant pas la
chaîne localhost.
• Pour toutes les connexions, saisissez https dans tous les URI.
5. Dans la fenêtre Explorateur, cliquez sur Sécurité, Cryptographie.
6. Pour utiliser le protocole SSL, vous devez indiquer des mots de passe pour les bibliothèques de
clés de chiffrement de Cognos 8. D'autres paramètres sont disponibles dans la section Sécu-
rité, Cryptographie, Cognos.
Configuration de la sécurité partagée entre les serveurs Cognos et d'autres

serveurs
Si vous souhaitez utiliser l'autorité de certification implicite de Cognos et employer le protocole
SSL pour des connexions d'autres serveurs à des serveurs Cognos, vous devez ajouter le certificat
de Cognos à la bibliothèque d'approbations des autres serveurs.
126
Remarque : Lorsque vous utilisez des navigateurs pour vous connecter aux composants de
Cognos, ils invitent automatiquement les utilisateurs à mettre à jour leurs bibliothèques d'appro-
bations.
Si vous souhaitez que la connexion entre les serveurs Cognos et l'autre serveur soit mutuellement
authentifiée, vous devez également copier le certificat de votre autorité de certification dans la
bibliothèque d'approbations pour les serveurs Cognos.
Lorsque vous avez configuré les composants de Cognos pour l'utilisation d'une autorité de certifi-
cation (CA) tierce, il n'est pas nécessaire de configurer de sécurité partagée entre le serveur Cognos
et les autres serveurs.
Procédure de copie du certificat de Cognos sur un autre serveur

1. Accédez au répertoire emplacement_c8\bin.
2. Procédez à l'extraction du certificat de Cognos en saisissant la commande suivante :
ThirdPartyCertificateTool.sh -E -T -r fichier_destination -k emplacement_c8/configura-
tion/signkeypair/jCAKeystore -p mot_de_passe
ThirdPartyCertificateTool.bat -E -T -r fichier_destination -k emplacement_c8\configura-
tion\signkeypair\jCAKeystore -p mot_de_passe
3. Importez le certificat dans la bibliothèque d'approbations de votre serveur.
Pour en savoir davantage sur la mise à jour de la bibliothèque d'approbations du serveur,
reportez-vous à la documentation du serveur.
Procédure de copie du certificat de l'autorité de certification sur les serveurs Cognos

1. Copiez le certificat de l'autorité de certification dans un emplacement sécurisé sur le serveur
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 :
ThirdPartyCertificateTool.sh -T -i -r fichier_certificat_autorité_de_certification -k
emplacement_c8/configuration/signkeypair/jCAKeystore -p mot_de_passe
ThirdPartyCertificateTool.bat -T -i -r fichier_certificat_autorité_de_certification -k
emplacement_c8\configuration\signkeypair\jCAKeystore -p mot_de_passe
Sélection et classement des algorithmes de chiffrement (ciphersuites) pour

SSL
Une connexion SSL commence par une négociation au cours de laquelle le client et le serveur pré-
sentent une liste des algorithmes de chiffrement (ciphersuites) pris en charge, par ordre de priorité.
Un algorithme de chiffrement (ciphersuite) garantit la qualité de la protection pour la connexion.
Il contient des algorithmes cryptographiques, d'authentification, de hachage et d'échange de clés.
Le protocole SSL sélectionne la suite de priorités les plus élevées que le client et le serveur prennent
en charge.
Cognos fournit une liste d'algorithmes de chiffrement (ciphersuites) pris en charge pour SSL. Vous
pouvez éliminer les algorithmes de chiffrement (ciphersuites) qui ne correspondent pas à vos exi-
gences, puis attribuer une priorité ou une préférence aux algorithmes de chiffrement restants. Les
algorithmes de chiffrement (ciphersuites) sélectionnés sont présentés par ordre de priorité pour les
côtés client et serveur de la négociation. Au moins l'un des algorithmes de chiffrement (ciphersui-
tes) entre les plates-formes client et serveur doit correspondre.

La liste des algorithmes de chiffrement pris en charge est créée de façon dynamique sur chaque
ordinateur et dépend de l'environnement JRE (Java Runtime Environment) ou de la présence de
logiciels cryptographiques tiers installés 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 entraîné la mise à niveau du JRE, cela peut avoir une incidence sur les algorithmes de chif-
frement 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.
Procédure
2. Dans la fenêtre Explorateur, cliquez sur Cryptographie, Cognos.
3. Dans la fenêtre Propriétés, cliquez sur la colonne Valeur située à côté de la propriété Algorith-
mes de chiffrement (ciphersuites) pris en charge.
4. Cliquez sur le bouton d'édition.
• Pour déplacer un algorithme de chiffrement (ciphersuite) dans la liste Valeurs actuelles,
cochez la case dans la liste Valeurs disponibles, puis cliquez sur Ajouter.
• Pour déplacer 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 flèches de
déplacement vers le haut et vers le bas.
• Pour supprimer un algorithme de chiffrement (ciphersuite) de la liste Valeurs actuelles, cli-
quez sur la case à cocher, puis sur Supprimer.
Configuration des messages de journalisation

Vous pouvez indiquer l'emplacement où le serveur de journalisation local envoie les messages de
journalisation. Pour en savoir davantage, reportez-vous au manuel Architecture and Planning
Guide.
Un serveur de journalisation local est automatiquement installé lors de l'installation de Content
Manager ou des composants d'application.
Le serveur de journalisation peut envoyer des messages de journalisation vers une ou plusieurs
destinations, comprenant entre autres :
• un serveur de journalisation distant,
• un fichier,
• une base de données.
Serveur de journalisation distant

Dans une installation répartie, vous pouvez configurer les serveurs de journalisation pour envoyer
des messages de journalisation vers un seul serveur de journalisation qui agit tel un serveur de
journalisation partagé. Vous pouvez ensuite configurer le serveur de journalisation partagé pour
envoyer les messages de journalisation vers un fichier simple ou une base de données sur un même
ordinateur ou un ordinateur différent.
Si le serveur de journalisation distant devient indisponible, les messages de journalisation sont
redirigés vers les fichiers de récupération de l'ordinateur local situés dans le répertoire
emplacement_c8\logs\recovery\remote. Les noms de ces fichiers de récupération contiennent des
informations de date-heure. Ces fichiers ne sont pas lisibles comme des fichiers de journalisation
ordinaires. Lorsque le serveur de journalisation est disponible, un processus de récupération auto-
matique transfère toutes les informations de journalisation vers le serveur de journalisation distant
et supprime les fichiers de journalisation locaux.
128
Fichier
Le serveur de journalisation est configuré par défaut pour envoyer les messages de journalisation
vers le fichier cogserver.log situé dans le répertoire emplacement_c8\logs. Vous pouvez configurer
le serveur de journalisation pour qu'il envoie les messages de journalisation vers un autre fichier,
tel que le journal système UNIX ou Linux ou le journal des événements Windows NT.
Base de données
Le serveur de journalisation peut également envoyer les messages vers une base de données sur le
même ordinateur ou sur un autre ordinateur.
La base de données de journalisation présente les mêmes exigences de configuration et de compte
d'utilisateur que la base de données Content Store. Après avoir configuré les composants de
Cognos 8 pour qu'ils envoient des messages à une base de données de journalisation, puis après
avoir redémarré le service Cognos 8, les composants de Cognos 8 créent les tables et les champs de
table requis. Vous pouvez tester la connexion à la base de données de journalisation avant de redé-
marrer le service Cognos 8.
Configuration des messages de journalisation

Pour configurer les messages de journalisation :
❑ Créez la base de données de journalisation en suivant la procédure utilisée pour créer la base
de données Content Store (p. 71).
Important : Pour DB2, vous devez définir un autre espace de table utilisateur standard avec
une taille de page de 8 ko pour les composants de Cognos 8 afin de créer la base de données
de journalisation.
❑ Configurez le client de base de données, le cas échéant.
❑ Indiquez la destination des messages de journalisation.
Configuration du client de base de données pour une base de données de

journalisation
Après avoir créé une base de données pour vos messages de journalisation, si vous utilisez Oracle,
DB2 ou Sybase comme serveur de base de données, des étapes supplémentaires sont requises.
Si vous utilisez une base de données Oracle ou Sybase, vous devez configurer le pilote JDBC.
Si vous utilisez une base de données DB2, vous devez configurer le logiciel client de base de don-
nées et le pilote JDBC 2.0.
Si vous utilisez une base de données Microsoft SQL Server, le fichier JSQLConnect.jar est installé à
l'emplacement implicite approprié. La seule autre procédure consiste à s'assurer que Microsoft
SQL Server utilise la connectivité TCP/IP.
Si vous utilisez le même type de base de données pour les messages de journalisation et pour Con-
tent Store, vous n'avez pas besoin de configurer un pilote JDBC sur les ordinateurs Content
Manager. Vous devez néanmoins configurer un pilote JDBC sur les ordinateurs des composants
d'application.
Remarque : Vous ne pouvez pas utiliser la base de données de contenu de Cognos en tant que base
de données de journalisation.

1. Sur l'ordinateur où Oracle est installé, accédez au répertoire ORACLE_HOME/jdbc/lib.
2. Copiez le fichier classes12.jar dans le répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib
de chaque ordinateur sur lequel Content Manager ou les composants d'application sont ins-
tallés.
Procédure pour DB2

1. Installez le logiciel client DB2 sur l'ordinateur où Content Manager ou les composants
d'application sont installés.

2. Si la base de données de journalisation ne se trouve pas sur le même ordinateur que le serveur
de journalisation, configurez un pseudonyme de base de données pour la base de données de
journalisation :
• Sous Windows, exécutez l'Assistant de configuration du client DB2.
• Sous UNIX ou Linux, utilisez l'interface de ligne de commande DB2.
Remarque : Si la base de données de journalisation et le serveur de journalisation se trouvent
sur le même ordinateur, le nom de la base de données de journalisation est automatiquement
utilisé pour créer un pseudonyme.
3. Sous Windows, arrêtez 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
répertoire emplacement_c8/webapps/p2pd/WEB-INF/lib.
5. Renommez le fichier db2java.zip en db2java.jar.
6. Sous Windows, redémarrez les services DB2 et le serveur de recherche HTML.
7. Répétez intégralement cette procédure sur chaque ordinateur sur lequel Content Manager ou
les composants d'application sont installés.
Procédure pour Sybase

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

Vous pouvez configurer un type de destination pour les messages de journalisation et configurer
ensuite les propriétés pour la destination spécifique. Vous pouvez également configurer plusieurs
destinations pour des messages de journalisation.
Procédure
1. Si la destination est une base de données, vérifiez que :
• vous avez créé la base de données de journalisation (p. 71),
• vous avez configuré le client de base de données (p. 129).
2. Sur l'ordinateur où vous avez installé Content Manager ou les composants d'application,
démarrez Cognos Configuration.
3. Dans la fenêtre Explorateur, dans la section Environnement, cliquez sur l'option Journalisa-
tion.
4. Dans la fenêtre Propriétés, définissez les propriétés du serveur de journalisation.
• Si vous souhaitez utiliser le protocole TCP pour la communication entre les composants
de Cognos 8 et le serveur de journalisation distant, définissez la propriété Voulez-vous
activer le protocole TCP ? sur Vrai.
• Si vous avez utilisé https dans l'URI interne du distributeur, définissez la propriété Activer
le protocole SSL sur Vrai dans la fenêtre Propriétés.
5. Dans la fenêtre Explorateur, dans la section Environnement, cliquez avec le bouton droit de la
souris sur l'option Journalisation, puis cliquez successivement sur les options Nouvelle res-
source 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 ou un serveur de journalisation distant, saisissez les valeurs
appropriées pour les propriétés obligatoires et facultatives dans la fenêtre Propriétés.
Pour un serveur de journalisation distant, vous devez indiquer ultérieurement la destination
des messages de journalisation lorsque vous configurez le serveur de journalisation distant.
9. Si la destination est une base de données, ajoutez une ressource de base de données :
130
• Dans la fenêtre Explorateur, cliquez avec le bouton droit de la souris sur la base de don-
nées, puis cliquez sur Nouvelle ressource, Base de données.
• Dans la zone Nom, saisissez le nom de la base de données de journalisation créée.
• Dans la liste Type, cliquez sur le type de base de données, puis sur le bouton OK.
• Dans la fenêtre Propriétés, saisissez les valeurs appropriées pour les propriétés facultatives
et obligatoires.
Si vous utilisez une base de données Microsoft SQL Server, vous pouvez utiliser un
numéro de port, tel que 1433 ou une instance nommée, en tant que valeur de la propriété
Serveur de base de données et numéro de port.
• Testez la connexion à la nouvelle base de données. Dans la section Environnement de la
fenêtre Explorateur, cliquez avec le bouton droit de la souris sur Journalisation, puis cli-
quez sur Tester.
Les composants de 8 se connectent à la base de données. Si vous avez configuré plusieurs
bases de données pour la journalisation des messages, les composants de Cognos 8 testent
l'ensemble des bases de données.
10. Répétez les étapes 5 à 9 pour chacune des destinations auxquelles le serveur de journalisation
doit envoyer des messages.
12. Dans la fenêtre Explorateur, cliquez sur Service Cognos 8, puis sur Cognos 8.
13. Dans le menu Fichier, cliquez sur l'option Redémarrer.
Si vous avez sélectionné une base de données comme destination, les composants de Cognos 8
créent les tables et les champs requis dans la base de données créée.
Si la destination était un serveur de journalisation distant, configurez le serveur de journalisation
distant et démarrez-le. Redémarrez ensuite le service Cognos 8 sur l'ordinateur local.
Si la destination était une base de données, vous pouvez utiliser les composants de Cognos 8 pour
exécuter les rapports de journalisation à partir de la base de données.
Vous pouvez également définir le niveau de journalisation qui contrôle la quantité de détails et le
type de messages qui sont envoyés vers un fichier ou une base de données de journalisation. Pour
obtenir des instructions, reportez-vous au Guide d'administration et de sécurité.
Modification des paramètres globaux

Vous pouvez modifier les paramètres globaux :
• pour personnaliser la prise en charge linguistique de l'interface utilisateur,
• pour personnaliser la prise en charge des monnaies,
• pour personnaliser la prise en charge des paramètres régionaux du contenu,
• pour faire correspondre la langue utilisée dans l'interface utilisateur du produit,
• pour faire correspondre les paramètres régionaux du contenu,
• pour ajouter des polices à votre environnement Cognos
• pour modifier le fuseau horaire implicite,
• pour modifier l'encodage des courriers électroniques,
• pour personnaliser les paramètres de témoin (cookie).
Par défaut, les composants de Cognos Series 8 appliquent une forme normalisée à tous les paramè-
tres régionaux, qui peuvent provenir de différentes sources et se présenter sous divers formats.
Cela signifie que tous les paramètres régionaux étendus sont conformes à une définition de langue
et de code régional.

Chaque ordinateur a des paramètres système régionaux implicites et des paramètres régionaux par
utilisateur. Les paramètres régionaux de l'utilisateur peuvent différer de ceux du système.
Important : Si vous modifiez les paramètres globaux sur l'un des ordinateurs Content Manager,
vous devez effectuer les mêmes modifications sur les autres ordinateurs Content Manager.
Personnalisation de la prise en charge linguistique de l'interface utilisateur

Utilisez la table Paramètres régionaux du produit pour ajouter ou supprimer des langues prises en
charge par l'interface utilisateur. Par exemple, si vous n'avez pas besoin d'une interface utilisateur
en allemand, vous pouvez supprimer cette langue de la liste.
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 répartie. Pour en savoir davan-
tage, contactez le responsable du support technique de Cognos.
L'ajout de langues à l'environnement de Cognos ne garantit pas que l'ordinateur dispose de la
police nécessaire pour afficher les pages Web dans vos langues favorites. Veillez à installer les
packs linguistiques appropriés pour la prise en charge des jeux de caractères utilisés.
La modification de la langue de l'interface utilisateur du produit n'affecte pas les données.
Procédure
3. Cliquez sur l'onglet Langues du produit.
Conseil : Pour supprimer une langue prise en charge, cochez la case située en regard de
l'option Paramètres régionaux pris en charge, puis cliquez sur l'option Supprimer.
5. Dans la deuxième colonne, saisissez la portion linguistique des paramètres régionaux.
6. Répétez les étapes 3 à 5 pour les autres langues prises en charge à ajouter.
Personnalisation de la prise en charge de la monnaie

Si vous souhaitez disposer de monnaies supplémentaires ou en supprimer certaines de l'interface
utilisateur, vous pouvez mettre à jour la liste des monnaies prises en charge dans la table Mon-
naies.
Par défaut, les composants de Cognos 8 présentent uniquement un sous-ensemble des monnaies
prises en charge dans l'interface utilisateur. Les monnaies sont identifiées par leur code ISO 4217.
La liste complète des monnaies prises en charge que vous pouvez ajouter figure dans le fichier
i18n_res.xml situé dans le répertoire emplacement_c8\bin.
Si vous ajoutez un code de monnaie qui n'est pas pris en charge par Cognos, vous devez l'ajouter
manuellement au fichier i18n_res.xml dans le répertoire emplacement_c8\bin. Copiez ce fichier
sur chaque ordinateur Cognos de votre installation.
L'ajout de monnaies à l'environnement de Cognos ne garantit pas que l'ordinateur dispose de la
police nécessaire pour en afficher les symboles. Veillez à installer les packs linguistiques appropriés
pour la prise en charge des symboles des monnaies que vous utilisez. Par exemple, pour afficher le
symbole de la monnaie indienne (roupie), vous devez exécuter un système d'exploitation japonais
ou installer le pack linguistique japonais.
Procédure
3. Cliquez sur l'onglet Monnaies.
132
Conseil : Pour supprimer un élément pris en charge, cochez la case située en regard de cet élé-
ment, puis cliquez sur l'option Supprimer.
5. Dans la deuxième colonne, saisissez une valeur appropriée.
La valeur que vous ajoutez doit être conforme aux codes ISO 4217 relatifs à la représentation
des monnaies et des formats. Généralement, la valeur que vous ajoutez doit être un code
alphabétique de trois lettres. Les deux premiers caractères sont des lettres représentant le code
monnaie ISO 3166 du pays dont provient la monnaie. La lettre supplémentaire correspond à
l'initiale de la monnaie.
6. Répétez les étapes 3 à 5 pour les autres types d'éléments pris en charge à ajouter.
Personnalisation de la prise en charge des paramètres régionaux du contenu

Pour s'assurer que les utilisateurs visualisent les rapports, les données ou les métadonnées dans
leur langue favorite ou avec des spécificités propres à leur région, vous pouvez ajouter des paramè-
tres régionaux partiels (langues) ou complets (langue-région) à la table Paramètres régionaux
(contenu). De cette façon, si le contenu est disponible dans plusieurs langues ou avec plusieurs spé-
cificités régionales, il s'affiche pour les utilisateurs en fonction de leurs paramètres régionaux.
Pour une partie du contenu du portail, les paramètres régionaux du contenu prévalent sur ceux du
produit.
Si un paramètre régional n'est pas obligatoire, vous pouvez le supprimer de la liste. Vous devez
laisser au moins un paramètre régional du contenu dans la liste pour que le serveur de rapport
puisse fonctionner.
L'ajout de paramètres régionaux incomplets (langues) à l'environnement de Cognos ne garantit
pas que l'ordinateur dispose de la police nécessaire pour afficher les pages Web dans vos langues
favorites. Veillez à installer les packs linguistiques appropriés pour la prise en charge des jeux de
caractères utilisés.
Lorsque vous affichez les rapports en langue thaï, les chiffres ne sont pas pris en charge.
Procédure
3. Cliquez sur l'onglet Paramètres régionaux (contenu).
Conseil : Pour supprimer un élément pris en charge, cochez la case située en regard de cet élé-
ment, puis cliquez sur l'option Supprimer.
5. Dans la deuxième colonne, saisissez une valeur appropriée.
• Pour ajouter la prise en charge d'une langue pour les données et métadonnées de rapport,
saisissez un paramètre local partiel (langue).
• Pour ajouter une prise en charge spécifique à une région, saisissez des paramètres régio-
naux complets (langue-région).
6. Répétez les tâches 3 à 5 pour chaque paramètre régional supplémentaire que vous voulez
prendre en charge.
Mise en correspondance des paramètres régionaux (contenu)

Utilisez la table Correspondances des paramètres régionaux (contenu) pour faire correspondre les
paramètres régionaux de l'utilisateur avec des paramètres régionaux complets (langue-région) ou
partiels (langue). Vous pouvez également faire correspondre la langue favorite d'un utilisateur
avec une autre langue si le contenu n'est pas disponible dans la langue de l'utilisateur.
Par exemple, si un rapport ou un tableau de bord n'est pas disponible dans la langue d'un utilisa-
teur, comme le vietnamien, mais est disponible en français et en allemand, vous pouvez utiliser la
table pour faire correspondre la langue favorite de l'utilisateur (vietnamien) avec une autre langue
(français ou allemand). Le rapport ou tableau de bord s'affiche alors dans cette langue.

Par défaut, la table Correspondances des paramètres régionaux (contenu) contient des paramètres
régionaux n'incluant pas la région. Cela permet de n'utiliser que la partie linguistique des paramè-
tres régionaux et garantit que vous voyez toujours les informations appropriées. Par exemple,
dans une base de données multilingue, les données sont généralement disponibles dans différentes
langues, telles que le français (fr), l'espagnol (es) et l'anglais (en), plutôt que dans des langues
régionales, telles que l'anglais du Canada (en-ca), l'anglais des États-Unis (en-us) ou le français de
France (fr-fr).
Les exemples ci-dessous illustrent comment les composants de Cognos 8 déterminent le rapport ou
le tableau de bord que l'utilisateur visualise si plusieurs versions de langues sont disponibles.
Exemple 1
Un rapport est disponible dans Content Manager dans deux langues régionales, telles que en-us
(anglais des États-Unis) et fr-fr (français de France), mais les paramètres régionaux de l'utilisateur
sont définis sur fr-ca (français du Canada). Cognos 8 utilise les correspondances de paramètres
régionaux pour déterminer le rapport à afficher pour l'utilisateur.
Tout d'abord, Cognos 8 vérifie dans Content Manager si le rapport est disponible dans la langue
des paramètres régionaux de l'utilisateur. Si tel n'est pas le cas, Cognos 8 met en correspondance
les paramètres régionaux de l'utilisateur avec des paramètres régionaux normalisés configurés
dans l'onglet Correspondances des paramètres régionaux (contenu). La langue des paramètres
régionaux de l'utilisateur étant fr-ca, la correspondance est établie avec fr. Cognos 8 utilise la
valeur de correspondance pour vérifier si le rapport est disponible en fr. Dans le cas présent, le
rapport est disponible en en-us et fr-fr, pas en fr.
Ensuite, Cognos 8 met en correspondance les rapports disponibles avec des paramètres régionaux
normalisés. Ainsi, en-us devient en et fr-fr devient fr.
Du fait que tant le rapport que les paramètres régionaux de l'utilisateur sont mis en correspon-
dance avec fr, l'utilisateur dont les paramètres régionaux indiquent la langue fr-ca voit s'afficher le
rapport en fr-fr.
Exemple 2
Les paramètres régionaux de l'utilisateur et ceux du rapport correspondent à la même langue.
Cognos 8 sélectionne les paramètres régionaux à utiliser. Par exemple, si les paramètres régionaux
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), Cognos 8 met en correspon-
dance chaque paramètre régional avec en. L'utilisateur visualise le rapport conformément aux
paramètres régionaux choisis par Cognos 8.
Exemple 3
Les paramètres régionaux du rapport et ceux de l'utilisateur ne sont pas mis en correspondance
avec une langue commune. Cognos 8 sélectionne la langue. Dans ce cas, il peut s'avérer nécessaire
de configurer la mise en correspondance. Par exemple, si un rapport est disponible en en-us
(anglais des États-Unis) et fr-fr (français de France), tandis que les paramètres régionaux de l'utili-
sateur indiquent la langue es-es (espagnol d'Espagne), Cognos 8 sélectionne la langue.
Procédure
3. Cliquez sur l'onglet Correspondances des paramètres régionaux (contenu).
5. Dans la zone Clé, saisissez les paramètres régionaux de l'utilisateur.
• Pour faire en sorte que toutes les régions correspondant à une langue voient le contenu
dans cette langue spécifique, saisissez la portion linguistique des paramètres régionaux,
suivie d'un tiret (-) et d'un astérisque (*).
Par exemple, saisissez fr-*.
• Pour faire en sorte qu'un utilisateur voie le contenu correspondant à ses paramètres régio-
naux spécifiques (langue-région), saisissez les paramètres régionaux complets.
Par exemple, saisissez fr-ch.
134
• Pour mettre en correspondance une langue favorite avec une autre, saisissez la portion de
langue favorite des paramètres régionaux.
Par exemple, saisissez zh.
Conseil : Pour indiquer les paramètres régionaux à utiliser pour plusieurs clés, saisissez le
caractère générique (*) avec la valeur Clé puis, dans la zone Correspondance des paramètres
régionaux, saisissez les paramètres régionaux. Si vous souhaitez par exemple que toutes les
clés allemandes utilisent des paramètres régionaux allemands, saisissez de* dans la zone Clé,
puis saisissez de dans la zone Correspondance des paramètres régionaux.
6. Dans la zone Correspondance des paramètres régionaux, saisissez la portion linguistique des
paramètres régionaux.
Les paramètres régionaux de l'utilisateur spécifiés dans la zone Clé appelleront le contenu
dans cette langue.
7. Répétez les étapes 3 à 5 pour les autres mises en correspondance à établir.
Mise en correspondance des langues du produit

Utilisez la table Correspondance des langues du produit pour indiquer la langue utilisée dans
l'interface utilisateur lorsque celle précisée dans les paramètres régionaux de l'utilisateur n'est pas
disponible.
Vous pouvez faire en sorte que toutes les régions correspondant à un paramètre régional utilisent
la même langue ou que des paramètres régionaux complets spécifiques (langue-région) utilisent
une langue particulière.
Par défaut, l'utilisateur voit l'interface du produit s'afficher dans la langue correspondant à celle
de ses paramètres régionaux.
Procédure
3. Cliquez sur l'onglet Correspondance des langues du produit.
5. Dans la zone Clé, saisissez les paramètres régionaux de l'utilisateur.
• Pour faire en sorte que toutes les régions correspondant à une langue voient l'interface
utilisateur dans cette langue spécifique, saisissez la portion linguistique des paramètres
régionaux, suivie d'un tiret (-) et d'un astérisque (*).
Par exemple, saisissez es-*.
• Pour faire en sorte que les paramètres régionaux complets (langue-région) entraînent
l'affichage de l'interface utilisateur dans une langue spécifique, saisissez les paramètres
régionaux complets.
Par exemple, saisissez es-es.
• Pour mettre en correspondance une langue favorite avec une autre, saisissez la portion de
langue favorite des paramètres régionaux.
Par exemple, saisissez zh.
Conseil : Pour indiquer les paramètres régionaux à utiliser par défaut, saisissez le caractère
générique (*) comme valeur dans la zone Clé, puis dans la zone Correspondance des paramè-
tres régionaux, saisissez les paramètres régionaux.
6. Dans la zone Correspondance des paramètres régionaux, saisissez la portion linguistique des
paramètres régionaux.
Les paramètres régionaux de l'utilisateur spécifiés dans la zone Clé appelleront le contenu
dans cette langue.
7. Répétez les étapes 3 à 5 pour les autres mises en correspondance à établir.

Personnalisation du fuseau horaire du serveur

Vous pouvez modifier le fuseau horaire utilisé par Content Manager en sélectionnant un autre
fuseau horaire dans Cognos Configuration.
Par défaut, Content Manager est configuré pour utiliser le fuseau horaire de votre système
d'exploitation. Toutes les activités programmées dans Cognos 8 sont définies à l'aide de ce fuseau
horaire. En outre, les utilisateurs de Cognos Connection utilisent ce fuseau horaire lorsque leurs
préférences sont définies avec le fuseau horaire implicite. Pour en savoir davantage sur la défini-
tion des préférences de l'utilisateur dans Cognos Connection, reportez-vous au Guide d'adminis-
tration et de sécurité.
Procédure
3. Dans la fenêtre Configuration globale, cliquez sur l'onglet Serveur.
4. Cliquez sur Fuseau horaire du serveur dans la colonne Valeur et sélectionnez un autre fuseau
horaire dans la liste.
Modification de l'encodage pour les courriers électroniques

Par défaut, les composants de Cognos 8 utilisent l'encodage UTF-8 dans les courriers électroni-
ques. Cette valeur définit l'encodage implicite utilisé par le service de diffusion dans cette instance
pour tous les messages électroniques. Il est possible que vous disposiez de clients de courrier élec-
tronique plus anciens ou que vous envoyiez des courriers électroniques depuis Cognos 8 à des télé-
phones portables et des assistants électroniques ne reconnaissant pas le format UTF-8. Si tel est le
cas, vous pouvez redéfinir l'encodage des courriers électroniques sur une valeur applicable à tous
vos clients de courrier électronique (par exemple, ISO-8859-1, Shift-JIS). Chaque instance de
Cognos 8 disposant d'un service de diffusion disponible doit être modifiée.
L'encodage défini affecte uniquement l'objet, les noms de pièces jointes et le texte brut du corps du
message. Le texte du corps HTML et le contenu des pièces jointes restent en encodage UTF-8.
Remarque : La conversion à partir d'Unicode vers les encodages de caractères japonais EUC-JP et
ISO-2022-JP n'est pas intégralement prise en charge par l'environnement d'exécution Java. Si vous
sélectionnez un de ces deux paramètres, les caractères ne sont pas pris en charge dans le texte de
l'objet ou du corps du message électronique.
Procédure
3. Dans la fenêtre Configuration globale, cliquez sur l'onglet Serveur.
4. Cliquez sur la propriété Encodage des courriers électroniques dans la colonne Valeur.
5. Défilez jusqu'au paramètre souhaité et sélectionnez-le.
Personnalisation de témoins (cookies)

Selon les exigences de votre environnement Cognos, vous pouvez être amené à modifier les para-
mètres utilisés par les composants de Cognos 8 pour créer les témoins (cookies). Vous pouvez uti-
liser Cognos Configuration pour personnaliser le domaine, le chemin d'accès et l'indicateur de
sécurité des témoins.
136
Les composants de Cognos 8 déterminent le domaine des témoins à partir de la demande HTTP
transmise par le client, qui correspond généralement à un navigateur Web. Dans la plupart des
configurations réseau, les demandes HTTP passent par des intermédiaires tels que des serveurs
proxy et des pare-feu pendant leur transfert depuis le navigateur vers les composants de Cognos 8.
Certains intermédiaires modifient les informations que les composants de Cognos 8 utilisent pour
calculer le domaine de témoins ; ces composants ne parviennent alors pas à définir de témoins. Le
symptôme principal de ce problème est l'apparition répétée de l'invite de connexion. Pour éviter ce
problème, configurez le domaine des témoins.
Pour définir la valeur correcte pour le domaine des témoins, utilisez le format et la valeur qui
représentent la couverture la plus importante pour l'hôte.
Hôte Format du domaine Exemple

ordinateur ou serveur nom de l'ordinateur ou du serveur masociété
(sans point)
le suffixe est .com, .edu, .gov, .int, .nom.suffixe .ma société.com

.mil, .net ou .org
(deux points)
autre .nom1.nom2.suffixe .infosvoyage.co.nz

(trois points)
Procédure
3. Cliquez sur l'onglet Serveur.
4. Cliquez sur la colonne Valeur dans Paramètres de témoin (cookie) pour chaque propriété que
vous souhaitez modifier et indiquez la nouvelle valeur.
Si vous laissez la propriété Domaine vide, le distributeur déduit le domaine du nom d'hôte de
la demande.
Changement de passerelle
Pour améliorer les performances du serveur Web, vous pouvez configurer Cognos 8 pour qu'il uti-
lise d'autres passerelles à la place du programme CGI implicite. Vous pouvez utiliser l'une des pas-
serelles suivantes :
• Microsoft Internet Application Programming Interface (ISAPI) pour les services d'information
Internet de Microsoft sous Windows.
• apache_mod pour un serveur Web Apache.
• servlet pour un serveur d'application ou un serveur Web compatible Java.
Aucune configuration de serveur Web supplémentaire n'est requise pour utiliser ISAPI. Pour accé-
der aux composants de Cognos 8 à l'aide d'ISAPI, dans Cognos Configuration, remplacez la partie
cognos.cgi de la propriété URI de la passerelle par cognosisapi.dll. Définissez ensuite l'URI ISAPI,
http://nom_hôte/cognos8/isapi, dans votre navigateur.
Avant de changer de passerelle, il est recommandé de vérifier que la passerelle CGI implicite et
votre configuration fonctionnent dans votre environnement.
Configuration de la passerelle pour le module Cognos Apache Web Server

Cognos 8 intègre deux modules Apache. Le module Cognos Apache requiert Apache Server 1.3.x
et le module Cognos Apache 2 requiert Apache Server 2.0.x.

Procédure
1. Arrêtez le serveur Web Apache.
2. Ajoutez le répertoire emplacement_c8/cgi-bin à la variable d'environnement appropriée :
• Sous Solaris ou Linux : LD_LIBRARY_PATH
• Sous HP-UX,
Pour Apache 1.3 : SHLIB_PATH
Pour Apache 2.0 : SHLIB_PATH et LD_LIBRARY_PATH
• Sous AIX : LIBPATH
3. Sous HP-UX, procédez comme suit :
• Assurez-vous que la variable d'environnement LD_PRELOAD contient /usr/lib/libcl.2.
• Pour Apache 1.3, définissez la variable d'environnement COG_CGIBIN_DIR sur
emplacement_c8/cgi-bin.
4. Ouvrez le répertoire 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 à :
Système d'exploitation Module Apache 1,3 Module Apache 2.0

Windows mod_cognos.dll mod2_cognos.dll
Solaris, AIX ou Linux mod_cognos.so mod2_cognos.so
HP-UX mod_cognos.sl mod2_cognos.sl
Sous Linux, le module Apache 2.0 est requis.

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 :
ScriptAlias /cognos8/cgi-bin "c8_location/cgi-bin"
Alias /cognos8 "c8_location/webcontent"
<Directory "c8_location/webcontent">
Options Indexes MultiViews
</Directory>
La directive <Directory> est facultative.
Conseil : Veillez à définir l'alias cognos8/cgi-bin avant l'alias cognos8.
9. Ajoutez ce qui suit à la section des rapports d'état du serveur :
<Location /cognos8/cgi-bin/cognos_module>
SetHandler cognos-handler
</Location>
10. Pour activer la page de diagnostic de la passerelle, ajoutez ce qui suit à la section des rapports
d'état du serveur :
<Location /cognos8/cgi-bin/diag_cognos_module>
SetHandler cognos-handler
</Location>
La chaîne diag_ est requise.
11. 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 "c8_location/cgi-bin"
</IfModule>
12. Pour Apache 2.0, ajoutez ce qui suit à la section de l'annuaire d'utilisateurs :
<IfModule mod_cognos.c>
138
CGIBinDir "c8_location/cgi-bin"
</IfModule>
13. Enregistrez et fermez le fichier.
14. Pour Apache 2.0, sous HP-UX, activez la recherche de LD_LIBRARY_PATH en exécutant la
commande suivante dans le répertoire installation_Apache/bin :
chatr +s enable +b enable httpd
15. Démarrez le serveur Web Apache.
16. Dans Cognos Configuration, configurez la propriété URI de la passerelle de façon à ce qu'elle
utilise la passerelle apache_mod :
http://nom_hôte:port/cognos8/cgi-bin/nom_fichier
où nom_fichier correspond au nom utilisé à l'étape 9.
Configuration d'une passerelle de type servlet

Vous pouvez configurer la passerelle de type servlet pour qu'elle s'exécute sous un serveur d'appli-
cation pris en charge ou le serveur Web Sun Java System.
Remarque : Le serveur Web Sun Java System était auparavant appelé serveur Web Sun ONE ou
serveur Web iPlanet.
Après avoir vérifié que les composants requis sont installés et fonctionnent, copiez les fichiers du
fournisseur de sécurité de Cognos dans l'environnement JVM, configurez Cognos 8, modifiez le
script de démarrage du serveur d'application (serveurs d'application uniquement), puis déployez
la passerelle de type servlet de Cognos sur le serveur d'application ou le serveur Web Sun Java Sys-
tem.
Les fichiers du fournisseur de sécurité de Cognos doivent être placés dans l'environnement JVM
utilisé par votre serveur d'application ou le serveur Sun Java System. Ces fichiers fournissent des
sous-programmes supplémentaires de chiffrement et de déchiffrement qui ne sont pas fournis dans
l'installation implicite du JVM. Pour garantir la sécurité, les fichiers de chiffrement doivent être
chargés par l'environnement JVM à l'aide du répertoire d'extensions Java.
Remarque : Pour le serveur Web Sun Java System, l'emplacement implicite du JRE est
emplacement_installation/bin/https/jdk.
Avant de configurer la passerelle de type servlet de Cognos, vérifiez les points suivants :
• le serveur d'application ou le serveur Web Sun Java System est installé et fonctionne sur cha-
que ordinateur où la passerelle de type servlet doit être installée,
• les composants de la passerelle Cognos 8 sont installés (p. 57) sur le même système que le ser-
veur d'application ou le serveur Web Sun Java System,
• le distributeur Cognos 8 et les composants de Content Manager sont installés et s'exécutent
dans l'environnement,
• le compte d'utilisateur du serveur d'application ou de Sun Java System dispose de droits
d'accès complets à l'installation Cognos.
Il est recommandé de créer un groupe UNIX ou Linux appelé cognos8. Ce groupe doit conte-
nir l'utilisateur qui démarre le serveur d'application ou le serveur Sun Java System et l'utilisa-
teur qui est propriétaire des fichiers Cognos. Définissez les droits de propriétaire des fichiers
Cognos pour le groupe cognos8 et définissez les droits d'accès à tous les fichiers Cognos sur
GROUP READABLE/WRITABLE/EXECUTABLE. Pour plus de simplicité, vous pouvez égale-
ment utiliser le compte d'utilisateur du serveur d'application ou de Sun Java System pour ins-
taller et exécuter les composants de Cognos.
Procédure de copie des fichiers du fournisseur de sécurité de Cognos

1. Sauvegardez le répertoire version_JVM/jre/lib/ext s'il existe.
2. Créez l'un des répertoires suivants s'il n'existe pas dans votre environnement JVM :
Pour JDK, version_JVM/jre/lib/ext
Pour JRE, version_JVM/lib/ext
Certains environnements JVM ne sont livrés avec aucun de ces répertoires.

3. Copiez le contenu du répertoire emplacement_c8/bin/jre/version/lib/ext dans le répertoire

version_JVM/jre/lib/ext de l'environnement JVM.
Important : Veillez à ne remplacer aucun fichier existant.
Procédure de configuration de Cognos 8

1. Pour le serveur Web Sun Java System, vous devez configurer la passerelle afin qu'elle décode
les témoins avant de créer le fichier d'application en procédant comme suit :
• Ouvrez emplacement_C8/war/gateway/web.xml dans un éditeur de texte ou xml et acti-
vez l'option urldecode en remplaçant la valeur du paramètre false par true.
<init-param>

<param-name>urldecodeCookies</param-name>

<param-value>true</param-value>
</init-param>
• Enregistrez le fichier.
2. Définissez la variable d'environnement JAVA_HOME de façon à ce qu'elle pointe vers l'envi-
ronnement JVM utilisé par le serveur d'application.
Conseil : Si le serveur de l'application ou le serveur Web Sun Java System est livré avec un
environnement JVM, la variable d'environnement JAVA_HOME doit être définie de telle sorte
qu'elle y fasse référence.
Cognos Configuration utilise cette variable pour localiser le composant JVM utilisé par le ser-
veur d'application ou le serveur Web Sun Java System et les fichiers du fournisseur de sécurité
fournis par Cognos.
3. Dans le répertoire emplacement_c8/bin, démarrez Cognos Configuration :
• Sous Windows, saisissez cogconfig.bat dans une fenêtre de commande ou sélectionnez
Cognos Configuration dans le menu Démarrer.
• Sous UNIX ou Linux, saisissez cogconfig.sh
Si des clés de chiffrement existantes sont incompatibles, vous êtes invité à en créer automati-
quement de nouvelles à ce stade.
4. Dans la fenêtre Explorateur de Cognos Configuration, développez Environnement.
5. Dans la section Paramètres de la passerelle de la fenêtre Propriétés, modifiez la propriété URI
du distributeur pour la passerelle de façon à utiliser le numéro de port et le nom d'hôte ou
l'adresse IP du serveur où le distributeur est installé.
La valeur de la racine de contexte implicite correspondant à la passerelle de type servlet est
/ServletGateway.
Pour en savoir davantage, reportez-vous à la section « Modification d'un URI » (p. 115).
6. Procédez aux autres modifications de configuration requises, comme l'activation de la sécu-
rité.
Les nouvelles clés cryptographiques sont créées à l'aide de la machine virtuelle Java définie par
la variable JAVA_HOME.
8. Pour créer le fichier d'application permettant le déploiement sur le serveur d'application ou le
serveur Web Sun Java System, cliquez sur Créer des fichiers d'application dans le menu Opéra-
tions.
L'assistant Création d'application s'ouvre, vous permettant de sélectionner le type d'applica-
tion à créer et la racine de contexte à utiliser pour accéder à l'application.
Pour le serveur Web Sun Java System, sélectionnez un fichier WAR sur la deuxième page de
l'assistant.
9. Fermez Cognos Configuration.
140
Si vous utilisez un serveur d'application, vous devez modifier maintenant son script de démar-
rage (p. 197), puis configurer ses propriétés et déployer les composants de Cognos (p. 198). Il
est recommandé de définir une taille maximale de segment de mémoire comprise entre
256 Mo et 512 Mo comme valeur de départ. Vous pourrez ensuite modifier cette valeur en
fonction des besoins de votre environnement.
Procédure de déploiement des composants de Cognos pour le serveur Web Sun Java
System
1. Démarrez le serveur Web Sun Java System.
2. Démarrez la console d'administration associée.
3. Créez une instance de serveur dans laquelle l'application Cognos 8 peut être déployée.
4. Ouvrez une invite de commande dans le répertoire suivant :
emplacement_Sun_Java_System\bin\https\httpadmin\bin
5. Déployez le fichier ServletGateway.war en utilisant la syntaxe suivante :
wdeploy deploy -u racine_contexte -i webserverinstance -v vs_id path/ServletGateway.war
Pour en savoir davantage, reportez-vous à la documentation relative au serveur d'application
Web Sun Java System.
Conseil : La racine de contexte implicite est /ServletGateway
6. Ajoutez le chemin d'accès emplacement_c8/bin à la variable d'environnement Native Lib Path
Prefix qui figure dans la section JVM Path Settings.
7. Cliquez sur le lien Appliquer dans la console d'administration.
Les modifications sont appliquées et le serveur redémarre.
Pour accéder aux composants de Cognos 8 à l'aide de la passerelle de type servlet, indiquez l'URI
de la passerelle. Par exemple :
http[s]:nom_hôte:port/ServletGateway
L'URI de la passerelle de type servlet est sensible à la casse.
Configuration de Cognos 8 pour fonctionner avec d'autres

produits de Cognos
Certains produits de Cognos offrent des fonctions non disponibles dans Cognos 8. Vous pouvez
continuer à utiliser ces produits dans le même environnement. D'autres tâches de configuration
peuvent se révéler nécessaires pour assurer l'accès de Cognos 8 à des objets créés à l'aide d'autres
produits de Cognos. Les conditions supplémentaires requises pour l'accès dépendent du mode
d'exécution choisi pour les deux produits.
Activation des rapports et agents programmés pour les sources de données de

Cognos Planning Contributor
Pour exécuter des rapports et agents programmés qui ont pour base des sources de données
Cognos Planning Contributor, vous devez définir un mot de passe secret partagé. Cela contribue à
la sécurité des communications entre les serveurs Cognos 8 et Contributor Data Server.
Procédure
1. Démarrez Cognos Configuration sur l'ordinateur Content Manager.
2. Dans la fenêtre Explorateur, cliquez sur Accès aux données, sur Cognos Planning, puis sur
Contributor Data Server.
3. Dans la fenêtre Propriétés, cliquez sur la zone Valeur à côté de la propriété Mot de passe de la
signature, puis sur le bouton d'édition lorsqu'il apparaît.
4. Dans la boîte de dialogue Valeur - Mot de passe de la signature, saisissez le mot de passe qui
sera l'objet d'une signature numérique.

Le mot de passe est sensible à la casse et doit correspondre à la propriété Mot de passe de la
signature que vous avez configurée dans les propriétés de Cognos Series 7, Configuration
Manager, Cognos Planning/Cognos 8 - Contributor Data Server/Général.
Une signature numérique est créée à partir du mot de passe. La signature numérique est encodée
par Cognos 8 et décodée par Contributor Data Server.
142
Chapitre 8 : Configuration de Cognos Office
Connection
Cognos Office Connection est automatiquement installé avec tous les produits serveur Cognos 8,
à l'exception de Metrics Manager.
Pour utiliser Cognos Office Connection, vous devez effectuer l'ensemble des tâches de configura-
tion décrites ci-dessous ou simplement une partie de ces tâches, en fonction de votre environne-
ment. Vous devez configurer des propriétés personnalisées dans un modèle à partir duquel les
utilisateurs de Microsoft Office pourront créer des documents, ou configurer des propriétés per-
sonnalisées dans un document. Un fichier de modèle pour Microsoft Excel est fourni avec
Cognos 8. Pour Microsoft Word et Microsoft PowerPoint, vous devez configurer des propriétés
personnalisées dans un document ou modèle nouveau ou existant.
Options de déploiement pour Cognos Office Connection

Cognos Office Connection utilise Microsoft .NET Framework pour permettre aux utilisateurs
d'interagir avec des composants serveur. Tous les utilisateurs de Cognos Office Connection doi-
vent avoir Microsoft .NET Framework version 1.1 SP1 installé sur leur ordinateur. Les ordina-
teurs clients doivent également disposer de Microsoft .NET Framework configuré pour les
applications Microsoft Office qu'ils utiliseront avec Cognos Office Connection.
Cognos Office Connection fournit deux types de clients : un client intelligent et un client de sup-
plément COM. Une installation de Cognos 8 peut prendre en charge à la fois les déploiements de
clients intelligents et de clients de supplément COM.
Un déploiement utilisant le client intelligent garantit une maintenance simplifiée, car il évite aux
utilisateurs d'avoir à installer Cognos Office Connection sur leur ordinateur. Si Cognos Office
Connection est mis à niveau avec une nouvelle version, les utilisateurs du client intelligent l'utilise-
ront automatiquement. Pour utiliser Cognos Office Connection avec le client intelligent, vous
devez configurer une propriété personnalisée dans un classeur, un document ou un modèle. Vous
devez également configurer la stratégie de sécurité d'exécution Microsoft .NET afin de permettre
au client intelligent de Cognos Office Connection de s'exécuter.
Un déploiement utilisant le client du supplément COM nécessite une installation sur l'ordinateur
des utilisateurs et la configuration de propriétés personnalisées dans les fichiers ou modèles Micro-
soft Office. Si Cognos Office Connection est mis à niveau avec une nouvelle version, les utilisa-
teurs du supplément COM doivent installer cette nouvelle version.
Les utilisateurs de Microsoft Excel et Microsoft Word disposant de Microsoft Office 2003 Profes-
sionnel peuvent utiliser le client intelligent ou le client du supplément COM de Cognos Office
Connection.
Les utilisateurs de Microsoft Office XP et Microsoft Office 2003 Standard, ainsi que tous les utili-
sateurs de Microsoft PowerPoint doivent utiliser le client du supplément COM.
Les fichiers ou modèles Microsoft Office qui sont configurés pour Cognos Office Connection peu-
vent être stockés dans un emplacement centralisé, envoyés par courrier électronique à d'autres uti-
lisateurs ou publiés dans Cognos Connection. Les options de déploiement que vous choisissez
pour ces fichiers dépendent de votre environnement. Les utilisateurs peuvent également configurer
leurs propres fichiers avec les propriétés personnalisées appropriées pour accéder à Cognos Office
Connection.
Pour déployer Cognos Office Connection avec Powerplay, vous pouvez configurer les mises en
correspondance des passerelles de façon à ce que les utilisateurs de Cognos Office Connection
puissent accéder aux rapports PowerPlay hébergés sur un serveur PowerPlay. Vous pouvez égale-
ment configurer la taille des rapports pouvant être importés dans Cognos Office Connection
depuis Cognos 8. Pour en savoir davantage sur les mises en correspondance de passerelles, repor-
tez-vous au Guide d'administration et de sécurité.

Chapitre 8 : Configuration de Cognos Office Connection
Tâches de configuration pour Cognos Office Connection

Utilisez la liste de contrôle suivante pour configurer Cognos Office Connection :
❑ Création d'un répertoire virtuel pour Cognos Office Connection.
❑ Mise à jour des types MIME reconnus par le serveur Web, s'il y a lieu.
❑ Activation du support SSL (Secure Socket Layer), s'il y a lieu.
❑ Désactivation de l'accès anonyme, s'il y a lieu.
❑ Configuration des fichiers Microsoft Office pour Cognos Office Connection.
❑ Déploiement du client Cognos Office Connection sur les environnements clients.
Création d'un répertoire virtuel pour Cognos Office

Connection
Vous devez configurer un répertoire virtuel, également appelé alias Web, correspondant au réper-
toire qui contient les fichiers HTML et Web destinés à Cognos Office Connection. Pour certains
serveurs Web, vous devez également activer la navigation dans ce répertoire virtuel et définir la
propriété relative aux droits d'exécution.
Seules les tâches relatives à Microsoft Internet Information Services (IIS) sont mentionnées ci-des-
sous. Vous devez définir le répertoire virtuel équivalent et ses propriétés si vous utilisez un autre
serveur Web.
Procédure pour IIS

1. Dans la console de gestion des services, repérez le répertoire virtuel créé pour Cognos 8.
S'il n'existe aucun répertoire virtuel pour Cognos 8, reportez-vous à la section
« Configuration du serveur Web » (p. 81).
2. Cliquez avec le bouton droit de la souris sur le répertoire virtuel de Cognos 8, puis cliquez sur
les options Nouveau et Répertoire virtuel.
3. Suivez la procédure proposée par l'assistant pour définir un alias et l'emplacement du contenu
Web de Cognos Office Connection, emplacement_c8/webcontent/coc, par exemple.
4. Cliquez avec le bouton droit de la souris sur le répertoire COC, puis cliquez sur l'option Pro-
priétés.
5. Dans l'onglet Répertoire virtuel, effectuez les opérations suivantes :
• Cochez la case Exploration de répertoire.
• Dans la zone Autorisations d'exécution, cliquez sur Scripts seulement.
6. Cliquez sur OK.
Mise à jour des types de contenu reconnus par le serveur Web

Pour certains types de serveurs Web, tels que Microsoft Internet Information Services (IIS) version
6.0 ou un serveur Windows 2003, vous devrez peut-être ajouter l'extension .config aux types de
contenu ou aux types MIME reconnus.
Seule les tâches relatives à IIS sont mentionnées ci-dessous. Il vous faudra peut-être réaliser une
définition équivalente pour votre serveur Web.
Procédure pour IIS

1. Dans le Gestionnaire des services IIS, localisez le répertoire emplacement_c8\webcontent\coc.
2. Cliquez avec le bouton droit de la souris sur le répertoire COC, puis cliquez sur l'option Pro-
priétés.
3. Dans l'onglet En-têtes HTTP, cliquez sur Types de fichiers.
4. Cliquez sur Nouveau type.
5. Dans la zone Extension associée, saisissez
.config
144
6. Dans la zone Type de contexte (MIME), saisissez

text/xml
7. Cliquez sur OK.
Activation du support SSL pour l'interface HTTPS de

PowerPlay
Si votre environnement contient Cognos Series 7 PowerPlay Enterprise Server et si vous utilisez
l'interface HTTPS pour accéder à PowerPlay, vous devez activer le support SSL (Secure Socket
Layer). Pour activer le support SSL pour la passerelle PowerPlay et le distributeur Cognos 8, vous
devez définir un mot de passe pour la bibliothèque de clés Cognos 8 puis créer et enregistrer le cer-
tificat de l'autorité de certification du serveur Web dans cette bibliothèque de clés.
Procédure d'activation du support SSL

1. Enregistrez le certificat de l'autorité de certification en tant que fichier ca.cer dans le répertoire
emplacement_c8\bin.
2. Si vous n'avez pas encore défini de mot de passe pour la bibliothèque de clés Cognos 8, fai-
tes-le maintenant dans Cognos Configuration.
• Dans la fenêtre Explorateur, cliquez sur Cryptographie, Cognos.
• Dans la section Paramètres de l'autorité de certification de la fenêtre Propriétés, définissez
l'option Mot de passe de la bibliothèque de clés de l'autorité de certification.
• Dans le menu Fichier, cliquez sur l'option Enregistrer.
• Dans le menu Opérations, cliquez sur l'option Redémarrer.
3. À partir de la ligne de commande, accédez au répertoire emplacement_c8\bin.
4. Définissez la variable d'environnement JAVA_HOME de façon à ce qu'elle pointe vers
l'emplacement JRE utilisé par le serveur d'application exécutant Cognos 8.
Les exemples ci-après présupposent que le serveur d'application Tomcat implicite est utilisé :
• Pour Microsoft Windows, saisissez
set JAVA_HOME=emplacement_c8\bin\jre\version
• Pour UNIX Cshell, saisissez
setenv JAVA_HOME emplacement_c8/bin/jre/version
5. Depuis la même ligne de commande, exécutez 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 bibliothèque de clés
• Pour UNIX, saisissez
ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeys-
tore-p
Au besoin, vous pouvez maintenant installer le certificat de l'autorité de certification sur le poste
client.
Procédure d'installation du certificat de l'autorité de certification sur le poste de tra-

vail client
1. Adressez-vous à l'autorité émettrice pour obtenir le certificat de l'autorité de certification.
Ce fichier possède l'extension .cer. Il ne s'agit pas du même certificat que celui utilisé par le
serveur Web, mais de celui destiné à l'autorité émettrice elle-même.
2. Cliquez deux fois sur le fichier .cer, cliquez sur l'option Installer le certificat, puis sur Suivant.
3. Cliquez sur Placer tous les certificats dans le magasin suivant.
4. Cliquez successivement sur les options Parcourir, Autorités de certification racines de con-
fiance et Suivant.

Activation de l'accès anonyme pour PowerPlay

Lorsque vous utilisez la connexion unique avec Microsoft Internet Information Services (IIS),
l'accès anonyme doit être activé pour que les utilisateurs du portail puissent accéder aux docu-
ments Cognos Office Connection basés sur des rapports PowerPlay.
Au besoin, une seconde passerelle PowerPlay peut être utilisée pour permettre l'accès anonyme à
Cognos Office Connection. Pour en savoir davantage, reportez-vous à la rubrique relative à la
définition des mises en correspondance de passerelles du Guide d'administration et de sécurité.
Procédure
2. Dans la fenêtre Explorateur, dans la section Sécurité, Authentification, cliquez sur l'option
Cognos.
3. Dans la fenêtre Propriétés, cochez la case située en regard de la propriété Autoriser les con-
nexions anonymes, puis cliquez sur l'option Vrai.
Configuration des fichiers Microsoft Office pour Cognos

Office Connection
Pour utiliser Cognos Office Connection avec les applications Microsoft Office, vous devez ajouter
des propriétés personnalisées à vos fichiers ou modèles.
Le tableau suivant fournit un récapitulatif des tâches de configuration requises pour chaque
méthode de déploiement.
Version de Composant de Déploiement du client Déploiement du

Microsoft Office Microsoft Office intelligent supplément COM
Microsoft Office Excel Configurez un modèle Configurez un modèle
2003 Professionnel ou fichier avec les ou fichier avec la
Word
propriétés suivantes : propriété suivante :
• CognosGateway • CognosGateway
• _AssemblyName
• _AssemblyLocation
PowerPoint Il n'existe pas de Configurez un modèle

déploiement de client ou une présentation
intelligent pour avec la propriété
Microsoft PowerPoint. suivante :
• CognosGateway
Microsoft Office Excel Il n'existe pas de Configurez un modèle

2003 Standard ou déploiement de client ou fichier avec la
Word
Microsoft Office XP intelligent pour propriété suivante :
PowerPoint Microsoft Office 2003 • CognosGateway
Standard ou Microsoft
Office XP.
Un exemple de modèle Microsoft Excel nommé CognosOfficeConnection.xlt est fourni dans le

répertoire emplacement_c8\webcontent\coc. Vous pouvez utiliser ce fichier ou ajouter les proprié-
tés personnalisées à vos propres fichiers ou modèles.
146
Si la valeur de l'une des propriétés personnalisées contient plus de 255 caractères, vous pouvez
ajouter un chiffre au nom de la propriété puis saisir une autre propriété personnalisée en incré-
mentant le nombre de 1. Par exemple, si vous saisissez une valeur pour la propriété
_AssemblyLocation dont le chemin d'accès contient 258 caractères, vous devez saisir les
255 premiers caractères dans la propriété _AssemblyLocation0. Ensuite, vous devez ajouter une
autre propriété personnalisée, _AssemblyLocation1, pour les 3 caractères restants. La valeur est
concaténée lors de la lecture de la propriété personnalisée.
Le tableau ci-dessous décrit les propriétés personnalisées que vous devez définir dans vos fichiers
ou modèles Microsoft Office.
Propriété
personnalisée Description Valeur
CognosGateway Requise pour toutes les http://nom_serveur:port/cognos8/cgi-
versions de Microsoft Office. bin/cognos.cgi
Indique l'URI de la passerelle Pour les utilisateurs du client
Cognos 8. intelligent Microsoft Office 2003
Professionnel, vous pouvez définir
une valeur implicite dans le fichier
Excel.EXE.config ou
Word.EXE.config, dans le répertoire
emplacement_c8\webcontent\coc.
_AssemblyName Utilisée par les clients Pour Microsoft Excel :

intelligents de Microsoft Office ExcelSmartClient
2003 Professionnel.
Pour Microsoft Word :
Nom de la bibliothèque de liens
dynamiques (DLL) du client WordSmartClient
intelligent, sans l'extension .dll.
_AssemblyLocation Utilisée par les clients http://nom_serveur:numéro_port_web

intelligents de Microsoft Office server/cognos8/coc
2003 Professionnel.
Emplacement du fichier dll du
client intelligent.
LogFile Facultative. c:\logs\LogFile.log

Fichier dans lequel les Le nom des fichiers de journalisation
informations sont journalisées. comporte une date et une heure, par
exemple
Si vous activez la journalisation
FichierJournal_155928924.log.
pour un modèle, elle le sera
également pour tous les fichiers
créés à partir de ce modèle.
AutoLogFile Facultative. c:\logs\AutoLogFile.log

Fichier dans lequel les
informations sont journalisées
pour le traitement par lots.
Pour en savoir davantage,
reportez-vous au Guide de
l'utilisateur de Cognos Office
Connection.
FBAC Pour activer l'authentification Oui ou Non

basée sur les formulaires.
La propriété FBAC peut être
utilisée avec des applications de
sécurité telles que SiteMinder.

Si des utilisateurs ont publié des documents dans Cognos Connection à l'aide d'un modèle issu
d'une version antérieure de Cognos Office Connection, leurs propriétés personnalisées doivent
être mises à jour. Pour en savoir davantage, reportez-vous à la section « Mise à niveau des docu-
ments Cognos Office Connection » (p. 54).
Procédure
1. Démarrez Microsoft Excel, Word ou PowerPoint.
2. Ouvrez un modèle (.xlt, .dot, ou .pot) ou un fichier (.xls, .doc, or .ppt).
3. Dans le menu Fichier, cliquez sur l'option Propriétés.
4. Cliquez sur l'onglet Personnaliser.
5. Ajoutez les propriétés personnalisées requises.
Pour en savoir davantage sur les propriétés personnalisées, reportez-vous aux tableaux de la
section « Configuration des fichiers Microsoft Office pour Cognos Office
Connection » (p. 146).
Après avoir attribué un nom et une valeur à une propriété personnalisée, n'oubliez pas de cli-
quer sur l'option Ajouter ou Modifier pour enregistrer cette propriété personnalisée avant
d'en ajouter une autre.
6. Une fois que vous avez ajouté ou modifié toutes les propriétés personnalisées voulues, cliquez
sur le bouton OK.
7. Enregistrez le fichier modifié en tant que modèle ou fichier.
Cognos Office Connection crée également un numéro d'identification permettant de distin-
guer les différents classeurs. Ce numéro figure dans la liste des propriétés personnalisées sous
la forme InstanceID0. Il est conseillé de ne pas en modifier la valeur.
Le modèle ou fichier est maintenant prêt à être utilisé avec Cognos Office Connection. Vous pou-
vez distribuer vos fichiers ou modèles en les stockant dans un emplacement centralisé, en les
envoyant par courrier électronique à d'autres utilisateurs ou en les publiant dans Cognos Connec-
tion. Par exemple, si vous disposez d'un emplacement centralisé pour les modèles, vous pouvez
copier ou enregistrer le fichier ou modèle dans cet emplacement afin que les utilisateurs puissent y
accéder.
Déploiement du client Cognos Office Connection

Cognos Office Connection est automatiquement installé avec Cognos 8. Une fois que Cognos 8 est
installé et configuré, vous devez déployer Cognos Office Connection sur les postes de travail
client.
Cognos Office Connection utilise Microsoft .NET Framework pour permettre aux utilisateurs
d'interagir avec des composants serveur. Tous les utilisateurs de Cognos Office Connection doi-
vent avoir Microsoft .NET Framework version 1.1 SP1 installé sur leur ordinateur. Les ordina-
teurs clients doivent également disposer de Microsoft .NET Framework configuré pour les
applications Microsoft Office qu'ils utiliseront avec Cognos Office Connection.
Cognos Office Connection fournit deux types de clients : un client intelligent et un client de sup-
plément COM. Une installation de Cognos 8 peut prendre en charge à la fois les déploiements de
clients intelligents et de clients de supplément COM.
Un déploiement utilisant le client intelligent garantit une maintenance simplifiée, car il évite aux
utilisateurs d'avoir à installer Cognos Office Connection sur leur ordinateur. Si Cognos Office
Connection est mis à niveau avec une nouvelle version, les utilisateurs du client intelligent l'utilise-
ront automatiquement. Pour utiliser Cognos Office Connection avec le client intelligent, vous
devez configurer une propriété personnalisée dans un classeur, un document ou un modèle. Vous
devez également configurer la stratégie de sécurité d'exécution Microsoft .NET afin de permettre
au client intelligent de Cognos Office Connection de s'exécuter.
Un déploiement utilisant le client du supplément COM nécessite une installation sur l'ordinateur
des utilisateurs et la configuration de propriétés personnalisées dans les fichiers ou modèles Micro-
soft Office. Si Cognos Office Connection est mis à niveau avec une nouvelle version, les utilisa-
teurs du supplément COM doivent installer cette nouvelle version.
148
Les utilisateurs de Microsoft Excel et Microsoft Word disposant de Microsoft Office 2003 Profes-
sionnel peuvent utiliser le client intelligent ou le client du supplément COM de Cognos Office
Connection.
Les utilisateurs de Microsoft Office XP et Microsoft Office 2003 Standard, ainsi que tous les utili-
sateurs de Microsoft PowerPoint doivent utiliser le client du supplément COM.
Utilisez le tableau suivant pour déterminer les tâches de configuration requises pour la méthode de
déploiement que vous voulez utiliser. Les deux méthodes de déploiement exigent l'installation de
Microsoft .NET Framework sur l'ordinateur de tous les utilisateurs de Cognos Office Connection.
Version de Composant de Déploiement du client Déploiement du

Microsoft Office Microsoft Office intelligent supplément COM
Microsoft Office Excel Propriétés Installez le supplément
2003 Professionnel personnalisées définies .NET à l'aide de
Word
dans le modèle ou le l'exécutable MSI fourni.
fichier : (p. 150)
• _AssemblyName Définissez les propriétés
• _AssemblyLocation personnalisées suivantes
• CognosGateway dans un modèle ou un
fichier :
Pour en savoir
• CognosGateway
davantage,
reportez-vous au Guide Pour en savoir
d'installation et de davantage,
configuration. reportez-vous au Guide
d'installation et de
configuration.
PowerPoint Il n'existe pas de Installez le supplément

déploiement de client .NET à l'aide de
intelligent pour l'exécutable MSI fourni.
Microsoft Office XP ou (p. 150)
Microsoft Office 2003 Définissez les propriétés
Standard.
personnalisées suivantes
dans un modèle ou un
fichier :
• CognosGateway
Pour en savoir
davantage,
reportez-vous au Guide
configuration.
Microsoft Office Excel Il n'existe pas de Installez le supplément

2003 Standard ou déploiement de client .NET à l'aide de
Word
Microsoft Office XP intelligent pour l'exécutable MSI fourni.
PowerPoint Microsoft Office 2003 (p. 150)
Standard ou Microsoft Définissez les propriétés
Office XP.
personnalisées suivantes
dans un modèle ou un
fichier Microsoft
Office :
• CognosGateway
Pour en savoir
davantage,
reportez-vous au Guide
configuration.

Les utilisateurs de clients intelligents Microsoft Office 2003 Professionnel Excel ou Word devront
peut-être mettre à jour leurs paramètres de sécurité Microsoft .NET Framework et installer le cer-
tificat de l'autorité de certification du serveur Web.
Utilisez la liste de contrôle suivante comme guide de déploiement :
❑ Installation de Microsoft .NET Framework.
❑ Ajout de la fonction Microsoft .NET aux composants Microsoft Office.
❑ Activation de la sécurité Microsoft .NET Framework.
❑ Activation ou désactivation de la fonction Cognos Office Connection pour les utilisateurs du
supplément COM, s'il y a lieu.
❑ Test de Cognos Office Connection.
Installation de Microsoft .NET Framework

Cognos Office Connection exige l'installation de Microsoft .NET Framework version 1.1 SP1 sur
l'ordinateur de tous les utilisateurs.
Procédure
• Exécutez l'utilitaire d'installation pour Microsoft .NET Framework version 1.1 puis Micro-
soft .NET Framework version 1.1 SP1 sur chaque ordinateur qui utilisera Cognos Office Con-
nection.
Microsoft .NET Framework version 1.1 et version 1.1 SP1 peuvent être téléchargés à partir du
site Web Microsoft MSDN.
Vous devez redémarrer l'ordinateur pour terminer l'installation.
Remarque : Lorsque vous installez Microsoft .Net Framework 1.1 et Service Pack 1 sur un
système d'exploitation dont la langue n'est pas l'anglais, les messages d'erreurs, raccourcis et
utilitaires Microsoft .Net s'afficheront 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 exem-
ple, si votre système d'exploitation est français et que vous avez installé Microsoft .Net Fra-
mework 1.1 et Service Pack 1, vous devez également appliquer le pack linguistique Microsoft
.NET français.
Ajout de la fonction Microsoft .NET Framework aux composants Microsoft

Office
La fonction Microsoft .NET Framework pour les utilisateurs de clients intelligents s'ajoute aux
composants Microsoft Office 2003 Professionnel à l'aide de l'utilitaire Ajout/Suppression de pro-
grammes de votre système d'exploitation Windows.
En ce qui concerne les utilisateurs du supplément COM, un programme d'installation doit être
exécuté sur chaque ordinateur qui utilisera Cognos Office Connection. Le supplément COM offre
une fonction .NET Framework aux utilisateurs des environnements suivants :
• Microsoft Office XP
• Microsoft Office 2003 Standard
• Microsoft Office 2003 Professionnel pour utiliser le déploiement du supplément COM de
Cognos Office Connection
• Microsoft PowerPoint
L'utilitaire d'installation est fourni dans le répertoire emplacement_c8\webcontent\coc. L'installa-
tion définit un objet COM et copie les fichiers de programmabilité Microsoft .NET spécifiques à
l'environnement de l'utilisateur. L'utilitaire d'installation peut être exécuté à distance ou copié sur
l'ordinateur des utilisateurs pour être exécuté en local.
Procédure pour les utilisateurs du client intelligent

1. Dans le menu Démarrer, cliquez sur Paramètres, Panneau de configuration et Ajout/Suppres-
sion de programmes.
150
2. Cliquez sur Microsoft Office Édition Professionnelle 2003 et sur Modifier.

La boîte de dialogue Installation de Microsoft Office 2003 s'affiche.
3. Cliquez sur Ajouter ou supprimer des composants et sur Suivant.
4. Cochez la case Choisir la personnalisation avancée des applications.
5. Développez chaque composant Microsoft Office, cliquez sur Prise en charge de la program-
mabilité .NET et sur Exécuter à partir du Poste de travail.
Sélectionnez cette option pour Microsoft Excel, Microsoft Word et Microsoft PowerPoint.
Vous devez également suivre la procédure ci-dessous si vous utilisez Microsoft PowerPoint
avec Cognos Office Connection.
6. Cliquez sur Mettre à jour.
Procédure pour les utilisateurs du supplément COM

1. Ouvrez le répertoire emplacement_c8\webcontent\coc et exécutez l'utilitaire d'installation :
• Pour Microsoft Office XP, cliquez deux fois sur le fichier COCOfficeXPAddinSetup.msi.
• Pour les utilisateurs de Microsoft Office 2003 Standard, PowerPoint Microsoft Office
2003 Professionnel ou les utilisateurs du supplément COM pour Microsoft Office 2003
Professionnel, cliquez deux fois sur le fichier COCOfficeXPAddinSetup.msi.
Ce fichier se trouve dans le répertoire emplacement_c8\webcontent\coc. Les utilisateurs peu-
vent exécuter le fichier à partir de cet emplacement, s'ils peuvent y accéder, ou copier le fichier
sur un serveur et l'exécuter à partir de là.
2. Suivez les instructions fournies par l'utilitaire.
Si vous installez Cognos Office Connection pour Tous, Cognos Office Connection ne figurera
pas dans le menu du supplément COM de votre produit Microsoft Office. Si vous l'installez
pour Just Me, vous pourrez voir Cognos Office Connection dans le menu du supplément
COM.
Activation de la sécurité Microsoft .NET Framework pour les utilisateurs du

client intelligent
Cognos Office Connection a été signé avec une clé Nom fort. Cela signifie que vous devez activer
la sécurité Microsoft .NET Framework afin de sécuriser le code Cognos Office Connection pour
l'application à exécuter. Cette action ne doit être réalisée que pour les utilisateurs des clients intel-
ligents de Microsoft Excel ou Word Office 2003 Professionnel. Les utilisateurs d'un déploiement
du supplément COM de Cognos Office Connection n'ont pas à activer la sécurité .NET Fra-
mework.
Si vous avez utilisé un chemin d'accès local, tel que C:\Program Files\cognos\c8\webcontent\coc
pour la propriété _AssemblyLocation de vos fichiers Microsoft Excel ou Word, vous devez ajouter
le paramètre de sécurité Nom fort au niveau Utilisateur. Dans le cas contraire, il convient d'ajouter
ce paramètre de sécurité au niveau Ordinateur.
Vous devez également déployer la configuration de la sécurité Microsoft .NET Framework.
Microsoft recommande différentes techniques pour déployer les paramètres de sécurité. Par exem-
ple, vous pouvez créer un fichier .bat pour exécuter un script CASPOL permettant d'ajouter une
stratégie. Vous avez également la possibilité d'utiliser un programme de configuration .msi et une
classe de programme d'installation personnalisée pour configurer la stratégie. Si les clients appar-
tiennent à un domaine utilisant Active Directory ou SMS, vous pouvez également déployer la stra-
tégie avec Active Directory ou SMS. Pour en savoir davantage, consultez le site Web MSDN
(Microsoft Developer Network).
Veillez à installer d'abord Microsoft .NET Framework.
Procédure
1. Démarrez l'outil Configuration Microsoft .NET Framework 1.1 (Démarrer, Paramètres, Para-
mètres de configuration, Outils d'administration).
2. Développez le noeud Stratégie de sécurité du runtime, Utilisateur, Groupes de codes ou Straté-
gie de sécurité du runtime, Ordinateur, Groupes de codes selon la valeur de la propriété
_AssemblyLocation.

3. Cliquez avec le bouton droit de la souris sur le groupe All_Code, puis cliquez sur Nouveau.
4. Saisissez un nom pour le groupe de codes, puis cliquez sur Suivant.
Par exemple, vous pouvez saisir Cognos comme nom du groupe de codes.
5. Dans la zone de sélection, cliquez sur Nom fort, puis cliquez sur Suivant.
6. Cliquez sur Importer, puis recherchez le fichier ExcelSmartClient.dll ou le fichier WordSmart-
Client.dll sur le serveur.
Si vous avez accès au répertoire d'installation de Cognos 8, allez dans le répertoire
emplacement_c8\webcontent\coc et sélectionnez le fichier ExcelSmartClient.dll ou WordS-
martClient.dll. Sinon, vous pouvez aller dans le répertoire à l'aide d'un chemin d'accès Web,
tel que http://nom_serveur/cognos/coc. Vous devrez peut-être saisir le nom du fichier, soit
ExcelSmartClient.dll, soit WordSmartClient.dll.
7. Sélectionnez le fichier ExcelSmartClient.dll ou WordSmartClient.dll et cliquez sur Ouvrir.
La clé publique est importée à partir du fichier avec le nom et la version associés. La même clé
publique est utilisée pour ces deux fichiers. Ne sélectionnez pas ces options (les cases corres-
pondantes ne doivent pas être cochées).
8. Cliquez sur Suivant.
9. Acceptez la valeur implicite, Full Trust, puis cliquez sur Suivant.
11. Si le fichier Microsoft.mshtml.dll n'est pas installé dans le Global Assembly Cache, répétez les
étapes 3 à 10, avec les modifications suivantes :
• Pour l'étape 4, saisissez un autre nom, tel que MS html.
• Pour les étapes 6 et 7, sélectionnez le fichier Microsoft.mshtml.dll dans le même réper-
toire.
Conseil : Vous pouvez vérifier si le fichier Microsoft.mshtml.dll a été installé en allant dans le
répertoire C:\WINDOWS\assembly et en le cherchant dans la liste des assemblages.
Après le redémarrage de l'application Microsoft Office, Cognos Office Connection s'exécute dans
un environnement sécurisé.
Vous pouvez également déployer manuellement les paramètres de sécurité à l'aide d'un fichier .bat
exécutant la commande CASPOL dans votre répertoire .NET.
Définition du niveau de sécurité des macros pour Microsoft Office XP

Pour les applications Microsoft Office XP qui exécutent Cognos Office Connection, vous devez
définir le niveau de sécurité des macros de façon appropriée. Vous le devez définir pour Microsoft
Excel, Microsoft Word ou Microsoft PowerPoint.
Procédure
1. Ouvrez votre application Microsoft Office XP.
2. Dans le menu Outils, cliquez sur Macros, puis sur Sécurité.
3. Indiquez si vous souhaitez modifier le niveau de sécurité ou les publications sécurisées.
• Dans l'onglet Security Level, cliquez sur Moyen ou sur Faible, puis sur le bouton OK.
• Dans l'onglet Trusted Publishers, sélectionnez Trust all installed add-ins or templates et
cliquez sur le bouton OK.
Activation ou désactivation de la fonction Cognos Office Connection pour les

utilisateurs du supplément COM
Les utilisateurs qui déploient Cognos Office Connection à l'aide du supplément COM peuvent
activer ou désactiver la fonction Cognos Office Connection grâce à une option de la barre d'outils.
Cette fonctionnalité sera activée ou désactivée lors de la prochaine ouverture du document.
Procédure
1. Démarrez votre application Microsoft Office.
2. Dans le menu Outils, cliquez sur Personnaliser.
152
3. Cliquez sur l'onglet Commandes.

4. Dans la section Catégories, cliquez sur Outils.
5. Dans la section Commandes, cliquez sur l'option Suppléments COM et faites-la glisser dans
une barre d'outils.
6. Cliquez sur Fermer.
7. Dans la barre d'outils, cliquez sur Suppléments COM.
8. Si Cognos Office Connection n'est pas répertorié sous Macros complémentaires disponibles,
procédez comme suit :
• Cliquez sur Ajouter.
• Allez à l'emplacement où vous avez installé les fichiers Cognos Office Connection.
Par défaut, les fichiers sont installés à l'emplacement C:\Program Files\Cognos\Cognos
Office Connection.
• Sélectionnez le fichier de supplément :
Pour Microsoft XP, COMAddInShimXP.dll
Pour Microsoft 2003, COMAddInShim2K3.dll
• Cliquez sur OK.
9. Cochez ou décochez la case Cognos Office Connection et cliquez sur OK.
Les changements seront appliqués lors de la prochaine ouverture d'un fichier Cognos Office Con-
nection.
Test de Cognos Office Connection

Vous pouvez tester l'installation des composants client en démarrant Cognos Office Connection.
Cognos Office Connection est lancé automatiquement lorsque les utilisateurs ouvrent un fichier
ou un modèle Microsoft Office qui a été configuré pour Cognos Office Connection.
Procédure
1. Démarrez Microsoft Excel, Word ou PowerPoint.
2. Effectuez l'une des actions suivantes :
• Ouvrez un classeur, un document ou une présentation qui ont été configurés pour Cognos
Office Connection.
• Créez un classeur, un document ou une présentation à l'aide d'un modèle qui a été confi-
guré pour Cognos Office Connection.

154
Chapitre 9 : Configuration de Cognos Portal
Services
Cognos Portal Services fournit un ensemble de portlets Cognos utilisables dans Cognos Connec-
tion ou dans des portails tiers. Vous pouvez utiliser les portlets pour parcourir, afficher et effectuer
des recherches dans les rapports Cognos de votre environnement de travail. D'autres utilisateurs
peuvent afficher les informations Cognos sans savoir utiliser les produits Cognos.
Cognos Portal Services est installé automatiquement avec les composants Cognos 8. Dans un envi-
ronnement réparti, il est inclus dans les composants d'application. L'installation inclut les fichiers
de déploiement pour :
• le portail SAP Enterprise Portal (SAP EP),
• le portail IBM WebSphere 5.0,
• le portail Plumtree.
Pour certains déploiements de Cognos Portal Services, vous devez modifier des paramètres de pro-
priété de Cognos Portal Services et configurer l'environnement Cognos pour qu'il prenne en
charge le portail tiers.
S'il est utilisé dans un portail tiers, Cognos Portal Services ne peut authentifier les utilisateurs que
dans un seul espace-noms. Si les composants de Cognos 8 sont configurés avec plusieurs espa-
ces-noms, vous devez installer une passerelle distincte pour chaque espace-noms servant à authen-
tifier les utilisateurs du portail. Vous devez configurer chaque passerelle pour l'espace-noms
approprié (p. 120), puis configurer les portlets déployés pour qu'ils utilisent cette passerelle.
Après avoir configuré les propriétés requises, vous devez déployer les portlets Cognos vers un por-
tail tiers. Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
Pour utiliser Cognos Portal Services avec les composants de Cognos 8, procédez comme suit :
❑ Indiquez l'emplacement du fichier applications.xml, s'il y a lieu.
❑ Installez et testez les portlets sur le portail tiers.
❑ Configurez la sécurité pour l'environnement de portail tiers.
Indication de l'emplacement du fichier Applications.xml

Si vous utilisez le fichier applications.xml en tant qu'élément d'un portlet d'application personna-
lisé, tous les ordinateurs des composants d'application d'un environnement réparti doivent faire
référence au même fichier applications.xml. Si vous disposez de plusieurs instances du fichier
applications.xml, elles doivent toutes être identiques.
Remarque : Cette procédure n'est requise que si vous souhaitez utiliser le portlet des applications
étendues, qui est fourni avec le SDK (Software Development Kit) de Cognos 8.
Procédure
1. Démarrez Cognos Configuration sur l'ordinateur sur lequel vous avez installé le serveur de
rapports.
2. Dans la section Environnement de la fenêtre Explorateur, cliquez sur Portal Services.
3. Dans la fenêtre Propriétés, cliquez sur la valeur située en regard de l'option Emplacement du
fichier 'applications.xml'.

Chapitre 9 : Configuration de Cognos Portal Services
4. Remplacez la valeur « localhost » par un nom d'hôte valide ou une adresse IP et, le cas
échéant, remplacez le numéro de port implicite.
Vous pouvez maintenant déployer les portlets de Cognos sur votre serveur de portail. Pour obtenir
des instructions, reportez-vous au Guide d'administration et de sécurité.
Configuration de la sécurité de Cognos Portal Services

Si vous utilisez Portal Services dans un portail tiers, vous devez activer le code d'accès unique afin
d'assurer l'intégration transparente entre le portail tiers et les composants de Cognos 8.
Portal Services utilise un code d'accès unique pour authentifier les utilisateurs. Autrement dit, les
utilisateurs n'ont pas besoin de se connecter à d'autres applications séparément par l'intermédiaire
du portail.
Vous devez configurer un URI dans les composants de Cognos 8 pour chaque portlet dans Portal
Services.
Pour activer la sécurité entre les composants de Cognos 8 et le portail tiers, procédez comme suit :
❑ Désactivez l'accès anonyme aux composants de Cognos 8.
Si votre infrastructure de sécurité nécessite que vous fassiez appel à une autre méthode de code
d'accès unique, utilisez l'une des méthodes suivantes :
❑ Activez un code d'accès unique pour le portail tiers à l'aide d'un secret partagé.
Si votre infrastructure de sécurité nécessite que vous fassiez appel à une autre méthode de code
d'accès unique, utilisez l'une des méthodes suivantes :
• « Activation du code d'accès unique pour le portail WebSphere à l'aide du serveur
d'application » (p. 163)
• « Activation du code d'accès unique pour le portail Plumtree à l'aide de l'authentification
de base » (p. 163)
• « Activation du code d'accès unique pour le portail Plumtree à l'aide de
SiteMinder » (p. 164)
❑ Le cas échéant, configurez les composants de Cognos 8 pour l'accès SSL.
Pour obtenir des instructions, reportez-vous au Guide d'installation et de configuration.
Désactivation de l'accès anonyme aux composants de Cognos 8

Portal Services utilise un code d'accès unique pour l'authentification. Lorsque la connexion ano-
nyme est activée dans les composants de Cognos 8, Portal Services connecte tous les utilisateurs du
portail en tant qu'utilisateurs anonymes. Assurez-vous que l'accès anonyme est désactivé dans les
composants de Cognos 8 pour que le code d'accès unique dans Portal Services fonctionne correc-
tement. Cependant, vous pouvez tester les connexions de Portal Services à l'aide de la connexion
anonyme pour vous assurer que les portlets fonctionnent dans le portail tiers.
Lorsque Portal Services ne parvient pas à authentifier un utilisateur, ce dernier voit un message
d'erreur s'afficher sur le portail tiers.
Procédure
Cognos.
3. Dans la fenêtre Propriétés, vérifiez que l'option Autoriser les connexions anonymes a la valeur
Faux.
5. Répétez les étapes 1 à 4 sur tous les serveurs sur lesquels les composants de Cognos 8 sont ins-
tallés.
156
Activation du code d'accès unique avec le secret partagé

Vous pouvez utiliser un secret partagé pour activer un code d'accès unique entre les portlets de
Cognos et les composants de Cognos 8. Les portlets de Cognos envoient un message contenant
une version chiffrée du code d'utilisateur du portail. La clé de chiffrement est déterminée par la
valeur d'une chaîne de caractères secrète partagée par les portlets et le fournisseur de sécurité Java
personnalisé sur le serveur Cognos.
Vous pouvez utiliser un secret partagé pour le portail tiers uniquement si les codes d'utilisateurs du
portail peuvent être recherchés dans un espace-noms d'authentification NTLM, LDAP ou Cognos
Series 7 partagé par les composants de Cognos 8.
Les composants de Cognos 8 doivent avoir accès à un serveur d'annuaire contenant les codes
d'utilisateurs de tous les utilisateurs du portail. À l'aide de Cognos Configuration, vous devez con-
figurer un espace-noms d'authentification pour que le portail et les composants de Cognos 8 par-
tagent la même source d'authentification.
Vous devez également créer un espace-noms de fournisseur Java personnalisé pour enregistrer le
fournisseur Java du secret partagé qui est proposé avec les composants de Cognos 8. Au sein des
portlets ou iViews, vous devez lier ces portlets ou iViews à l'espace-noms du fournisseur Java per-
sonnalisé à l'intérieur de votre portail respectif :
• Cognos iViews (SAP EP)
• application de portlet de Cognos (portail WebSphere)
• serveur distant (portail Plumtree)
Il est inutile de configurer l'accès au contenu Web de Portal Services. En revanche, si vous
déployez les portlets vers un portail tiers, vous pouvez configurer l'accès vers un autre URI pour
les images et le contenu Web de Portal Services.
Procédure de configuration des espaces-noms requis

1. Dans Cognos Configuration, configurez un espace-noms pour authentifier les utilisateurs du
portail.
Pour en savoir davantage, reportez-vous à la rubrique relative à la configuration des fournis-
seurs d'authentification LDAP, NTLM ou Cognos Series 7 dans le Guide d'installation et de
configuration.
Pour en savoir davantage, reportez-vous à la section « Configuration des composants de
Cognos 8 pour un fournisseur d'authentification » (p. 165).
2. Pour un espace-noms LDAP, configurez les propriétés suivantes :
• Remplacez la valeur de la propriété Voulez-vous utiliser une identité externe ? par Vrai.
• Définissez la valeur de la propriété Correspondance des identités externes sur :
(uid=${environment("REMOTE_USER")})
D'autres propriétés peuvent être requises. Pour en savoir davantage, reportez-vous à la rubri-
que relative à la configuration des composants de Cognos 8 pour LDAP dans le Guide d'ins-
tallation et de configuration.
3. Si vous utilisez un espace-noms Series 7, vous devez mettre en correspondance les codes d'uti-
lisateurs du portail avec les codes d'utilisateurs Series 7 à l'aide des codes d'accès au système
d'exploitation.
Pour en savoir davantage, reportez-vous à la documentation de Cognos Series 7.
4. Dans Cognos Configuration, créez et configurez un espace-noms de fournisseur Java person-
nalisé.
Pour en savoir davantage, reportez-vous à la rubrique relative à la configuration d'un
espace-noms d'authentification personnalisé dans le Guide d'installation et de configuration.
• Pour la propriété Identificateur d'espace-noms, saisissez un autre identificateur.
Par exemple : cpstrusted
Ce nouvel identificateur doit être utilisé dans les paramètres de configuration des portlets.
• Pour la propriété Nom de classe Java, saisissez :
com.cognos.cps.auth.CPSTrustedSignon
Les noms de classe Java sont sensibles à la casse.

5. Dans Cognos Configuration, dans la section Environnement, Portal Services, configurez les
propriétés suivantes :
• Dans la section Identificateur d'espace-noms de codes d'accès sécurisés, saisissez l'identifi-
cateur de l'espace-noms LDAP, NTLM ou Cognos Series 7 que vous avez configuré à
l'étape 1.
Conseil: L'espace-noms de codes d'accès sécurisés joue le rôle d'intermédiaire et doit être
connecté à un espace-noms basé sur un répertoire réel, de type LDAP, NTLM ou Cognos
Series 7.
• Dans la section Secret partagé, saisissez la clé à utiliser pour le code d'accès unique.
Ce paramètre représente la clé secrète d'autorisation devant être partagée par les portlets
de Cognos et le serveur Cognos. Il fait office de mot de passe secret. Vous devez utiliser la
même chaîne de caractères lorsque vous configurez l'application de portlet. La clé doit
être constituée d'un seul mot.
Pour des raisons de sécurité, il est recommandé d'indiquer une valeur non nulle.
6. Dans la section Environnement, pour l'option Paramètres de la passerelle, définissez la pro-
priété Autoriser le remplacement des espaces-noms ? sur true.
8. Redémarrez le service Cognos 8.
Procédure de configuration de l'accès au contenu Web de Portal Services

1. Sur l'ordinateur où les composants d'application sont installés, démarrez Cognos Configura-
tion.
2. Dans la section Environnement de la fenêtre Explorateur, cliquez sur Portal Services.
3. Dans la fenêtre Propriétés, cliquez sur la zone Valeur en regard de l'option URI du contenu
Web.
4. Indiquez le nom d'hôte ou l'adresse IP de la passerelle et un numéro de port en utilisant le for-
mat suivant :
hôte_ou_adresse_IP:port
Procédure de configuration des iViews de Cognos pour SAP EP

1. Ouvrez l'éditeur iView pour chaque iView de Cognos.
2. Dans la zone Property Category, sélectionnez l'option Show all.
3. Pour la propriété cpsauthsecret: CPS Authorization Secret, indiquez la chaîne de caractères
secrète que vous avez utilisée pour la propriété Secret partagé lorsque vous avez configuré
l'espace-noms du fournisseur Java personnalisé.
4. Pour la propriété cps: authentication namespace ID, saisissez l'identificateur de l'espace-noms
du fournisseur Java personnalisé.
5. Pour la propriété cpsserver: CPS Connection Server, saisissez l'adresse URL permettant
d'accéder aux composants de Portal Services par l'intermédiaire de la passerelle.
Le format de l'URL est le suivant :
• Pour les portlets de contenu Cognos
URI_passerelle/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type CGI :
http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/port-
lets/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
lets/sdk?wsdl&b_action=cps.wsdl
158

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
lets/cmm?wsdl&b_action=cps.wsdl
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Procédure de configuration des portlets de Cognos pour le portail WebSphere

1. Pour chaque application de portlet de Cognos, cliquez sur Modify parameters.
2. Pour la propriété cps_auth_secret, indiquez la chaîne de caractères secrète que vous avez utili-
sée pour la propriété Secret partagé lorsque vous avez configuré l'espace-noms du fournisseur
Java personnalisé.
3. Pour la propriété cps_auth_namespace, saisissez l'identificateur de l'espace-noms du fournis-
seur Java personnalisé.
4. Pour la propriété CPS Endpoint, saisissez l'adresse URL permettant d'accéder aux composants
de Portal Services par l'intermédiaire de la passerelle.
Le format de l'URL est le suivant :
• Pour les portlets de contenu Cognos
URI_passerelle/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
lets/nav?wsdl&b_action=cps.wsdl
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
lets/sdk?wsdl&b_action=cps.wsdl
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
lets/cmm?wsdl&b_action=cps.wsdl
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Procédure de configuration du serveur distant pour le portail Plumtree

1. À l'aide d'un éditeur ASCII, tel que le Bloc-notes, modifiez le fichier cpspt.properties dans le
répertoire emplacement_c8/cps/plumtree/webapps/gadgets/WEB-INF/classes.
2. Configurez les paramètres suivants :

Paramètre 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_hôte/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets
/[package]?wsdl&b_action=cps.wsdl
Pour en savoir davantage, reportez-vous à la rubrique relative au
changement de passerelle dans le Guide d'installation et de
configuration.
forward_cookies= Nom du témoin (cookie) qui doit être envoyé au serveur de

rapports pour le code d'accès unique.
Laissez en blanc.
cps_auth_secret Code secret partagé que Cognos 8 utilise pour chiffrer une variable
d'en-tête HTTP contenant l'identité de l'utilisateur.
Ce paramètre représente la clé secrète d'autorisation devant être
partagée par les portlets de Cognos et le serveur Cognos 8. Il fait
office de mot de passe secret. Utilisez la valeur employée pour
l'option Secret partagé dans Cognos Configuration.
Pour des raisons de sécurité, il est recommandé d'indiquer une
valeur non nulle.
cps_auth_namespace Identificateur de l'espace-noms du fournisseur Java personnalisé.
3. Accédez au répertoire emplacement_c8/cps/plumtree et exécutez le fichier build suivant :

• Sous UNIX ou Linux, build.sh
• Sous Windows, build.bat
Un fichier cps-pt.war est créé dans le répertoire emplacement_c8/cps/plumtree/gadgets.
4. Si les composants de Cognos 8 sont exécutés à l'aide de Tomcat,
• Arrêtez Cognos 8.
• Copiez le fichier cps-pt.war dans le répertoire emplacement_c8/webapps.
Tomcat développe automatiquement le fichier WAR et démarre le serveur distant.
• Démarrez Cognos 8.
5. Si les composants de Cognos 8 sont exécutés sous un autre type de serveur d'application,
copiez le fichier cps-pt.war pour le serveur d'application correspondant.
Pour en savoir davantage, reportez-vous au guide d'administration de votre serveur d'applica-
tion.
Le code d'accès unique est configuré.
Activation du code d'accès unique pour SAP EP avec le permis de connexion

SAP
Lorsque vous activez le code d'accès unique avec le permis de connexion SAP, vous devez configu-
rer les composants de Cognos 8 avec un espace-noms SAP qui établit un lien avec un serveur SAP
BW.
160
Ensuite, vous devez copier le certificat produit au cours de l'installation du portail SAP EP dans
l'environnement de sécurité personnalisé de SAP BW.
Les utilisateurs doivent disposer du même code d'utilisateur dans tous les systèmes accessibles par
l'intermédiaire d'un code d'accès unique.
Avant de commencer, vérifiez que vous avez :
• configuré les composants de Cognos 8 pour l'utilisation d'une source d'authentification SAP.
Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration.
• activé le code d'accès unique entre les composants de Cognos 8 et SAP BW.
Pour en savoir davantage, reportez-vous au Guide d'installation et de configuration.
• installé les versions les plus récentes de Service Pack sur le serveur SAP BW.
Vous pouvez télécharger les versions de Service Pack à partir de SAPNET.
• installé le programme de correction le plus récent 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 antérieures à la version 6.2, sous SAPNET, téléchargez EP50_PLUG-IN
pour la base 620 (SAPKINE32A). Installez SAPKINE32A à l'aide de la transaction SAINT.
• installé la bibliothèque de sécurité SAP sur les serveurs SAP BW.
À partir de sapservX, sous /general/misc/security/SAPSECU/plateforme, téléchargez sapsecin
et sepsecu.dll, puis placez les deux fichiers dans le répertoire d'exécution /run du serveur
SAP BW.
Pour activer le code d'accès unique pour SAP EP, suivez les procédures correspondantes avec les
permis de connexion SAP, décrites dans le manuel SAP Enterprise Portal Security Guide.
Vous pouvez désormais utiliser des iViews de Cognos dans le portail SAP Enterprise Portal. Pour
en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
Activation du code d'accès unique pour SAP EP avec mise en correspondance

des utilisateurs
Lorsque vous activez le code d'accès unique à l'aide de la mise en correspondance des utilisateurs,
vous définissez une source de données de Cognos dans le portail SAP EP. Les utilisateurs indivi-
duels ou les administrateurs peuvent saisir les mots de passe et les identificateurs d'utilisateurs
pour les composants de Cognos 8 dans la source de données. Vous devez établir la correspondance
entre les références de connexion des utilisateurs dans la source de données et un
espace-noms LDAP, Cognos Series 7 ou NTLM. Les iViews de Portal Services transmettent les
références de connexion aux composants de Cognos 8 à l'aide de l'authentification HTTP de base.
Procédure de préparation de l'environnement

1. Configurez l'URI de la passerelle que Portal Services utilisera pour demander l'authentifica-
tion à l'aide de l'authentification HTTP de base.
Pour en savoir davantage sur la configuration d'une adresse URL pour utiliser l'authentifica-
tion HTTP de base, reportez-vous à la documentation de la passerelle ou à celle du serveur
Web.
2. Configurez le iView afin d'accéder à l'URL sécurisée.
portail.
configuration.
4. Si vous utilisez un espace-noms LDAP, configurez les propriétés suivantes :
• Remplacez la valeur de la propriété Voulez-vous utiliser une identité externe ? par Vrai.
• Définissez la valeur de la propriété Correspondance des identités externes sur :
(uid=${environment("REMOTE_USER")})

D'autres propriétés peuvent être requises. Pour en savoir davantage, reportez-vous à la rubri-
que relative à la configuration des composants de Cognos 8 pour LDAP dans le Guide d'ins-
tallation et de configuration.
Procédure de création de la source de données et de mise en correspondance des utili-

sateurs
1. Dans le portail SAP, assurez-vous que les propriétés ci-dessous sont configurées pour la source
de données dans le répertoire /PortalCon-
tent/other_vendors/every_user/com.cognos.pct.c8/systems/Cognos 8 :
• méthode de connexion = UIDPW
• nom du serveur = nom du serveur Cognos
• numéro de port = numéro de port de la passerelle
• protocole du système cible = HTTP
• type de mise en correspondance des utilisateurs = admin,Utilisateur
• alias système (créer un alias système)
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 données en saisissant le nom de l'alias système au niveau de l'iView, dans un attribut
appelé CPS: User Mapping Datasource.
Guide.
3. Pour chaque iView de Cognos, définissez la propriété CPS: Authentication Namespace ID sur
l'espace-noms que vous souhaitez utiliser pour l'authentification.
4. Enregistrez les références d'identification de Cognos pour les utilisateurs du portail.
Les utilisateurs peuvent saisir leurs propres références d'identification et mots de passe.
Guide.
Il est recommandé d'activer la communication sécurisée entre le portail SAP EP et Cognos 8.
Vous pouvez désormais utiliser des iViews de Cognos dans le portail SAP Enterprise Portal. Pour
Activation de la communication sécurisée entre le portail SAP EP et les

composants de Cognos 8
Une connexion sécurisée à l'aide du protocole SSL n'est pas nécessaire entre SAP EP et les compo-
sants de Cognos 8. Il est plus important d'activer un code d'accès unique avec la mise en corres-
pondance des utilisateurs.
La sécurité SSL prise en charge par SAP utilise une clé de chiffrement dont la longueur est supé-
rieure à 56 bits. Par défaut, les composants de Cognos 8 utilisent l'algorithme de chiffrement
allant jusqu'à 56 bits. Cognos propose en complément un module de chiffrement amélioré. Pour
activer le protocole SSL, vous devez acheter et installer le module de chiffrement amélioré pour
OpenSSL en plus des composants de Cognos 8. Pour en savoir davantage, reportez-vous au
manuel Cognos Enhanced Encryption Module for OpenSSL Installation and Configuration
Guide.
Pour activer le protocole SSL entre le portail SAP EP et les composants de Cognos 8, reportez-vous
à la documentation relative à la sécurité du portail SAP EP.
Pour en savoir davantage sur la configuration de SSL dans les composants de Cognos 8, repor-
tez-vous à la rubrique relative à la configuration du protocole SSL dans le Guide d'installation et
de configuration.
Après avoir activé le protocole SSL, modifiez les propriétés de tous les iViews afin que la propriété
cpsserver: CPS Connection Server utilise https et non http.
Vous pouvez désormais utiliser les portlets de Cognos dans le portail SAP Enterprise Portal. Pour
162
Activation du code d'accès 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 de Cognos 8. Portal Services prend en charge les
objets Active Credentials suivants : HttpBasicAuth, LtpaToken, SiteMinderToken et WebSealTo-
ken.
Les références d'identification de l'utilisateur du portail sont communiquées à la passerelle à l'aide
de cet objet. Pour en savoir davantage sur les objets Active Credentials, reportez-vous à la docu-
mentation relative au portail IBM WebSphere.
Pour utiliser un code d'accès 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 Cognos 8 sur un serveur d'application
WebSphere, reportez-vous à la section « Configuration du protocole SSL » (p. 124).
Pour en savoir davantage sur le protocole SSL pour les composants de Cognos 8 sur un serveur
d'application WebSphere, reportez-vous à la rubrique traitant de l'activation du protocole SSL
dans le chapitre relatif au serveur d'application du Guide d'installation et de configuration.
Une fois le code d'accès unique configuré, vous pouvez utiliser les portlets de Cognos dans le por-
tail WebSphere. Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
Activation du code d'accès unique pour le portail Plumtree à l'aide de

l'authentification de base
Vous pouvez configurer un portlet dans le portail Plumtree pour envoyer le nom d'utilisateur et le
mot de passe sous forme d'en-tête d'authentification HTTP de base. L'en-tête peut être utilisé avec
un espace-noms d'authentification NTLM, LDAP ou Cognos Series 7 pour fournir un code d'accès
unique.
Procédure
portail.
configuration.
2. Installez une passerelle secondaire de type servlet, CGI ou ISAPI dans Cognos 8.
Pour en savoir davantage, reportez-vous à la rubrique relative à l'installation de Cognos 8
dans le Guide d'installation et de configuration.
3. Configurez la passerelle.
Pour obtenir des instructions, reportez-vous au Guide d'installation et de configuration.
4. Dans la console d'administration du serveur Web, configurez les répertoires virtuels permet-
tant d'accéder à la passerelle.
5. Configurez le serveur distant Plumtree pour accéder à Cognos 8 :
• Modifiez le fichier cpspt.properties dans le répertoire emplacement_c8/cps/plum-
tree/webapps/gadgets/WEB-INF/classes.
• Modifiez la propriété cps_endpoint de façon à indiquer l'URL de la passerelle.
Pour une passerelle de type CGI, vous pouvez utiliser le paramètre implicite si la passe-
relle et le serveur distant se trouvent sur le même ordinateur. Sinon, remplacez la partie
localhost par nom_hôte:port.
Pour une passerelle de type servlet ou ISAPI, remplacez la partie local-
host/cognos8/cgi-bin/cognos.cgi par les valeurs permettant de cibler la passerelle.
Par exemple :
http://nom_hôte:port/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/[pac-
kage]?wsdl&b_action=cps.wsdl

• Définissez la propriété cps_auth_namespace sur l'espace-noms que vous souhaitez utiliser

pour l'authentification.
Activation du code d'accès unique pour le portail Plumtree à l'aide de

SiteMinder
Si vous utilisez SiteMinder de Netegrity pour fournir un code d'accès unique à votre infrastructure
de sécurité, vous pouvez également l'utiliser pour le code d'accès unique sur le portail Plumtree.
Vous devez configurer un espace-noms d'authentification SiteMinder dans Cognos Series 8. Le
portail Plumtree envoie le jeton d'authentification SiteMinder actif au serveur distant, qui l'envoie
à la passerelle Cognos Series 8.
Procédure
1. Dans Cognos Configuration, configurez un espace-noms d'authentification SiteMinder.
Pour en savoir davantage, reportez-vous à la rubrique relative à la configuration d'un
espace-noms d'authentification SiteMinder dans le Guide d'installation et de configuration.
2. Configurez le serveur distant pour transférer le jeton d'authentification :
• Modifiez le fichier cpspt.properties dans le répertoire emplacement_c8/cps/Plum-
tree/webapps/gadgets/WEB-INF/classes.
• Modifiez la propriété forward_cookies de façon à inclure le nom du jeton d'authentifica-
tion actif fourni par SiteMinder.
• Modifiez la propriété cps_endpoint de façon à indiquer l'URL de la passerelle.
Pour une passerelle de type CGI, vous pouvez utiliser le paramètre implicite si la passe-
relle et le serveur distant se trouvent sur le même ordinateur. Sinon, remplacez la partie
localhost par nom_hôte:port.
Pour une passerelle de type servlet ou ISAPI, remplacez la partie local-
host/cognos8/cgi-bin/cognos.cgi par les valeurs permettant de cibler la passerelle.
Par exemple :
http://nom_hôte:port/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/[pac-
kage]?wsdl&b_action=cps.wsdl
• Définissez la propriété cps_auth_namespace sur l'espace-noms que vous souhaitez utiliser
pour l'authentification.
164
Chapitre 10 : Configuration des composants de
Cognos 8 pour un fournisseur d'authentification
Les composants de Cognos 8 s'exécutent avec deux niveaux de connexion : anonyme et authenti-
fiée. Par défaut, l'accès anonyme est activé.
Vous pouvez utiliser deux types de connexion dans votre installation. Si vous souhaitez utiliser
uniquement la connexion authentifiée, vous pouvez désactiver l'accès anonyme.
Pour une connexion authentifiée, vous devez configurer les composants de 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 sélectionner, en cours
d'exécution, celui que vous voulez utiliser. Pour en savoir davantage, reportez-vous au Guide
d'administration et de sécurité.
Si vous procédez à une mise à niveau à partir de ReportNet et que Cognos 8 détecte un
espace-noms 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 sécurité.
Par ailleurs, lors de la mise à niveau d'une version vers une autre, vous devez utiliser le même
espace-noms d'authentification pour les deux versions. Si tel n'est pas le cas, la nouvelle version
risque de ne pas contenir les mêmes polices, utilisateurs, rôles et groupes.
Les composants de Cognos 8 prennent en charge les types de serveurs suivants en tant que sources
d'authentification :
• Active Directory Server
• Cognos Series 7
• Fournisseur d'authentification personnalisé
• LDAP
• SiteMinder de Netegrity
• 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 fournis-
seur d'authentification que vous sélectionnez et la manière dont vous le configurez doivent être les
mêmes sur tous les ordinateurs de toutes les plates-formes. La configuration doit contenir des
informations auxquelles tous les ordinateurs Content Manager peuvent accéder.
Si Cognos 8 est installé sur un seul ordinateur Linux ou que Content Manager est installé sur un
ordinateur Linux, Cognos 8 peut être configuré de façon à n'utiliser comme sources d'authentifi-
cation que des serveurs d'annuaire compatibles avec la version 3 de LDAP et des fournisseurs per-
sonnalisés.
Certains fournisseurs d'authentification requièrent que les bibliothèques externes à l'environne-
ment Cognos 8 soient disponibles. Si tel n'est pas le cas sous Linux, le fournisseur d'authentifica-
tion ne peut être initialisé.
Pour configurer l'un des éléments suivants en tant que source d'authentification, vous devez instal-
ler Content Manager sur un ordinateur ne fonctionnant pas sous Linux.
• Espace-noms Cognos Series 7
• Active Directory Server
• NTLM

Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification
• SiteMinder de Netegrity
• SAP BW
Si vous activez la sécurité, vous devez configurer des paramètres de sécurité dès que vous avez ter-
miné le processus d'installation et de configuration. Pour en savoir davantage, reportez-vous au
Guide d'administration et de sécurité.
Important : Une fois la sécurité activée, il est fortement déconseillé de la désactiver. Lorsque vous
supprimez un espace-noms, les entrées des dossiers Mes dossiers et Mes pages sont définitivement
perdues. Les paramètres d'autorisation existants continuent à faire référence à des utilisateurs, des
groupes et des rôles qui n'existent plus. Si cela n'affecte pas le fonctionnement des autorisations,
un utilisateur administrant les paramètres d'autorisation risque de voir des entrées « inconnues ».
Étant donné que ces entrées font référence à des utilisateurs, des groupes et des rôles qui n'existent
plus, vous pouvez les supprimer en toute sécurité.
Après avoir configuré un fournisseur d'authentification pour les composants de Cognos 8, vous
pouvez activer le code d'accès unique entre votre environnement de fournisseur d'authentification
et les composants de Cognos 8. Ainsi, un utilisateur se connecte une seule fois et peut passer d'une
application à une autre sans se reconnecter.
Pour utiliser un fournisseur d'authentification et exiger des utilisateurs qu'ils s'authentifient :
❑ Désactivez l'accès anonyme, le cas échéant.
❑ Configurez les composants de Cognos 8 de façon à ce qu'ils utilisent un fournisseur d'authen-
tification.
Désactivation de l'accès anonyme

Par défaut, les composants de Cognos 8 n'exigent pas d'authentification de l'utilisateur. Les utili-
sateurs peuvent ouvrir une session anonyme.
Si vous souhaitez utiliser une connexion authentifiée uniquement, vous pouvez utiliser Cognos
Configuration pour désactiver l'accès anonyme.
Procédure
Cognos.
La ressource Cognos représente l'espace-noms de Cognos. L'espace-noms de Cognos stocke
des informations sur les groupes de Cognos, tels que l'utilisateur anonyme, les contacts et les
listes de diffusion, et fait référence à des objets figurant dans d'autres espaces-noms de sécu-
rité. Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
3. Dans la fenêtre Propriétés, cliquez sur la zone située en regard de la propriété Autoriser les
connexions anonymes, puis cliquez sur l'option Faux.
Les utilisateurs doivent désormais fournir des références d'identification de connexion pour accé-
der aux ressources de Cognos.
Restriction de l'accès à l'espace-noms Cognos

L'accès peut être limité aux utilisateurs appartenant à un groupe ou un rôle défini dans
l'espace-noms intégré Cognos. Par défaut, tous les utilisateurs appartiennent à plusieurs groupes
ou rôles intégrés. Pour restreindre l'accès, vous devez :
• activer la propriété permettant de restreindre l'accès,
• supprimer le groupe Tous des groupes et rôles Cognos intégrés,
• vous assurer que les utilisateurs autorisés appartiennent à au moins un groupe ou rôle
Cognos.
166
Procédure
2. Dans la section Sécurité de la fenêtre Explorateur, cliquez sur l'option Authentification.
3. Dans la fenêtre Propriétés, affectez la valeur Vrai à l'option Voulez-vous limiter l'accès aux
membres de l'espace-noms prédéfini ?.
Vous devez maintenant avoir recours au portail pour supprimer le groupe Tous des rôles et grou-
pes Cognos intégrés, puis vous assurer que les utilisateurs autorisés appartiennent à au moins un
groupe ou rôle Cognos intégré.
Pour en savoir davantage sur l'ajout ou la suppression de membres d'un groupe ou rôle Cognos,
reportez-vous au Guide d'administration et de sécurité.
Configuration des composants de Cognos 8 pour Active

Directory Server
Si vous installez Content Manager sur un ordinateur Windows, vous pouvez configurer Active
Directory comme source d'authentification utilisant un espace-noms Active Directory.
Si vous installez Content Manager sur un ordinateur UNIX, vous devez utiliser un espace-noms
LDAP pour configurer Active Directory en tant que source d'authentification. Si vous installez
Content Manager sur des ordinateurs équipés des systèmes d'exploitation UNIX et Windows,
vous devez utiliser un espace-noms LDAP pour configurer Active Directory sur tous les ordina-
teurs de Content Manager. Pour en savoir davantage, reportez-vous à la section « Configuration
d'un espace-noms LDAP pour Active Directory Server » (p. 177).
Si vous installez Content Manager sur un ordinateur Linux, vous ne pouvez pas utiliser un serveur
Active Directory Server en tant que source d'authentification.
Si vous souhaitez utiliser Microsoft SQL Server ou Microsoft Analysis Server en tant que source
de données et utiliser un code d'accès unique pour l'authentification, vous devez utiliser Active
Directory en tant que source d'authentification.
Pour utiliser un espace-noms Active Directory Server et pour configurer le code d'accès unique,
procédez comme suit :
❑ Configurez les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms Active
Directory Server.
❑ Activez la communication sécurisée pour Active Directory Server, le cas échéant.
❑ Activez le code d'accès unique entre Active Directory Server et les composants de Cognos 8.
Configuration d'un espace-noms Active Directory

Vous pouvez utiliser Active Directory Server en tant que fournisseur d'authentification.
Vous avez également la possibilité de rendre disponibles des propriétés d'utilisateur personnalisées
d'Active Directory Server dans les composants de Cognos 8.
Remarque : Pour que Cognos 8 fonctionne correctement avec Active Directory Server, vous devez
vous assurer que le groupe Utilisateurs authentifiés dispose de droits de lecture sur le dossier
Active Directory où sont stockés ces utilisateurs.
Si vous configurez un espace-noms Active Directory pour prendre en charge un code d'accès uni-
que avec une source de données Microsoft SQL Server ou Microsoft Analysis Server, vous devez
utiliser la configuration suivante :
• La passerelle Cognos 8 doit être installée sur un serveur Web IIS, configuré pour l'authentifi-
cation intégrée de Windows.
• 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 données (Microsoft SQL Server ou Microsoft Analysis Server) doivent
appartenir au domaine Active Directory.

• La connexion à la source de données pour Microsoft SQL Server ou Microsoft Analysis Server
doit être configurée pour un espace-noms externe et celui-ci doit être un espace-noms Active
Directory.
Pour en savoir davantage sur les sources de données, reportez-vous au Guide d'administration et
de sécurité.
Procédure
1. Sur chaque ordinateur sur lequel vous avez installé Content Manager, démarrez Cognos Con-
figuration.
2. Dans la section Sécurité de la fenêtre 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 fenêtre Explorateur, sous le com-
posant Authentification.
5. Dans la fenêtre Propriétés, pour la propriété Identificateur d'espace-noms, indiquez un identi-
ficateur unique pour l'espace-noms.
6. Définissez les valeurs de toutes les propriétés requises pour vous assurer que les composants
de Cognos 8 pourront localiser et utiliser le fournisseur d'authentification existant.
7. Indiquez les valeurs de la propriété Hôte et port.
8. Si vous voulez rechercher des détails lorsque l'authentification échoue, indiquez le code d'uti-
lisateur et le mot de passe pour la propriété Références d'identification pour la liaison.
Utilisez les références d'identification pour l'utilisateur d'Active Directory Server qui possède
des droits de recherche et de lecture pour ce serveur.
10. Testez la connexion à un nouvel espace-noms. Dans la section Authentification de la fenêtre
Explorateur, cliquez avec le bouton droit de la souris sur la nouvelle ressource d'authentifica-
tion, puis cliquez sur l'option Tester.
Cognos 8 charge, initialise et configure les bibliothèques du fournisseur de l'espace-noms con-
cerné.
Mise à disposition des propriétés d'utilisateur personnalisées d'Active Directory

pour les composants de Cognos 8
Vous pouvez utiliser des attributs d'utilisateur arbitraires d'Active Directory Server dans les com-
posants de Cognos 8. Pour procéder à cette configuration, vous devez ajouter ces attributs en tant
que propriétés personnalisées pour l'espace-noms Active Directory.
Les propriétés personnalisées sont disponibles en tant que paramètres de session par le biais de
Framework Manager. Pour en savoir davantage sur les paramètres de session, reportez-vous au
manuel Framework Manager User Guide.
Les propriétés personnalisées peuvent également être utilisées à l'intérieur de blocs de commande
servant à configurer les sessions et les connexions Oracle. Les blocs de commande peuvent être uti-
lisés avec les connexions Oracle légères et les bases de données privées virtuelles. Pour en savoir
davantage, reportez-vous au Guide d'administration et de sécurité.
Procédure
figuration.
2. Dans la section Sécurité, Authentification de la fenêtre Explorateur, cliquez sur l'espace-noms
Active Directory.
3. Dans la fenêtre Propriétés, cliquez sur la colonne Valeur située à côté de la propriété Proprié-
tés personnalisées, puis sur le bouton d'édition.
4. Dans la fenêtre Valeur - Propriétés personnalisées, cliquez sur l'option Ajouter.
168
5. Cliquez sur la colonne Nom et saisissez le nom que les composants de Cognos 8 doivent utili-
ser pour le paramètre de session.
6. Cliquez sur la colonne Valeur et saisissez le nom du paramètre de compte dans Active Direc-
tory Server.
7. Répétez les deux étapes précédentes (indiquées par des puces) pour chaque paramètre person-
nalisé.
Activation de la communication sécurisée pour Active Directory Server

Si vous utilisez une connexion SSL pour Active Directory Server, vous devez copier le certificat
d'Active Directory Server sur l'ordinateur Content Manager.
Procédure
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 bibliothèque de certificat du compte que vous utilisez pour la session
de Cognos en cours :
• Si vous exécutez la session de Cognos avec un compte d'utilisateur, utilisez le même navi-
gateur Web que celui utilisé à l'étape 1 pour importer le certificat de racine de l'autorité
de certification dans la bibliothèque de certificats de votre compte d'utilisateur.
Pour en savoir davantage, reportez-vous à la documentation de votre navigateur Web.
• Si vous exécutez la session de Cognos avec un compte d'ordinateur local, utilisez la con-
sole MMC (Microsoft Management Console) pour importer le certificat de racine de
l'autorité de certification dans la bibliothèque de certificats de l'ordinateur local.
Pour en savoir davantage, reportez-vous à la documentation de MMC.
3. Dans Cognos Configuration, redémarrez le service comme suit :
• Dans la fenêtre Explorateur, cliquez sur Service Cognos 8, puis sur Cognos 8.
• Dans le menu Opérations, cliquez sur l'option Redémarrer.
Inclusion ou exclusion de domaines à l'aide des propriétés avancées

Lorsque vous configurez un espace-noms d'authentification pour Cognos 8, les utilisateurs d'un
seul domaine peuvent se connecter. À l'aide des propriétés avancées d'Active Directory Server, les
utilisateurs des domaines (parent-enfant) associés et des arborescences de domaines non connexes
du même groupe de serveurs ont également la possibilité de se connecter.
Authentification dans une arborescence de domaines

Si vous définissez le paramètre chaseReferrals sur true, les utilisateurs du domaine authentifié
d'origine et tous les domaines enfants de l'arborescence de domaines peuvent se connecter à
Cognos 8. Les utilisateurs situés au-dessus du domaine authentifié d'origine ou dans une arbores-
cence de domaines différente ne peuvent pas se connecter.
Authentification dans toutes les arborescences de domaines du groupe de serveurs

Si vous définissez le paramètre MultiDomainTrees sur true, les utilisateurs de toutes les arbores-
cences de domaines du groupe de serveurs peuvent se connecter à Cognos 8.
Procédure
figuration.
Active Directory.
3. Dans la fenêtre Propriétés, indiquez la propriété Hôte et port :

• Pour les utilisateurs d'un domaine, indiquez l'hôte et le port d'un contrôleur de ce
domaine.
• Pour les utilisateurs d'une arborescence de domaines, indiquez l'hôte et le port du contrô-
leur de niveau supérieur de l'arborescence.
• Pour les utilisateurs de toutes les arborescences de domaines du groupe de serveurs, indi-
quez l'hôte et le port de n'importe quel contrôleur de domaine du groupe de serveurs.
4. Cliquez dans la colonne Valeur des Propriétés avancées, puis sur le bouton Modifier.
5. Dans la fenêtre Valeur - Propriétés avancées, cliquez sur l'option Ajouter.
6. Définissez deux nouvelles propriétés, chaseReferrals et MultiDomainTrees, ayant les valeurs
suivantes :
Authentification pour chaseReferrals MultiDomainTrees

Un domaine False False
Une arborescence de domaines True False
Toutes les arborescences de True True

domaines du groupe de serveurs

Activation du code d'accès unique entre Active Directory Server et les

Par défaut, le fournisseur Active Directory utilise la délégation Kerberos et s'intègre au serveur
Web IIS pour la connexion unique si l'authentification intégrée (auparavant appelée stimula-
tion/réponse de Windows NT) est activée sur le serveur Web IIS.
Si l'authentification intégrée est activée, vous n'êtes pas invité à saisir à nouveau les informations
d'authentification lorsque vous accédez au contenu de Cognos sécurisé par l'espace-noms Active
Directory.
Si vous ne souhaitez pas utiliser la délégation Kerberos, le fournisseur peut être configuré de façon
à accéder à la variable d'environnement REMOTE_USER pour obtenir le code d'accès unique.
Vous devez définir la propriété avancée singleSignonOption sur la valeur IdentityMapping. Micro-
soft définit REMOTE_USER par défaut lorsque vous activez l'authentification intégrée Windows.
Si l'authentification Kerberos est évitée, le code d'accès unique aux sources de données Microsoft
OLAP (MSAS) est impossible.
Procédure de connexion unique à l'aide de la délégation Kerberos

1. Configurez l'authentification intégrée 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 opère, afin
qu'il soit sécurisé pour la délégation.
Lors de la configuration des ordinateurs à l'aide de l'outil Active Directory, ne sélectionnez
pas l'attribut Compte qui est sensible à la casse et ne peut être délégué.
Procédure de connexion unique à l'aide de REMOTE_USER

figuration.
Active Directory.
3. Cliquez dans la colonne Valeur des Propriétés avancées, puis sur le bouton Modifier.
4. Dans la fenêtre Valeur - Propriétés avancées, cliquez sur l'option Ajouter.
170
5. Dans la colonne Nom, saisissez singleSignonOption

6. Dans la colonne Valeur, saisissez IdentityMapping
Le fournisseur Active Directory utilise maintenant REMOTE_USER pour la connexion unique.
Conseil : Pour utiliser de nouveau la délégation Kerberos, modifiez les Propriétés avancées et, dans
la colonne Valeur, saisissez KerberosAuthentication.
Configuration de Cognos 8 pour l'espace-noms Cognos Series

7
Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
Cognos Series 7 en tant que fournisseur d'authentification. Les utilisateurs seront authentifiés
selon la configuration d'authentification et de connexion de l'espace-noms Cognos Series 7.
Pour configurer un espace-noms Cognos Series 7 en tant que source d'authentification, vous devez
installer Content Manager sur un ordinateur ne fonctionnant pas sous Linux.
Remarque : Vous ne pouvez pas utiliser le fichier LAE (exportation d'authentification locale) de
Cognos Series 7 pour l'authentification avec les composants de Cognos 8.
Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent plusieurs four-
nisseurs d'authentification de Cognos Series 7. Il est préférable que tous les espaces-noms Cognos
Series 7 utilisent le même Ticket Server principal de Cognos Series 7. Dans le cas contraire, vous
risquez de voir des messages d'erreur s'afficher ou d'être invité à vous authentifier plusieurs fois.
Si vous modifiez les informations de configuration stockées dans le serveur d'annuaire utilisé pour
Cognos Series 7, vous devez redémarrer le service Cognos 8 pour que les modifications soient pri-
ses en compte dans l'installation de Cognos.
L'utilisateur doit faire partie d'au moins une classe d'utilisateurs Access Manager pour pouvoir se
connecter aux composants de Cognos 8.
Pour utiliser un espace-noms Cognos Series 7 et pour configurer le code d'accès unique, procédez
comme suit :
❑ Configurez Cognos 8 de façon à ce qu'il utilise un espace-noms de Cognos Series 7.
❑ Activez la communication sécurisée pour le serveur d'annuaire utilisé par l'espace-noms
Cognos Series 7, le cas échéant.
❑ Activez le code d'accès unique entre Cognos Series 7 et Cognos 8.
Configuration d'un espace-noms Cognos Series 7

Vous pouvez configurer Cognos 8 de façon à ce qu'il utilise un ou plusieurs espaces-noms de
Cognos Series 7 pour l'authentification.
Procédure
figuration.
Espace-noms.

Si vous disposez d'un espace-noms Series 7 version 16.0, vérifiez que la propriété Encodage
des données est définie sur UTF-8. En outre, les ordinateurs sur lesquels Content Manager est
installé doivent utiliser les mêmes paramètres régionaux que les données de l'espace-noms
Series 7.
La valeur de l'hôte peut être un nom d'ordinateur ou une adresse IP. Si vous publiez de Power-
Play Enterprise Server vers Cognos 8, vous devez utiliser le même format de valeurs que celui
utilisé dans Cognos Series 7 Configuration Manager pour l'emplacement du serveur
d'annuaire. Par exemple, si le nom de l'ordinateur est utilisé dans Cognos Series 7 Configura-
tion Manager, c'est également le nom de l'ordinateur qui doit être utilisé dans Cognos Confi-
guration pour Cognos 8.
7. Si votre environnement d'espaces-noms contient l'espace-noms Series 7 version 15.2, vous
devez désactiver le paramètre Series7NamespacesAreUnicode.
• Dans la zone Propriétés avancées de la fenêtre Propriétés, cliquez sur le bouton Modifier.
• Dans la fenêtre Valeur - Propriétés avancées, 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 Paramètres de témoin (cookie) de la fenêtre Propriétés, assurez-vous que les
propriétés Chemin d'accès, Domaine et Indicateur de sécurité activé ? correspondent aux
paramètres configurés pour Cognos Series 7.
Activation de la communication sécurisée pour le serveur d'annuaire utilisé par

l'espace-noms Series 7
Si vous utilisez une connexion SSL pour le Directory Server utilisé par l'espace-noms Cognos
Series 7, vous devez copier le certificat de Directory Server sur chaque ordinateur Content Mana-
ger.
Pour en savoir davantage, reportez-vous au manuel Cognos Access Manager Administrator Guide
et à la documentation de Directory Server.
Activation du code d'accès unique entre Cognos Series 7 et Cognos 8

Si votre espace-noms Cognos Series 7 a été configuré pour intégrer les mécanismes d'authentifica-
tion externe associés à la connexion unique, le fournisseur de Cognos Series 7 utilise automatique-
ment cette configuration.
En configurant le code d'accès unique, vous n'êtes pas invité à saisir à nouveau les informations
d'authentification lorsque vous accédez au contenu de Cognos sécurisé par l'espace-noms Cognos
Series 7.
Procédure
1. Veillez à configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
Cognos Series 7 en tant que fournisseur d'authentification (p. 171).
2. Pour Cognos Series 7, démarrez Configuration Manager.
3. Cliquez sur l'option Ouvrir la configuration actuelle.
4. Dans la fenêtre Explorateur de l'onglet Composants, développez le dossier Services, Access
Manager - Exécution, puis cliquez sur l'option Paramètres de témoin (cookie).
5. Dans la fenêtre Propriétés, assurez-vous que les propriétés Chemin d'accès, Domaine et Indi-
cateur de sécurité activé ? correspondent aux paramètres configurés pour Cognos 8.
6. Enregistrez et fermez Configuration Manager.
7. Si l'espace-noms Cognos Series 7 utilise le module d'extension Trusted Signon pour la con-
nexion unique, vous devez dès maintenant définir la fonction SaferAPIGetTrustedSignonWi-
thEnv.
172
Vous pouvez maintenant ajouter des classeurs de Cognos Upfront Series 7 aux pages du portail
Web Cognos Connection.
Espaces-noms Cognos Series 7 et module d'extension Cognos Series 7 Trusted

Signon
Si l'espace-noms Cognos Series 7 utilise le module d'extension Trusted Signon pour la connexion
unique, vous devez définir la fonction SaferAPIGetTrustedSignonWithEnv dans votre module
d'extension. Vous devez ensuite recompiler et redéployer la bibliothèque pour que la connexion
unique prenne effet entre les composants de Cognos Series 8 et votre mécanisme d'authentifica-
tion.
La fonction SaferAPIGetTrustedSignonWithEnv est une version mise à jour de la fonction SaferA-
PIGetTrustedSignon. Cette mise à jour est requise car la connexion à Cognos 8 n'est pas effectuée
sur le serveur Web, comme c'est le cas avec les applications Cognos Series 7. Par conséquent, 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 spécifiques soient supprimées du serveur Web à l'aide de la fonction SaferAPI-
GetTrustedSignonWithEnv.
Si vous exécutez les produits Cognos Series 7 et Cognos 8 à l'aide du même module d'extension,
les fonctions SaferAPIGetTrustedSignonWithEnv et SaferAPIGetTrustedSignon sont requises.
Pour en savoir davantage sur la fonction SaferAPIGetTrustedSignon, reportez-vous à la documen-
tation de Cognos Series 7.
Fonction SaferAPIGetTrustedSignonWithEnv
Pour que les utilisateurs soient authentifiés correctement par Access Manager, les codes d'accès au
SE doivent exister et être activés dans l'espace-noms en cours.
La mémoire pour les noms trustedSignonName et trustedDomainName renvoyés est allouée dans
cet API. Si la fonction renvoie SAFER_SUCCESS, Access Manager appelle la fonction SaferAIFree-
TrustedSignon pour libérer la mémoire allouée.
La mémoire de la fonction reqEnvVarList renvoyée est allouée dans cet API. Si la fonction renvoie
SAFER_INFO_REQUIRED, Access Manager appelle la fonction SaferAPIFreeBuffer() pour libérer
la mémoire allouée.
Les fonctions SaferAPIGetTrustedSignon et SaferAPIFreeBuffer doivent être mises en œuvre pour
enregistrer correctement la bibliothèque lorsque la fonction SaferAPIGetTrustedSignonWithEnv
est mise en œuvre. La fonction SaferAPIGetError est nécessaire uniquement si vous voulez que des
messages d'erreur précis soient renvoyés à partir du module d'extension.
Syntaxe
SaferAPIGetTrustedSignonWithEnv(
EnvVar envVar[], /*[IN]*/
char **reqEnvVarList, /*[OUT]*/
void **trustedSignonName, /*[OUT]*/
unsigned long *trustedSignonNameLength, /*[OUT]*/
void **trustedDomainName, /*[OUT]*/
unsigned long *trustedDomainNameLength, /*[OUT]*/
SAFER_USER_TYPE *userType, /*[OUT]*/
void **implementerData); /*[IN/OUT]*/

Paramètre Description
[in] envVar Tableau de noms de variable d'environnement et de valeurs
extraits du serveur Web. La fin du tableau est représentée par
une entrée dotée d'un nom envVarName nul et d'une valeur
envVarValue nulle. Notez que la première fois que cet API est
appelé, le groupe envVar contient uniquement la fin du
repère de tableau.
[in] reqEnvVarList Chaîne contenant une liste de noms de variable

d'environnement séparés par une virgule et requis par la mise
en œuvre Safer. La fin de la liste doit se terminer par une
valeur nulle.
[out] trustedSignonName Séquence d'octets identifiant l'utilisateur actuellement

authentifié. Cette valeur ne doit pas nécessairement être
nulle. Cette valeur est obligatoire.
[out] trustedSignonNameLength Valeur d'entier indiquant la longueur de la fonction

trustedSignonName. Cette longueur doit exclure la marque
de fin nulle, si elle est présente. Cette valeur est obligatoire.
[out] trustedDomainName Séquence d'octets identifiant le domaine de l'utilisateur

actuellement authentifié. Cette valeur ne doit pas
nécessairement être nulle. S'il n'y a pas de nom
trustedDomainName, 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 présente. Cette valeur est obligatoire et
doit être réglée sur zéro s'il n'existe pas de nom
trustedDomainName.
[out] userType Valeur indiquant le type d'utilisateur qu'Access Manager doit

authentifier. Cette valeur est obligatoire.
Les valeurs renvoyées suivantes sont nécessaires pour
qu'Access Manager authentifie les utilisateurs correctement :
SAFER_NORMAL_USER
Utilisateur nommé. Les codes d'accès au SE doivent exister et
être activés 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.
[in/out] implementerData Pointeur utilisé pour conserver les données spécifiques à 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 attribuée.
174
Configuration de Cognos 8 pour l'utilisation d'un fournisseur

d'authentification personnalisé
Si vous avez mis en oeuvre un fournisseur d'authentification Java personnalisé avec votre infras-
tructure de sécurité existante, vous pouvez configurer les composants de Cognos 8 de façon à ce
qu'ils l'utilisent.
Vous pouvez utiliser un fournisseur d'authentification personnalisé pour accéder à des utilisateurs
d'une autre source d'authentification et les authentifier. Vous pouvez également l'utiliser comme
méthode de connexion unique pour intégrer les composants de Cognos 8 à votre infrastructure de
sécurité.
Pour en savoir davantage, reportez-vous au manuel Custom Authentication Provider Developer
Guide.
Configuration d'un espace-noms d'authentification personnalisé

d'authentification personnalisé. Toute configuration supplémentaire pour l'accès à une source
d'authentification, le code d'accès unique ou des attributs personnalisés dépend de l'implémenta-
tion du fournisseur d'authentification personnalisé.
Procédure
figuration.
2. Dans la fenêtre Explorateur, dans la section Sécurité, cliquez avec le bouton droit sur l'option
Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms.
4. Dans la liste Type, cliquez sur l'option Fournisseur Java personnalisé, puis sur le bouton OK.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe deux-points
(:).
6. Définissez les valeurs de toutes les autres propriétés requises pour vous assurer que Cognos 8
pourra localiser et utiliser le fournisseur d'authentification existant.
cerné.
Configuration des composants de Cognos 8 pour LDAP

LDAP en tant que fournisseur d'authentification.
Pour lier un utilisateur au serveur LDAP, le fournisseur d'authentification LDAP doit construire le
nom unique (DN). Si la propriété Voulez-vous utiliser une identité externe ? a la valeur Vrai, elle
utilise la propriété Correspondance des identités externes pour tenter de résoudre 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 propriété Fichier de référence d'utilisateur pour créer le DN.

Si les utilisateurs occupent différents niveaux hiérarchiques dans le serveur d'annuaire, vous pou-
vez configurer les propriétés Fichier de référence d'utilisateur et Correspondance des identités
externes de façon à ce qu'elles utilisent des filtres de recherche. Lorsque le fournisseur d'authenti-
fication LDAP effectue des recherches, il utilise les filtres que vous spécifiez pour les propriétés
Fichier de référence d'utilisateur et Correspondance des identités externes. Par ailleurs, il établit
une liaison avec le serveur d'annuaire au moyen de la valeur que vous indiquez pour la propriété
Lier le nom unique et le mot de passe de l'utilisateur ou de façon anonyme si aucune valeur n'est
précisée.
Si un espace-noms LDAP a été configuré pour utiliser la propriété Correspondance des identités
externes pour l'authentification, le fournisseur LDAP établit une liaison avec le serveur d'annuaire
à l'aide de la propriété Lier le nom unique et le mot de passe de l'utilisateur ou de façon anonyme
si aucune valeur n'est indiquée. Tous les utilisateurs qui se connectent à Cognos 8 à l'aide d'une
correspondance des identités externes voient les mêmes utilisateurs, groupes et dossiers que l'utili-
sateur lié.
Vous avez également la possibilité de rendre disponibles des propriétés d'utilisateur personnalisées
de l'espace-noms LDAP dans les composants de Cognos 8.
Pour utiliser un espace-noms LDAP et configurer le code d'accès unique, procédez comme suit :
❑ Configurez les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms LDAP.
❑ Configurez un espace-noms LDAP pour Active Directory Server, le cas échéant.
❑ Mettez à la disposition des composants de Cognos 8 les propriétés d'utilisateur personnali-
sées, le cas échéant.
❑ Activez la communication sécurisée pour le serveur LDAP, le cas échéant.
❑ Activez le code d'accès unique entre LDAP et les composants de Cognos 8.
Configuration d'un espace-noms LDAP

LDAP lorsque les utilisateurs sont stockés dans un annuaire d'utilisateurs LDAP. Il est possible
d'accéder à l'annuaire d'utilisateurs LDAP à partir d'un autre environnement serveur tel que
Active Directory Server ou SiteMinder de Netegrity.
Si vous configurez un espace-noms LDAP pour Active Directory Server, reportez-vous à la section
Configuration d'un espace-noms LDAP pour Active Directory Server. Si vous configurez un
espace-noms LDAP pour un serveur IBM Directory Server, reportez-vous à la section Configura-
tion d'un espace-noms LDAP pour IBM Directory Server. Si vous configurez un espace-noms
LDAP pour un serveur Novell Directory Server, reportez-vous à la section Configuration d'un
espace-noms LDAP pour Novell Directory Server.
Procédure
figuration.
Espace-noms.
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
spécifique, indiquez ces valeurs.
176
Si aucune valeur n'est indiquée, le fournisseur d'authentification LDAP se lie en tant qu'ano-
nyme.
Si la correspondance des identités externes est activée, la propriété Lier le nom unique et le
mot de passe de l'utilisateur est utilisée pour tous les accès LDAP. Si la correspondance des
identités externes n'est pas activée, la propriété Lier le nom unique et le mot de passe de l'uti-
lisateur est utilisée uniquement lorsqu'un filtre de recherche est indiqué pour la propriété
Fichier de référence d'utilisateur. Dans ce cas, lorsque le nom unique de l'utilisateur est défini,
les demandes envoyées ultérieurement au serveur LDAP sont exécutées dans le contexte
d'authentification de l'utilisateur.
8. Vérifiez les paramètres 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 de Cognos 8 et le serveur LDAP.
cerné.
Configuration d'un espace-noms LDAP pour Active Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec Active Directory Server, vous
devez modifier les paramètres nécessaires et modifier les valeurs de toutes les propriétés des objets
Active Directory.
Procédure
figuration.
Espace-noms.
(:).
7. Pour la propriété Identificateur unique, il est recommandé de saisir
objectGuid
Si aucune valeur n'est indiquée, le fournisseur d'authentification LDAP se lie en tant qu'ano-
nyme.
9. Pour configurer les propriétés de mise en correspondance avancée LDAP à utiliser avec les
objets Active Directory Server, utilisez les valeurs spécifiées dans le tableau ci-dessous.

Mises en
correspondance Propriété LDAP Valeur LDAP
Dossier Classe d'objets « organizationalunit,organizatio
n»
Description Description
Nom « ou,o »
Groupe Classe d'objets Groupe
Description Description
Member Member
Nom cn
Compte Classe d'objets utilisateur
Téléphone professionnel telephonenumber
Paramètres régionaux du contenu (ne pas saisir de valeur)
Description description
Courrier électronique mail
Télécopieur/téléphone facsimiletelephonenumber
Prénom givenname
Téléphone privé homephone
Téléphone mobile mobile
Nom displayName
Récepteur d'appels pager
Mot de passe unicodePwd
Adresse postale Postaladdress
Langue du produit (ne pas saisir de valeur)
Prénom Sn
Nom d'utilisateur sAMAccountName
Ces propriétés de correspondances représentent des modifications basées sur une installation
implicite de Active Directory Server. Si vous avez modifié le schéma, vous devrez peut-être
apporter d'autres modifications aux correspondances.
cerné.
178
Configuration d'un espace-noms LDAP pour IBM Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec IBM Directory Server, vous
devez modifier les paramètres nécessaires et modifier les valeurs de toutes les propriétés des objets
IBM Directory.
Procédure
figuration.
Espace-noms.
4. Dans la liste Type, cliquez sur LDAP, puis sur le bouton OK.
Le nouvel espace-noms d'authentification s'affiche dans la fenêtre Explorateur, sous le com-
(:).
pourra localiser et utiliser l'espace-noms d'authentification existant.
Si aucune valeur n'est indiquée, l'espace-noms d'authentification LDAP se lie en tant qu'ano-
nyme.
8. Pour configurer les propriétés de mise en correspondance avancée LDAP à utiliser avec les
objets IBM Directory Server, utilisez les valeurs spécifiées dans le tableau ci-dessous.
Mises en
Dossier Classe d'objets organizationalunit,organization
Nom ou,o
Groupe Classe d'objets groupofnames
Member member
Nom cn
Compte Classe d'objets organizationalperson
Paramètres régionaux du (ne pas saisir de valeur)

contenu
Courrier électronique (ne pas saisir de valeur)

Mises en
Prénom givenname
Téléphone privé (ne pas saisir de valeur)
Téléphone mobile (ne pas saisir de valeur)
Nom cn
Récepteur d'appels (ne pas saisir de valeur)
Mot de passe userPassword
Adresse postale postaladdress
Langue du produit (ne pas saisir de valeur)
Prénom sn
Nom d'utilisateur cn
Ces propriétés de correspondances représentent des modifications basées sur une installation
implicite de IBM Directory Server. Si vous avez modifié le schéma, vous devrez peut-être
apporter d'autres modifications aux correspondances.
Configuration d'un espace-noms LDAP pour Novell Directory Server

Si vous configurez un nouvel espace-noms LDAP pour l'utiliser avec Novell Directory Server, vous
devez modifier les paramètres nécessaires ainsi que les valeurs de toutes les propriétés des objets
Novell Directory.
Procédure
figuration.
Espace-noms.
4. Dans la liste Type, cliquez sur LDAP, puis sur le bouton OK.
Le nouvel espace-noms d'authentification s'affiche dans la fenêtre Explorateur, sous le com-
5. Dans la fenêtre Propriétés, pour la propriété Identificateurd'espace-noms, indiquez un identifi-
cateur unique pour l'espace-noms.
(:).
pourra localiser et utiliser l'espace-noms d'authentification existant.
Pour la propriété Fichier de référence d'utilisateur, indiquez (cn=${userID})
Si aucune valeur n'est indiquée, l'espace-noms d'authentification LDAP se lie en tant qu'ano-
nyme.
8. Pour configurer les propriétés de mise en correspondance avancée LDAP à employer avec les
objets Novell Directory Server, utilisez les valeurs indiquées dans le tableau ci-dessous.
180
Mises en
Dossier Classe d'objets organizationalunit,organization
Nom ou,o
Groupe Classe d'objets groupofnames
Member member
Nom cn
Compte Classe d'objets inetorgperson
Paramètres régionaux du contenu preferredlanguage
Courrier électronique mail
Prénom givenname
Téléphone privé homephone
Téléphone mobile mobile
Nom cn
Récepteur d'appels pager
Mot de passe userPassword
Adresse postale postaladdress
Langue du produit preferredlanguage
Prénom sn
Nom d'utilisateur uid
Ces propriétés de correspondances représentent des modifications apportées par rapport à une
installation implicite de Novell Directory Server. Si vous avez modifié le schéma, vous devrez
peut-être apporter d'autres modifications aux correspondances.

Mise à disposition des propriétés d'utilisateur personnalisées de LDAP pour les

Vous pouvez utiliser des attributs d'utilisateur arbitraires de votre fournisseur d'authentification
LDAP dans les composants de Cognos 8. Pour procéder à cette configuration, vous devez ajouter
ces attributs en tant que propriétés personnalisées pour l'espace-noms LDAP. Les propriétés per-
sonnalisées sont disponibles en tant que paramètres de session par le biais de Framework Mana-
ger. Pour en savoir davantage sur les paramètres de session, reportez-vous au manuel Framework
Manager User Guide.
Les propriétés personnalisées peuvent également être utilisées à l'intérieur de blocs de commande
servant à configurer les sessions et les connexions Oracle. Les blocs de commande peuvent être uti-
lisés avec les connexions Oracle légères et les bases de données privées virtuelles. Pour en savoir
davantage, reportez-vous au Guide d'administration et de sécurité.
Procédure
figuration.
2. Dans la section Sécurité, de la fenêtre Explorateur, cliquez avec le bouton droit de la souris sur
l'option Authentification, puis cliquez sur l'espace-noms LDAP.
3. Dans la fenêtre Propriétés, cliquez sur la colonne Valeur située à côté de la propriété Proprié-
tés personnalisées, puis sur le bouton d'édition.
4. Dans la fenêtre Valeur - Propriétés personnalisées, cliquez sur l'option Ajouter.
5. Cliquez sur la colonne Nom et saisissez le nom que les composants de Cognos 8 doivent utili-
ser pour le paramètre de session.
6. Cliquez sur la colonne Valeur et saisissez le nom du paramètre de compte dans votre fournis-
seur d'authentification LDAP.
7. Répétez les deux étapes précédentes (indiquées par des puces) pour chaque paramètre person-
nalisé.
Activation de la communication sécurisée pour le serveur LDAP

Pour activer le protocole SSL, vous devez indiquer le chemin d'accès et le nom de la base de don-
nées du certificat dans la base de données du certificat SSL pour le serveur LDAP.
Pour en savoir davantage, reportez-vous à la documentation du serveur LDAP.
Activation du code d'accès unique entre LDAP et les composants de Cognos 8

Pour bénéficier de la connexion unique aux composants de Cognos 8, vous devez configurer la
propriété Correspondance des identités externes.
La correspondance des identités externes peut faire référence à une variable d'environnement CGI
ou à un en-tête HTTP variable. Dans le cas d'une entrée de passerelle ou de distributeur de serveur
d'application pointant vers les composants de Cognos 8, la correspondance des identités externes
peut faire référence à la variable de session userPrincipalName. La valeur résolue de la propriété
de correspondance des identités externes en exécution doit être un nom de domaine d'utilisateur
valide.
Si un espace-noms LDAP est configuré pour utiliser la propriété Correspondance des identités
externes pour l'authentification, le fournisseur LDAP se lie au serveur d'annuaire à l'aide de la
propriété Lier le nom unique et le mot de passe de l'utilisateur ou de façon anonyme si aucune
valeur n'est indiquée. Tous les utilisateurs qui se connectent à Cognos 8 à l'aide d'une correspon-
dance des identités externes voient les mêmes utilisateurs, groupes et dossiers que l'utilisateur lié.
182
Si vous voulez que Cognos 8 fonctionne avec des applications utilisant la sécurité du serveur
d'application ou Java, vous pouvez configurer la propriété Correspondance des identités 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 propriété. Pour en savoir
davantage, reportez-vous à l'aide en ligne de Cognos Configuration.
Vous pouvez appliquer une modification limitée de l'expression à la propriété Correspondance des
identités externes à l'aide de l'opération de remplacement.
Opération de remplacement
L'opération de remplacement renvoie une copie de la chaîne avec toutes les occurrences de la
sous-chaîne précédente remplacées par la nouvelle sous-chaîne.
Les règles suivantes s'appliquent :
• Le caractère \ est utilisé comme caractère d'échappement dans les paramètres de la fonction.
Les caractères \ et " doivent être utilisés pour l'échappement.
• Les appels de fonction imbriquée ne sont pas pris en charge.
• Les caractères spéciaux ne sont pas pris en charge.
Syntaxe
${replace(str , old , new)}
Paramètre Description
str Chaîne à rechercher.
ancien Sous-chaîne à remplacer par la nouvelle sous-chaîne.
nouveau Sous-chaîne remplaçant l'ancienne sous-chaîne.
Exemples
${replace(${environment("REMOTE_USER")},"NAMERICA\\",)}
${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}
Configuration des composants de Cognos 8 pour SiteMinder

de Netegrity
Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent l'espace-noms
SiteMinder de Netegrity en tant que source d'authentification, à condition que Content Manager
soit installé sur un ordinateur ne fonctionnant pas sous Linux.
Pour configurer un fournisseur d'authentification dans un environnement SiteMinder, vous confi-
gurez un espace-noms LDAP, NTLM ou SiteMinder en fonction de la configuration de votre Site-
Minder. Les configurations SiteMinder prises en charge sont les répertoires d'utilisateur LDAP,
Active Directory Server et NTLM.
Remarque : Le fournisseur d'authentification utilise un SDK SiteMinder pour mettre en œuvre un
agent personnalisé , en outre, le déploiement de cet agent personnalisé exige que les propriétés
d'agent définies dans la console d'administrateur du serveur de stratégies SiteMinder soient confi-
gurées de façon à prendre en charge des agents 4.x.

Si SiteMinder est configuré pour plusieurs annuaires d'utilisateurs

Si vous avez configuré SiteMinder pour plusieurs annuaires d'utilisateurs, vous devez utiliser
l'espace-noms SiteMinder. Après avoir configuré l'espace-noms SiteMinder dans les composants
de Cognos 8, vous devez également ajouter un espace-noms LDAP, Active Directory Server ou
NTLM correspondant à la configuration Cognos, pour chaque annuaire d'utilisateurs défini dans
SiteMinder.
Lorsque vous configurez un espace-noms LDAP correspondant, vous devez veiller à activer la pro-
priété Correspondance des identités externes et à inclure l'unité syntaxique REMOTE_USER dans
la valeur de la propriété. Cela ne veut pas dire que SiteMinder de Netegrity doit être configuré
pour définir REMOTE_USER. Dans Cognos, l'espace-noms SiteMinder communique de façon
interne les informations sur l'utilisateur à l'espace-noms LDAP correspondant lorsqu'il reçoit un
code d'utilisateur correct de l'environnement SiteMinder.
Lorsque vous configurez un espace-noms Active Directory correspondant, vous devez vous assurer
que la propriété singleSignonOption est définie sur IdentityMapping. L'espace-noms SiteMinder
de Cognos communique de façon interne les informations sur l'utilisateur à l'espace-noms LDAP
correspondant à l'aide de la variable d'environnement REMOTE_USER lorsqu'il reçoit un code
d'utilisateur correct de l'environnement SiteMinder. Pour en savoir davantage, reportez-vous à la
section « Activation du code d'accès unique entre Active Directory Server et les composants de
Cognos 8 » (p. 170).
Si SiteMinder est configuré pour un seul annuaire d'utilisateurs

Lorsque SiteMinder est configuré avec un seul annuaire d'utilisateurs, l'espace-noms SiteMinder
n'est pas requis. Vous pouvez utiliser l'annuaire d'utilisateurs en tant que source d'authentification
en configurant l'espace-noms approprié, ou vous pouvez configurer le fournisseur SiteMinder avec
un annuaire d'utilisateurs. Par exemple, lorsque l'annuaire d'utilisateurs SiteMinder est NTML,
vous pouvez configurer les composants de Cognos 8 avec un espace-noms NTLM ou avec un
espace-noms SiteMinder, en faisant référence à un annuaire d'utilisateurs constituant un
espace-noms NTLM.
Si l'annuaire d'utilisateurs de SiteMinder est Active Directory, vous pouvez utiliser un
espace-noms Active Directory ou LDAP configuré pour utiliser Active Directory.
Si vous voulez directement utiliser l'annuaire d'utilisateurs en tant que source d'authentification
plutôt que de configurer un espace-noms SiteMinder, configurez l'espace-noms LDAP (p. 176),
Active Directory (p. 177) ou NTLM (p. 186) approprié. Dans ce cas, vous devez vérifier les pro-
priétés d'objet de configuration d'agent sur le serveur de stratégies SiteMinder. Assurez-vous que
SetRemoteUser est activé.
Lorsque vous configurez l'espace-noms LDAP, vous devez veiller à activer la propriété Correspon-
dance des identités externes et à inclure l'unité syntaxique REMOTE_USER dans la valeur de la
propriété.
Lorsque vous configurez l'espace-noms Active Directory, vous devez vous assurer que la propriété
singleSignonOption est définie sur IdentityMapping. Pour en savoir davantage, reportez-vous à la
section « Activation du code d'accès unique entre Active Directory Server et les composants de
Cognos 8 » (p. 170).
Pour utiliser un espace-noms SiteMinder et configurer le code d'accès unique, procédez comme
suit :
❑ Configurez les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms SiteMin-
der.
❑ Activez la communication sécurisée pour l'annuaire d'utilisateurs de SiteMinder, le cas
échéant.
❑ Activez le code d'accès unique entre SiteMinder et Cognos 8.
❑ Protégez l'alias Web de Cognos.
Configuration d'un espace-noms SiteMinder

Si vous avez configuré SiteMinder pour plusieurs annuaires d'utilisateurs, vous devez utiliser
l'espace-noms SiteMinder. Après avoir ajouté l'espace-noms SiteMinder, vous devez également
ajouter un espace-noms LDAP ou NTLM adéquat pour chaque annuaire d'utilisateurs.
184
Vous pouvez également configurer un espace-noms SiteMinder si les utilisateurs sont stockés dans
• un serveur LDAP
• un serveur NTLM
• un serveur Active Directory
Procédure
4. Dans la liste Type, cliquez sur l'espace-noms SiteMinder de Netegrity, puis sur le bouton OK.
(:).
7. Dans les sections Sécurité, Authentification de la fenêtre Explorateur, cliquez avec le bouton
droit de la souris sur l'espace-noms Netegrity, puis cliquez sur les options Nouvelle ressource,
Serveur de stratégies SiteMinder.
8. Dans la zone Nom, saisissez un nom pour le serveur de stratégies, puis cliquez sur le bouton
OK.
9. Dans la fenêtre Propriétés, définissez la propriété Hôte et modifiez les valeurs de propriété de
votre choix.
10. Dans la fenêtre Explorateur, cliquez avec le bouton droit de la souris sur le nouveau serveur
de stratégies SiteMinder, puis cliquez sur les options Nouvelle ressource et Annuaire d'utilisa-
teurs.
Conseil : Configurez un annuaire d'utilisateurs pour chaque annuaire d'utilisateurs du serveur
de stratégies 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 stratégies.
12. Dans la fenêtre Propriétés, saisissez une valeur pour la propriété Référence d'identification de
l'espace-noms.
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 même valeur pour la propriété Identificateur d'espace noms
que pour la propriété Identificateur d'espace noms de l'espace-noms SiteMinder.
Activation de la communication sécurisée pour l'annuaire d'utilisateurs

SiteMinder
Si vous utilisez une connexion SSL pour le serveur d'annuaire, vous devez configurer correctement
l'espace-noms Cognos pour l'annuaire d'utilisateurs.
Pour en savoir davantage, reportez-vous à la section « Configuration d'un espace-noms
LDAP » (p. 176).

Activation du code d'accès unique entre SiteMinder et Cognos 8

En configurant le code d'accès unique, vous n'êtes pas invité à saisir de nouveau les informations
d'authentification.
Les composants de Cognos 8 font automatiquement référence au témoin de session SiteMinder
pour les données de session de l'utilisateur.
Lorsque l'annuaire d'utilisateurs SiteMinder est LDAP ou Active Directory, vous devez configurer
l'annuaire d'utilisateurs SiteMinder de façon à ce qu'il utilise la correspondance des identités
externes avec la variable d'environnement REMOTE_USER.
Si l'annuaire d'utilisateurs SiteMinder est NTLM, l'authentification intégrée de Windows est utili-
sée pour la connexion unique et aucune configuration supplémentaire n'est requise.
Protection de l'alias Web de Cognos

SiteMinder doit être configuré correctement pour protéger l'alias Web de Cognos.
Utilisez l'outil de test de SiteMinder fourni avec SiteMinder pour vérifier si la ressource est proté-
gée, authentifiée et autorisée. Pour en savoir davantage, reportez-vous à la documentation sur Site-
Minder.
Configuration des composants de Cognos 8 pour un

espace-noms NTLM
Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent la sécurité native
Windows, NT LAN Manager (NTLM), en tant que source d'authentification.
Si vous n'utilisez pas NTLM dans votre environnement IS, vous ne pouvez pas utiliser un
espace-noms NTLM.
Si vous souhaitez utiliser un annuaire d'utilisateurs NTLM en tant que source d'authentification
avec SiteMinder de Netegrity, vous devez vérifier les propriétés d'objet de configuration d'agent
sur le serveur de stratégies SiteMinder. Assurez-vous que SetRemoteUser est activé.
Pour utiliser NTLM et configurer le code d'accès unique, procédez comme suit :
❑ configurez un espace-noms NTLM,
❑ activez le code d'accès unique entre NTLM et les composants de Cognos 8.
Configuration d'un espace-noms NTLM

NTLM lorsque les utilisateurs sont stockés dans un annuaire d'utilisateurs NTLM. Vous pouvez
également avoir accès à l'annuaire d'utilisateurs NTLM en utilisant un fournisseur d'authentifica-
tion SiteMinder de Netegrity.
Procédure
4. Dans la liste Type, cliquez sur l'option NTLM, puis sur le bouton OK.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe
deux-points (:).
186
cerné.
Activation du code d'accès unique entre NTLM et les composants de Cognos 8

Par défaut, le fournisseur NTLM de Cognos s'intègre au serveur Web IIS pour la connexion uni-
que si l'authentification intégrée de Windows (auparavant nommée stimulation/réponse de
Windows NT) est activée sur le serveur Web IIS.
Si l'authentification intégrée de Windows est activée, vous n'êtes pas invité à saisir à nouveau les
informations d'authentification lorsque vous accédez au contenu de Cognos sécurisé par
l'espace-noms NTLM.
Procédure
1. Configurez l'authentification intégrée 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 opère, afin
qu'il soit sécurisé pour la délégation.
cerné.
Configuration de Cognos 8 pour l'utilisation de SAP

Pour utiliser un serveur SAP en tant que fournisseur d'authentification, vous devez utiliser
SAP BW version 3.0 B ou ultérieure. En outre, Content Manager doit être installé sur un ordina-
teur non-Linux.
Dans SAP BW, vous pouvez affecter des utilisateurs à des groupes d'utilisateurs, des rôles ou les
deux. Le fournisseur d'authentification SAP n'utilise que des rôles.
Les droits d'autorisation requis par l'utilisateur SAP dépendent du statut de la personne qui
emploie les composants Cognos 8 (utilisateur ou administrateur).
Paramètres d'autorisation SAP pour les utilisateurs de Cognos 8

Les objets d'autorisation suivants sont requis pour tous les utilisateurs de Cognos. Certaines
valeurs affichées, telles que * sont les valeurs implicites que vous pouvez modifier pour votre envi-
ronnement.

S_RFC Activité
Contrôle d'autorisation pour
l'accès RFC
Nom de RFC à protéger RFC1 RS_UNIFICATION,

SDTX, SH3A, SU_USER,
SYST, SUSO


Type de RFC à protéger FUGR
S_USER_GRP Activité 03
Maintenance principale des
utilisateurs : Groupe
d'utilisateurs
Nom du groupe d'utilisateurs *
Paramètres d'autorisation SAP pour les administrateurs de Cognos

Si des utilisateurs souhaitent effectuer des tâches d'administration et rechercher des utilisateurs ou
des rôles, les valeurs suivantes doivent être ajoutées à l'objet d'autorisation S_RFC, en plus des
valeurs citées ci-dessus pour les utilisateurs de Cognos 8. Certaines valeurs affichées, telles que *
sont les valeurs implicites que vous pouvez modifier pour votre environnement.

S_RFC Activité 16
Contrôle d'autorisation pour
l'accès RFC
RFC_NAME PRGN_J2EE, SHSS, SOA3
Connectivité entre SAP BW et Cognos 8 sous UNIX

Pour configurer la connectivité entre SAP BW et les composants de Cognos 8 sur un système
d'exploitation UNIX, veillez à installer le fichier de bibliothèque partagée SAP (fourni par SAP) et
à l'ajouter à la variable d'environnement de chemin d'accès aux bibliothèques, comme suit :
• Solaris
LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<répertoire_librfccm.so>
• HPUX
SHLIB_PATH=$SHLIB_PATH :<répertoire_librfccm.sl>
• AIX
LIBPATH=$LIBPATH :<répertoire_librfc.a>
Pour utiliser SAP et configurer le code d'accès unique, procédez comme suit :
❑ Configurez les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms SAP.
❑ Activez le code d'accès unique entre SAP et les composants de Cognos 8.
Configuration d'un espace-noms SAP

Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un serveur SAP
en tant que source d'authentification.
Procédure
l'option Authentification, puis cliquez sur les options Nouvelle ressource et Espace-noms.
4. Dans la liste Type, cliquez sur SAP, puis sur le bouton OK.
188

(:).
En fonction de votre environnement, pour la propriété Hôte, vous devrez peut-être ajouter la
chaîne du routeur SAP au nom d'hôte SAP.
7. Si le système SAP code le contenu des paramètres de témoin (cookie), activez la fonction de
décodage des permis :
• Dans la fenêtre Propriétés, pour l'option Propriétés avancées, cliquez sur la valeur puis sur
le bouton Modifier.
• Cliquez sur le bouton Ajouter.
• Saisissez le nom URLDecodeTickets et indiquez la valeur true
• Cliquez sur OK.
Tous les permis de connexion SAP seront décodés par l'espace-noms SAP avant l'établissement
de la connexion.
Activation du code d'accès unique entre SAP et Cognos 8

Vous pouvez activer le code d'accès unique entre SAP Enterprise Portal et les composants de
Cognos 8, ainsi qu'utiliser la fonction d'espace-noms externe des connexions à la source de don-
nées SAP BW. Pour ce faire, veillez à définir les paramètres système suivants sur le serveur
SAP BW :
• login/accept_sso2_ticket = 1
• login/create_sso2_ticket = 1
• login/ticket_expiration_time = 200
Test des espaces-noms

Après avoir configuré un ou plusieurs espaces-noms pour les composants de Cognos 8, vous pou-
vez les tester. Ce test peut avoir lieu avant ou après le démarrage du service Cognos 8. Les espa-
ces-noms peuvent être testés simultanément ou individuellement.
Procédure permettant de tester l'ensemble des espaces-noms

• Dans la fenêtre Explorateur, cliquez avec le bouton droit de la souris sur Authentification,
puis cliquez sur l'option Tester.
Les composants de Cognos 8 chargent, initialisent et configurent les bibliothèques du fournis-
seur d'un espace-noms avant de passer au suivant.
Conseil : Pour annuler le test d'un espace-noms, cliquez sur Annuler. Le test s'arrête lorsque
l'espace-noms en cours a entièrement été testé.
Procédure pour un seul espace-noms

• Dans la section Authentification de la fenêtre Explorateur, cliquez avec le bouton droit de la
souris sur la nouvelle ressource d'authentification, puis cliquez sur l'option Tester.
Les composants de Cognos 8 chargent, initialisent et configurent les bibliothèques du fournis-
seur de l'espace-noms concerné.

Suppression d'un fournisseur d'authentification

Vous pouvez supprimer des espaces-noms que vous avez ajoutés ou des espaces-noms non configu-
rés que les composants de Cognos 8 ont détectés, si ceux-ci ne sont plus requis.
Important : Vous ne devez pas supprimer l'espace-noms Cognos. Il contient des données d'authen-
tification qui appartiennent à tous les utilisateurs et il est nécessaire pour l'enregistrement de la
configuration.
Lorsque vous supprimez un espace-noms, vous ne pouvez plus vous y connecter. Les données de
sécurité de l'espace-noms sont conservées dans Content Manager jusqu'à ce que vous les suppri-
miez définitivement du portail. Pour en savoir davantage, reportez-vous au Guide d'administra-
tion et de sécurité.
Une fois l'espace-noms supprimé, il apparaît comme inactif dans le portail.
Procédure
2. Dans la section Sécurité, Authentification de la fenêtre Explorateur, cliquez avec le bouton
droit de la souris sur l'espace-noms et sélectionnez Supprimer.
3. Cliquez sur le bouton Oui pour confirmer.
L'espace-noms disparaît de la fenêtre Explorateur et vous ne pouvez plus vous connecter à
l'espace-noms sur cet ordinateur.
5. Répétez les étapes 1 à 4 pour chaque ordinateur sur lequel vous avez installé Content Mana-
ger.
Vous devez désormais vous connecter au portail et supprimer les données de l'espace-noms de
manière permanente. Pour en savoir davantage, reportez-vous au Guide d'administration et
de sécurité.
190
Chapitre 11 : Changement de serveur
d'application
Cognos 8 installe et utilise Tomcat comme serveur d'application implicite. Si vous ne voulez pas
utiliser Tomcat, vous pouvez exécuter Cognos 8 sur l'un des serveurs d'application suivants :
• Serveur d'application IBM WebSphere
• Serveur BEA WebLogic
• Serveur d'application SAP Web
• Serveur d'application Oracle
Remarque : Sous Linux, Cognos 8 peut s'exécuter uniquement avec Tomcat et IBM WebSphere
Application Server.
Afin de garantir le bon fonctionnement de vos produits, veillez à appliquer tous les programmes
de correction requis au système d'exploitation et à n'utiliser que les versions de logiciel tiers prises
en charge par le produit de Cognos.
Pour consulter une liste à jour des environnements pris en charge par les produits de Cognos, tels
que les systèmes d'exploitation, les programmes de correction, les navigateurs, les serveurs Web,
les serveurs d'annuaire, les serveurs de bases de données et les serveurs d'application :
• Visitez le site Web du support technique de Cognos (http://support.cognos.com).
Il est important de noter que le système d'exploitation Linux est disponible dans plusieurs ver-
sions et prend en charge plusieurs plates-formes. Assurez-vous que le système d'exploitation et
la combinaison de matériel que vous utilisez sont pris en charge.
Lorsque vous installez Cognos 8 sous Linux, Framework Manager n'est pas installé. BMTS-
criptPlayer est un utilitaire de ligne de commande qui offre une interface avec le moteur Fra-
mework Manager, permettant d'exécuter les journaux d'opération de Framework Manager.
Le fichier BMTScriptPlayer ne peut pas être exécuté car Framework Manager n'est pas ins-
tallé.
Pour éviter tout risque de conflit au niveau des classes Java ou des ressources système, Cognos 8
doit être exécuté dans une instance JVM (Java Virtual Machine) isolée des autres applications
existantes. Cela permet de s'assurer que Cognos 8 n'a pas d'incidence sur les applications client
existantes. Cognos 8 doit être installé dans une instance JVM séparée des processus d'administra-
tion du serveur d'application, afin d'isoler à la fois Cognos 8 et les fonctions d'administration du
serveur d'application.
Pour isoler une instance JVM, vous pouvez créer au choix :
• une instance de serveur séparée dans IBM WebSphere,
• un serveur géré séparé dans BEA WebLogic,
• une instance OC4J séparée dans Oracle 10g Application Server,
• une instance Java séparée dans SAP Web Application Server.
Si vous procédez à une mise à niveau de ReportNet vers Cognos 8 - ReportNet, reportez-vous à la
section « Mise à niveau de ReportNet vers Cognos 8 dans un environnement de serveur
d'application » (p. 203).
Si vous procédez à une mise à niveau de Metrics Manager vers Cognos 8 - Metrics Manager,
reportez-vous à la section « Mise à niveau de Metrics Manager vers Cognos 8 dans un environne-
ment de serveur d'application » (p. 203).
Pour en savoir davantage sur la configuration d'une installation répartie multi-serveurs de
Cognos 8 dans un environnement de serveur d'application, contactez le support technique de
Cognos (http://support.cognos.com).

Chapitre 11 : Changement de serveur d'application
Cognos 8 permet de modifier la valeur implicite /p2pd ou /ServletGateway de la racine de con-

texte. Dans un environnement Cognos 8 réparti, la racine de contexte de tous les déploiements
d'application doit être la même, à l'exception de l'application de passerelle de type servlet, qui
peut être dotée d'une valeur unique. Pour en savoir davantage sur la configuration de la passerelle
de type servlet, reportez-vous à la section « Configuration d'une passerelle de type
servlet » (p. 139).
Pour configurer Cognos 8 de façon à ce qu'il s'exécute sur votre serveur d'application, vous devez
exécuter les tâches suivantes :
❑ Vérifier que les composants de Cognos sont correctement configurés
❑ Le cas échéant, effectuer une copie de sauvegarde des données et des clés de chiffrement exis-
tantes de Cognos
❑ Définir des variables d'environnement
❑ Copier les fichiers du fournisseur de sécurité de Cognos dans l'environnement JVM (Java Vir-
tual Machine)
❑ Configurer les composants de Cognos pour qu'ils s'exécutent au sein du serveur d'application
❑ Le cas échéant, modifier le script de démarrage du serveur d'application
❑ Configurer les propriétés du serveur d'application et déployer Cognos 8
❑ Le cas échéant, activer le protocole SSL
❑ Configurer le serveur Web
❑ Annuler l'inscription des distributeurs qui ne sont plus utilisés
❑ Importer toutes les données sauvegardées de la base de données Content Store
Après avoir configuré Cognos 8 afin qu'il s'exécute sur votre serveur d'application, vous pouvez
effectuer des tâches de configuration supplémentaires pour personnaliser le comportement des
composants de Cognos afin de l'adapter à votre environnement de création de rapports (p. 115).
Vous pouvez également tester la configuration (p. 113).
Conseil : N'utilisez pas de chemin d'installation contenant des espaces pour le serveur d'applica-
tion ou pour Cognos 8. Les espaces entravent l'exécution des scripts internes et des paramètres de
commande. Si vous êtes obligé de faire appel à un chemin d'installation contenant des espaces, uti-
lisez la convention de dénomination DOS 8.3 pour faire référence à ce type d'emplacement.
Vérification de la configuration des composants de Cognos

Vérifiez les points suivants avant de configurer les composants de Cognos de façon à ce qu'ils
s'exécutent sur votre serveur d'application :
❑ Les composants de Cognos sont installés (p. 57).
❑ Avant de démarrer Cognos 8, vous devez configurer la base de données Content Store. Le cas
échéant, installez et configurez les clients de base de données (p. 90), puis testez la connectivité
à la base de données.
❑ Le serveur d'application est installé et fonctionnel sur chaque ordinateur sur lequel les compo-
sants de Cognos sont installés.
Pour en savoir davantage sur l'installation, reportez-vous à la documentation de votre serveur
d'application.
❑ Le compte d'utilisateur du serveur d'application dispose des droits d'accès complets pour
l'installation de Cognos.
Conseil : Nous vous recommandons de créer un groupe UNIX ou Linux appelé cognos8. Ce
groupe doit contenir l'utilisateur qui démarre le serveur d'application et l'utilisateur qui est
propriétaire des fichiers Cognos. Définissez les droits de propriétaire des fichiers Cognos pour
le groupe cognos8 et définissez les droits d'accès à tous les fichiers Cognos sur GROUP REA-
DABLE/WRITABLE/EXECUTABLE. Pour plus de simplicité, vous pouvez également utiliser
le compte d'utilisateur du serveur d'application pour installer et exécuter les composants de
Cognos.
192
Sauvegarde des informations Cognos

Vous devez sauvegarder les informations existantes relatives à Cognos si les composants de
Cognos 8 sont en cours d'exécution :
• sur un serveur d'application (y compris Tomcat) et si vous passez à un serveur d'application
livré avec son propre environnement JVM,
• avec un environnement JVM d'un fournisseur et si vous passez à un autre fournisseur.
Remarque : Avant de procéder à la mise à niveau, vous devez sauvegarder les informations exis-
tantes relatives à Cognos au sein de l'environnement de travail.
Avant de configurer les composants de Cognos 8 pour qu'il s'exécute sur un nouveau serveur
d'application ou dans un environnement JVM, vous devez sauvegarder :
• les données de la base de données Content Store en créant une exportation de déploiement,
• les informations de configuration en les exportant ; toutes les données chiffrées sont déchif-
frées lors de l'exportation.
• les clés cryptographiques en les enregistrant à un autre emplacement. Les nouvelles clés cryp-
tographiques doivent être créées à l'aide du même environnement JVM utilisé par le serveur
d'application. Ces clés pouvant être créées uniquement si les clés précédentes sont supprimées,
il est important de sauvegarder ces dernières.
Pour garantir la sécurité et l'intégrité des données de Cognos, enregistrez une copie de sauvegarde
de la base de données Content Store, les informations de configuration et les clés cryptographiques
dans un répertoire protégé contre l'accès non autorisé et inapproprié.
Conseil : Pour connaître les clés existantes, examinez le répertoire emplacement_c8/configuration.
Les clés cryptographiques existent si ce répertoire contient les sous-répertoires suivants : csk,
encryptkeypair ou signkeypair.
Procédure
1. S'il existe des données dans la base de données Content Store, démarrez le service Cognos 8 et
exportez l'intégralité de la base de données Content Store à l'aide de l'outil Déploiement.
Pour améliorer la sécurité, l'exportation du déploiement doit être protégée par un mot de
passe. Cette opération sauvegarde les données existantes à l'aide d'une clé de chiffrement neu-
tre. Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
2. Dans Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que et
enregistrez les informations de configuration dans un format déchiffré. Nommez ce fichier de
manière explicite, par exemple « déchiffré.xml ».
Exportez les données dans un répertoire protégé contre tout accès non autorisé ou inappro-
prié. Vous êtes invité à confirmer le caractère non sécurisé de l'exportation.
3. Arrêt du service Cognos 8 :
• Si vous utilisez Tomcat, arrêtez le service Cognos 8 et fermez Cognos Configuration.
• Si vous utilisez un serveur d'application autre que Tomcat, fermez Cognos 8 dans votre
environnement.
4. Sauvegardez toutes les clés cryptographiques en enregistrant les fichiers et répertoires appro-
priés dans un autre emplacement sécurisé.
Les fichiers sont :
• emplacement_c8/configuration/cogstartup.xml
• emplacement_c8/configuration/caSerial
• emplacement_c8/configuration/cogconfig.prefs
• emplacement_c8/configuration/coglocale.xml
Les répertoires 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 répertoires : csk, encrypt-
keypair et signkeypair.

6. Remplacez le fichier emplacement_c8/configuration/cogstartup.xml par celui qui contient les

données exportées depuis Cognos Configuration (par exemple, « déchiffré.xml »).
Important : Dans le répertoire emplacement_c8/configuration, le fichier doit porter le nom
« cogstartup.xml ».
Les informations de ce fichier sont automatiquement chiffrées de nouveau à l'aide des clés
cryptographiques lorsque vous enregistrez la configuration dans Cognos Configuration.
Définition des variables d'environnement

Vous devez définir des variables d'environnement pour identifier l'emplacement de l'environne-
ment JVM et le chemin d'accès à la bibliothèque. Vous pouvez définir des variables d'environne-
ment à l'aide d'une des méthodes suivantes :
• Sous Windows, définissez une variable système ou utilisateur ou modifiez le script de démar-
rage ou d'environnement du serveur d'application.
Si vous définissez une variable utilisateur, veillez à la définir pour le compte de l'utilisateur qui
exécute le serveur d'application ou la console d'administration.
• Sous UNIX et Linux, définissez une variable d'environnement dans le profil de l'utilisateur ou
modifiez le script de démarrage ou d'environnement du serveur d'application.
Pour en savoir davantage sur la modification du script de démarrage d'un serveur d'application,
reportez-vous à la section « Modification du script de démarrage du serveur
d'application » (p. 197).
Conseil : La plupart des versions des serveurs d'application sont livrées avec un script spéciale-
ment conçu pour définir des variables d'environnement. Par exemple, certaines versions de WebS-
phere sont livrées 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 être modifiés afin de définir les valeurs appropriées pour une utilisation avec les
composants de Cognos. La plupart de ces scripts définissent par défaut la variable d'environne-
ment JAVA_HOME.
Procédure
1. Définissez la variable d'environnement JAVA_HOME de façon à ce qu'elle pointe vers l'envi-
ronnement JVM utilisé par le serveur d'application.
Conseil : Si le serveur d'application est livré avec un environnement JVM, la variable d'envi-
ronnement JAVA_HOME doit être définie de telle sorte qu'elle y fasse référence.
Cognos Configuration utilise cette variable pour créer des clés de chiffrement pour les compo-
sants de Cognos qui sont compatibles avec l'environnement JVM utilisé par le serveur d'appli-
cation.
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 appropriée.
Cette variable est utilisée pour localiser les fichiers de la bibliothèque de Cognos.
Système d'exploitation Variable d'environnement

Windows PATH
AIX LIBPATH
Solaris et Linux LD_LIBRARY_PATH
HP-UX SHLIB_PATH
194
Conseil : Pour installer plusieurs instances de Cognos 8 sur un même serveur, définissez la
variable PATH, LIBPATH, LD_LIBRARY_PATH ou SHLIB_PATH dans la portée 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 : La variable CRN_ROOT n'est plus requise dans un environnement non groupé et doit
être supprimée si elle était utilisée dans une installation précédente.
Copie des fichiers du fournisseur de sécurité de Cognos

Les fichiers du fournisseur de sécurité de Cognos doivent être placés dans l'environnement JVM
utilisé par votre serveur d'application. Ces fichiers fournissent des sous-programmes supplémen-
taires de chiffrement et de déchiffrement qui ne sont pas fournis dans l'installation implicite du
JVM. Pour garantir la sécurité, les fichiers de chiffrement doivent être chargés par l'environnement
JVM à l'aide du répertoire d'extensions Java.
Procédure

Configuration des composants de Cognos pour une exécution

dans le serveur d'application
Cognos 8 doit être configuré selon les informations de configuration du serveur d'application. La
configuration doit être enregistrée pour que des clés cryptographiques puissent être créées. Cognos
Configuration utilise l'environnement Java défini par la variable d'environnement JAVA_HOME.
Important : Vous devez définir 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 sécu-
rité pour pouvoir exécuter Cognos Configuration.
Procédure
1. Dans le répertoire emplacement_c8/bin, démarrez Cognos Configuration :
• Sous Windows, saisissez cogconfig.bat dans une fenêtre de commande ou sélectionnez
Cognos Configuration dans le menu Démarrer.
• Sous UNIX ou Linux, saisissez cogconfig.sh
Si des clés de chiffrement existantes sont incompatibles, vous êtes invité à en créer automati-
quement de nouvelles à ce stade.
Conseil : Veillez à effectuer une copie de sauvegarde des clés existantes dans un emplacement
sécurisé avant de poursuivre. Une fois les clés créées, il n'est pas possible de revenir en arrière.
2. Dans la fenêtre Explorateur de Cognos Configuration, développez le dossier Environnement
et modifiez les propriétés suivantes pour qu'elles utilisent le numéro de port et le nom d'hôte
ou l'adresse IP du serveur sur lequel le composant est installé.
• 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 Content Manager
Le serveur d'application doit être configuré pour écouter les connexions sur le nom d'hôte ou
l'adresse IP saisi dans l'URI. Pour en savoir davantage, reportez-vous à la documentation de
votre serveur d'application.
Si vous remplacez la valeur implicite p2pd de la racine du contexte, vous devez également
changer l'URI.
3. Sous Environnement, Service Cognos 8, cliquez avec le bouton droit de la souris sur l'option
Cognos 8, puis cliquez sur le bouton Supprimer.
L'entrée correspondant au service Cognos 8 est utilisée pour configurer les paramètres d'envi-
ronnement permettant l'exécution sous Tomcat. L'entrée n'est pas requise en cas d'utilisation
d'un serveur d'application différent.
4. Complétez les autres changements de configuration requis, en :
• indiquant les propriétés de la base de données Content Manager,
• saisissant les codes d'utilisateurs et mots de passe.
Si vous avez utilisé les paramètres implicites pour l'installation de Cognos, vous n'aurez
peut-être que quelques changements mineurs à apporter aux paramètres de configuration
implicites (p. 115). Vous pouvez revoir la configuration d'installations sur des ordinateurs
individuels (p. 90) ou d'installations réparties (p. 96) afin de déterminer si des modifications
supplémentaires sont requises.
Les nouvelles clés cryptographiques sont créées à l'aide de la machine virtuelle Java définie par
la variable JAVA_HOME.
196
6. Utilisez l'Assistant Création d'application pour créer le fichier d'application qui va être
déployé sur le serveur d'application. Pour lancer l'Assistant Création d'application à partir de
Cognos Configuration sous Opérations, cliquez sur Créer des fichiers d'application. L'assis-
tant permet de sélectionner le type d'application à créer et la racine de contexte utilisée pour
accéder à l'application.
La valeur de la racine de contexte indiquée dans l'assistant doit être la même que celle saisie
dans l'onglet Environnement et être utilisée pour déployer le serveur d'application.
Il n'est pas nécessaire de créer ou de déployer à nouveau le fichier d'archive lorsque vous
modifiez la configuration, car les informations de configuration sont stockées en externe.
Pour WebLogic, vous pouvez utiliser l'assistant Création d'application dans Cognos Configu-
ration pour créer l'application dans un répertoire développé.
Par exemple, vous placez l'application dans C:\bea\user_projects\domins\apps\p2pd, où p2pd
est le nom de l'application. Lors du déploiement de l'application à partir de la console d'admi-
nistration de WebLogic, vous sélectionneriez alors le répertoire p2pd.
Pour en savoir davantage sur les fichiers d'application WAR et EAR et pour déterminer lequel
de ces deux types est pris en charge par votre environnement, reportez-vous à la documenta-
tion du serveur d'application.
7. Fermez Cognos Configuration.
Modification du script de démarrage du serveur d'application

Assurez-vous de la conformité avec la configuration requise pour les serveurs d'application avant
d'exécuter Cognos 8. En fonction du serveur d'application, vous pouvez avoir besoin de définir
des variables d'environnement, de copier des fichiers et d'ajouter ou modifier le code des fichiers.
Si vous utilisez le serveur BEA WebLogic version 7.0 ou 8.1, vous devez effectuer des modifica-
tions dans le script de démarrage du serveur d'application. Le script de démarrage doit être modi-
fié de façon à utiliser les paramètres JVM. Pour WebLogic 9, il est conseillé d'utiliser la console
d'administration pour modifier l'environnement WebLogic.
Si vous utilisez SAP Web Application Server 6.20, vous devez effectuer des modifications dans le
script de démarrage du serveur d'application. Le script de démarrage doit être modifié pour définir
les paramètres de mémoire et les arguments de la ligne de commande Java. Aucune modification
n'est requise pour le script de démarrage du serveur d'application SAP Web Application
Server 6.40.
Si vous utilisez le serveur d'application WebSphere d'IBM ou le serveur d'application Oracle,
aucune modification du script de démarrage n'est requise, à moins que vous ne souhaitiez ajouter
les modifications à la variable d'environnement à ces scripts.
Procédure pour WebLogic

1. Créez un domaine WLS (WebLogic Server) pour Cognos 8.
Pour en savoir davantage sur la création de domaines, reportez-vous à la documentation de
WebLogic.
2. Accédez au répertoire approprié et ouvrez le script de démarrage du serveur d'application
dans un éditeur.
• emplacement_ WebLogic7.0/user_projects /nom_domaine
• emplacement_ WebLogic8.1/user_projects /nom_domaine
• emplacement_ WebLogic9/user_projects /nom_domaine
Le nom du script de démarrage peut varier selon le type d'installation de WebLogic effectué.
Par exemple, dans le cas d'une installation de serveur géré, le nom du script de démarrage est
startManagedWebLogic.sh (sous UNIX) ou startManagedWebLogic.cmd (sous Windows).
3. Pour le mode d'exécution JVM, remplacez le paramètre implicite JAVA_VM= par
JAVA_VM=-server
4. Modifiez le paramètre JAVA_OPTIONS comme suit :
JAVA_OPTIONS=
-Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts
-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

Remarque : La valeur JAVA_HOME doit correspondre au même chemin d'accès que celui uti-
lisé pour Cognos 8. Il est recommandé d'utiliser l'environnement JVM intégré à l'installation
de WebLogic.
5. Définissez les valeurs minimale et maximale de mémoire utilisée par la machine virtuelle Java.
En général, la mémoire est définie en ajoutant ou en modifiant les deux paramètres JVM:
-Xms et -Xmx. Pour en savoir davantage sur ces paramètres, reportez-vous à la documenta-
tion du serveur d'application ou de la machine virtuelle Java.
Conseil : Utilisez entre 25 et 50 % de votre mémoire physique (soit au moins 768 Mo) comme
valeurs de départ. Vous pourrez toujours les modifier plus tard en fonction des besoins de
6. Vérifiez que le mode de production est activé.
Pour WebLogic 7.0, définissez STARTMODE= sur STARTMODE=true
Pour WebLogic 8 et 9, définissez PRODUCTION_MODE= sur
PRODUCTION_MODE=true
Procédure pour SAP Web Application Server 6.20

1. Ouvrez le script de démarrage du serveur d'application dans un éditeur :
• Sous Windows, ouvrez emplacement_SAP/cluster/server/go.bat
• Sous UNIX, ouvrez emplacement_SAP/cluster/server/go.sh
2. Définissez la mémoire utilisée par la machine virtuelle Java.
3. Si vous utilisez une version de JVM antérieure à la version 1.3.1_08, vous risquez de devoir
définir le paramètre MaxPermSize dans les arguments de la ligne de commande Java. Par
exemple :
-XX:MaxPermSize=64m
Pour en savoir davantage sur ce paramètre, reportez-vous à la documentation du serveur
d'application ou de la machine virtuelle Java.
Configuration des propriétés du serveur d'application et

déploiement des composants de Cognos
Vous devez configurer les propriétés du serveur d'application et déployer les composants de
Cognos.
Procédure pour WebSphere

1. Démarrez le serveur d'application de WebSphere, puis la console d'administration de WebS-
phere.
2. Créez une nouvelle instance de serveur dans laquelle l'application Cognos 8 va être déployée.
3. Installez une nouvelle application au niveau de l'entreprise à l'aide du fichier d'archive conte-
nant l'application Cognos.
La racine de contexte implicite p2pd peut être utilisée dans la plupart des cas. Vous devrez
peut-être modifier d'autres valeurs de déploiement d'application implicites, telles que le nom
de l'application, afin de mieux répondre aux besoins de votre environnement. La valeur de la
racine de contexte utilisée pour déployer l'application doit être la même que celle indiquée
dans Cognos Configuration.
198
En règle générale, la mémoire est définie en ajoutant ou en modifiant la taille initiale et maxi-
male de segment mémoire Java. Pour en savoir davantage sur ces paramètres, reportez-vous à
la documentation du serveur d'application ou de la machine virtuelle Java.
5. Arrêtez puis redémarrez l'instance du serveur d'application WebSphere utilisée pour les com-
posants de Cognos.
6. Vérifiez que les composants de Cognos sont en cours d'exécution en recherchant le message
suivant dans la fenêtre de la console du serveur d'application ou dans le fichier journal du ser-
veur d'application :
Le distributeur est prêt à traiter les demandes.
Procédure pour WebLogic

1. Si vous avez choisi l'option du répertoire développé lors de la création de l'application dans
Cognos Configuration, passez à l'étape 2. Si vous avez créé un fichier *.war, déployez l'appli-
cation manuellement :
• Créez un répertoire dans un emplacement accessible par le serveur d'application, en don-
nant au répertoire le même nom que la racine du contexte.
Le nom de la racine de contexte implicite et du répertoire de l'application est p2pd, il peut
être utilisé dans la plupart des cas. Vous devrez peut-être modifier d'autres valeurs de
déploiement d'application implicites, telles que le nom de l'application, afin de mieux
répondre aux besoins de votre environnement. La valeur de la racine de contexte utilisée
pour déployer l'application doit être la même que celle indiquée dans Cognos Configura-
tion.
• Dans le répertoire que vous venez de créer, procédez à l'extraction du fichier .war de l'ins-
tallation de WebLogic à l'aide de la commande suivante d'une invite de commande :
emplacement_WebLogic/version_jdk/bin/jar xvfm "emplacement_installation/applica-
tion.war" .
Important : Vous devez ajouter un espace, suivi d'un point, à la fin de la commande. Dans
cette commande, le point ne fait pas référence au répertoire actuel.
2. Démarrez le serveur d'administration WebLogic et le serveur géré WebLogic associés au
domaine Cognos.
L'application Node Manager doit être lancée pour que vous puissiez arrêter et démarrer les
instances du serveur géré à l'aide de la console d'administration.
3. Pour WebLogic 9, vous devez modifier l'environnement dans la console d'administration
WebLogic avant de déployer Cognos 8. Connectez-vous à la console d'administration et accé-
dez à l'instance de serveur géré prévue pour héberger l'application Cognos 8. Sélectionnez
l'onglet Server Start correspondant à l'instance de serveur géré et activez le mode d'édition.
4. Dans la zone Java Home, saisissez le chemin d'accès au JVM. Cette valeur doit être identique
à celle utilisée pour Cognos 8. Il est recommandé d'utiliser l'environnement JVM intégré à
l'installation de WebLogic.
5. Définissez les arguments Java. Les arguments Java incluent l'ensemble des paramètres du
JVM, tels que les paramètres de mémoire.
Par exemple, dans la zone Arguments, saisissez :
-Xms768m -Xmx768m -XX:MaxPermSize=128m -server -Dorg.xml.sax.driver=org.apa-
che.xerces.parsers.SAXParser
-Xms et -Xmx. Pour WebLogic 9, il est également recommandé de définir le paramètre Max-
PermSize.
Pour en savoir davantage sur ces paramètres, reportez-vous à la documentation du serveur
d'application ou de la machine virtuelle Java.
6. Enregistrez et appliquez les modifications.
Vous pouvez maintenant démarrer et arrêter l'instance du serveur géré à partir de l'onglet
Control.
7. Démarrez l'instance.

8. Déployez l'application Cognos 8 dans la console WebLogic à l'aide d'une nouvelle application
Web, comme suit :
• Définissez le nom de l'application.
Par exemple, cognos8.
• Définissez le chemin d'accès au répertoire dans lequel les fichiers de l'application étendue
se trouvent.
Remarque : Pour utiliser le chargeur de classe personnalisé, vous devez utiliser l'option de
répertoire développé lors du déploiement.
• Sélectionnez l'instance de serveur cible.
Il est recommandé de n'utiliser le serveur d'administration que pour les tâches d'adminis-
tration de WebLogic et de déployer l'application Cognos 8 sur sa propre instance de ser-
veur géré.
9. Une fois le déploiement correctement effectué, définissez la période de rechargement pour
l'application Web sur -1 afin d'améliorer les performances. Cela évite que WebLogic ne
recherche des fichiers d'application mis à jour.
10. Arrêtez et redémarrez le serveur géré WebLogic associé au domaine Cognos afin d'activer les
modifications.
Procédure pour SAP Web Application Server 6.20, SP23

1. Dans l'outil de configuration J2EE Engine de SAP, modifiez l'environnement de la façon
suivante :
• Pour le serveur approprié, définissez le paramètre Enable Chunked Response sur True.
• Vérifiez que les valeurs des paramètres implicites sont correctes. Par exemple, le service
HTTP utilise le port 80 par défaut. Assurez-vous que le service HTTP pour le distributeur
adéquat dans le cluster est configuré sur un port qui n'est pas utilisé par un autre pro-
gramme. Vous devrez peut-être également augmenter le délai d'attente Keep Alive qui est
fixé par défaut à 15-secondes car cette valeur risque d'être insuffisante.
2. Démarrez le contrôleur d'état pour SAP Web Application Server 6.20.
3. Démarrez le distributeur pour SAP Web Application Server.
4. Démarrez le serveur pour SAP Web Application Server.
5. Utilisez l'outil Déploiement pour créer un nouveau projet.
6. Chargez le fichier d'archive de Cognos que vous avez créé et nommé p2pd.ear.
Si vous avez créé un fichier WAR au lieu d'un fichier EAR, vous pouvez créer le fichier EAR à
partir du fichier WAR. Pour obtenir des informations, reportez-vous à la documentation de
votre serveur d'application.
7. À l'aide de l'outil Déploiement, connectez-vous à l'outil Administration et déployez le fichier
p2pd.ear.
8. Enregistrez le projet.
Procédure pour SAP Web Application Server 6.40 sous Windows

1. Ouvrez l'outil de configuration en saisissant ce qui suit :
lecteur:\usr\sap\sapid\JCxx\j2ee\configtool\configtool.bat
Ainsi, si l'ID SAP est J2E et que l'installation se trouve sur le lecteur D, vous devez saisir :
D:\usr\sap\J2E\JC00\j2ee\configtool\configtool.bat
2. Lorsque vous êtes invité à utiliser les paramètres de base de données implicites, cliquez sur
Yes.
200
3. Sous cluster-data, instance_IDxxxxxxx, Dispatcher_IDxxxxxxx, services, où xxxxxxx corres-

pond au numéro d'identification de votre installation, mettez en évidence http.
4. Sous Global Properties, mettez en évidence KeepAliveTimeout et saisissez un nombre plus
élevé, puis cliquez sur Set.
Conseil : Il est conseillé d'adopter une valeur KeepAliveTimeout d'au moins 60.
5. Sous cluster-data, instance_IDxxxxxxx, mettez en évidence Server_IDxxxxxxx.
Suivez les instructions fournies par SAP. Pour en savoir davantage, consultez la note
SAP 723909 dans le portail de support SAP.
Si votre ordinateur dispose de moins de 1,5 Go de mémoire, des problèmes peuvent se pro-
duire lors de l'exécution de SAP Web Application Server.
7. Dans la zone de paramètres Java, saisissez :
-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser
8. Enregistrez les modifications.
Vous êtes invité à redémarrer le serveur.
9. Redémarrez le serveur à l'aide de la console de gestion SAP ou en redémarrant les services
dans la section Services.
10. Utilisez l'outil Déploiement pour créer un nouveau projet.
11. Chargez le fichier d'archive de Cognos que vous avez créé et nommé p2pd.ear.
Vous pouvez créer le fichier EAR à partir du fichier WAR. Pour obtenir des informations,
reportez-vous à la documentation de votre serveur d'application.
12. À l'aide de l'outil Déploiement, connectez-vous à l'outil Administration et déployez le fichier
p2pd.ear.
13. Lorsque vous êtes invité à démarrer l'application, cliquez sur Yes.
14. Enregistrez le projet.
Procédure pour le serveur d'application Oracle

1. Créez une instance OC4J au sein de laquelle les composants de Cognos s'exécuteront.
3. Dans les propriétés du serveur, ajoutez "-userThreads" aux options OC4J.
4. Dans les propriétés du serveur, ajoutez une variable d'environnement, selon le tableau ci-des-
sous, qui fait référence au répertoire emplacement_installation/bin.
Système d'exploitation Variable d'environnement

Windows PATH
AIX LIBPATH
Solaris LD_LIBRARY_PATH
HP-UX SHLIB_PATH
5. Déployez le fichier d'archive Web (.war) ou le fichier d'archive Enterprise (.ear) de Cognos.
La valeur du paramètre Map to URL doit être identique à celle de la racine de contexte indi-
quée dans Cognos Configuration.
6. Démarrez l'instance de OC4J que vous avez créée pour les composants de Cognos.

Activation du protocole SSL

Si vous utilisez le protocole SSL (Secure Socket Layer) pour les composants de Cognos, vous devez
également activer le protocole SSL dans l'environnement du serveur d'application. Identifiez
ensuite le certificat de serveur SSL pour les composants de Cognos.
Procédure
1. Configurez le serveur d'application de façon à ce qu'il utilise le protocole SSL.
Un certificat de serveur SSL est créé par une autorité de certification tierce. Le certificat de
l'autorité de certification qui crée le certificat de serveur SSL vous est également délivré.
Pour en savoir davantage, reportez-vous à la documentation du serveur d'application.
2. Copiez le certificat de l'autorité de certification dans le répertoire
emplacement_installation/bin et renommez le fichier en ca.cer.
Ce fichier doit utiliser l'encodage Base-64, format X.509.
3. À partir du répertoire emplacement_installation/bin :
• Sous Windows, saisissez :
ThirdPartyCertificateTool.bat -T -i -r ca.cer -D ../configuration/signkeypair/jCAKeys-
tore -p mot_de_passe
• Sous UNIX ou Linux, saisissez :
ThirdPartyCertificateTool.bat -T -i -r ca.cer -D ../configuration/signkeypair/jCAKeys-
tore -p mot_de_passe
Important : Vous devez saisir jCAKeystore comme nom de bibliothèque de clés de l'autorité
de certification.
Configuration du serveur Web

Si vous utilisez un serveur Web dans votre environnement, configurez-le maintenant. Pour en
savoir davantage sur la configuration du serveur Web, reportez-vous à la section « Configuration
du serveur Web » (p. 81).
Pour en savoir davantage sur la configuration du module d'extension du serveur Web de WebS-
phere, contactez le support client de Cognos (http://support.cognos.com).
Annulation de l'inscription des distributeurs

Une fois que vous avez démarré le serveur d'application et l'application Cognos, annulez l'inscrip-
tion des distributeurs Cognos qui avaient été inscrits et qui ne sont plus utilisés. Par exemple,
annulez l'inscription de tous les distributeurs Tomcat exécutés désormais sous le serveur d'applica-
tion.
Supprimez les distributeurs à l'aide de l'outil d'administration du serveur. Pour accéder à cet outil,
vous devez disposer de droits d'exécution sur la fonction protégée Administration.
Procédure
1. Ouvrez Cognos Connection.
2. Dans la barre d'outils du portail, cliquez sur l'option Administration des serveurs.
3. Activez la case à cocher correspondant au distributeur dont vous souhaitez annuler l'inscrip-
tion, puis, dans la barre d'outils, cliquez sur le bouton d'annulation de l'inscription.
Conseil : Vous pouvez également annuler l'inscription des distributeurs en cliquant sur le bou-
ton Plus dans la colonne Opérations.
202
4. Dans la boîte de dialogue de confirmation, cliquez sur OK.

Les informations sur le distributeur sont retirées de Content Manager.
Importation des données de la base de données Content Store

Si vous avez exporté la base de données Content Store avant de configurer les composants de
Cognos pour qu'ils s'exécutent sur le serveur d'application (p. 193), importez le déploiement pour
restaurer et chiffrer les données à l'aide des nouvelles clés de chiffrement.
Procédure
2. Importez l'intégralité de la base de données Content Store à l'aide de l'outil Déploiement
Mise à niveau de ReportNet vers Cognos 8 dans un

environnement de serveur d'application
Si vous procédez à une mise à niveau de ReportNet vers Cognos 8, effectuez la procédure suivante.
Procédure
1. Effectuez une copie de sauvegarde des informations de ReportNet existantes (p. 193).
2. Utilisez les outils administratifs pour le serveur d'application afin d'annuler le déploiement de
l'application de ReportNet.
Pour en savoir davantage sur l'annulation du déploiement d'applications, reportez-vous à la
documentation de votre serveur d'application.
Si le répertoire dans lequel ReportNet était déployé à l'origine n'est pas supprimé lors de
l'annulation du déploiement, supprimez-le.
Supprimez également tous les fichiers .jar de ReportNet qui se trouvent dans l'antémémoire de
l'environnement du serveur d'application. Par exemple, dans WebLogic 7.0, des fichiers .jar
subsistent parfois dans %WL_HOME%\user_projects\nom-domaine\ nom-ser-
veur-géré\.wlnotdelete\crn_p2pd_p2pd\jarfiles.
Vous pouvez les supprimer en supprimant le répertoire WEB-INF.
Dans WebLogic 8.1, l'antémémoire se trouve dans
%WL_HOME%\user_projects\domains\nom-domaine\ nom-serveur-géré\.wlnotde-
lete\extract\crn_p2pd_p2pd\ jarfiles
3. Désinstallez ReportNet (p. 68).
4. Installez Cognos 8 (p. 57).
5. Suivez les instructions appropriées indiquées dans ce chapitre pour modifier le serveur d'appli-
cation.
Vous devez effectuer les opérations suivantes pour la plupart des installations :
• Configurer Cognos 8 pour qu'il s'exécute au sein du serveur d'application
• Configurer les propriétés du serveur d'application et déployer Cognos 8.
6. Pour activer les nouvelles fonctions après avoir effectué la mise à niveau, enregistrez la confi-
guration dans Cognos Configuration puis redémarrez les services.
Mise à niveau de Metrics Manager vers Cognos 8 dans un

environnement de serveur d'application
Si vous effectuez une mise à niveau de Metrics Manager vers Cognos 8, procédez comme suit :

Procédure
1. Suivez la procédure pour mettre à niveau Metrics Manager vers Cognos 8 (p. 50).
2. Suivez les instructions appropriées indiquées dans ce chapitre pour modifier le serveur d'appli-
cation.
Vous devez effectuer les opérations suivantes pour la plupart des installations :
• Configurer Cognos 8 pour qu'il s'exécute au sein du serveur d'application.
• Configurer les propriétés du serveur d'application et déployer Cognos 8.
3. Pour activer les nouvelles fonctions après avoir effectué la mise à niveau, vous devez enregis-
trer la configuration dans Cognos Configuration puis redémarrer les services.
204
Chapitre 12 : Options de configuration avancées
Les options de configuration avancées ont trait aux modifications que vous apportez, après instal-
lation, aux propriétés de configuration des ressources utilisées par les composants de Cognos 8.
Cognos Configuration ne permet pas d'apporter ces modifications. Les options de configuration
avancées améliorent la sécurité et les performances et modifient le comportement implicite des
Changement du type de JVM utilisée par Cognos 8

Pour mieux adapter votre environnement de création de rapports, vous pouvez changer le type de
JVM (Java Virtual Machine) utilisée par les composants de Cognos 8, en fonction des critères
suivants :
• Java HotSpot Client VM
Cette JVM permet d'améliorer des environnements de banc d'essai, de démonstration ou de
développement. Elle est spécialement conçue pour réduire le temps de démarrage des applica-
tions et l'utilisation de la mémoire.
Il s'agit du paramétrage implicite de l'installation de Cognos sous Windows. Sur les plates-for-
mes UNIX et Linux, Cognos ne fournit pas Java Runtime Environment (JRE). La JVM impli-
cite utilisée par les composants de Cognos 8 dépend donc du paramétrage du JRE existant.
• Java HotSpot Server VM
Ce module permet d'optimiser l'exécution des applications serveur longues lorsque les perfor-
mances ont priorité sur le temps de démarrage.
• Classic VM
Vous devrez peut-être utiliser Classic VM pour des raisons de compatibilité. Tous les JDK
(Java Development Kits) ne comprennent pas Classic VM. Sous UNIX ou Linux, si vous utili-
sez JavaSoft Solaris JDK 1.3 ou l'un des JDK JavaSoft 1.4, vous disposez uniquement de
HotSpot VM.
Pour en savoir davantage, reportez-vous au site Web de Sun Microsystems Inc.
Procédure
1. Ouvrez l'emplacement où sont installées les bibliothèques de Java Runtime Environment
(JRE) :
• Sous Windows, ouvrez le répertoire emplacement_c8/bin/jre/version_jre/lib.
• Sous UNIX ou Linux, ouvrez le répertoire 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 première ligne sans commen-
taire. Saisissez le texte approprié pour la JVM que vous voulez utiliser :
JVM Texte
Hotspot Client hotspot
Hotspot Client serveur
Classic classic

Changement de la version de Java Runtime Environment

utilisée par les composants de Cognos 8
Pour fonctionner, les composants de Cognos 8 ont besoin d'un environnement JRE (Java Runtime
Environment). La version actuellement fournie avec Cognos 8 est la version JRE 1.4.2, mais la
version 1.3.1 est toujours prise en charge. Pour en savoir davantage sur les versions de JRE prises
en charge, reportez-vous au site Web du support technique de Cognos (http://sup-
port.cognos.com).
Cognos Configuration et les autres composants de Cognos 8 utilisent le JRE référencé par la varia-
ble d'environnement JAVA_HOME. Sous Windows, si la variable JAVA_HOME n'est pas définie,
le JRE fourni avec les composants de Cognos 8 est utilisé par défaut.
Pour changer de version de JRE, vous devez modifier la configuration. Ces modifications peuvent
s'avérer utiles dans les situations suivantes :
• Vous voulez utiliser les composants de Cognos 8 avec un serveur d'application qui nécessite
une version de JRE spécifique.
• Vous utilisez déjà une version de JRE avec d'autres applications.
• Vous utilisez un environnement JRE version 1.3.1 et souhaitez utiliser des caractères thaïs
avec les composants de Cognos 8.
De plus, si vous utilisez des technologies Microsoft DEP (Data Execution Prevention), vous devrez
peut-être utiliser un environnement JRE version 1.5. Cognos 8 est également compatible avec
JRE 1.5.
Si vous utilisez les composants de Cognos 8 dans un environnement de serveur d'application, sui-
vez la procédure décrite dans la section « Changement de serveur d'application » (p. 191). Cette
procédure inclut les étapes permettant de mettre à jour l'environnement Java.
Avant de commencer, assurez-vous que les composants de Cognos 8 et le JRE que vous souhaitez
utiliser sont installés.
Pour changer de version de JRE, procédez comme suit :
❑ Le cas échéant, effectuez une sauvegarde de toutes les données et clés de chiffrement existantes
de Cognos.
❑ Copiez les fichiers du fournisseur de sécurité de Cognos dans l'environnement JVM (Java Vir-
tual Machine).
❑ Le cas échéant, importez les données dans la base de données Content Store.
Les tâches de cette section correspondent à une installation de Cognos avec Tomcat.
Sauvegarde des informations Cognos

Vous devez sauvegarder les informations existantes relatives à Cognos si les composants de
Cognos 8 sont en cours d'exécution :
• sur un serveur d'application (y compris Tomcat) et si vous passez à un serveur d'application
livré avec son propre environnement JVM,
• avec un environnement JVM d'un fournisseur et si vous passez à un autre fournisseur.
Remarque : Avant de procéder à la mise à niveau, vous devez sauvegarder les informations exis-
tantes relatives à Cognos au sein de l'environnement de travail.
Avant de configurer les composants de Cognos 8 pour qu'il s'exécute sur un nouveau serveur
d'application ou dans un environnement JVM, vous devez sauvegarder :
• les données de la base de données Content Store en créant une exportation de déploiement,
• les informations de configuration en les exportant ; toutes les données chiffrées sont déchif-
frées lors de l'exportation.
• les clés cryptographiques en les enregistrant à un autre emplacement. Les nouvelles clés cryp-
tographiques doivent être créées à l'aide du même environnement JVM utilisé par le serveur
d'application. Ces clés pouvant être créées uniquement si les clés précédentes sont supprimées,
il est important de sauvegarder ces dernières.
206
Pour garantir la sécurité et l'intégrité des données de Cognos, enregistrez une copie de sauvegarde
de la base de données Content Store, les informations de configuration et les clés cryptographiques
dans un répertoire protégé contre l'accès non autorisé et inapproprié.
Conseil : Pour connaître les clés existantes, examinez le répertoire emplacement_c8/configuration.
Les clés cryptographiques existent si ce répertoire contient les sous-répertoires suivants : csk,
encryptkeypair ou signkeypair.
Procédure
1. S'il existe des données dans la base de données Content Store, démarrez le service Cognos 8 et
exportez l'intégralité de la base de données Content Store à l'aide de l'outil Déploiement.
Pour améliorer la sécurité, l'exportation du déploiement doit être protégée par un mot de
passe. Cette opération sauvegarde les données existantes à l'aide d'une clé de chiffrement neu-
tre. Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
2. Dans Cognos Configuration, dans le menu Fichier, cliquez sur l'option Exporter en tant que et
enregistrez les informations de configuration dans un format déchiffré. Nommez ce fichier de
manière explicite, par exemple « déchiffré.xml ».
Exportez les données dans un répertoire protégé contre tout accès non autorisé ou inappro-
prié. Vous êtes invité à confirmer le caractère non sécurisé de l'exportation.
3. Arrêt du service Cognos 8 :
• Si vous utilisez Tomcat, arrêtez le service Cognos 8 et fermez Cognos Configuration.
• Si vous utilisez un serveur d'application autre que Tomcat, fermez Cognos 8 dans votre
environnement.
4. Sauvegardez toutes les clés cryptographiques en enregistrant les fichiers et répertoires appro-
priés dans un autre emplacement sécurisé.
Les fichiers sont :
• emplacement_c8/configuration/cogstartup.xml
• emplacement_c8/configuration/caSerial
• emplacement_c8/configuration/cogconfig.prefs
• emplacement_c8/configuration/coglocale.xml
Les répertoires 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 répertoires : csk, encrypt-
keypair et signkeypair.
6. Remplacez le fichier emplacement_c8/configuration/cogstartup.xml par celui qui contient les
données exportées depuis Cognos Configuration (par exemple, « déchiffré.xml »).
Important : Dans le répertoire emplacement_c8/configuration, le fichier doit porter le nom
« cogstartup.xml ».
Les informations de ce fichier sont automatiquement chiffrées de nouveau à l'aide des clés
cryptographiques lorsque vous enregistrez la configuration dans Cognos Configuration.
Copie des fichiers du fournisseur de sécurité de Cognos

Les fichiers du fournisseur de sécurité de Cognos doivent se trouver dans l'environnement JVM
pour la nouvelle version de Java.

Procédure
Cognos Configuration crée de nouvelles clés et chiffre les données.
Importation des données de la base de données Content Store

Si vous avez exporté la base de données Content Store avant de changer la JVM, importez le
déploiement pour restaurer et chiffrer les données à l'aide des nouvelles clés de chiffrement.
Procédure
• Pour importer les données de la base de données Content Store, démarrez le service Cognos 8
et importez l'intégralité de la base de données Content Store à l'aide de l'outil Déploiement.
Configuration des composants de Cognos 8 pour l'utilisation

d'une autorité de certification tierce
Par défaut, les composants de Cognos 8 utilisent leur propre service d'autorité de certification
(CA) pour établir la racine d'approbation dans l'infrastructure de sécurité de Cognos. Vous pou-
vez configurer les composants de Cognos 8 afin qu'ils utilisent une autre autorité de certification si
vous disposez déjà d'une autorité de certification tierce, telle qu'iPlanet ou Microsoft, dans votre
environnement d'exécution de rapports.
208
Lorsque vous configurez les composants de Cognos 8 afin qu'ils utilisent une autorité de certifica-
tion tierce, veillez à indiquer les mêmes informations dans l'utilitaire de ligne de commande et
dans Cognos Configuration.
Pour configurer les composants de Cognos 8 afin qu'ils utilisent une autorité de certification
tierce, vous devez :
❑ créer les clés de sécurité de Cognos et les demandes de signature de certificat à utiliser avec
l'autorité de certification tierce,
❑ soumettre les clés de sécurité de Cognos et les certificats à l'autorité de certification tierce,
❑ configurer les composants de Cognos 8 pour l'utilisation d'une autorité de certification tierce.
Création de clés et de demandes de signature de certificat

L'utilitaire de ligne de commande permet de créer toutes les clés pour les bibliothèques de clés de
Cognos et de créer les demandes de signature de certificat (CSR).
Le tableau ci-dessous présente les options de l'outil de ligne de commande utilisé pour créer des
clés et des demandes de signature.
Commande Description
Mode de fonctionnement principal
-c Créer une nouvelle CSR
-i Importer un certificat
Modificateurs de fonctionnement
-s Utiliser l'identité de signature
-e Utiliser l'identité de chiffrement
-T Utiliser la bibliothèque d'approbations (uniquement

avec -i)
Indicateurs d'informations
-d Nom unique à utiliser pour le certificat
-r CSR ou emplacement de fichier de certificat (selon le

mode)
-t Fichier de certificat de l'autorité de certification

(uniquement avec -i)
-p Mot de passe de la bibliothèque de clés (doit être

fourni)
-a Algorithme de paire de clés. RSA ou DSA.

Implicite : RSA
-D Emplacement du répertoire
Les exemples de valeurs suivants sont utilisés :
Propriété Valeur
DN du certificat de signature CN=SignCert,O=MaSociété,C=CA

Propriété Valeur
DN du certificat de chiffrement CN=EncryptCert,O=MaSociété,C=CA
Mot de passe de bibliothèque de clés password
Procédure
1. Accédez au répertoire emplacement_c8/bin.
2. Créez la demande de signature de certificat pour les clés de signature en saisissant la com-
mande suivante :
Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MaSociété,C=CA" -r signRequest.csr
-D ../configuration/signkeypair/jSignKeystore -p mot_de_passe
ThirdPartyCertificateTool.bat c -s -d "CN=SignCert,O=MaSociété,C=CA" -r signRequest.csr
-D ../configuration/signkeypair/jSignKeystore -p mot_de_passe
Important : Vous devez saisir jSignKeystore comme nom de la bibliothèque de clés de signa-
ture. Veillez également à ce que le répertoire défini pour -D soit le même que celui indiqué
dans la propriété Emplacement de la bibliothèque de clés de signature, sous Sécurité, Crypto-
graphie, Cognos dans Cognos Configuration.
Conseil : Les noms de fichier UNIX ou Linux sont sensibles à la casse et doivent être saisis
exactement de la manière indiquée.
3. Créez la demande de signature de certificat pour les clés de chiffrement en saisissant la com-
mande suivante :
ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MaSociété,C=CA" -r encryptRe-
quest.csr -D ../configuration/encryptkeypair/jEncKeystore -p mot_de_passe
ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MaSociété,C=CA" -r encryptRe-
quest.csr -D ../configuration/encryptkeypair/jEncKeystore -p mot_de_passe
Important : Vous devez saisir jEncKeystore comme nom de la bibliothèque de clés de chiffre-
ment. Veillez également à ce que le répertoire défini pour -D soit le même que celui indiqué
dans la propriété Emplacement de la bibliothèque de clés de chiffrement, sous Sécurité, Cryp-
tographie, Cognos dans Cognos Configuration.
4. Saisissez les fichiers de demande de signature de certificat (CSR) créés lors des étapes 2 et 3
dans l'autorité de certification tierce.
Pour en savoir davantage, reportez-vous à la documentation sur l'autorité de certification
tierce.
L'autorité de certification tierce produit un certificat de signature et un certificat de chiffre-
ment.
5. Copiez le contenu du certificat de signature dans le fichier signCertificate.cer.
6. Copiez le contenu du certificat de chiffrement dans le fichier encryptCertificate.cer.
7. Copiez le contenu du certificat de l'autorité de certification dans le fichier ca.cer.
8. Copiez ca.cer, signCertificate.cer et encryptCertificate.cer dans le répertoire
emplacement_c8\bin.
Ces fichiers doivent utiliser l'encodage Base-64, format X.509.
9. Importez le certificat de signature de l'étape 5 dans la bibliothèque de clés de signature de
Cognos en saisissant la commande suivante :
ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D ../configuration/signkeypair/jSign-
Keystore -p mot_de_passe -t ca.cer
ThirdPartyCertificateTool.bat-i -s -r signCertificate.cer -D ../configuration/signkeypair/jSign-
Keystore -p mot_de_passe -t ca.cer
210
Important : Vous devez saisir jSignKeystore comme nom de la bibliothèque de clés de signa-
ture. Veillez également à ce que le répertoire défini pour -D soit le même que celui indiqué
dans la propriété Emplacement de la bibliothèque de clés de signature, sous Sécurité, Crypto-
graphie, Cognos dans Cognos Configuration.
10. Importez le certificat de chiffrement de l'étape 6 dans la bibliothèque de clés de chiffrement de
Cognos en saisissant la commande suivante :
ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D ../configuration/encryptkey-
pair/jEncKeystore -p mot_de_passe -t ca.cer
ThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -D ../configuration/encryptkey-
pair/jEncKeystore -p mot_de_passe -t ca.cer
Important : Vous devez saisir jEncKeystore comme nom de la bibliothèque de clés de chiffre-
ment. Veillez également à ce que le répertoire défini pour -D soit le même que celui indiqué
dans la propriété Emplacement de la bibliothèque de clés de chiffrement, sous Sécurité, Cryp-
tographie, Cognos dans Cognos Configuration.
11. Importez le certificat de l'autorité de certification de l'étape 7 dans la bibliothèque d'approba-
tions de Cognos en saisissant la commande suivante:
ThirdPartyCertificateTool.sh -T -i -r ca.cer -D ../configuration/signkeypair/jCAKeystore -p
mot_de_passe
ThirdPartyCertificateTool.bat -T -i -r ca.cer -D ../configuration/signkeypair/jCAKeystore -p
mot_de_passe
Important : Vous devez saisir jCAKeystore comme nom de la bibliothèque de clés de l'autorité
de certification. Veillez également à ce que le répertoire défini pour -D soit le même que celui
indiqué dans la propriété Emplacement de la bibliothèque de clés de signature, sous Sécurité,
Cryptographie, Cognos dans Cognos Configuration.
Configuration des composants de Cognos 8 pour exécution dans une autorité

de certification tierce
Vous devez configurer chaque ordinateur Cognos pour qu'il utilise une autorité de certification
externe en définissant la propriété appropriée dans Cognos Configuration.
En définissant cette propriété, les composants de Cognos 8 partent de l'hypothèse que toutes les
clés requises ont été créées et testées par l'autorité de certification externe.
Assurez-vous que les emplacements de bibliothèque de clés et le mot de passe dans Cognos Confi-
guration correspondent à ceux saisis dans l'outil de ligne de commande tiers.
Procédure
Cognos.
3. Dans la fenêtre Propriétés, sous le groupe de propriétés Paramètres de l'autorité de certifica-
tion, cliquez sur la zone Valeur située à côté de la propriété Utiliser une autorité de certifica-
tion de tierce partie, puis cliquez sur Vrai.
Remarque : Lorsque vous définissez cette propriété sur Vrai, toutes les propriétés relatives à
l'autorité de certification et au nom d'identité sont ignorées.
4. Configurez les propriétés suivantes de façon à ce qu'elles correspondent à celles saisies dans
l'utilitaire de ligne de commande :
• Emplacement de la bibliothèque de clés de signature
• Mot de passe de la bibliothèque de clés de signature
• Emplacement de la bibliothèque de clés de chiffrement
• Mot de passe de la bibliothèque de clés de chiffrement

• Mot de passe de la bibliothèque de clés de l'autorité de certification

6. Pour démarrer le service Cognos 8, dans le menu Opérations, cliquez sur l'option Démarrer.
212
Chapitre 13 : Configuration des exemples
Vous pouvez utiliser les exemples Cognos pour apprendre à utiliser Cognos 8, notamment Fra-
mework Manager, Metric Studio, Metric Designer et Event Studio.
Cognos 8 fournit des exemples de bases de données contenant des informations sur les ventes, le
marketing et les finances d'une société fictive nommée Vacances et Aventure, qui vend du matériel
sportif.
Pour pouvoir utiliser les exemples de bases de données, Cognos 8 doit être installé, configuré et en
cours d'exécution. Pour les rapports et analyses de Cognos 8, Framework Manager peut égale-
ment être installé, configuré et en cours d'exécution. Pour utiliser l'exemple de contenu de Metric
Designer, l'outil de modélisation facultatif de Metric Studio, Metric Designer doit également être
installé, configuré et en cours d'exécution.
Pour configurer les exemples, procédez comme suit :
❑ Restaurez les exemples de bases de données.
❑ Créez des connexions à la source de données pour les exemples de bases de données relation-
nelles.
❑ Si vous prévoyez d'utiliser des exemples de sources de données OLAP, définissez les exemples
(cubes Microsoft Analysis Services et cubes DB2 uniquement) et créez les connexions aux
sources de données OLAP que vous souhaitez utiliser.
❑ Si vous envisagez d'utiliser l'exemple de Metric Studio, définissez l'exemple de Metric Studio.
❑ Si vous envisagez d'utiliser l'exemple de Metric Designer, restaurez la base de données
GOSLDW, définissez-lui une connexion à la source de données, définissez l'exemple de Metric
Studio et importez les archives de déploiement Cognos_Samples et GO_Metrics.
❑ Importez l'exemple de pack et les autres exemples de contenu dans Content Store.
❑ Si un utilisateur d'Event Studio souhaite tester l'exemple d'agent ELM Returns Agent, exécu-
tez l'exemple d'agent avec les données modifiées.
Une fois ces tâches effectuées, utilisez Cognos 8 pour exécuter les exemples de rapports ou de
tableaux de bord. Vous pourrez supprimer les exemples de Cognos 8 ultérieurement.
Restauration des fichiers de sauvegarde des exemples de

bases de données
Pour utiliser les exemples, vous devez restaurer les fichiers de sauvegarde des exemples de base de
données. Cette opération crée à nouveau des versions multilingues des bases de données Vacances
et Aventure.
L'exemple de bases de données ci-dessous et les fichiers associés sont fournis avec Cognos 8. Pour
SQL Server et Oracle, chaque base de données est fournie sous la forme d'un fichier de sauvegarde
de Microsoft SQL Server, d'un fichier d'exportation d'Oracle (.dmp). Pour DB2, les schémas de
bases de données sont fournis dans un fichier move de DB2. Le fichier move de DB2 est com-
pressé, vous devez le décompresser avant de restaurer les schémas dans les bases de données DB2.
Description de base de données ou Fichier SQL

de schéma Server Fichier Oracle Fichier DB2
Ventes de Vacances et Aventure gosl gosl.dmp go_db.tar.gz
Détaillants de Vacances et Aventure gort gort.dmp go_db.tar.gz

Description de base de données ou Fichier SQL

de schéma Server Fichier Oracle Fichier DB2
Entrepôt de données de Vacances et gosldw gosldw.dmp go_db.tar.gz
Aventure
Étude de marché de Vacances et gomr gomr.dmp go_db.tar.gz

Aventure
Ressources humaines de Vacances et gohr gohr.dmp go_db.tar.gz

Aventure
Important : Pour assurer le bon fonctionnement des exemples, vous devez attribuer les mêmes
noms aux bases de données restaurées et aux fichiers de sauvegarde ou d'exportation. Les noms
prennent en compte la distinction minuscules/majuscules.
Veillez à restaurer les exemples de bases de données à l'aide du jeu de caractères UTF-8.
Avant de restaurer les exemples de bases de données, assurez-vous de disposer de 50 Mo d'espace
disque disponible dans l'emplacement cible.
Observations concernant SQL Server

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

Avant de restaurer les schémas de Vacances et Aventure contenus dans le fichier move de DB2 sous
Unix ou Windows, procédez à sa décompression. Sous Unix, procédez à la décompression du
fichier move de DB2 à l'aide de la commande gnutar -xcvf DB2_move_filename ou tar -xcvf
DB2_move_filename. Si vous utilisez WinZip pour extraire le fichier move de DB2 sous Windows,
veillez à désactiver l'option TAR file smart CR/LF conversion.
À l'issue de la décompression du fichier move de DB2, restaurez les schémas vers une base de don-
nées nommée GO_DB. Lorsque vous créez cette base de données dans DB2, créez un groupe de
mémoire tampon de 16 Ko et un espace de table associé.
Pour restaurer les schémas dans la base de données GO_DB, vous devez modifier le fichier
go_db_modify.sql et entrer un nom d'utilisateur et un mot de passe dans le fichier. Vous devez éga-
lement exécuter le fichier go_db_modify.bat pour créer les vues dans la base de données GO_DB.
Procédure
1. Sur l'ordinateur où Cognos 8 est installé, ouvrez le répertoire sqlserver, oracle ou db2 qui se
trouve dans emplacement_c8/webcontent/samples/datasources/db.
2. Au besoin, copiez les fichiers de sauvegarde des exemples de bases de données vers le réper-
toire de sauvegarde de base de données.
Pour garantir la sécurité et l'intégrité de Cognos 8, copiez les fichiers dans le répertoire pro-
tégé contre tout accès non autorisé ou inapproprié.
3. Restaurez les exemples de bases de données à l'aide de votre outil de gestion de base de don-
nées.
Conseil :Pour les fichiers de sauvegarde SQL, restaurez la base de données à partir d'un péri-
phérique et assurez-vous que les emplacements de restauration sont adéquats pour les fichiers
de base de données .ldf et .mdf. Pour en savoir davantage, reportez-vous à la documentation
de Microsoft SQL Server ou à la base de connaissances de Cognos (http://sup-
port.cognos.com/kb-app/knowledgebase).
4. Pour chaque base de données, créez au moins un utilisateur disposant de droits de sélection
sur toutes les tables des bases de données restaurées.
Vous pouvez à présent créer les connexions à la source de données dans le portail.
214
Création de connexions entre la source de données et les

exemples de bases de données relationnelles
Vous devez créer des connexions à la source de données pour les exemples de bases de données
restaurés. Cognos 8 utilise ces informations pour se connecter aux exemples de bases de données
et exécuter les exemples de rapports ou utiliser l'exemple de pack.
Le nom de la base de données DB2 que vous saisissez doit être en majuscules. En outre, dans Fra-
mework Manager, les noms de schémas que vous saisissez pour les sources de données DB2 doi-
vent être en majuscules.
Avant de créer les connexions à la source de données, vous devez restaurer les fichiers de sauve-
garde pour les exemples de bases de données. Assurez-vous également que le service Cognos 8 est
en cours d'exécution.
Pour créer des sources de données, vous devez disposer des droits d'exécution sur la fonctionnalité
protégée Annuaire et des droits de passage sur la fonction protégée Administration.
Procédure
2. Dans la barre d'outils, cliquez sur Outils, puis sur Annuaire.
3. Cliquez sur l'onglet Sources de données.
4. Chaque sur le bouton Nouvelle source de données.
5. Dans la zone Nom, saisissez VentesVA, puis cliquez sur le bouton Suivant.
6. Dans la page de connexion, cliquez sur le type de la base de données restaurée et à laquelle
vous souhaitez vous connecter, sélectionnez un niveau d'isolement, puis cliquez sur le bouton
Suivant.
La page de chaîne de connexion relative à la base de données sélectionnée s'affiche.
7. Effectuez l'une des tâches suivantes :
• Si vous avez restauré les exemples de bases de données dans SQL Server, dans la zone
Nom du serveur, saisissez le nom du serveur où se trouvent les bases restaurées. Dans la
zone Nom de la base de données, saisissez GOSL.
Les exemples de Cognos 8 requièrent une connectivité TCP/IP avec le serveur SQL. Veillez
à ce que la sécurité SQL Server soit définie sur SQL Server et Windows, et non sur Win-
dows uniquement. Pour l'authentification, les exemples font appel à la sécurité SQL Ser-
ver.
• Si vous avez restauré les exemples de bases de données dans Oracle, dans la zone Chaîne
de connexion SQL*Net, saisissez la chaîne de connexion Oracle.
• Si vous avez restauré les exemples de base de données dans DB2, dans la zone Nom de
base de données DB2, saisissez GO_DB. Dans la zone Chaîne de connexion DB2, saisis-
sez la chaîne de connexion DB2.
8. Dans la section Codes d'accès, cochez les cases Mot de passe et Créer un code d'accès 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 données, puis cliquez sur Terminer.
Conseil : Pour tester si les paramètres sont corrects, cliquez sur le bouton Test.
10. Répétez les tâches 4 à 9 pour les exemples de bases de données gosldw.
• Pour la base de données gosldw dans SQL Server et Oracle, saisissez
entrepôt_données_VA comme nom de source de données et gosldw comme nom de base
de données. Pour DB2, saisissez entrepôt_données_VA comme nom de source de données
et GO_DB comme nom de base de données.
Les connexions à la source de données Vacances et Aventure s'affichent sous la forme d'entrées
dans l'onglet Sources de données de l'outil Annuaire.
Vous pouvez à présent importer les exemples, à moins qu'il n'y ait un paramètre incorrect ou une
erreur de syntaxe dans la chaîne de connexion.

Configuration des exemples de cubes de Microsoft Analysis

Services
Deux exemples de cubes Microsoft Analysis Services sont fournis, que vous pouvez utiliser dans
Cognos Connection ou dans Framework Manager. Les exemples de cubes se trouvent dans un
fichier d'archive appelé GOSLDW.cab, dans le répertoire emplacement_c8/webcontent/sam-
ples/datasources/cubes/MSAS. Le fichier d'archive doit être restauré dans une base de données
Microsoft SQL Server exécutant Microsoft Analysis Services.
Le cube Société Vacances et aventure et la base de données GOSLDW contiennent les mêmes don-
nées de ventes mensuelles. Le cube Vacances et aventure - Finance contient les données financières
de l'année en cours relatives au résultat et au bilan, qui vous permettent de créer des modèles
d'état financier dans Analysis Studio, Query Studio et Report Studio.
Remarque : Le cube Vacances et aventure - Finance contient des valeurs réelles utilisant des sou-
missions exprimées en dollars US pour 2004, 2005 ou 2006. Ces données ne sont disponibles
qu'en anglais.
Procédure
1. Sur l'ordinateur sur lequel Cognos 8 est installé, accédez au répertoire emplacement_c8/web-
content/samples/datasources/cubes/MSAS/en.
2. Copiez le fichier GOSLDW.cab dans un répertoire auquel vous pouvez accéder à partir de la
console Analysis Manager de Microsoft SQL Server ou Analysis Servers.
3. Utilisez Analysis Manager pour restaurer la base de données à partir du fichier GOSLDW.cab.
Vous pouvez maintenant créer les connexions aux sources de données à l'aide du cube Société
Vacances et aventure ou du cube Vacances et aventure - Finance.
Configuration de l'exemple de cube DB2

Pour configurer l'exemple de cube DB2, Hyperion Essbase doit être installé, ainsi qu'un serveur
OLAP DB2 doté de la console des services d'intégration et d'analyse Essbase.
Procédure
1. À l'aide de la console des services d'intégration Essbase, effectuez le chargement d'un membre
et un chargement de données Outline.
2. En utilisant la base de données GOSLDW_ML comme cube, importez le modèle
GOSLDW_EN_FR_DE_JA.xml et le profil de métadonnées GOSLDW_langue.xml correspon-
dant à la langue à utiliser, où langue peut être EN (anglais), DE (allemand), FR (français) ou
JA (japonais).
Vous trouverez des informations sur les cubes dans le fichier de détails du cube pour chaque
langue : DB2OLAPGOSLDWlangueCubeInfo.xml.
3. À l'aide de la console d'administration Hyperion Solutions Essbase Administration, configu-
rez les créations du modèle et remplissez le cube.
Vous pouvez à présent créer une connexion à la source de données avec le cube.
Création de connexions à la source de données vers des

sources de données OLAP
Cognos 8 fournit les exemples OLAP suivants :
• Cubes Microsoft Analysis Services de la société Vacances et Aventure et Vacances et Aventure
Finance
• Cube Cognos de la société Vacances et Aventure et VA_Finance
• Cube DB2 Vacances et Aventure
216
Vous devez créer des connexions à la source de données pour les cubes avant d'utiliser les exem-
ples. Vous devez configurer l'exemple de cube Microsoft Analysis Services ou configurer l'exemple
de cube DB2, si vous les utilisez, avant de créer les connexions à la source de données.
Pour créer des sources de données, vous devez disposer des droits d'exécution sur la fonctionnalité
protégée Annuaire et des droits de passage sur la fonction protégée Administration.
Procédure pour les cubes

4. Cliquez sur le bouton Nouvelle source de données.
5. Dans la zone Nom, saisissez l'un des noms suivants, puis cliquez sur le bouton Suivant.
• Pour créer une connexion à la source de données pour le cube de la Société Vacances et
Aventure, saisissez vacances_et_aventure.
• Pour créer une connexion à la source de données pour le cube Cognos Finance, saisissez
va_finance.
Vous pouvez définir un chemin d'accès Windows ou UNIX. Si vous définissez un chemin
d'accès UNIX et que vous envisagez d'utiliser Framework Manager, vous devez également
définir le chemin d'accès Windows et vérifier que le cube est disponible dans l'emplacement
Windows. Framework Manager ne peut accéder qu'à des cubes qui se trouvent dans des
emplacements Windows.
6. Dans la page de connexion, sous Type, cliquez sur Cube Cognos, sélectionnez un niveau d'iso-
lement, puis cliquez sur Suivant.
7. Dans la zone Taille de l'antémémoire lue (Mo), saisissez la taille de l'antémémoire du cube en
méga-octets.
Si vous laissez ce champ vide ou saisissez 0, Cognos Connection utilise la valeur par défaut
dans le fichier ppds_cfg.xml du dossier de configuration.
8. Dans la zone Emplacement sous Windows, tapez l'emplacement et le nom du fichier
vacances_et_aventure.mdc ou du fichier va_finance.mdc pour la connexion à la source de
données. Par exemple, saisissez emplacement_c8/webcontent/samples/datasour-
ces/cubes/PowerCubes/Fr/vacances_et_aventure.mdc.
9. Pour tester si les paramètres sont corrects, cliquez sur le bouton Test.
Vous pouvez à présent importer l'exemple de pack pour le cube afin d'utiliser cette source de don-
nées.
Procédure pour un cube DB2

1. Ouvrez Framework Manager.
2. Cliquez sur Create a new project.
3. Dans la page New project, indiquez le nom et l'emplacement du projet.
4. Dans la page Select Language, cliquez sur la langue de conception du projet.
L'Assistant de d'importation s'affiche.
6. Dans la page de connexion, sous type, cliquez sur IBM DB2 OLAP Server, sélectionnez un
niveau d'isolement, puis cliquez sur Next.
7. Dans la zone Server name, saisissez le nom du serveur.
8. Pour tester si les paramètres sont corrects, cliquez sur le bouton Test.
Pour pouvoir utiliser cette source de données, vous devez créer, puis publier un pack à l'aide de
cette source de données dans Framework Manager.

Procédure pour les cubes Microsoft Analysis Service

4. Cliquez sur le bouton Nouvelle source de données.
5. Dans la zone Nom, saisissez vacances_et_aventure ou vacances_et_aventure_finance, puis cli-
quez sur le bouton Suivant.
6. Dans la page de connexion, cliquez sur le type de la base de données Microsoft SQL Server
restaurée et à laquelle vous souhaitez vous connecter, sélectionnez un niveau d'isolement, puis
cliquez sur le bouton Suivant.
7. Dans la zone Nom du serveur, saisissez le nom du serveur sur lequel se trouvent les bases de
données restaurées. Si nécessaire, saisissez le nom de la base de données que vous avez restau-
rée dans la zone Nom de la base de données.
8. Dans la section Codes d'accès, cochez les cases Mot de passe et Créer un code d'accès 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 données, puis cliquez sur Terminer.
Conseil : Pour tester si les paramètres sont corrects, cliquez sur le bouton Test.
Pour pouvoir utiliser cette source de données, vous devez créer, puis publier un pack à l'aide de
cette source de données dans Framework Manager.
Configuration de l'exemple de Metric Studio

Pour configurer l'exemple de Metric Studio, procédez comme suit :
❑ Créez une bibliothèque d'indicateurs appelée GOMETRICS.
Pour en savoir davantage sur la création d'une bibliothèque d'indicateurs, reportez-vous au
Guide d'installation et de configuration de Cognos 8.
❑ Créez un pack d'indicateurs appelé GO Metrics qui utilise la bibliothèque d'indicateurs
GOMETRICS.
Lorsque l'assistant vous y invite, sélectionnez le calendrier grégorien standard et acceptez les
valeurs implicites pour les années, les trimestres et les mois. Définissez le 1er janvier 2004 en
tant que date de début pour une période de 3 ans.
Pour en savoir davantage sur la création des packs d'indicateurs, reportez-vous au Guide
d'administration et de sécurité de Cognos 8.
❑ Importez les données et les fichiers relatifs aux indicateurs dans la bibliothèque d'indicateurs.
Procédure d'importation des données et des fichiers d'indicateurs dans la bibliothèque

d'indicateurs.
1. Copiez tous les fichiers texte du répertoire emplacement_c8/webcontent/samples/datasour-
ces/metricdata/emplacement_langue dans emplacement_c8/deployment/cmm.
2. Indiquez les sources et les codes d'assemblage des différentes langues dans Metric Studio.
3. Dans la liste Outils de Metric Studio, cliquez sur Sources d'importation.
4. Cliquez sur Nouvelle.
5. Dans la zone Nom, saisissez un nom descriptif pour la source de données.
6. Cliquez sur Répertoire d'importation des indicateurs.
7. Indiquez l'emplacement des fichiers délimités par des tabulations. Vous pouvez utiliser le nom
et le chemin d'accès complets ou des caractères génériques.
Conseil : Cliquez sur le bouton à côté du nom d'un dossier existant ou sélectionnez le bouton
en regard de Nouveau répertoire, puis saisissez le nom du répertoire ou du fichier.
8. Si le dossier inclut des sous-dossiers, cliquez sur Inclure les sous-répertoires.
9. Dans la zone Format de fichier, cliquez sur 8.1.2 MR2.
218
10. Dans la zone Encodage du jeu de caractères, spécifiez le jeu de caractères ou cliquez sur Autre
et tapez le jeu de caractères correspondant à la langue que vous importez.
12. Importez les fichiers dans la bibliothèque d'indicateurs à l'aide de Cognos Connection ou de
Metric Studio, au choix.
• Avec Cognos Connection, dans Dossiers publics ou Mes dossiers, ouvrez le pack GO
Metrics en cliquant sur l'icône d'affichage du contenu du pack d'indicateurs dans la
colonne Opérations. Cliquez sur Mise à jour des indicateurs.
• Avec Metric Studio, dans la liste Outils, cliquez sur Mise à jour des indicateurs.
13. Cliquez sur la tâche reliée aux indicateurs Importer et transférer les données des fichiers dans
la bibliothèque d'indicateurs.
Vous pouvez à présent utiliser l'application GO Metrics dans Metric Studio.
Sources pour différentes langues

L'emplacement des dossiers de langues et des codes d'assemblage associés pour différentes sources
de données est indiqué ci-dessous.
Nom du
Langue dossier Description
Chinois zh-hans Page de codes DB2 : 1381 ou 1383
(simplifié)
Nom du jeu de caractères Oracle : ZHS16CGB231280
Indicateur d'assemblage SQL Server 2K :
Chinese_PRC_CI_AS
Chinois zh-hant Page de codes DB2 : 950

(traditionnel) Nom du jeu de caractères Oracle : ZHT16MSWIN950
Chinese_Taiwan_Stroke_CI_AS
Hollandais nl Page de codes DB2 : 1252 ou 819

Nom du jeu de caractères Oracle : WE8ISO8859P1
Latin1_General_CI_AS
Anglais en Page de codes DB2 : 1252 ou 819

Latin_General_CI_AS
Finnois fi Page de codes DB2 : 1252 ou 819

Finnish_Swedish_CI_AS
Français fr Page de codes DB2 : 1252 ou 819

Indicateur d'assemblage SQL Server 2K : French_CI_AS

Nom du
Langue dossier Description
Allemand de Page de codes DB2 : 1252 ou 819
Italien it Page de codes DB2 : 1252 ou 819

Japonais ja Page de codes DB2 : 943 ou 932

Nom du jeu de caractères Oracle : JA16SJIS
Japanese_CI_AS
Coréen ko Page de codes DB2 : 1363 ou 970

Nom du jeu de caractères Oracle : KO16KSC5601
Korean_Wansung_CI_AS
Portugais pt Page de codes DB2 : 1252 ou 819

Espagnol es Page de codes DB2 : 1252 ou 819

Modern_Spanish_CI_AS
Suédois sv Page de codes DB2 : 1252 ou 819

Finnish_Swedish_CI_AS
Importation des exemples

Pour utiliser l'exemple de pack et d'autres contenus, vous devez les importer à partir de l'exemple
d'archive de déploiement, à l'aide de l'outil de déploiement.
Avant d'importer les archives de déploiement Cognos_Samples.zip et GO_Metrics.zip, vous devez
restaurer les bases de données. Pour chaque base de données, vous devez créer au moins un utilisa-
teur nommé disposant de droits de sélection sur les tables de base de données. Vous devez égale-
ment créer des connexions à la source de données pour les exemples de bases de données.
Avant d'importer l'archive de déploiement Cognos_PowerCube.zip ou
Cognos_PowerCube_Financial.zip, vous devez connecter la base de données au cube approprié et
sélectionner la langue que vous souhaitez utiliser. La langue choisie doit être prise en charge par
vos paramètres régionaux.
Pour en savoir davantage sur les paramètres régionaux, reportez-vous au Guide d'installation et
de configuration de Cognos 8.
220
Pour utiliser l'outil Administration du contenu, vous devez disposer des droits de passage sur la
fonction protégée Administration et de droits d'exécution sur la fonction Administration du con-
tenu.
Procédure
1. Copiez le fichier compressé du répertoire emplacement_c8/webcontent/samples/content vers le
répertoire où sont enregistrées les archives de déploiement.
L'emplacement implicite est emplacement_c8/deployment. L'emplacement est défini 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.
3. Dans le coin supérieur droit de l'écran, cliquez sur Outils, puis sur Administration du contenu.
4. Dans la barre d'outils, cliquez sur le bouton Nouvelle importation.
L'Assistant Nouvelle importation s'affiche.
5. Dans la barre d'outils, cliquez sur le bouton Nouvelle importation.
L'Assistant Nouvelle importation s'affiche.
6. Dans la zone Archive de déploiement, sélectionnez Cognos_Samples, Cognos_PowerCubes,
GO_Metrics ou GO_Events.
7. Cliquez sur le bouton Suivant.
8. Saisissez un nom unique ainsi qu'une infobulle et une description facultatives pour l'archive
de déploiement, sélectionnez le dossier où vous souhaitez l'enregistrer, puis cliquez sur le bou-
ton Suivant.
9. Dans la zone Contenu des dossiers publics, sélectionnez les packs et les dossiers que vous sou-
haitez importer.
L'archive de déploiement Cognos_Samples contient les packs et les dossiers suivants :
• GO Data Warehouse, GO Sales and Retailers, GO Sales et Query Studio Templates
L'archive de déploiement Cognos_PowerCube pour la société Vacances et Aventure contient
des packs et des dossiers pour les langues suivantes :
• Anglais
• Français
• Allemand
• Japonais
L'archive de déploiement GO_Metrics contient les packs et les dossiers suivants :
• GO Metrics
L'archive de déploiement GO_Events contient les packs et les dossiers suivants :
• GO Events
10. Sélectionnez les options souhaitées, ainsi que les règles de résolution des conflits choisies pour
les options sélectionnées, puis cliquez sur Suivant.
11. Dans la page Définition des options générales, indiquez s'il convient d'inclure des droits
d'accès et des références à des espaces-noms externes et qui doit être propriétaire des entrées
après leur importation.
12. Cliquez sur le bouton Suivant.
Les informations récapitulatives s'affichent.
13. Examinez les informations récapitulatives et cliquez sur Suivant.
14. Sélectionnez une action :
• Pour procéder à une exécution unique immédiatement ou ultérieurement, cliquez sur
Enregistrer et exécuter une fois . Cliquez sur Terminer, indiquez la date et l'heure de l'exé-
cution et cliquez sur Exécuter. Vérifiez l'heure d'exécution et cliquez sur OK.
• Pour programmer une exécution à intervalles réguliers, cliquez sur Programmer l'exécu-
tion pour qu'elle se répète de façon régulière. Cliquez sur Terminer et sélectionnez ensuite
la fréquence, ainsi que les dates de début et de fin. Cliquez sur le bouton OK.
Conseil : Pour désactiver temporairement le calendrier, cochez la case Désactiver le calen-
drier de production.

• Pour enregistrer sans programmation ni exécution, 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 créer des rapports et des analyses
dans Report Studio, Query Studio et Analysis Studio, consulter des extractions dans Metric Desi-
gner ou créer des agents dans Event Studio. Vous pouvez également exécuter les exemples de rap-
ports disponibles dans l'onglet Dossiers publics du portail.
Exemples de modèles de bases de données

Les exemples de modèles ci-dessous fournissent des informations pour la société fictive Vacances
et Aventure et sont fournis avec Cognos 8 :
• gosales_goretailers, qui fait référence aux exemples de bases de données gosl
• go_data_warehouse, qui fait référence à la base de données gosldw
• go_sales, qui fait référence aux exemples de bases de données gosl et gort
• gosales_scriptplayer, qui fait référence aux exemples de bases de données gosl et gort
• go_events, qui fait référence aux exemples de bases de données gosl et gort
Vous pouvez utiliser des modèles d'exemples de bases de données sur différentes plates-formes.
Pour en savoir davantage sur le déplacement des modèles d'une plate-forme vers une autre, repor-
tez-vous au manuel Framework Manager User Guide.
Modèle GO Sales et Retailers

Ce modèle contient des informations sur les détaillants et l'analyse des ventes de la société fictive
Vacances et Aventure. Il accède à deux schémas.
Modèle GO Data Warehouse

Ce modèle contient des informations sur les finances et les ressources humaines de la société fictive
Vacances et Aventure. Ce modèle accède à une source de données relationnelle dimensionnelle.
Modèle GO Sales
Ce modèle contient des informations sur l'analyse des ventes de la société fictive Vacances et Aven-
ture. Ce modèle accède à une source de données relationnelle dimensionnelle.
GO Sales Scriptplayer
Ces fichiers peuvent servir à exécuter séquentiellement les journaux des opérations. Cette opéra-
tion crée un modèle nommé gosales_scriptplayer et publie un pack à destination de la base de don-
Modèle Go Events
Ce modèle contient des informations sur l'analyse des ventes de la société fictive Vacances et Aven-
ture. Ce modèle accède à une source de données relationnelle dimensionnelle.
Exemple - Exécution de l'exemple d'agent ELM Returns

Agent avec des données modifiées
Vous pouvez modifier des données dans la base de données GOSL si un utilisateur d'Event Studio
souhaite tester l'exemple d'agent ELM Returns Agent. L'utilisateur d'Event Studio peut exécuter
l'exemple d'agent deux fois et détecter un nouvel événement. Pour en savoir davantage, repor-
tez-vous au Guide de l'utilisateur d'Event Studio.
L'exécution de l'exemple d'agent avec des données modifiées s'effectue de la façon suivante :
❑ L'utilisateur d'Event Studio exécute l'exemple d'agent sur les données implicites et vous
demande ensuite de modifier les données.
222
❑ Vous simulez certains éléments déclencheurs d'événements initiaux, puis vous demandez à
l'utilisateur d'Event Studio d'exécuter l'exemple d'agent une seconde fois.
❑ L'utilisateur d'Event Studio exécute l'exemple d'agent sur les données modifiées et vous pré-
vient lorsque c'est terminé.
❑ Vous simulez le passage du temps et la résolution de certains événements, puis vous demandez
à l'utilisateur d'Event Studio d'exécuter l'exemple d'agent une troisième fois.
❑ L'utilisateur d'Event Studio exécute l'exemple d'agent pour la dernière fois et vous prévient
lorsque c'est terminé.
❑ Vous modifiez les données afin que l'agent ELM Returns Agent ne détecte pas d'événements.
Exemple - Simulation de l'élément déclencheur d'événements initiaux

Exécutez une partie du script Event_Studio_ELM_Agent_Modify_GOSL.sql pour simuler les
modifications de données suivantes :
• remplacement de la date par la date du jour
• remplacement du code de suivi par -1 dans quate enregistrements.
Le code -1 indique que le suivi est obligatoire.
Procédure
1. Dans SQL Query Analyzer, ouvrez le menu Fichier et cliquez sur Ouvrir.
2. Accédez à emplacement_c8/webcontent/samples/datasources/sqlserver et cliquez deux fois sur
le fichier Event_Studio_ELM_Agent_Modify_GOSL.sql.
3. Dans la barre d'outils, cliquez sur GOSL dans la liste des bases de données.
4. Dans la fenêtre Requête, sous Part 1, sélectionnez les seize lignes de code.
5. Dans le menu Requête, cliquez sur Exécuter.
Les modifications sont enregistrées dans la base de données.
Exemple - Simulation du passage du temps et de la résolution de certains

événements
Exécutez une partie du script Event_Studio_ELM_Agent_Modify_GOSL.sql pour simuler des
modifications de données. Pour commencer, modifiez-le afin que deux jours se soient écoulés
depuis la dernière exécution de l'exemple d'agent ELM Returns Agent. Ensuite, pour trois des
quatre instances d'événements trouvés la dernière fois que l'exemple d'agent ELM Returns Agent
a été exécuté, remplacez le code de suivi -1 par +1. Ce code indique qu'une seule de ces instances
d'événements nécessite encore un suivi et que les autres instances sont résolues.
Procédure
1. Dans SQL Query Analyzer, ouvrez le menu Fichier et cliquez sur Ouvrir.
2. Accédez à emplacement_c8/webcontent/samples/datasources/sqlserver et cliquez deux fois sur
le fichier Event_Studio_ELM_Agent_Modify_GOSL.sql.
3. Dans la barre d'outils, cliquez sur GOSL dans la liste des bases de données.
4. Dans la fenêtre Requête, sous Part 2, sélectionnez toutes les lignes de code qui apparaissent
après les commentaires.
5. Dans le menu Requête, cliquez sur Exécuter.
Les modifications sont enregistrées dans la base de données.
Exemple - Modification des données afin que l'agent ELM Returns Agent ne
détecte pas d'événements
Lorsque l'utilisateur Event Studio finit d'exécuter l'exemple d'agent ELM Returns Agent avec les
données modifiées, vous devez recevoir une notification. Vous pouvez ensuite modifier la base de
données GOSL afin que l'agent ne détecte plus aucune instance d'événement.

Procédure
• Exécutez les commandes sql suivantes :
UPDATE GOSL.RETURNED_ITEM SET FOLLOW_UP_CODE = 0
UPDATE GOSL.RETURNED_ITEM SET ASSIGNED_TO = 0
UPDATE GOSL.RETURNED_ITEM SET DATE_ADVISED = NULL
Les données sont modifiées. L'exemple d'agent ELM Returns Agent est prêt à être utilisé par un
autre utilisateur Event Studio.
Suppression des exemples de bases de données de Cognos 8

Vous pouvez supprimer les packs sur lesquels reposent les exemples quand vous n'avez plus besoin
des exemples de rapports pour apprendre à utiliser Cognos 8 et notamment son composant Fra-
mework Manager. Cette opération supprime définitivement les exemples du Content Store.
Procédure
2. Cliquez sur l'onglet Dossiers publics.
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 réutiliser les exemples, vous devez configurer ces exemples.
224
Chapitre 14 : Exécution d'une installation et d'une
configuration sans surveillance
Exécutez une installation et une configuration sans surveillance pour :

• installer une configuration identique sur plusieurs ordinateurs du réseau,
• automatiser le processus d'installation et de configuration en définissant des options et des
paramètres pour les utilisateurs.
Avant de préparer une installation et une configuration sans surveillance, assurez-vous que la con-
figuration système requise est entièrement respectée et que tous les produits tiers nécessaires sont
dûment installés et configurés.
Pour exécuter une installation et une configuration sans surveillance :
❑ configurez un fichier de spécification de transfert (.ats) contenant les options d'installation,
❑ exécutez l'outil d'installation en mode silencieux,
❑ utilisez un fichier de configuration préconfiguré provenant d'un autre ordinateur,
❑ exécutez l'outil de configuration en mode silencieux.
Une fois ces tâches accomplies, vérifiez que le répertoire d'installation de Cognos 8 sur tous les
ordinateurs est protégé contre tout accès non autorisé ou inapproprié. Vous serez alors prêt à uti-
liser Cognos 8.
Exécution d'une installation sans surveillance

Utilisez un fichier de spécification de transfert (.ats) pour copier les composants de Cognos 8 (y
compris Framework Manager ou Metrics Designer) sur votre ordinateur sans que le système ne
vous demande de saisir des informations.
Par défaut, chaque fois que vous installez des composants de Cognos 8 à l'aide de l'Assistant d'ins-
tallation, les options que vous sélectionnez sont enregistrées dans un fichier de spécification de
transfert. C'est pourquoi, si vous avez déjà installé des composants de Cognos 8 sur un ordinateur,
vous pouvez utiliser le fichier de spécification de transfert créé par l'installation comme modèle
pour des installations sans surveillance sur d'autres ordinateurs.
Si vous n'utilisez pas l'Assistant d'installation pour installer des composants, vous pouvez utiliser
le fichier de spécification de transfert implicite nommé response.ats, disponible sur le CD. Vous
devez modifier le fichier response.ats en fonction de votre environnement avant de l'utiliser pour
une installation sans surveillance.
Pour contrôler le bon déroulement de l'installation sans surveillance, vérifiez l'état renvoyé. Une
valeur nulle (0) indique que l'installation s'est effectuée correctement. Toute autre valeur indique
qu'une erreur s'est produite.
Procédure d'utilisation d'un fichier créé par une installation précédente

1. Utilisez l'Assistant d'installation pour installer les composants de Cognos 8 sur votre ordina-
teur.
2. Ouvrez le répertoire emplacement_c8/instlog.
3. Localisez le fichier de spécification de transfert (.ats) créé :
• Si vous avez installé Framework Manager, le nom de fichier est ts-FRAMEWORK
MANAGER-version-aaaammjj_hhmm.ats.
• Si vous avez installé Cognos 8 pour la création de rapports, le nom de fichier est
ts-produit_cognos-version-aaaammjj_hhmm.ats.

Chapitre 14 : Exécution d'une installation et d'une configuration sans surveillance
• Si vous avez installé Metric Studio, le nom de fichier est ts-CMM-ver-

sion-aaaammjj_hhmm.ats.
• Si vous avez installé Metric Designer, le nom de fichier est ts-CMD-ver-
sion-yyyymmdd_hhmm.ats.
4. Copiez le fichier de spécification de transfert sur l'ordinateur où vous prévoyez d'installer
Cognos 8.
5. Sur l'ordinateur où vous prévoyez d'installer le logiciel, insérez le CD approprié dans le lec-
teur et copiez son contenu sur le disque dur.
• Sous Windows, ouvrez une fenêtre Invite de commandes, pointez sur le répertoire win32
dans lequel vous avez copié le contenu du CD, puis saisissez la commande suivante, dans
laquelle emplacement est le répertoire dans lequel vous avez copié nom_fichier, le fichier
de spécification de transfert :
issetup -s location/filename.ats
• Sous UNIX ou Linux, pointez sur le répertoire dans lequel vous avez copié le contenu du
CD, puis saisissez la commande suivante dans le répertoire de votre système d'exploita-
tion, dans laquelle emplacement est le répertoire dans lequel vous avez copié nom_fichier,
le fichier de spécification de transfert :
Avec XWindows, saisissez
issetup -s location/filename.ats
Sans XWindows, saisissez
issetupcc -s location/filename.ats
Si l'état renvoyé est différent de zéro (0), vérifiez les messages d'erreur des fichiers de journalisa-
tion. Les erreurs sont consignées dans le fichier suivant, situé dans le répertoire d'installation :
• Pour Framework Manager, le nom de fichier est tl-FM-version-aaaam-
mjj-hhmm_summary-error.txt.
• Pour les composants du serveur d'exécution de rapports de Cognos 8, le nom de fichier est
tl-produit_Cognos-version-aaaammjj-hhmm_summary-error.txt.
• Pour les composants de Metric Studio, le nom de fichier est tl-CMM-version-aaaam-
• Pour Metric Designer, le nom de fichier est tl-CMD-version-aaaam-
Si des erreurs se produisent avant que l'initialisation soit suffisamment avancée, des messages de
journalisation sont acheminés vers l'un des fichiers journaux suivants dans le répertoire Temp :
• Pour Framework Manager, le nom de fichier est tl-FM-version-aaaammjj-hhmm.txt.
• Pour les composants d'exécution de rapports de Cognos 8, le nom de fichier est
tl-produit_Cognos-version-aaaammjj-hhmm.txt.
Veillez également à ce que le répertoire d'installation soit protégé contre tout accès non autorisé
ou inapproprié.
Lorsque toutes les erreurs sont résolues, vous pouvez procéder à une configuration sans sur-
veillance.
Procédure d'utilisation du fichier response.ats

1. Sur l'ordinateur cible, insérez le CD dans le lecteur et copiez-en le contenu sur le disque dur.
2. Ouvrez le répertoire win32, puis ouvrez le fichier response.ats dans un éditeur de texte.
Chaque section du fichier response.ats correspond à une boîte de dialogue de l'Assistant d'ins-
tallation.
3. Indiquez l'emplacement d'installation des fichiers programmes de Cognos 8 dans
APPDIR=emplacement.
226
Conseil : Il ne doit y avoir aucun espace de part et d'autre du signe égal (=).
4. Pour les composants de serveur de Cognos 8, dans la section nommée [Component List], en
regard de chaque composant :
• pour installer le composant, saisissez 1,
• pour ne pas installer le composant, saisissez 0.
Remarque : Vous ne sélectionnez pas de composants pour Framework Manager, ni pour
Metric Designer. Tous les fichiers requis sont installés.
5. Dans le cas d'une installation Windows, pour la propriété APPFOLDER=, saisissez le nom du
dossier du menu Démarrer qui contient les raccourcis de vos programmes.
Conseil : Afin de vous assurer que le dossier des raccourcis est visible pour tous les utilisa-
teurs, saisissez 1 pour la propriété 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. Après avoir apporté les changements nécessaires au fichier response.ats, enregistrez-le dans un
répertoire local.
8. Ouvrez le répertoire win32.
9. À l'invite de commande, saisissez la commande suivante, où emplacement correspond au
répertoire 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 différent de zéro (0), vérifiez les messages d'erreur des fichiers de journalisa-
tion. Les erreurs sont consignées dans le fichier suivant, situé dans le répertoire d'installation :
• Pour Framework Manager, le nom de fichier est tl-FM-version-aaaam-
• Pour les composants du serveur d'exécution de rapports de Cognos 8, le nom de fichier est
tl-produit_Cognos-version-aaaammjj-hhmm_summary-error.txt.
Si des erreurs se produisent avant que l'initialisation soit suffisamment avancée, des messages de
journalisation sont acheminés vers l'un des fichiers journaux suivants dans le répertoire Temp :
• Pour Framework Manager, le nom de fichier est tl-FM-version-aaaammjj-hhmm.txt.
• Pour les composants d'exécution de rapports de Cognos 8, le nom de fichier est
tl-produit_Cognos-version-aaaammjj-hhmm.txt.
Veillez également à ce que le répertoire d'installation soit protégé contre tout accès non autorisé
ou inapproprié.
Une fois toutes les erreurs résolues, vous pouvez exécuter une configuration sans surveillance.
Exécution d'une configuration sans surveillance

Avant d'exécuter une configuration sans surveillance, vous devez exporter une configuration à
partir d'un autre ordinateur, sur lequel sont installés les mêmes composants de Cognos 8. Vous
pouvez ensuite exécuter Cognos Configuration en mode silencieux.

La configuration exportée contient les propriétés des composants de Cognos 8 que vous avez ins-
tallés sur l'ordinateur source. Si vous avez modifié la configuration globale, vous devez également
copier le fichier de configuration globale de l'ordinateur source sur l'ordinateur sur lequel vous
prévoyez d'exécuter une configuration sans surveillance. La configuration globale comporte des
paramètres tels que les paramètres régionaux du contenu, la langue du produit et les paramètres
de monnaies, polices et cookies (témoins). Pour en savoir davantage, reportez-vous à la section
« Modification des paramètres globaux » (p. 131).
Assurez-vous que les paramètres de configuration de l'ordinateur local sont appropriés pour con-
figurer un autre ordinateur Cognos 8 sur lequel les mêmes composants sont installés. Par exemple,
si vous avez remplacé la portion de nom d'hôte, local host, de la propriété URI de la passerelle par
une adresse IP ou un nom d'ordinateur, assurez-vous que ce paramètre convient pour la configura-
tion du nouvel ordinateur.
Pour contrôler le bon déroulement de la configuration sans surveillance, vérifiez l'état renvoyé.
Une valeur nulle (0) indique que l'installation s'est effectuée correctement. Toute autre valeur indi-
que qu'une erreur s'est produite.
Procédure
1. Dans 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 Recher-
cher dans, localisez et ouvrez le dossier.
Veillez à ce que le dossier soit protégé contre tout accès 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
réseau vers le répertoire emplacement_c8/configuration de l'ordinateur où vous prévoyez
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 coglo-
cale.xml de l'ordinateur source dans le répertoire emplacement_c8/configuration de l'ordina-
teur sur lequel vous prévoyez d'effectuer la configuration sans surveillance.
8. Ouvrez le répertoire emplacement_c8/bin.
9. Saisissez la commande de configuration :
./cogconfig.sh -s
cogconfig.bat -s
Conseil : Pour consulter les messages de journalisation créés au cours d'une configuration
sans surveillance, ouvrez le fichier cogconfig_response.csv situé dans le répertoire
emplacement_c8/logs.
Cognos Configuration applique les paramètres de configuration spécifiés dans la copie locale du
fichier cogstartup.xml, chiffre les références d'identification, crée des certificats numériques et, le
cas échéant, démarre un service ou un processus Cognos 8.
228
Annexe A : Configuration manuelle de Cognos 8
La console connectée à l'ordinateur UNIX ou Linux sur lequel vous installez Cognos 8 ne prend
peut-être pas en charge les interfaces graphiques utilisateur de type Java. Vous devez effectuer
manuellement les tâches suivantes :
❑ Modifier manuellement les paramètres de configuration implicites en modifiant le fichier
cogstartup.xml situé dans le répertoire emplacement_c8/configuration,
❑ Modifier manuellement les langues ou les monnaies prises en charge ou les correspondances
des paramètres régionaux en modifiant le fichier coglocale.xml situé dans le répertoire
emplacement_c8/configuration,
❑ Appliquer la configuration et les paramètres régionaux à l'ordinateur en exécutant Cognos
Configuration en mode silencieux,
❑ Déployer Cognos 8 vers un environnement de serveur d'application en créant manuellement
un fichier d'archive de Cognos.
Pour toutes les installations, certaines tâches de configuration sont nécessaires pour que Cognos 8
puisse fonctionner dans votre environnement. Si vous répartissez des composants de Cognos 8 sur
plusieurs ordinateurs, l'ordre dans lequel vous configurez et démarrez les ordinateurs est impor-
tant.
D'autres tâches de configuration sont facultatives et dépendent de votre environnement d'exécu-
tion de rapports. Vous pouvez changer le comportement implicite de Cognos 8 en modifiant le
fichier cogstartup.xml afin de changer les valeurs de propriétés. Vous pouvez également utiliser
des exemples de fichiers permettant à Cognos 8 d'utiliser des ressources existantes de votre envi-
ronnement.
Configuration manuelle de Cognos 8 sous UNIX et Linux

La console connectée à l'ordinateur UNIX ou Linux sur lequel vous installez Cognos 8 ne prend
peut-être pas en charge les interfaces graphiques utilisateur de type Java. Vous devez :
❑ modifier manuellement les paramètres de configuration implicites en modifiant le fichier cogs-
tartup.xml situé dans le répertoire emplacement_c8/configuration,
❑ modifier manuellement les langues ou les monnaies prises en charge ou les correspondances
des paramètres régionaux en modifiant le fichier coglocale.xml situé dans le répertoire
emplacement_c8/configuration,
❑ appliquer la configuration et les paramètres régionaux à l'ordinateur en exécutant Cognos
Configuration en mode silencieux.
Pour toutes les installations, certaines tâches de configuration sont nécessaires pour que Cognos 8
puisse fonctionner dans votre environnement. Si vous répartissez des composants de Cognos 8 sur
plusieurs ordinateurs, l'ordre dans lequel vous configurez et démarrez les ordinateurs est impor-
tant.
D'autres tâches de configuration sont facultatives et dépendent de votre environnement d'exécu-
tion de rapports. Vous pouvez changer le comportement implicite de Cognos 8 en modifiant le
fichier cogstartup.xml afin de changer les valeurs de propriétés. Vous pouvez également utiliser
des exemples de fichiers permettant à Cognos 8 d'utiliser des ressources existantes de votre envi-
ronnement.

Modification manuelle des paramètres de configuration implicites sur les

ordinateurs UNIX et Linux
Si la console connectée à l'ordinateur UNIX ou Linux ne prend pas en charge les interfaces graphi-
ques utilisateur de type Java, vous devez modifier le fichier cogstartup.xml afin de configurer
Cognos 8 pour qu'il fonctionne dans votre environnement.
Remarque : Si vous n'utilisez pas l'interface graphique utilisateur, certains paramètres de configu-
ration ne sont pas enregistrés dans le fichier cogstartup.xml. Par exemple, le fuseau horaire du ser-
veur n'est pas défini pour vos composants de Cognos lorsque vous modifiez le fichier
cogstartup.xml directement et que vous exécutez Cognos Configuration en mode silencieux. Dans
ce cas, les paramètres des autres utilisateurs qui utilisent le fuseau horaire du serveur peuvent ne
pas fonctionner comme prévu.
Si vous souhaitez que 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 défaut, le fichier cogstartup.xml est encodé au format UTF-8. Lorsque vous enre-
gistrez le fichier cogstartup.xml, veillez à modifier l'encodage des paramètres régionaux de l'utili-
sateur afin qu'ils correspondent à l'encodage utilisé. L'encodage des paramètres régionaux de
l'utilisateur est défini 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 libellés d'éléments et
d'attributs, les éléments et les valeurs.
Avant de modifier le fichier cogstartup.xml, veillez à :
• faire une copie de sauvegarde,
• créer la base de données Content Store sur un ordinateur disponible de votre réseau,
• passer en revue la configuration requise pour votre type d'installation.
Procédure
1. Accédez au répertoire emplacement_c8/configuration.
2. Ouvrez le fichier cogstartup.xml dans un éditeur.
3. Identifiez le paramètre de configuration que vous voulez modifier en consultant l'aide et les
commentaires de descriptifs qui se trouvent devant la balise de début des éléments
<crn:parameter>.
4. Modifiez la valeur de l'élément <crn:value> pour qu'il soit conforme à votre environnement.
<crn:parameter> .
Conseil : Utilisez l'attribut type pour déterminer le type de données de la propriété de confi-
guration.
8. Répétez les tâches 3 et 4 jusqu'à ce que les valeurs de configuration soient adaptées à votre
environnement.
Vous devez à présent utiliser un éditeur XML de validation afin de valider les modifications par
rapport aux règles inscrites dans le fichier cogstartup.xsd situé dans le répertoire
Ajout d'un composant à la configuration

Le fichier cogstartup.xml contient les paramètres de configuration utilisés par Cognos 8 et par les
composants tiers implicites. Vous pouvez modifier les composants utilisés par Cognos 8 en copiant
des éléments XML d'exemples de fichiers dans le fichier cogstartup.xml. Vous pouvez ensuite
modifier les valeurs de configuration afin de les adapter à votre environnement.
230
Par exemple, pour utiliser une base de données Oracle plutôt qu'une base de données Microsoft
SQL Server en tant que Content Store, vous pouvez utiliser l'exemple de fichier
ContentManager_code_de_langue.xml afin de remplacer les informations implicites de connexion
à la base de données.
Cognos 8 ne peut utiliser qu'une seule instance à la fois des éléments ci-dessous :
• la base de données Content Store,
• un fournisseur cryptographique,
• un modèle de configuration pour le service Cognos 8.
Avant de commencer à modifier des fichiers XML, vous devez en connaître la structure.
Procédure
1. Accédez au répertoire 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 tiers, ouvrez le fichier
Cryptography_code_de_langue.xml.
• Si vous souhaitez consigner les messages ailleurs que dans un fichier, ouvrez le fichier
Logging_code_de_langue.xml.
• Si vous souhaitez utiliser un modèle de taille moyenne ou grande pour la quantité de res-
sources utilisée par le processus Cognos 8, ouvrez le fichier
CognosService_code_de_langue.xml.
3. Copiez les éléments dont vous avez besoin.
Conseil : Veillez à copier le code en incluant les balises de début et de fin de l'élément
<crn:instance>.
Par exemple, recherchez les commentaires (Begin of) et (End of) :

<crn:instance ...>
...
</crn:instance>

6. Collez le code de l'exemple de fichier dans le fichier cogstartup.xml en remplaçant l'élément
<crn:instance> approprié.
7. Modifiez les valeurs de ces nouveaux éléments afin de les adapter à votre environnement.
Ne modifiez pas l'attribut de classe de l'élément <crn:instance>. Vous pouvez modifier
l'attribut de nom afin de l'adapter à votre environnement.
Par exemple, si vous utilisez une base de données Oracle comme Content Store, modifiez uni-
quement l'attribut de nom pour l'adapter à votre environnement.
<crn:instance class="Oracle" name="MyContentStore">
9. Exécutez Cognos Configuration en mode silencieux en saisissant la commande suivante :
./cogconfig.sh -s
Cela garantit la validité du fichier et le chiffrement des mots de passe.

Modification manuelle des paramètres chiffrés

Il est possible de modifier manuellement les paramètres chiffrés, tels que les mots de passe ou les
références de l'utilisateur, dans le fichier cogstartup.xml.
Pour demander à Cognos Configuration d'enregistrer un paramètre chiffré, vous devez modifier la
valeur, puis définir l'indicateur de chiffrement sur Faux.
Procédure
<crn:parameter>.
Conseil : Utilisez l'attribut type pour déterminer le type de données de la propriété de configu-
ration.
5. Faites passer la valeur de chiffrement à Faux.
Par exemple :
<crn:value encrypted="false">
6. Répétez les tâches 3 à 5 jusqu'à ce que les valeurs de configuration soient adaptées à votre
environnement.
8. Saisissez la commande de configuration suivante :
./cogconfig.sh -s
Les nouveaux paramètres sont enregistrés et chiffrés.
Modification manuelle des paramètres globaux sur les ordinateurs UNIX et

Linux
Si la console connectée à l'ordinateur UNIX ou Linux ne prend pas en charge les interfaces graphi-
ques utilisateur de type Java, vous devez modifier manuellement le fichier coglocale.xml situé dans
le répertoire emplacement_c8/configuration.
Vous pouvez modifier les paramètres globaux :
• pour préciser la langue utilisée dans l'interface utilisateur lorsque celle spécifiée dans les para-
mètres régionaux de l'utilisateur n'est pas disponible,
• pour préciser les paramètres régionaux utilisés dans les rapports lorsque ceux de l'utilisateur
ne sont pas disponibles,
• pour ajouter une prise en charge de monnaie ou de paramètres régionaux aux données du rap-
port ou aux métadonnées,
• pour ajouter une prise en charge de langue à l'interface utilisateur.
Par défaut, les composants de Cognos Series 8 appliquent une forme normalisée à tous les paramè-
tres régionaux, qui peuvent provenir de différentes sources et se présenter sous divers formats.
Cela signifie que tous les paramètres régionaux étendus sont conformes à une définition de langue
et de code régional.
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 répartie. Pour en savoir davan-
tage, contactez le responsable du support technique de Cognos.
Exemple 1
Un rapport est disponible dans Content Manager dans deux langues régionales, telles que en-us
(anglais des États-Unis) et fr-fr (français de France), mais les paramètres régionaux de l'utilisateur
sont définis sur fr-ca (français du Canada). Cognos 8 utilise les correspondances de paramètres
régionaux pour déterminer le rapport à afficher pour l'utilisateur.
232
Tout d'abord, Cognos 8 vérifie dans Content Manager si le rapport est disponible dans la langue
des paramètres régionaux de l'utilisateur. Si tel n'est pas le cas, Cognos 8 met en correspondance
les paramètres régionaux de l'utilisateur avec des paramètres régionaux normalisés configurés
dans l'onglet Correspondances des paramètres régionaux (contenu). La langue des paramètres
régionaux de l'utilisateur étant fr-ca, la correspondance est établie avec fr. Cognos 8 utilise la
valeur de correspondance pour vérifier si le rapport est disponible en fr. Dans le cas présent, le
rapport est disponible en en-us et fr-fr, pas en fr.
Ensuite, Cognos 8 met en correspondance les rapports disponibles avec des paramètres régionaux
normalisés. Ainsi, en-us devient en et fr-fr devient fr.
Du fait que tant le rapport que les paramètres régionaux de l'utilisateur sont mis en correspon-
dance avec fr, l'utilisateur dont les paramètres régionaux indiquent la langue fr-ca voit s'afficher le
rapport en fr-fr.
Exemple 2
Les paramètres régionaux de l'utilisateur et ceux du rapport correspondent à la même langue.
Cognos 8 sélectionne les paramètres régionaux à utiliser. Par exemple, si les paramètres régionaux
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), Cognos 8 met en correspon-
dance chaque paramètre régional avec en. L'utilisateur visualise le rapport conformément aux
paramètres régionaux choisis par Cognos 8.
Exemple 3
Les paramètres régionaux du rapport et ceux de l'utilisateur ne sont pas mis en correspondance
avec une langue commune. Cognos 8 sélectionne la langue. Dans ce cas, il peut s'avérer nécessaire
de configurer la mise en correspondance. Par exemple, si un rapport est disponible en en-us
(anglais des États-Unis) et fr-fr (français de France), tandis que les paramètres régionaux de l'utili-
sateur indiquent la langue es-es (espagnol d'Espagne), Cognos 8 sélectionne la langue.
Procédure
1. Sur chaque ordinateur où vous avez installé Content Manager, ouvrez le répertoire
2. Ouvrez le fichier coglocale.xml dans un éditeur.
3. Ajoutez ou modifiez l'élément et l'attribut requis entre les balises de début et de fin.
Type d'élément Balise de début Balise de fin

Langue <supportedProductLocales> </supportedProductLocales>
Paramètres régionaux <supportedContentLocales> </supportedContentLocales>

(contenu)
Monnaie <supportedCurrencies> </supportedCurrencies>
Correspondance des <productLocaleMap> </productLocaleMap>

paramètres régionaux
Correspondance des <contentLocaleMap> </contentLocaleMap>

(contenu)
Polices <supportedFonts> </supportedFonts>
Conseil : Pour supprimer une prise en charge, supprimez l'élément.

Conseil : Nous vous recommandons d'utiliser un éditeur XML pour valider les modifications par
rapport aux règles du fichier cogstartup.xsd, situé dans le répertoire emplacement_c8/configura-
tion.

Si vous ajoutez un code de monnaie qui n'est pas pris en charge par Cognos, vous devez l'ajouter
manuellement au fichier i18n_res.xml dans le répertoire emplacement_c8/bin/. Copiez ce fichier
sur chaque ordinateur Cognos de votre installation.
Exécution de Cognos Configuration en mode silencieux sur les ordinateurs

UNIX et Linux
Exécutez Cognos Configuration en mode silencieux pour appliquer les paramètres de configura-
tion à votre ordinateur si la console connectée à l'ordinateur UNIX ou Linux ne prend pas en
charge les interfaces graphiques utilisateur de type Java.
Avant d'exécuter l'outil de configuration en mode silencieux, vous devez utiliser un éditeur XML
de validation afin de valider les modifications par rapport aux règles inscrites dans le fichier cogs-
tartup.xsd situé dans le répertoire emplacement_c8/configuration.
Procédure
1. Assurez-vous que le fichier cogstartup.xml situé dans le répertoire emplacement_c8/configura-
tion de l'ordinateur local contient les paramètres de propriétés que vous voulez utiliser pour la
configuration.
3. Saisissez la commande de configuration suivante :
./cogconfig.sh -s
Conseil : Pour consulter les messages de journalisation créés au cours d'une configuration
sans surveillance, ouvrez le fichier cogconfig_response.csv situé dans le répertoire
emplacement_c8/logs.
Cognos Configuration applique les paramètres de configuration spécifiés dans la copie locale du
fichier cogstartup.xml, chiffre les références d'identification, crée des certificats numériques et, le
cas échéant, démarre un service ou un processus Cognos 8.
Création manuelle du fichier d'archive de Cognos

Cognos 8 doit être inclus dans un fichier d'archive qui permettra son déploiement dans l'environ-
nement de serveur d'application (p. 197) ou dans une passerelle de type servlet (p. 139). Cognos 8
offre un assistant Création d'application qui permet de créer le fichier d'archive. Si vous choisissez
de ne pas utiliser l'assistant Création d'application, procédez comme suit pour créer le fichier
d'archive :
Si le serveur d'application n'est pas utilisé en tant que serveur Web, il n'est pas nécessaire d'inclure
le contenu statique de Cognos dans le fichier d'archive. Le fait de ne pas inclure le contenu stati-
que lors de la création du fichier d'archive réduit la taille de ce fichier.
Vous pouvez créer un fichier d'archive Web (.war) ou un fichier d'archive Enterprise (.ear). Pour
en savoir davantage sur les fichiers WAR et EAR et pour déterminer celui qui est pris en charge
par votre serveur d'application, reportez-vous à la documentation du serveur d'application.
Pour une passerelle de type servlet, vous pouvez créer un fichier WAR ou EAR. Si vous utilisez un
serveur Sun Java System Web, vous devez créer un fichier WAR.
Procédure de création d'un fichier WAR

1. Accédez au répertoire emplacement_c8/war/p2pd.
2. Exécutez un script en procédant de l'une des manières suivantes :
• sous Windows, pour créer un fichier avec un contenu Web, saisissez
build.bat
• sous Windows, pour créer un fichier sans contenu Web, saisissez
build.bat war_without_webcontent
• sous UNIX ou Linux, pour créer un fichier avec un contenu Web, saisissez
build.sh
• sous UNIX ou Linux, pour créer un fichier sans contenu Web, saisissez
234
build.sh war_without_webcontent
Procédure de création d'un fichier EAR

1. Accédez au répertoire emplacement_c8/war/p2pd.
2. Exécutez un script en procédant de l'une des manières suivantes :
• sous Windows, pour créer un fichier avec un contenu Web, saisissez
build.bat ear
• sous Windows, pour créer un fichier sans contenu Web, saisissez
build.bat ear_without_webcontent
• sous UNIX ou Linux, pour créer un fichier avec un contenu Web, saisissez
build.sh ear
• sous UNIX ou Linux, pour créer un fichier sans contenu Web, saisissez
build.sh ear_without_webcontent

236
Annexe B : Dépannage
Ces informations de référence et solutions de dépannage constituent un outil pratique pour résou-
dre des problèmes spécifiques détectés durant ou après l'installation de composants de Cognos 8.
Pour en savoir davantage sur les ressources de dépannage, reportez-vous au Guide de dépannage.
Les problèmes se caractérisent par leurs symptômes. Chaque symptôme permet de remonter à une
ou plusieurs causes en utilisant des outils et techniques de dépannage spécifiques. Une fois le pro-
blème identifié, il est possible de le résoudre en exécutant une série d'opérations.
Les fichiers journaux sont utiles pour le dépannage. Un autre outil de dépannage précieux est la
base de connaissances, disponible sur le site du support technique de Cognos (http://supp-
port.cognos.com). Il s'agit d'une base de données dans laquelle figurent un ensemble de problèmes
et leurs solutions pour tous les produits de Cognos.
Si vous ne parvenez pas à résoudre un problème, votre ultime recours est le responsable du sup-
port technique de Cognos. Pour analyser un problème, ce dernier a besoin d'informations sur la
situation et les symptômes que vous observez. Pour l'aider à diagnostiquer la cause du problème,
réunissez les données nécessaires avant de le contacter.
Fichiers journaux
Les fichiers journaux facilitent le dépannage en enregistrant les activités qui interviennent lors de
l'utilisation d'un produit. Les opérations exécutées dans Cognos 8 sont enregistrées dans divers
fichiers journaux à des fins de suivi. Par exemple, si vous êtes confronté à des problèmes lors de
l'installation de Cognos 8, consultez le fichier journal de transfert afin de savoir quelles activités
l'Assistant d'installation a effectuées durant le transfert des fichiers.
Avant de consulter les fichiers journaux, assurez-vous qu'ils contiennent les informations dont
vous avez besoin. Le nombre de fichiers journaux et les informations qu'ils contiennent sont défi-
nis par des paramètres dans Cognos Connection et dans Cognos Configuration.
Utilisez l'outil d'administration des serveurs dans Cognos Connection pour découvrir les catégo-
ries de journalisation et la manière de définir le niveau de détail à journaliser pour chaque catégo-
rie.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité de Cognos 8.
Utilisez Cognos Configuration pour spécifier la taille, le nombre et l'emplacement des fichiers
journaux, ainsi que pour configurer les propriétés du serveur de journalisation. Pour en savoir
davantage, reportez-vous au Guide de l'utilisateur de Cognos Configuration.
Lors du dépannage, aidez-vous des fichiers suivants :
Fichier journal de transfert

Ce fichier est utilisé pour consigner les activités que l'Assistant d'installation exécute lors du trans-
fert de fichiers. Le fichier journal de transfert se trouve dans le répertoire emplacement_c8\instlog.
Le nom du fichier indique le nom du produit, sa version et son numéro d'édition, et comprend un
horodateur. Voici un exemple du format de nom de fichier :
tl-COG-8-1-0-0-20050901_1122.txt

Fichier journal récapitulatif des erreurs de transfert

Ce fichier est utilisé pour consigner les composants que vous avez installés, des informations sur
l'espace disque, les sélections que vous avez faites dans les boîtes de dialogue de transfert et les
erreurs éventuelles détectées par l'Assistant d'installation lors du transfert des composants. Le
fichier journal récapitulatif des erreurs de transfert se trouve dans le répertoire
emplacement_c8/instlog. Le nom du fichier indique le nom du produit, sa version et son numéro
d'édition, et comprend un horodateur. Voici un exemple du format de nom de fichier :
tl-COG-8-1-0-0-20050901_1122_summary-error.txt
Fichier de configuration de démarrage

Ce fichier est utilisé pour consigner vos choix de configuration chaque fois que vous enregistrez
vos paramètres de propriété. Le nom du fichier est cogstartup.xml. Si vous n'êtes pas en mesure
d'enregistrer la configuration ou si vous rencontrez des problèmes, vous pouvez revenir à un
fichier de configuration enregistré précédemment. Les fichiers de configuration de sauvegarde se
trouvent dans le répertoire emplacement_c8/configuration. Voici un exemple du format de nom de
fichier pour des fichiers de configuration de sauvegarde :
cogstartup_200211231540.xml
Fichier de verrouillage de configuration de démarrage

Ce fichier est créé à chaque fois que vous exécutez Cognos Configuration. Il vous empêche
d'ouvrir plusieurs fenêtres de Cognos Configuration. Si vous avez des difficultés à ouvrir Cognos
Configuration, vérifiez le fichier cogstartup.lock dans le répertoire emplacement_c8/configuration.
Si le fichier est présent alors que Cognos Configuration n'est pas ouvert, cela signifie que Cognos
Configuration n'a pas été arrêté correctement la dernière fois que vous l'avez utilisé. Vous pouvez
supprimer ce fichier .lock et ouvrir Cognos Configuration.
Fichier de configuration des paramètres régionaux

Ce fichier est utilisé pour consigner les choix de configuration posés dans Cognos Configuration
concernant les paramètres régionaux du produit et du contenu, la mise en correspondance des
paramètres régionaux et la prise en charge des monnaies. Si vous rencontrez des problèmes de
prise en charge des langues dans l'interface utilisateur ou dans les rapports, utilisez ces fichiers
pour suivre les changements. Les fichiers de configuration de sauvegarde se trouvent dans le réper-
toire emplacement_c8/configuration. Voici un exemple du format de nom de fichier :
coglocale_200211231540.xml
Fichier journal d'exécution

Le fichier journal implicite de Cognos nommé cogserver.log, ou d'autres fichiers journaux configu-
rés pour recevoir des messages de journalisation du serveur de journalisation, consignent des
informations après le démarrage du service Cognos 8. Celles-ci se trouvent dans le répertoire
emplacement_c8. Si vous avez configuré une autre destination pour les messages de journalisation,
vérifiez le fichier ou la base de données appropriée.
Certains messages de journalisation signalent des problèmes. La plupart de ces messages contien-
nent uniquement des informations mais d'autres peuvent vous aider à diagnostiquer des problè-
mes dans votre environnement d'exécution.
Fichier journal de passerelle

Les passerelles consignent les erreurs dans le fichier journal de passerelle qui se trouve dans le
répertoire emplacement_c8/logs. Vous pouvez utiliser le fichier journal de passerelle pour dépan-
ner des problèmes empêchant la passerelle de traiter les demandes ou d'utiliser le chiffrement. Les
symptômes de ces problèmes sont les suivants : les codes d'utilisateur et les mots de passe ne fonc-
tionnent pas, le code d'accès unique ne fonctionne pas et le distributeur est en cours d'exécution
mais les utilisateurs voient s'afficher le message d'erreur suivant : The Cognos BI server is
not available. Le nom du fichier journal de passerelle est le suivant (où interface_passerelle est
cgi, mod (module Apache 1.3), mod2 (module Apache 2.0) ou isapi) :
gwinterface_passerelle.log (par ex., gwcgi.log)
238
Fichier journal de désinstallation

Ce fichier est utilisé pour consigner les activités que l'Assistant de désinstallation exécute lors de la
désinstallation de fichiers. Le fichier journal s'intitule cognos_uninst_log.htm et se trouve dans le
répertoire Temp. Vous pouvez utiliser le fichier journal pour assurer le dépannage de certains pro-
blèmes liés à la désinstallation des composants de Cognos 8.
Fichier journal du mode silencieux

Ce fichier est utilisé pour consigner les activités que Cognos Configuration exécute en cours d'exé-
cution en mode silencieux. Ce fichier journal s'intitule cogconfig_response.csv et se trouve dans le
répertoire emplacement_c8/logs.
(R)
Fichier de mise à niveau de ReportNet à Cognos 8
(R)
Ce fichier contient un sommaire des résultats obtenus lors de la mise à niveau de ReportNet à
Cognos 8. Ce fichier journal se nomme upgradeLog.xml et se trouve dans le répertoire
emplacement_c8/log. Le fichier est au format xml et il fait référence à une feuille de style xslt.
Vous pouvez cliquer deux fois sur le fichier pour qu'il s'affiche dans votre navigateur.
Problèmes d'installation et de configuration

Certains problèmes peuvent se produire pendant l'installation et la configuration ou lors du para-
métrage de Cognos 8 pour qu'il s'exécute avec un serveur d'application.
Problèmes de démarrage de Cognos 8

Certains problèmes peuvent se produire lorsque vous tentez :
• de démarrer le service Cognos 8,
• d'ouvrir la page Bienvenue de Cognos Connection pour la première fois,
• de démarrer un serveur d'application, tel que WebLogic ou WebSphere.
Symptômes Solution
La page de garde de Cognos Connection ne Vérifiez la configuration de votre serveur Web.
s'affiche pas lorsque vous démarrez Cognos 8.
Le service démarre, mais aucune table n'est Vérifiez la configuration de la base de données
créée dans la base de données Content Store. Content Store.
Le service ne démarre pas. Assurez-vous que vous attendez quelques

instants avant de soumettre une demande.
Le serveur d'application tiers ne démarre pas. Vérifiez les droits d'accès aux fichiers et les
noms des répertoires de l'emplacement
d'installation du serveur d'application.
Assurez-vous que vous utilisez un logiciel tiers pris en charge par les composants de Cognos. Vous
pouvez afficher une liste d'environnements mis à jour, tels que les systèmes d'exploitation, les pro-
grammes de correction, les navigateurs, les serveurs Web, les serveurs d'annuaire et les serveurs de
base de données sur le site Web Cognos Global Customer Services (http://support.cognos.com).
CFG-ERR-0106 Erreur lors du démarrage du service Cognos 8 dans Cognos Configuration

Lorsque vous démarrez le service Cognos 8, vous pouvez voir le message d'erreur suivant
s'afficher :
CFG-ERR-0106 Cognos Configuration n'a reçu aucune réponse du service Cognos 8 pendant la
période allouée. Assurez-vous que le service Cognos 8 est disponible et correctement configuré.
Il existe deux causes possibles à ce problème :

• Le service Cognos 8 a besoin de plus de temps pour démarrer.

• Un ordinateur Content Manager en attente peut être configuré de manière incorrecte.
Le service Cognos 8 a besoin de plus de temps

Par défaut, Cognos Configuration vérifie la progression de la demande de démarrage toutes les
demi-secondes pendant trois minutes. Si Cognos Configuration ne reçoit pas de réponse dans ce
délai, le message d'erreur s'affiche.
Pour éviter cette erreur, vous pouvez modifier la durée pendant laquelle Cognos Configuration
attend de recevoir une réponse du service Cognos 8. Pour cela, configurez les propriétés Servi-
ceWaitInterval et ServiceMaxTries dans le fichier emplacement_c8/configuration/cogconfig.prefs.
La propriété ServiceWaitInterval représente l'intervalle, en millisecondes, pour lequel Cognos
Configuration vérifie la progression de la demande de démarrage. Sa valeur implicite est 500, ce
qui équivaut à une demi-seconde.
La propriété ServiceMaxTries représente le nombre de fois où Cognos Configuration vérifie la
progression de la demande de démarrage. Sa valeur implicite est 360.
Content Manager est configuré de manière incorrecte

Si le message d'erreur s'affiche sur un ordinateur Content Manager en attente, le paramètre de
stockage des clés symétriques est peut-être incorrect.
Pour éviter ce problème, configurez l'ordinateur Content Manager en attente afin qu'il stocke les
clés symétriques localement.
Procédure de modification du temps d'attente

1. À l'aide de Cognos Configuration, arrêtez le service Cognos 8.
2. Ouvrez le fichier emplacement_c8/configuration/cogconfig.prefs dans un éditeur.
Ce fichier est créé automatiquement la première fois que vous exécutez Cognos Configura-
tion.
3. Ajoutez le code suivant au fichier :
ServiceWaitInterval=nombre de millisecondes
ServiceMaxTries=fréquence
Conseil : Ajoutez les valeurs numériques correspondant à vos besoins de configuration.
4. Enregistrez le fichier.
5. À l'aide de Cognos Configuration, démarrez le service Cognos 8.
Procédure de stockage de clés symétriques localement

1. Démarrez Cognos Configuration sur l'ordinateur Content Manager en attente.
3. Dans la fenêtre Propriétés, dans la section Paramètres CSK, définissez l'option Stocker la clé
symétrique localement sur la valeur Vrai.
vous souhaitez démarrer un service spécifique, sélectionnez le noeud du service dans la fenêtre
de l'explorateur et cliquez sur Démarrer dans le menu Opérations.
Échec du démarrage du service Cognos 8 car le port est utilisé par un autre processus
Il est possible que vous ne puissiez pas démarrer un service ou un processus de Cognos 8 si l'un
des ports implicites est utilisé par un autre processus.
Conseil : Pour voir les connexions réseau TCP/IP actuelles, utilisez la commande netstat.
Utilisez Cognos Configuration pour modifier le port implicite utilisé par Cognos 8.
240
Si vous modifiez le port utilisé par le distributeur local, vous devez modifier la valeur de la pro-
priété URI du distributeur. Étant donné que le changement a une incidence sur tous les URI basés
sur le distributeur local, vous devez modifier ceux de tous les composants locaux. Par défaut,
l'URI des composants locaux contient la chaîne localhost.
Par exemple, si vous installez tous les composants sur un seul ordinateur et que vous modifiez le
port du distributeur, vous devez également modifier le port dans les URI du Content Manager
local et l'URI du distributeur local.
Procédure de modification du port implicite

2. Dans la fenêtre Explorateur, cliquez sur le groupe ou le composant approprié :
• Pour modifier le numéro de port du distributeur, cliquez sur l'option Environnement.
• Pour modifier le numéro de port du serveur de journalisation local, dans la section Envi-
ronnement, cliquez sur l'option Journalisation.
3. Dans la fenêtre Propriétés, cliquez sur la zone Valeur à côté de la propriété que vous voulez
modifier.
4. Si vous changez le port du distributeur, veillez à modifier les ports dans d'autres URI conte-
nant un hôte local.
6. Dans le menu Opération, cliquez sur l'option Démarrer.
Non disponibilité du serveur Cognos BI lors du démarrage de Cognos 8

Après avoir configuré les composants de Cognos et démarré le service Cognos 8, le message
d'erreur suivant peut s'afficher lorsque vous ouvrez Cognos Connection :
Échec de le connexion entre la passerelle Cognos et le serveur de Cognos BI..
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 Cognos. Par défaut, le
fichier cogserver.log se trouve dans le répertoire emplacement_c8/logs. Si vous avez configuré une
autre destination pour les messages de journalisation, vérifiez le fichier ou la base de données
appropriée.
Content Manager ne peut parfois pas se connecter la base de données Content Store si cette der-
nière n'est pas correctement configurée. Cela peut se produire si :
• la base de données Content Store utilise un encodage de caractères non pris en charge,
• la base de données Content Store utilise une séquence d'assemblage de base de données sensi-
ble à la casse,
• les paramètres de configuration spécifiés dans Cognos Configuration ne sont pas valides.
Encodage de caractères non pris en charge

Si le fichier journal contient les messages suivants, l'encodage de caractères de la base de données
créée en tant que Content Store n'est pas pris en charge :
• Pour Oracle :
CM-CFG-5063 Une erreur de configuration de Content Manager s'est produite lors de la con-
nexion à Content Store.
CM-SYS-5121 Content Manager ne parvient pas à démarrer car le jeu de caractères de la base
de données Content Store n'est pas pris en charge.
CM-SYS-5126 Le serveur de base de données Content Store utilise le jeu de caractères
US7ASCII.
CM-SYS-5125 Le client de base de données Content Store utilise le jeu de caractères
US7ASCII.
• Pour DB2 UDB :

CM-SYS-5124 Le serveur de base de données Content Store utilise la page de codes 1252.
• Pour Sybase :
Pour que Content Manager puisse se connecter à la base de données Content Store, cette dernière
doit utiliser l'encodage de caractères approprié :
Base de données Encodage de caractères

Oracle 8.1.7 UTF8
UTF16
Oracle 9i AL32UTF8
AL32UTF16
DB2 UDB Codeset UTF-8
Sybase ASE UTF-8
Microsoft SQL Server UTF8

UTF16
Pour résoudre ce problème, vous devez recréer la base de données Content Store à l'aide de l'enco-
dage de caractères correct ou convertir l'encodage de caractères. Pour en savoir davantage, repor-
tez-vous à la documentation sur la base de données.
Séquence d'assemblage sensible à la casse

Si les messages suivants s'affichent dans le fichier journal, la base de données créée en tant que
Content Store utilise une séquence d'assemblage de base de données sensible à la casse :
CM-SYS-5122 La base de données Content Store utilise une séquence de classement des caractères
implicite qui fait la distinction entre les majuscules et les minuscules. Content Manager requiert un
Content Store utilisant un assemblage non sensible à la casse.
CM-SYS-5123 Le serveur de base de données Content Store utilise l'assemblage <paramètre>.
CM-SYS-5007 Échec du lancement de la compilation <numéro_version> de Content Manager.
Passez en revue les fichiers journaux de Content Manager puis contactez l'administrateur du sys-
tème ou le support client..
Pour résoudre ce problème, vous devez recréer la base de données Content Store à l'aide d'une
séquence d'assemblage de base de données qui n'est pas sensible à la casse. Pour en savoir davan-
tage, reportez-vous à la documentation sur la base de données.
Paramètres de configuration non valides

Si le fichier journal contient le message suivant ou un message similaire, vous n'avez pas configuré
correctement la base de données Content Store dans Cognos Configuration.
• Pour Microsoft SQL Server :
CM-CFG-5036 Content Manager n'a pas pu se connecter à Content Store. La chaîne de con-
nexion est 'jdbc:JSQLConnect://localhost:1433/cm'.
242
Échec de connexion:com.jnetdirect.jsql.x: Cannot open database requested in login 'cm'.

Échec de connexion. url:jdbc:JSQLConnect://localhost:1433/cm.
• Pour DB2 :
CM-SYS-5003 Content Manager ne parvient pas à accéder au Content Store. Vérifiez les para-
mètres de connexion à la base de données, puis contactez l'administrateur de base de données.
[IBM][CLI Driver] SQL1013N Pseudonyme de base de données ou nom de base de données
« CM123 » non trouvé.
• Pour Oracle :
nexion est « jdbc:oracle:thin:@localhost:1521:pb1 ».
ORA-01017 : nom d'utilisateur/mot de passe non valide ; connexion refusée.
• Pour Sybase :
nexion est « jdbc:sybase:Tds:localhost:5000/cm ».
JZ006: Caught IOException: java.net.ConnectException: Connection refused: connect.
Si vous utilisez une base de données Oracle, n'utilisez pas de caractères illégaux, tels que le tiret de
soulignement dans Cognos Configuration pour la propriété Nom du service. Si le nom du service
comprend des caractères non autorisés, les tables ne sont pas créées dans la base de données Con-
tent Store au démarrage du service Cognos 8.

de données.


connexion.
Par exemple :
cliquez sur Tester.
test.
Échec de la connexion à un espace-noms lors de l'utilisation de Cognos Connection (Erreur

PRS-CSE-1255)
Vous ouvrez Cognos 8 à partir de Cognos Connection. Toutefois, lorsque vous tentez de créer une
source de données et de vous connecter à un espace-noms, les messages d'erreur suivants
s'affichent :
• PRS-CSE-1255 Erreur lors du déchiffrement des données.
• CAM-CRP-1064 Impossible de traiter les données PKCS #7 en raison d'une erreur interne.
Raison : java.lang.IndexOutOfBoundsException.
Ce problème peut survenir si vous ne disposez pas des droits d'accès nécessaires pour les répertoi-
res suivants :
• c8\configuration
• c8\configuration\csk
• c8\configuration\encryptkeypair
• c8\configuration\signkeypair
La solution consiste à activer les droits de lecture et d'exécution sur les répertoires cités ci-dessus
pour tous les utilisateurs devant démarrer le service Cognos 8.
Échec du redémarrage des services de Cognos 8 après une panne de réseau

Après une panne de réseau, Cognos Bootstrap Service redémarre les services de Cognos 8 des ins-
tallations Tomcat où l'adresse IP de réseau est définie dans l'URI interne du distributeur. Lors du
redémarrage, l'initialisation des services de Cognos 8 peut échouer. Il faudra alors les redémarrer
manuellement une fois le réseau rétabli.
Pour résoudre ce problème, configurez la propriété URI interne du distributeur dans Cognos Con-
figuration afin d'utiliser le nom d'hôte local ou de réseau.
244
Aucun avertissement pour indiquer que la version antérieure de Content Store sera mise à jour
automatiquement lors de l'installation d'une version plus récente de Cognos 8
(R)
Vous disposez d'une version de ReportNet sur votre ordinateur. Vous installez une version plus
récente dans un nouvel emplacement. Vous utilisez la même base de données Content Store pour
les deux versions. Lorsque vous configurez la version plus récente et démarrez le service Cognos 8,
la version précédente de ReportNet (R) ne fonctionne plus car l'intégralité du contenu est mise à
niveau automatiquement.
(R)
Si vous souhaitez utiliser différentes versions de ReportNet et de Cognos 8 après une mise à
niveau, assurez-vous qu'avant d'installer la version la plus récente vous effectuez :
• une copie de sauvegarde de la base de données que vous utilisez comme Content Store,
• une restauration de cette sauvegarde dans un nouvel emplacement.
Vous pouvez également choisir d'utiliser l'outil de déploiement pour importer la totalité de la base
de données Content Store d'une version antérieure de ReportNet dans une version plus récente.
Toutes les données existantes de la base de données Content Store sont remplacées par le contenu
importé. Vous recevez un message d'avertissement.
Échec du téléchargement des ressources

Vous démarrez Report Studio dans Internet Explorer et le message d'erreur suivant s'affiche :
Échec du téléchargement des ressources spécifiées.
Il est possible que la cause soit une mise à niveau récente de Microsoft XMLHTTP si vous n'avez
pas défini de préférence de langue dans Internet Explorer.
Pour résoudre le problème, définissez une préférence de langue dans Internet Explorer.
Erreur SQL1224N retournée par DB2 en cas de connexion depuis AIX

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

Après avoir démarré Cognos 8, aucun processus BIBUSTKSERVMA ne démarre. Des erreurs sont
consignées dans les fichiers pogo******.log et cogserver.log. Les utilisateurs reçoivent des erreurs
dans le navigateur lorsqu'ils se connectent à Cognos Connection.
Dans le fichier pogo******.log, une erreur liée à Content Manager s'affiche.
Dans le fichier cogserver.log, le message d'erreur suivant s'affiche :
Échec de l'inscription du distributeur dans Content Manager. Le système essaiera à nouveau de
façon périodique.
Lorsque vous vous connectez à http://nom_ordinateur/cognos8, les messages d'erreur suivants
s'affichent dans le navigateur :
• DPR-ERR-2058 Le distributeur ne peut répondre à cette demande en ce moment. Il est en
cours d'initialisation.
• SoapSocketException: Connection Refused
Cognos Configuration utilise un code d'utilisateur pour établir une liaison à la base de données
LDAP. Si ce code d'utilisateur est déplacé dans un autre groupe, Cognos Configuration ne peut
plus déterminer son emplacement.
Pour remédier à ce problème, replacez le code d'utilisateur dans son groupe d'origine.

Impossible d'ouvrir un cube MS ou Cognos

Vous ne pouvez pas ouvrir un cube MS ou vous pouvez en ouvrir un mais seules les métadonnées
s'affichent.
Pour résoudre ce problème, assurez-vous que l'utilisateur qui exécute le service Cognos 8 est un
utilisateur de domaine disposant des droits d'accès adéquats au cube. Par exemple, dans un envi-
ronnement réparti, où le cube MSAS est exécuté sur un autre ordinateur, vous devrez peut-être
ajouter l'utilisateur du service Cognos 8 en tant qu'administrateur OLAP.
Les cubes sont accessibles par l'intermédiaire de lecteurs mis en correspondance ou de noms che-
mins d'accès UNC.
Impossible d'ouvrir une source de données OLAP

L'une des sources de données suivantes ne s'ouvre pas :
• MSAS
• Essbase
• DB2
Vous pouvez essayer d'ouvrir le même cube dans Excel. Ceci vous permettra de déterminer si le
serveur OLAP fonctionne et si le logiciel client adéquat est installé.
Page introuvable lors du démarrage de Cognos 8 sous Windows 2003

Après avoir installé Cognos 8 sous Windows 2003, il est possible que le message d'erreur suivant
s'affiche lors du démarrage de Cognos 8 :
La page est introuvable.. La page que vous recherchez a peut- être été supprimée, renommée ou est
momentanément inaccessible. Erreur HTTP 404 - Fichier ou répertoire introuvable.
Cette erreur provient d'une fonction de sécurité des services d'information Internet (IIS) sous
Windows 2003. Cette fonction de sécurité n'autorise pas les extensions de fichiers cgi inconnues.
Pour résoudre ce problème, 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 après avoir installé Cognos 8

Après avoir installé et configuré Cognos 8, vous ne parvenez pas à ouvrir Cognos Connection.
Cela peut être dû à une mauvaise configuration du serveur Web. Par exemple, il se peut que les
répertoires virtuels requis pour Cognos 8 n'existent pas ou qu'ils pointent vers les mauvais dos-
siers physiques.
Pour en savoir davantage sur la configuration du serveur Web, reportez-vous au Guide d'installa-
tion et de configuration.
DPR-ERR-2058 Une erreur s'affiche dans le navigateur Web lors du démarrage de Cognos 8
Lorsque vous démarrez les services dans Cognos Configuration puis essayez d'ouvrir le portail, un
message semblable à l'un des suivants peut s'afficher :
DPR-ERR-2058 Le distributeur a détecté une erreur lors du traitement d'une demande. Il faut ini-
tialiser le gestionnaire XTS avant de pouvoir l'appeler.
DPR-ERR-2058 Le distributeur ne peut répondre à 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 généralement lorsque le distributeur ne peut pas communiquer
avec Content Manager. Afin de déterminer la cause de ces erreurs, consultez le fichier cogser-
ver.log dans le répertoire emplacement_c8/logs. Les causes les plus fréquentes sont répertoriées
ci-dessous avec leurs solutions.
246
L'initialisation des services Cognos n'est pas terminée

Après avoir démarré les services dans Cognos Configuration et une fois que l'outil de configura-
tion indique que les services sont actifs, attendez quelques minutes pour laisser à tous les services
le temps de démarrer avant d'ouvrir le portail.
Content Manager n'est pas disponible

Dans une installation répartie, assurez-vous que Content Manager est installé, configuré et en
cours d'exécution. Assurez-vous également que les autres ordinateurs Cognos sont configurés avec
l'URI correct de Content Manager.
La base de données Content Store n'est pas disponible ou n'est pas configurée correc-
tement
Assurez-vous que la base de données Content Store a été créée et que vous l'avez configurée cor-
rectement dans Cognos Configuration.
Les tables ne sont pas créées dans la base de données Content Store
Assurez-vous d'utiliser une version de DB2, Microsoft SQL Server, Oracle ou Sybase prise en
charge par les composants de Cognos.
Les références de connexion de la base de données Content Store ne sont pas correc-
tes
Vérifiez 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 références d'identification de connexion pour la base de données Content Store dans
Vérifiez que le mot de passe de connexion ne contient pas de caractères spéciaux. Le pilote JDBC
n'accepte parfois pas les caractères réservés pour le format xml, tels que %, !, < et >.
L'utilisateur ne dispose pas des droits d'accès appropriés

Vérifiez que l'utilisateur dispose des droits d'accès appropriés.
Mémoire insuffisante sous HP-UX

Si vous utilisez Tomcat, vous pouvez déterminer si le problème est lié à la configuration du serveur
HP-UX. Le nombre maximal attendu d'unités d'exécution par processus a peut-être été dépassé.
Procédure de vérification d'un problème de configuration HP-UX
1. Dans le fichier /bin/startup.sh, trouvez
../tomcat4.1.27/bin/catalina.sh start "$@"
2. Remplacez cette chaîne par la suivante :
../tomcat4.1.27/bin/catalina.sh run "$@"
La commande « run » affiche la sortie Tomcat dans la fenêtre de la console Cognos 8.
3. Arrêtez et redémarrez Cognos 8 à l'aide des commandes ./shutdown.sh et ./startup.sh.
Si le message d'erreur suivant s'affiche dans la fenêtre de la console d'un serveur d'application,
le problème vient de la configuration de HP-UX :
OutofMemoryException error: Unable to create new native thread on HP-UX.
Le problème vient du fait que les valeurs implicites de 11.0 et 11i HP-UX sont trop faibles
pour la plupart des applications Java.
Conseil : Vous pouvez vérifier le nombre d'unités d'exécution comprises dans votre processus
en utilisant l'option -eprof disponible dans JDK 1.1.8, puis en analysant le fichier Java.eprof à
l'aide de l'option HPjmeter en sélectionnant l'indicateur d'unités d'exécution.
Procédure d'augmentation du nombre maximal d'unités d'exécution par processus

1. Demandez à l'administrateur système de modifier les paramètres de noyau suivants :
• max_thread_proc = 512
• nkthread = 1024

2. Veillez à ce que les paramètres ulimit soient illimités.
Content Manager ne parvient pas à se connecter à la base de données Content Store

sous Oracle
Si vous utilisez une base de données Oracle comme Content Store, l'erreur DPR-ERR-2058 peut
être générée lorsque vous vous connectez au portail http://nom_hôte/cognos8. Toutes les tables
sont créées dans la base de données
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 refusée
Procédure de définition du nom de serveur de la base de données Oracle

1. Dans la fenêtre Explorateur, cliquez sur Accès aux données, Content Manager, Content Store.
2. Remplacez le nom de serveur de la base de données Oracle par un nom qualifié complet, tel
que nom_hôte.nom_société:1534, qui correspondra au nom contenu dans le fichier tnsna-
mes.ora.
Report Studio ne démarre pas

Vous ne serez peut être pas en mesure de démarrer Cognos Report Studio si vous utilisez un logi-
ciel de blocage des incrustations sur votre ordinateur.
Au démarrage de Report Studio, celuici ouvre une nouvelle fenêtre de navigateur. De plus, une
nouvelle fenêtre de navigateur s'ouvvre lorsque vous exécutez un rapport et lorsqu'une erreur est
détectée.
Pour résoudre le problème, désactivez ce logiciel lorsque vous utilisez Report Studio.
DPR-ERR-2022 Une erreur s'affiche dans le navigateur Web lors du démarrage de Cognos 8
Lorsque vous démarrez les services dans Cognos Configuration, puis que vous essayez d'ouvrir le
portail, un message semblable au suivant peut s'afficher :
DPR-ERR-2022 Aucune réponse générée. Il est possible que la configuration soit incorrecte, que
l'installation soit endommagée ou que l'initialisation du distributeur ne soit pas terminée.
Ouverture anticipée du portail

Ce problème peut se produire si vous tentez d'ouvrir le portail avant d'avoir installé les services
Cognos.
Pour éviter ce problème, après avoir démarré les services dans Cognos Configuration et une fois
que l'outil de configuration indique que les services sont actifs, attendez quelques minutes pour
laisser à tous les services le temps de démarrer avant d'ouvrir le portail.
Le fichier system.xml contient des erreurs

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

Une fois que vous avez installé Cognos 8, vous êtes invité à télécharger le fichier cognos.xts lors de
l'ouverture de Cognos Connection. Les messages d'erreur suivants s'affichent :
Vous avez choisi de télécharger un fichier à partir de cet emplacement. cognos.xts à partir de
nom_serveur
Ce problème se produit lorsque les autorisations associées aux répertoires virtuels n'ont pas été
correctement définies. Vous devez indiquer le répertoire virtuel cgi-bin dans les services d'informa-
tion Internet de Microsoft (IIS) et définir des droits d'exécution.
248
Pour résoudre ce problème, créez à nouveau les répertoires virtuels dans les services d'information
Internet avec les droits suivants.
Alias Chemin d'accès Autorisations

cognos8 emplacement_c8\Program Lecture
Files\Cognos\c8\webcontent
cognos8\ cgi-bin emplacement_c8\Program Lecture Exécution

Files\Cognos\c8\cgi-bin
cognos8\help emplacement_c8\Program Lecture

Files\Cognos\c8\webcontent\
documentation
Échec du script de démarrage d'un serveur d'application

Vous pouvez être confronté à des problèmes d'exécution des scripts de démarrage permettant à un
serveur d'application de déployer l'application Cognos si des composants de Cognos 8 sont instal-
lés dans un répertoire dont le nom contient des espaces.
Pour résoudre ce problème, renommez le répertoire et n'incluez pas d'espaces dans le nouveau
nom. Si cette solution ne convient pas aux scripts de démarrage, essayez d'ajouter des guillemets
autour du nom du répertoire incluant des espaces ou utilisez la convention de dénomination 8.3.
Non-fonctionnement du type de rapport multipage Microsoft Excel 2000

Pour vous assurer que les adresses URL des rapports ne puissent pas être modifiées lorsqu'elles
sont transférées d'un navigateur client à un serveur de rapports, Cognos 8 applique des signatures
aux adresses URL qu'il crée. Cependant, le format multipage Excel 2000 (xls) ne prend pas en
charge les adresses URL signées. Pour utiliser le type de rapport multipage Excel 2000, vous devez
désactiver la signature numérique des adresses URL en effectuant les opérations suivantes :
Procédure de désactivation des adresses URL signées

1. Arrêtez le distributeur.
2. Dans le répertoire emplacement_c8/configuration, renommez le fichier cafconfig.xml.sample
en cafconfig.xml.
3. Ouvrez le fichier cafconfig.xml et naviguez jusqu'à la section suivante :

<crn:parameter name="caf_signedReportUrls">
<crn:value xsi:type="xsd:boolean">true</crn:value>
</crn:parameter>
4. Change ="xsd:boolean">true</crn:value> to ="xsd:boolean">false</crn:value>.
5. Redémarrez votre distributeur.
6. Répétez les étapes ci-dessus pour chaque distributeur de votre environnement, ou copiez le
fichier cafconfig.xml dans chaque répertoire emplacement_c8/configuration, puis redémarrez
les distributeurs.
Impossible de désérialiser l'attribut contextuel lors du déploiement du fichier p2pd.war vers

WebLogic
Lorsque vous déployez 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 déploiement du fichier p2pd.war.
Pour éviter ce problème, ajoutez au moins une langue dans les préférences d'Internet Explorer.

Une erreur s'affiche après la mise à niveau de Cognos 8 sur un serveur d'application WebLogic
Vous utilisez WebLogic et effectuez une mise à niveau de Cognos 8 à partir d'une version anté-
rieure. Après avoir déployé le fichier p2pd.war pour la nouvelle installation, un message sembla-
ble à celui-ci s'affiche :
<BEA-101215> <Malformed Request "null". Request parsing failed, Code: -10>
Cela peut se produire si vous annulez le déploiement de Cognos 8 à partir de WebLogic et que cer-
tains fichiers de la version précédente ne sont pas supprimés du système.
Pour remédier à ce problème, utilisez les outils d'administration de votre serveur d'application
pour vous assurer que le déploiement de Cognos 8 a été annulé. Pour en savoir davantage sur
l'annulation du déploiement d'applications, reportez-vous à la documentation de votre serveur
d'application.
Si le répertoire vers lequel Cognos 8 était initialement déployé n'est pas supprimé pendant le pro-
cessus d'annulation du déploiement, supprimez le répertoire. Supprimez également les fichiers .jar
de Cognos 8 mis en antémémoire dans l'environnement de votre serveur d'application. Par exem-
ple, dans WebLogic 7.0, des fichiers .jar sont parfois conservés dans
%WL_HOME%\user_projects\<nom_domaine>\<nom_serveur_géré>\.wlnotde-
lete\c8_p2pd_p2pd\jarfiles
Vous pouvez les supprimer en supprimant le répertoire WEB-INF.
Dans WebLogic 8.1.2, l'emplacement de mise en antémémoire est
%WL_HOME%\user_projects\domains\<nom_domaine>\<nom_serveur_géré>\.wlnotde-
lete\extract\c8_p2pd_p2pd\jarfiles
Après avoir supprimé tous les fichiers de l'installation précédente, vous pouvez redéployer
Cognos 8.
Message de mise à niveau dans Cognos Configuration

Après avoir effectué la mise à niveau vers Cognos 8, la première fois que vous démarrez Cognos
Configuration, un message vous avertit qu'une mise à niveau est en cours. Ce message sera affiché
à chaque fois que vous ouvrirez Cognos Configuration et ce, jusqu'à ce que vous enregistriez la
configuration. Ce message ne cause aucun problème.
Pour supprimer le message, enregistrez la configuration.
(R)
Échec de l'installation du service ReportNet sous Windows
(R)
Vous installez Cognos 8, mais le service ReportNet continue à s'exécuter.
Vous pouvez installer plusieurs versions de Cognos 8 à différents emplacements sur le même ordi-
nateur. Si les versions utilisent les mêmes ports, l'installation risque de ne pas mettre le service à
niveau correctement. Cognos Configuration effectue la mise à niveau vers le service configuré le
plus récemment pour Cognos 8. Vous devez supprimer le service manuellement.
Conseil : Pour savoir si le service Cognos 8 correct est actif, vérifiez le numéro de version dans la
fenêtre À propos de de Cognos Configuration.
(R)
Procédure de suppression manuelle du service ReportNet
2. Cliquez sur nœud de service 'Cognos 8' (ou tout autre nom donné au service par l'utilisateur)
dans le panneau de gauche.
3. Dans le menu Opération, cliquez sur le bouton Arrêter.
4. Ouvrez une fenêtre Invite de commande.
6. Désinstallez 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".
7. Fermez la fenêtre Invite de commande.
250
8. Redémarrez Cognos Configuration pour effectuer la mise à niveau vers le service correct.
Les caractères chinois, japonais et coréen sont différents après la mise à jour
Si vous utilisez des caractères chinois, japonais ou coréens, il est possible que des différences appa-
raissent sur certains caractères après avoir mis Cognos 8 à niveau.
Exemples
• Vous exécutez un rapport. Lorsque vous comparez la sortie avec le même rapport dans Repor-
tNet(R), vous constatez que certains caractères sont différents.
• Vous effectuez une recherche et vous obtenez des résultats qui diffèrent de celle réalisée dans
ReportNet(R).
Ces différences proviennent des tables de conversion utilisées pour le chinois, le japonais et le
coréen, qui ont été modifiées pour répondre à des normes internationales. Si les spécifications de
votre rapport ou vos filtres de recherche contiennent des expressions utilisant des valeurs constan-
tes, les résultats peuvent s'en trouver affectés.
Si vous souhaitez utiliser les mêmes tables de conversion que celles utilisées dans ReportNet(R), exé-
cutez le script suivant dans le répertoire emplacement_c8/bin :
• Sous UNIX, saisissez
conv_compat.sh
• Sous Linux, saisissez
conv_compat.sh
conv_compat.cdm
Problèmes de configuration de Cognos 8

Une fois les composants de Cognos 8 installés, vous pouvez être confronté à certains problèmes
lors de l'enregistrement des modifications apportées à Cognos Configuration.
Assurez-vous de :
• configurer et de démarrer les services sur l'ordinateur sur lequel Content Manager est installé
avant de configurer d'autres composants,
• redémarrer le service Cognos 8 après avoir effectué les modifications de configuration.
Exécution de scripts de nettoyage de base de données

Dans certaines situations de dépannage, il vous sera peut-être conseillé de démarrer avec de nou-
velles données de configuration.
Vous pouvez exécuter un script SQL pour supprimer toutes les tables des bases de données utili-
sées par les composants de Cognos 8 suivantes :
• la base de données Content Store nécessaire au fonctionnement de Cognos 8,
• la base de données de diffusion utilisée pour transmettre des notifications de rapports,
• la base de données de journalisation utilisée pour les messages d'analyse,
• la bibliothèque d'indicateurs utilisée pour stocker le contenu des packs d'indicateurs et les pré-
férences des utilisateurs de Metric Studio.
Lorsque vous supprimez une table, la définition de sa structure et ses données sont supprimées de
façon permanente de la base de données. Il est également possible de supprimer les objets stockés
dans la base de données de la bibliothèque d'indicateurs.
Lorsque vous redémarrez le service Cognos 8, un nouveau jeu de tables de base de données est
créé automatiquement à l'emplacement indiqué par les paramètres de configuration.
Procédure
1. Arrêtez le service Cognos 8 sur chaque ordinateur sur lequel Content Manager est installé.
2. Ouvrez le répertoire approprié :

• Pour supprimer les tables de la base de données de journalisation, ouvrez le répertoire

emplacement_c8\configuration\schemas\logging.
• Pour supprimer les tables de la base de données Content Store, ouvrez le répertoire
emplacement_c8\configuration\schemas\content.
• Pour supprimer les tables de la base de données de notification, ouvrez le répertoire
emplacement_c8\configuration\schemas\delivery.
• Pour supprimer les tables de la bibliothèque d'indicateurs, ouvrez le répertoire
emplacement_c8\configuration\schemas\cmm.
3. Ouvrez le répertoire de base de données approprié.
4. Selon le type de base de données, exécutez l'un des scripts suivants afin de supprimer les
tables :
Base de données Type de base de données Nom du script

base de données Content DB2 dbClean_db2.sql
Store
Microsoft SQL Server dbClean_mssqlserver.sql
Oracle dbClean_oracle.sql
Sybase dbClean_sybase.sql
Notification DB2 NC_DROP_DB2.sql
Microsoft SQL Server NC_DROP_MS.sql
Oracle NC_DROP_ORA.sql
Sybase NC_DROP_SYBASE.sql
Journal DB2 LS_dbClean_db2.sql
Microsoft SQL Server LS_dbClean_mssql.sql
Oracle LS_dbClean_oracle.sql
Sybase LS_dbClean_sybase.sql
Bibliothèque d'indicateurs DB2 cmm_purge_deleted_data

pseudonyme_base_de_donné
es nom_utilisateur
mot_de_passe
Définissez un pseudonyme
pour la base de données
seulement si une base
données portant le même
nom est déjà cataloguée.
Microsoft SQL cmm_purge_deleted_data

nom_hôte
nom_base_de_données_bibli
othèque_indicateurs
nom_utilisateur_Admin
mot_de_passe
252
Base de données Type de base de données Nom du script

Oracle cmm_purge_deleted_data
nom_base_de_données
nom_utilisateur_base_de_do
nnées mot_de_passe
Rempacez
nom_base_de_donnée par le
nom qui figure dans le
fichier tnsnames.ora file qui
fait référence au SID de la
base de données pour Metric
Studio
Amélioration des performances de la bibliothèque d'indicateurs

Cognos 8 offre un script nommé cmm_update_stats qui met à jour les index de votre base de don-
nées, améliorant ainsi ses performances. En règle générale, ce script est utilisé avant ou après un
chargement lorsque la quantité ou la distribution des données change de façon significative. Par
exemple, vous pouvez peut-être améliorer les performance si vous exécutez ce script lorsque le
nombre de tableaux de bord passe de 100 à 1 000.
Procédure
1. Assurez-vous que la bibliothèque d'indicateurs n'est pas en cours d'utilisation.
2. Ouvrez le répertoire suivant :
emplacement_c8\configuration\schemas\cmm
3. Ouvrez le répertoire de base de données approprié.
4. Selon le type de base de données, exécutez l'un des scripts suivants à partir de la ligne de
commande :
• Pour Microsoft SQL Server ou DB2 :
cmm_update_stats nom_hôte nom_bibliothèque_indicateurs nom_utilisateur_Admin
mot_de_passe
• Pour Oracle :
cmm_update_stats nom_bibliothèque_indicateurs nom_utilisateur_Admin mot_de_passe
Erreur de chiffrement lors de l'enregistrement de la configuration

Lorsque vous enregistrez la configuration à l'aide de l'outil de configuration, vous pouvez voir
s'afficher un message d'erreur indiquant l'échec du chiffrement des informations cryptographi-
ques. Une erreur s'est produite lors de la demande d'un certificat à l'autorité de certification.
Impossible de chiffrer les informations cryptographiques. Voulez-vous enregistrer la configuration
sous forme de texte brut ?
Avant de chiffrer des paramètres de configuration, l'ordinateur sur lequel Content Manager est
installé doit être configuré et actif. Sous UNIX, copiez les fichiers .jar appropriés dans l'emplace-
ment d'installation de Java Runtime Environment. En outre, vérifiez que votre environnement
Java est correctement configuré, que les URI sont corrects et que le même mot de passe d'autorité
de certification est configuré sur tous les ordinateurs Content Manager.
Sous Linux, copiez les fichiers .jar appropriés dans l'emplacement d'installation de Java Runtime
Environment.
Un message d'erreur semblable au suivant peut s'afficher :
java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory.
En général, une erreur cryptographique signifie que l'environnement Java n'est pas correctement
configuré. Vérifiez que la variable d'environnement JAVA_HOME est correctement définie et que
les fournisseurs de sécurité appropriés sont installés, tels que JSSE pour JRE 1.31.

Procédure de vérification de la configuration

1. Démarrez Cognos Configuration sur l'ordinateur Content Manager.
3. Dans la fenêtre Propriétés, vérifiez les propriétés suivantes :
• Dans la section Paramètres de la passerelle, URI de la passerelle.
• Dans la section Paramètres du distributeur, URI externe du distributeur et URI interne du
distributeur.
• Dans la section Autres paramètres de l'URI, URI du distributeur pour des applications
externes et URI de Content Manager.
4. Dans la fenêtre Explorateur, cliquez sur Sécurité, Cryptographie, Cognos.
5. Dans la section Paramètres de l'autorité de certification de la fenêtre Propriétés, cliquez sur la
valeur associée à Mot de passe.
Veillez à ce que le même mot de passe soit utilisé sur tous les ordinateurs Content Manager.
6. Enregistrez la configuration et redémarrez Cognos 8.
CAM-CRP-1315 Erreur lors de l'enregistrement de la configuration

Lorsque vous enregistrez la configuration, le message suivant peut s'afficher :
CAM-CRP-1315 La configuration actuelle pointe vers un domaine sécurisé autre que celui qui
était configuré au départ.
Cette erreur se produit lorsque des modifications ont été apportées au domaine sécurisé de votre
environnement. Le domaine sécurisé est administré par l'autorité de certification associée au Con-
tent Store. Cette erreur peut se produire si le Content Store d'origine a été supprimé ou si vous
avez modifié votre configuration de façon à utiliser Content Manager avec un autre Content Store
après avoir enregistré votre configuration originale.
Pour résoudre ce problème, modifiez votre configuration afin d'utiliser le Content Store original.
Les données de configuration sont verrouillées par une autre instance de Cognos Configuration
Vous risquez de voir s'afficher un message d'erreur indiquant que les données de configuration
sont verrouillées par une autre instance de Cognos Configuration.
Lorsque vous lancez Cognos Configuration, celui-ci vérifie si le fichier cogstartup.lock existe dans
le répertoire emplacement_c8/configuration. Il est possible que ce fichier s'y trouve si la session
précédente ne s'est pas terminée correctement ou si une autre instance de Cognos Configuration
est active.
Si une autre instance de Cognos Configuration est active, vous devez la fermer. Sinon, les modifi-
cations que vous apportez à la configuration locale risquent d'entraîner des erreurs.
Si aucune autre instance de Cognos Configuration n'est en cours d'exécution, supprimez le fichier
cogstartup.lock du répertoire emplacement_c8/configuration.
En cas d'arrêt du service Cognos 8, cliquez sur le bouton Démarrer.
Échec de sortie d'une séquence de tabulations en cas de navigation à l'aide du clavier dans Cognos
Configuration
Si vous utilisez la touche de tabulation pour naviguer dans Cognos Configuration, vous risquez
d'éprouver des difficultés à sortir d'une séquence de tabulations. Par exemple, dans la fenêtre Pro-
priétés, vous pouvez utiliser la touche de tabulation pour passer d'une propriété à l'autre.
Toutefois, Cognos Configuration étant une application Java, pour fermer la fenêtre Propriétés,
vous devez appuyer sur les touches [Ctrl]+[Tab].
254
Échec de l'enregistrement de la configuration

Il peut être impossible d'enregistrer la configuration s'il manque une ressource. Par exemple, vous
avez supprimé une ressource telle que l'espace-noms de Cognos, un fournisseur cryptographique
ou la base de données Content Store. Vous pouvez remplacer le type de base de données Content
Store implicite par une base de données de type Oracle, DB2 ou Sybase. Vous ne pouvez pas rem-
placer l'espace-noms de Cognos. Vous pouvez le créer à nouveau, mais vous devez dans ce cas
créer à nouveau les groupes et rôles de Cognos.
Pour en savoir davantage sur la création des groupes et rôles dans Cognos Connection, repor-
tez-vous au Guide d'administration et de sécurité.
Procédure de re-création de l'espace-noms de Cognos

Authentification, puis cliquez successivement sur les options Nouvelle ressource et
Espace-noms.
4. Dans la boîte de dialogue Type, cliquez sur l'option Cognos, puis sur le bouton OK.
L'espace-noms de Cognos s'affiche dans la fenêtre Explorateur.
Erreur Java lors du démarrage de Cognos Configuration

Lorsque vous démarrez Cognos Configuration, vous pouvez recevoir un message d'erreur modifié
par l'environnement JRE (Java Runtime Environment) signalant que les informations cryptogra-
phiques en cours ne sont pas compatibles avec le nouvel environnement JRE. Vous pouvez être
invité à générer à nouveau ces informations cryptographiques pour le nouvel environnement JRE
ou à rétablir la version antérieure du JRE.
Cette erreur peut se produire pour l'une des raisons suivantes :
• Vos données de configuration ont été chiffrées à l'aide d'un JRE différent de celui actuellement
utilisé par les composants de Cognos 8.
• Les informations cryptographiques ont pu être endommagées.
Si vous cliquez sur Créer à nouveau dans la fenêtre d'erreur, le service Cognos 8 est arrêté et les
informations cryptographiques sont à nouveau générées.
Si vous cliquez sur Quitter dans la fenêtre d'erreur, vous devez définir 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 de Cognos 8 utilisent le JRE installé par
défaut, annulez la définition de JAVA_HOME ou définissez 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 utilisée par les composants de Cognos 8. Pour en savoir davantage, repor-
tez-vous au Guide d'installation et de configuration.
Erreur de chiffrement lors du démarrage de Cognos Configuration

Lorsque vous démarrez Cognos Configuration, le message d'erreur suivant peut s'afficher :
Les informations cryptographiques ont peut-être été altérées ou le fichier cogstartup.xml n'est pas
valide. Vous devrez peut-être réparer le fichier ou le supprimer du disque.. Pour en savoir davan-
tage, reportez-vous au Guide d'installation et de configuration.
Cette erreur survient lorsque les composants de Cognos 8 détectent une erreur dans le fichier cogs-
tartup.xml. Cela peut se produire lorsque le fichier cogstartup.xml est modifié manuellement et
que le texte modifié comporte une erreur.
Pour résoudre ce problème, remplacez le fichier cogstartup.xml par une copie se trouvant dans
l'emplacement de sauvegarde.

Paramètres de configuration actuels non appliqués à l'ordinateur

Cognos Configuration permet de modifier les valeurs de propriété implicites ou d'ajouter une res-
source à une installation. Après avoir enregistré la configuration actuelle, il est possible que vous
ne puissiez plus voir les changements ou que vous ne puissiez plus utiliser la ressource dans l'envi-
ronnement d'exécution.
Pour appliquer les nouveaux paramètres à l'ordinateur, vous devez redémarrer le service
Cognos 8.
Procédure de redémarrage du service Cognos 8

2. Dans le menu Opérations, cliquez sur la commande appropriée :
• Si le service Cognos 8 est en cours d'exécution, cliquez sur le bouton Redémarrer.
Cette opération démarre tous les services installés qui n'étaient pas en cours d'exécution
et redémarre ceux qui l'étaient. Si vous souhaitez redémarrer un service spécifique, sélec-
tionnez le noeud du service dans la fenêtre de l'explorateur et cliquez sur Redémarrer dans
le menu Opérations.
• Si le service Cognos 8 est arrêté, cliquez sur le bouton Démarrer. Cette opération démarre
tous les services installés qui n'étaient pas en cours d'exécution. Si vous souhaitez démar-
rer un service spécifique, sélectionnez le noeud du service dans la fenêtre de l'explorateur
et cliquez sur Démarrer dans le menu Opérations.
Cette opération démarre tous les services installés qui n'étaient pas en cours d'exécution.
Si vous souhaitez démarrer un service spécifique, sélectionnez le noeud du service dans la
fenêtre de l'explorateur et cliquez sur Démarrer dans le menu Opérations.
CM-CFG-029 Une erreur s'est produite en tentant d'enregistrer un configuration qui indique que la
source de données est de type SQL Server
Dans 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 déterminer 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'accès nécessaires pour initialiser Con-
tent Store ou pour créer une table dans la base de données.
Pour résoudre ce problème, assurez-vous que l'utilisateur du Content Store dispose des droits
d'accès nécessaires à l'utilisation de la procédure stockée 'sp_tables' dans la base de données prin-
cipale.
Police non trouvée au démarrage de Cognos Configuration sous UNIX

Lorsque vous démarrez Cognos Configuration, le message d'erreur suivant peut s'afficher :
Police spécifiée dans font.properties non trouvée...
Il s'agit d'un problème courant sous UNIX. Cela indique que le composant JVM (Java Virtual
Machine) tente d'utiliser une ou plusieurs polices non installées sur l'ordinateur. Cependant, le
composant JVM doit utiliser les valeurs système implicites, tandis que Cognos Configuration doit
démarrer et fonctionner normalement.
Pour éviter ces erreurs, ajoutez les polices manquantes à Java Runtime Environment en modifiant
les fichiers font.properties. Plusieurs fichiers font.properties contenant des informations d'envi-
ronnement de polices standard sont installés avec le SDK Java (Software development kit). Ces
fichiers se trouvent dans le répertoire emplacement_JRE/lib.
Pour en savoir davantage, reportez-vous à la documentation sur Java.
Erreur Page introuvable lors de l'exécution de rapport à l'aide de Cognos Office Connection
Dans un document Microsoft Office configuré pour Cognos Office Connection, vous utilisez Exé-
cuter le rapport mais vous recevez le message d'erreur "La page est introuvable".
256
Cela peut se produire si la passerelle et le distributeur Cognos 8 utilisent "localhost" comme

valeur du nom de serveur sur le serveur Cognos 8.
Pour corriger ce problème, utilisez le nom de l'ordinateur pour les valeurs hôte de la passerelle et
du distributeur à la place de "localhost".
Certains utilisateurs sont invités à se connecter lors de l'utilisation de Active Directory Server
Vous avez configuré Cognos 8 de façon à ce qu'il utilise Microsoft Active Directory Server en tant
que fournisseur d'authentification. Il n'existe qu'un seul domaine et tous les utilisateurs sont mem-
bres de ce domaine. Certains utilisateurs peuvent se connecter au système sans être à nouveau invi-
tés à effectuer cette opération dans Cognos 8. D'autres utilisateurs reçoivent l'invite de connexion
de Cognos.
La connexion unique peut ne pas fonctionner pour certains utilisateurs s'ils utilisent Internet
Explorer et que l'option permettant d'activer l'authentification intégrée de Windows n'est pas
activée.
Procédure d'activation de l'option d'authentification Windows intégrée

1. Dans le menu Outils d'Internet Explorer, cliquez sur Options Internet.
2. Dans l'onglet Avancé, cochez l'option Activer l'authentification intégrée de Windows.
Erreur d'initialisation de la base de données Content Store d'Oracle après une mise à niveau à partir
de ReportNet
Vous créez une base de données Content Store dans Oracle ou mettez à niveau une base de don-
nées Content Store ReportNet dans Oracle vers 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 données Oracle est inférieur à
9.0.1.
Vous pouvez corriger ce problème en optant pour le niveau de compatibilité 9.0.1 ou un niveau
supérieur et en redémarrant l'instance Oracle.
Erreur serveur HTTP 500 pour le serveur d'application Oracle

Vous avez configuré votre serveur d'application Oracle et lorsque essayez de déployer les compo-
sants de Cognos 8, le message d'erreur suivant s'affiche :
HTTP 500 - Erreur interne au serveur
Pour résoudre ce problème, vous devez créer le fichier WAR ou EAR sans contenu Web.
Procédure
1. Accédez au répertoire oracle_home\dcm\bin.
2. Créez le fichier WAR ou EAR et déployez-le à l'aide de la commande suivante :
dcmctl deployapplication -f chemin_et_nom_du_fichier_war_ou_ear -a nom_application -co
nom_instance_OC4J
Par exemple :
dcmctl deployapplication -f /applications/testApp.ear -a testApplication -co testOC4Jinstance
Erreur de délai d'attente d'un script CGI lors de la connexion aux composants de Cognos 8 par le biais
d'un navigateur Web
Lors des opérations ci-dessous dans votre navigateur Web, le message d'erreur suivant s'affiche :
Délai 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 configurée pour utiliser CGI. IIS dispose d'un délai d'attente implicite
pour les applications CGI.

Pour résoudre ce problème, vous pouvez configurer la passerelle de manière à ce qu'elle utilise
l'interface ISAPI. IIS ne dispose pas de délai d'attente implicite pour les applications ISAPI. Sinon,
pour continuer à utiliser une passerelle CGI, vous pouvez augmenter le délai d'attente CGI dans
IIS.
Procédure de configuration de la passerelle avec l'interface ISAPI

1. Sur l'ordinateur passerelle, démarrez Cognos Configuration.
2. Dans la section Environnement, pour la propriété URI de la passerelle, modifiez la partie
cognos.cgi de l'URI à
cognosisapi.dll
3. Dans votre navigateur Web, indiquez l'URI ISAPI :
http://nom_ordinateur/cognos8/isapi
Procédure d'augmentation du délai d'attente CGI

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

Vous pouvez rencontrer des problèmes lors de la configuration d'une installation de serveur répar-
tie et de l'utilisation de WebLogic en tant que serveur d'application pour Cognos 8.
Lorsque vous déployez le fichier p2pd.war pour l'ordinateur des composants d'application, vous
pouvez recevoir des exceptions de servlet et le distributeur peut ne pas démarrer. De plus, le fichier
cogserver.log n'est pas créé.
Les messages d'erreur suivants s'affichent dans la console du serveur WebLogic :
<Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP><BEA-101249> <[ServletCon-
text(id=19023494,name=p2pd,context-path=/p2pd)]:Servlet class com.cognos.pogo.isolation.Ser-
vletWrapper for servletcfgss could not be loaded because the requested class was not found in the
classpath /host2/bea812/user_projects/domains/c8/applications/p2pd/WEB-INF/classes.
java.lang.ClassNotFoundException: com.cognos.pogo.isolation.ServletWrapper.>
<Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP> <BEA-101216> <Servlet: "cfgss" failed to pre-
load on startup in Web application: "p2pd".
javax.servlet.ServletException: [HTTP:101249][ServletContext(id=19023494,name=p2pd,con-
text-path=/p2pd)]: Servlet class com.cognos.pogo.isolation.ServletWrapperfor servlet cfgss could
not be loaded because the requested class was not found in the classpath
/host2/bea812/user_projects/domains/c8/applications/p2pd/WEB-INF/classes.java.lang.ClassNot-
FoundException: com.cognos.pogo.isolation.ServletWrapper. at weblogic.servlet.internal.Ser-
vletStubImpl.prepareServlet (ServletStubImpl.java:799)
at weblogic.servlet.internal.WebAppServletContext.preload Servlet(WebAppServletCon-
text.java:3252)
Pour éviter ce problème, ne déployez par l'application p2pd à partir du répertoire des applications
WebLogic. Créez le répertoire p2pd dans un autre emplacement puis déployez l'application corres-
pondante à partir de ce répertoire.
Procédure
1. Ouvrez Cognos Configuration et configurez l'ordinateur des composants d'application.
2. Redémarrez l'ordinateur Content Manager.
3. Créez un répertoire p2pd dans un emplacement accessible par le serveur WebLogic mais ne
figurant pas dans le répertoire des applications WebLogic.
Créez par exemple un répertoire nommé p2pd à l'emplacement suivant :
emplacement_WebLogic/user_projects/nom_domaine
4. Créez le fichier p2pd.war.
258
5. Dans le répertoire p2pd, procédez à l'extraction du fichier p2pd.war vers l'installation de

WebLogic à l'aide de la commande suivante :
%JAVA_HOME%/bin/jar xvfm "c8_location/p2pd.war" .
6. Démarrez WebLogic.
7. Dans la console du serveur WebLogic, déployez l'application p2pd.
Les icônes du bureau ou la fenêtre Cognos Configuration scintillent sous Windows

Lorsque vous exécutez Cognos Configuration sous Windows, il est possible que les icônes du
bureau ou de la fenêtre Cognos Configuration scintillent.
Pour résoudre ce problème, démarrez Cognos Configuration à l'aide de l'option de ligne de com-
mande -noddraw.

260
Glossaire
accès anonyme
Méthode d'accès à des ressources qui ne requiert pas l'authentification des utilisateurs; tous les
utilisateurs disposent des mêmes droits d'accès.
algorithme de chiffrement
Lors de l'utilisation de la sécurité SSL, ensemble d'algorithmes d'authentification, de chiffrement
et d'intégrité des données utilisés dans l'échange de messages entre les nœuds d'un réseau.
Lors d'une liaison SSL, les deux nœuds négocient afin de déterminer quel algorithme de chiffre-
ment utiliser lors de la transmission des messages.
archive de déploiement
Fichier utilisé pour le déploiement. Une archive de déploiement contient les données du Content
Store qui sont déplacées.
authentification
Processus de vérification de l’identité des utilisateurs lors de leur connexion. Les utilisateurs doi-
vent être authentifiés avant de pouvoir être autorisés à utiliser une ressource sécurisée.
autorité de certification
Le composant Cognos qui émet des certificats (identification) sur chaque poste de travail où sont
installés des composants. Vous pouvez également utiliser une autorité de certification tierce.
bibliothèque d'indicateurs
Base de données qui renferme du contenu pour les packs d'indicateurs. Une bibliothèque d'indica-
teurs contient aussi les paramètres de Metric Studio, tels que les préférences de l'utilisateur.
certificat
Document qui identifie quelqu'un ou quelque chose par son nom. Les certificats sont distribués
par les autorités de certification.
Tout poste de travail Cognos dans une installation répartie utilise un certificat différent.
Les certificats sont utilisés pour identifier une entité. Ils sont utilisés dans les signatures numéri-
ques et les communications sécurisées et peuvent être utilisés pour le chiffrement ou le déchiffre-
ment.
composants tiers de l'application

Lors de l'installation, les processeurs qui accèdent aux bases de données de requêtes pour recueillir
des informations et afficher les résultats sous forme de rapports en format PDF ou HTML et sous
forme d'indicateurs. Les composants tiers de l'application envoient aussi les demandes à Content
Manager et affichent les résultats que Content Manager extrait du Content Store.
connexion
Information nommée qui définit le type de source de données, son emplacement physique et toute
exigence en termes de code d’accès. Une source de données peut disposer de plusieurs connexions.

Content Manager
Service Cognos 8 qui gère le stockage des applications client, incluant la sécurité propre à ses
applications, les données de configuration, les modèles, les rapports et les versions de rapports.
Content Manager est requis pour la publication de modèles, l’extraction ou le stockage de spécifi-
cations de rapports, la gestion d’informations de calendrier ou bien encore la gestion de
l’espace-noms Cognos.
Content Store
Base de données qui contient les données nécessaires au fonctionnement de Cognos 8, telles que
les spécifications de rapports, les modèles publiés et les packs qui les contiennent; des informations
de connexion aux sources de données; des informations à propos des espaces-noms externe et de
Cognos; ainsi que des informations sur les calendriers de production de rapports et sur la diffusion
de rapports en rafale.
Les modèles de conception et les fichiers journaux ne sont pas stockés dans Content Store.
Le service Cognos 8 qui utilise Content Store se nomme Content Manager.
droits d'accès
Règles définissant les droits d'accès aux ressources. Les droits d'accès peuvent être accordés à
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 configurée d'un fournisseur d'authentification, pour l'authentification et le
contrôle de l'accès. Donne accès aux informations d'utilisateurs et de groupes.
Dans XML, collection de noms, identifiés par une référence URI, qui sont utilisés dans les docu-
ments XML comme types d'éléments et noms d'attributs.
Dans Framework Manager, les espaces-noms servent à identifier de façon unique des éléments de
requête, des sujets de requête, etc. Importez des bases de données différentes dans des espa-
ces-noms distincts pour éviter l'apparition de noms en double.
fichier de réponse
Fichier ASCII qui contient les données de configuration nécessaires à l'automatisation de l'installa-
tion. Pour les installations Cognos, le fichier de réponse automatise seulement le processus de
copie des fichiers avec la configuration implicite.
fournisseur d'authentification
Mécanisme 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'intermédiaire des fournisseurs d'authentification.
fournisseur de sécurité
Voir fournisseur d'authentification.
glyphe
Image d’un caractère dans une police.
Les lettres sont des glyphes, mais dans la plupart des cas, le terme est utilisé dans le cadre de systè-
mes d’écriture non alphabétiques.
groupe
En matière de sécurité, liste d'utilisateurs ou d'autres groupes utilisée pour la définition des droits
d'accès.
Il peut s'agir de groupes provenant d'une source d'authentification de tierce partie ou d'une source
locale à 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 Cognos 8.
262
En matière de reporting, il s'agit du regroupement des valeurs communes d'un élément de requête
afin de ne les afficher qu'une seule fois. Les en-têtes et cartouches apparaissent souvent après cha-
que occurrence d’une valeur commune dans une colonne groupée.
HTTPS
Version sécurisée de HTTP (Hypertext Transfer Protocol) qui intègre la sécurité SSL (Secure Soc-
kets Layer).
Les produits Cognos utilisent les protocoles HTTPS et SSL pour chiffrer et transmettre des mots
de passe en toute sécurité par Internet.
interface de passerelle commune (CGI)

Norme qui décrit comment les serveurs Web devraient accéder aux autres programmes afin de
créer un document qui puisse être affiché dans un navigateur. Par exemple, les serveurs Web utili-
sent souvent des programmes CGI pour traiter des formulaires.
invite
Élément de rapport qui demande des valeurs avant l’exécution du rapport.
langue du produit
Code ou paramètre qui indique la langue ou les paramètres régionaux à utiliser pour certaines sec-
tions de l’interface du produit, telles que les commandes de menu.
pack d'indicateurs
Représentation d'une application Metric Studio dans Cognos Connection. Un pack d'indicateurs
contient des informations de connexion, des rapports et des tâches de gestion des indicateurs pour
cette application.
Code utilisé pour définir la langue ou le dialecte à utiliser dans le navigateur, le contenu d'un rap-
port, etc.; ainsi que les préférences régionales, notamment le format de la date, de l'heure et de la
monnaie.
Pour les produits Cognos, vous pouvez indiquer les paramètres régionaux propres à l’interface du
produit (paramètres régionaux du produit) et d’autres propres aux données du rapport (paramè-
tres régionaux du contenu).
Code utilisé pour définir la langue ou le dialecte à utiliser dans le navigateur, le contenu d'un rap-
port, etc.; ainsi que les préférences régionales, notamment le format de la date, de l'heure et de la
monnaie.
Pour les produits Cognos, vous pouvez indiquer les paramètres régionaux propres à l’interface du
produit (paramètres régionaux du produit) et d’autres propres aux données du rapport (paramè-
tres régionaux du contenu).
passeport
Informations de session relatives aux utilisateurs authentifiés. Un passeport est créé la première
fois qu'un utilisateur accède à Cognos 8. Il est conservé jusqu’à la fin de la session, soit lorsque
l’utilisateur se déconnecte, soit après une période d’inactivité donnée.
Les informations de passeport sont stockées dans la mémoire de Content Manager. Les références
d'identification sont chiffrées, puis stockées.
Un numéro de référence de passeport est stocké dans un témoin de navigation tout au long de la
session.

passerelle
Extension d’un programme de serveur Web qui transfère les informations depuis le serveur Web
vers un autre serveur. Les passerelles sont souvent des programmes CGI, mais peuvent suivre
d’autres normes, telles que ISAPI et Apache.
portlet
Mécanisme d'affichage du contenu Web sous forme de page dans le portail.
protocole SOAP (simple object access protocol)

Protocole XML léger de messagerie utilisé pour encoder les informations d'une demande de ser-
vice Web et les messages de réponse avant des les envoyer sur un réseau. Les messages SOAP sont
indépendants des systèmes d'exploitation ou des autres protocoles et peuvent être transportés à
l'aide d'une variété de protocoles Internet, dont SMTP, MIME et HTTP.
Un message SOAP inclut le contenu d'un message et une enveloppe. L'enveloppe contient des
informations relatives au contenu et des informations sur le traitement de celui-ci (XML) et les ins-
tructions de transmission du message
pseudonymes
Dans le domaine de la modélisation et des bases de données, il s'agit d'un autre nom pour désigner
une table de base de données. Les pseudonymes sont utilisés pour créer une référence distincte à
une table dans le modèle, afin de créer des auto-jointures ou de résoudre des chemins d'accès vers
des requêtes ambiguës.
références d'identification
Informations stockées sur l’identité d’un utilisateur Cognos, généralement un nom d’utilisateur et
un mot de passe. Vous pouvez affecter vos références d’identification à une autre personne de sorte
qu’elle puisse utiliser les ressources que vous êtes autorisés à utiliser.
Les références d'identification sont créées pour les composants de Cognos. Si un utilisateur plani-
fie et programme une action, les références d’identification doivent être stockées dans Content
Store.
source de données
Base de données relationnelle, cube dimensionnel, fichier ou d'autres bibliothèques de données
auxquelles on peut accéder à partir de Cognos 8.
spécification de rapport
Définition des requêtes, des invites, des présentations et des styles qui constituent un rapport. Une
spécification de rapport est combinée à des données par une opération d'exécution pour créer des
sorties de rapports. Vous créez des spécifications de rapports à l'aide de Report Studio, Query Stu-
dio, Analysis Studio ou à l'aide du Software Development Kit.
tâche
La plus petite partie d’un travail pouvant être exécutée séparément. Habituellement, une tâche est
un rapport. Une tâche peut également être un autre travail.
travail
Groupe d'objets exécutables, tels que des rapports, des agents et d'autres travaux que vous pro-
grammez et que vous exécutez par lots.
utilisateur
Personne qui accède à une application Cognos 8. Les définitions et les informations des utilisa-
teurs authentifiés, telles que les prénoms et les noms, les mots de passe, les identificateurs, les para-
mètres régionaux et les adresses de courrier électronique, sont mises à jour dans des sources
d'authentification de tierce partie.
D’autres informations d'utilisateurs, telles que l’emplacement des dossiers personnels ou les for-
mats favoris d’affichage des rapports, sont stockées dans Cognos 8.
264
XML (extensible markup language)
Langage qui utilise les symboles ou les balises pour créer des descriptions de la structure de don-
nées. Le standard XML est défini par le W3C (World Wide Web Consortium) et est lié aux langa-
ges HTML et SGML. Contrairement au langage HTML, le langage XML est extensible car les
balises ne sont pas prédéfinies ou limitées.

266
Index
Symboles code d'accès unique pour NTLM, 187

code d'accès unique utilisant Active Directory Server, 170
.NET Framework
code d'accès unique utilisant l'espace-noms Cognos
installation pour les clients Cognos Office Connection,
Series 7, 172
150
code d'accès unique utilisant LDAP, 182
code d'accès unique utilisant Netegrity SiteMinder, 186
A code d'accès unique utilisant SAP, 189
accès anonyme configuration de l'espace-noms Cognos Series 7, 171
activation pour les données de rapport PowerPlay dans définition, 261
Cognos Office Connection, 146 désactivation de la connexion anonyme, 166
définition, 261 fonction SaferAPIGetTrustedSignon, 173
désactivation, 156 fournisseurs d'authentification personnalisés, 175
activation LDAP, 175, 176, 177
Cognos Application Firewall, 119 LDAP utilisant IBM Directory Server, 179
services, 120 LDAP utilisant Novell Directory Server, 180
SSL pour serveur d'application, 202 modules d'extension Trusted Signon pour Cognos Series 7,
Active Directory Server 173
activation du code d'accès unique, 170 Netegrity Siteminder, 183, 184, 186
activation du protocole SSL, 169 NTLM, 186
authentification dans plusieurs domaines, 169 propriétés d'utilisateur personnalisées pour LDAP, 182
problèmes de connexion unique, 257 propriétés personnalisées pour Active Directory Server,
propriétés avancées, 169 168
utilisation pour authentification, 167 SAP, 187
Active Scripting spécifications relatives au code d'accès unique avec Micro-
activation dans les navigateurs Web, 83 soft Analysis Server ou Microsoft SQL Server, 167
AIX SSL pour Netegrity Siteminder, 185
erreur de connexion à la base de données DB2, 245 SSL utilisant LDAP, 182
algorithme de confidentialité, 118 suppression d'espaces-noms, 190
algorithmes de chiffrement test des espaces-noms, 189
définition, 261 utilisation d'espaces-noms, 165
algorithmes de chiffrement (ciphersuites) authentification HTTP de base
définition d'une priorité pour les connexions SSL, 127 pour code d'accès unique avec le portail Plumtree, 163
alias Web autorité de certification
Cognos 8, 81 définition, 261
Cognos Office Connection, 144 service de configuration, 208
Analysis Studio autorité de certification tierce
description des composants, 11 configuration, 208
annulation de l'inscription des distributeurs, 202
Apache Web Servers B
configuration des alias, 81
banc d'essai, 90, 109
applications SDK
base de données Content Store
observations concernant la mise à niveau, 38
configuration de clients de base de données, 78
archives de déploiement
création, 57, 71
définition, 261
critères pour le changement de serveur d'application, 192
assistant Nouveau pack d'indicateurs
DB2, 73
mise à niveau de la bibliothèque d'indicateurs, 94, 108
description des composants, 13
attribut contextuel impossible à désérialiser, 249
gestion de la connexion, 90, 98
aucune réponse générée, 248
importation de données, 203, 208
authentification
Microsoft SQL Server, 72
Active Directory Server, 167, 257
mise à niveau, 245
arborescences de domaines d'Active Directory Server, 169
Oracle, 73
code d'accès unique pour le portail Plumtree à l'aide de
paramètres non valides, 241
l'authentification HTTP de base, 163

Index
sauvegarde, 193, 206 configuration pour les témoins (cookies), 136

Sybase Adaptive Server Enterprise, 75 chiffrement
base de données de notification, 101, 104 erreurs de configuration, 253
suppression de tables, 251 modification des paramètres en configuration sans sur-
base de données des journaux veillance, 232
suppression de tables, 251 chinois
bases de données les caractères s'affichent de façon incorrecte après la mise
bibliothèque d'indicateurs, 75 à niveau, 251
client de base de données de journalisation, 129 classeurs, 14
Content Store, 71 clavier
exemples de Cognos, 213 problèmes de navigation, 254
journalisation, 129 clé symétrique commune, 117
notification, 92, 101 clés cryptographiques
rétablissement à l'état d'origine dans Event Studio, 223 création pour des autorités de certification tierces, 209
suppression de tables, 251 sauvegarde et suppression, 193, 206
bases de données de journalisation client de base de données
création, 71 configuration pour une base de données de journalisation,
bases de données SQL Server 129
création d'une base de données Content Store, 72 client de la base de données
BEA WebLogic, 191 configuration, 78
BI bus CM-CFG-029, 256
observations concernant la mise à niveau, 39 code d'accès unique
bibliothèque d'indicateurs annuaire d'utilisateurs de SiteMinder, 186
amélioration des performances, 253 espace-noms Active Directory, 170
configuration de clients de base de données, 78 espace-noms LDAP, 182
configuration de variables d'environnement sous UNIX, espace-noms NTLM, 187
79 espace-noms SAP, 189
connectivité à la base de données, 60 pour le portail Plumtree à l'aide de l'authentification
création, 75 HTTP de base, 163
création de connexions à une source de données, 93, 107 pour le portail Plumtree à l'aide de SiteMinder, 164
DB2, 77 pour le portail WebSphere à l'aide du serveur d'applica-
définition, 261 tion, 163
description des composants, 13 utilisation de l'espace-noms Cognos Series 7, 172
Microsoft SQL Server, 75 utilisation du secret partagé avec Portal Services, 157
mise à niveau, 39, 94, 108 Cognos
Oracle, 76 exemples, 213
pilotes JDBC, 78 Cognos 8
bibliothèque de données, Voir bibliothèque d'indicateurs changement des serveurs d'application, 191
blocage des incrustations, 248 composants, 11
BMTScriptPlayer configuration, 89
disponibilité sous Linux, 60 configuration système requise, 57
dépannage des installations, 237
C déploiement, 198
désinstallation, 68
CA Voir autorité de certification exécution sur le même ordinateur que ReportNet, 53
calendriers flux de travail, 33
mise à niveau de calendriers personnalisés Metrics Mana- installation, 60
ger, 53 options d'installation, 15
CAM-CRP-1315, 254 paramètres implicites, 57
caractères non pris en charge, 241 partage des composants d'un même ordinateur, 19
catalogues et rapports Impromptu Cognos Application Firewall
migration vers Cognos 8, 27 configuration, 119
certificats Cognos Configuration
définition, 261 description des composants, 12
chaînes de connexion à la base de données erreur de police non trouvée sous UNIX, 256
IBM DB2, 90, 98 impossible de démarrer, 254
Microsoft SQL Server, 90, 98 message de mise à niveau, 250
Oracle, 90, 98 mode sans surveillance, 227
changement paramètres non valides, 241
passerelle Cognos 8, 137 problèmes d'enregistrement d'une configuration, 251
version Java, 206 problèmes d'ouverture, 238
chemins d'accès problèmes de navigation à l'aide du clavier, 254
268
Index
Cognos Connection Cognos Configuration, 12

description des composants, 11 Cognos Connection, 11
ouverture impossible, 246 Cognos Office Connection, 12
Cognos Contributor composants d'application, 17, 18
accès aux cubes depuis Cognos 8, 14 Composite Information Server, 12
Cognos Controller Content Manager, 12, 18, 24, 60
accès aux données dans Cognos 8, 28 Event Studio, 12
Cognos Finance Framework Manager, 13
accès aux cubes depuis Cognos 8, 14 installation, 60
accès aux données dans Cognos 8, 28 installation sur un même ordinateur, 15
Cognos Metrics Manager Map Manager, 13
mise à niveau vers Cognos 8, 26, 38 Metric Designer, 13
Cognos NoticeCast Metric Studio, 12
duplication des fonctions dans Cognos 8, 29 passerelles, 12, 16, 60
Cognos Office Connection Query Studio, 11
ajouter la fonction .NET Framework aux composants répartition de Metric Designer, 24
Microsoft Office, 150 Report Studio, 11
configuration, 143 serveur de rapports, 60
configuration des propriétés personnalisées dans Micro- sources de données, 13
soft Excel, 146 tiers, 11
configuration des propriétés personnalisées dans Micro- Transformer, 13
soft PowerPoint, 146 visualiseur Cognos, 11
configuration des propriétés personnalisées dans Micro- composants d'application
soft Word, 146 configuration, 104
configuration des types MIME pour votre serveur Web, configuration requise, 18, 23
144 installation sur un ordinateur séparé, 17
configuration du type de contenu pour votre serveur Web, installation sur un ordinateur séparé des composants de
144 création de tableaux de bord de Cognos 8, 23
déploiement des composants client, 148 composants de création de tableaux de bord de Cognos 8
désactivation pour les utilisateurs du supplément COM, installation d'une passerelle sur un ordinateur séparé, 22
152 installation des composants d'application sur un ordina-
description des composants, 12 teur séparé, 23
erreur lors de l'exécution de rapports, 256 installation sur un même ordinateur, 21
installation de .Net Framework pour les clients, 150 composants de modélisation, 12
mise à niveau des documents, 54 composants du serveur, 11
modèles, 143 composants tiers, 13
niveau de sécurité des macros pour Microsoft Office XP, composants tiers de l'application
152 définition, 261
répertoires virtuels, 144 Composite Information Server
SSL, 145 description des composants, 12
test de l'installation des composants client, 153 configuration
utilisation des rapports PowerPlay, 146 ajout de ressources, 230
Cognos Planning - Analyst apache_mod pour la passerelle, 109
accès aux données dans Cognos 8, 28 automatisation, 225
Cognos Planning - Contributor Cognos 8, 89
accès aux données dans Cognos 8, 28 Cognos 8 pour des serveurs d'application, 196
activation des rapports et agents programmés, 141 Cognos 8 pour fonctionner avec d'autres produits de
migration vers Cognos 8, 27 Cognos, 141
Cognos Query Cognos Office Connection, 143
duplication des fonctions dans Cognos 8, 28 composants d'application, 104
Cognos Series 7 configuration requise pour Metric Designer, 26
activation du code d'accès unique, 172 Content Manager, 18, 24
activation du protocole SSL, 172 destination des messages de journalisation, 128
migration vers Cognos 8, 27 données verrouillées, 254
modules d'extension Trusted Signon, 173 échec d'enregistrement, 255
utilisation pour authentification, 171 emplacement des fichiers temporaires, 120
Cognos Visualizer en mode silencieux pour la mise à niveau, 49
duplication des fonctions dans Cognos 8, 29 erreur de chiffrement des informations, 253
composants, 11 espace-noms Active Directory, 167
Analysis Studio, 11 espace-noms LDAP, 176
base de données Content Store, 13 espace-noms LDAP pour Active Directory Server, 177
bibliothèque d'indicateurs, 13 espace-noms LDAP pour IBM Directory Server, 179

Index
espace-noms NTLM, 186 configurations en mode silencieux Voir configurations sans

espace-noms SAP, 188 surveillance
espace-noms SiteMinder, 184 configurations sans surveillance
exécution à partir de la ligne de commande, 234 mise à niveau, 49
exécution de plusieurs versions de Cognos 8, 53 configurer
exemples, 213 sans surveillance, 227
fichiers de spécification de transfert (.ats), 225 connectivité à la base de données
flux de travail, 31 base de données Content Store, 59
fournisseurs d'authentification personnalisés, 175 bibliothèque d'indicateurs, 60
Framework Manager, 19, 109 bibliothèque de rapports, 59
Framework Manager sur un autre ordinateur, 109 bibliothèque de requêtes, 59
fuseau horaire implicite, 136 connexion anonyme
graphiques de type Carte de Report Studio, 124 désactivation, 166
impossible de chiffrer les informations cryptographiques, désactivation pour Portal Services, 156
253 connexion unique
installations réparties, 96 activation de l'accès aux documents Cognos Office Con-
installations sur un seul ordinateur, 90 nection basés sur des rapports PowerPlay, 146
ISAPI pour la passerelle, 109 Active Directory Server, 257
manuelle, 229 connexions
message de mise à niveau, 250 connexions à la source de données, 215
Metric Designer, 112 définition, 261
modification des paramètres implicites, 115 connexions à la base de données Voir connexions à la source
modification du modèle, 121 de données
navigateurs Web, 83 connexions à la source de données
observations concernant la mise à niveau, 39, 45 bibliothèques d'indicateurs, 93, 107
options avancées, 205 définition, 90, 98
ordinateur Content Manager en attente, 102 Content Manager
ordinateurs Content Manager, 98 actif par défaut, 98
paramètres de Cognos 8, 63, 115 composant, 18, 24
paramètres de Tomcat, 63 configuration, 18, 24, 98
paramètres globaux, 131 configuration d'une base de données Content Store, 71
paramètres implicites, 115 configuration sur plusieurs ordinateurs, 102
paramètres non appliqués, 256 critères pour le changement de serveur d'application, 192
passerelles, 106 définition, 262
pilotes JDBC, 78 description des composants, 12
polices, 122 en attente, 18, 24
Portal Services, 155 installation, 60
propriétés de l'environnement pour les composants modification des fuseaux horaires, 136
d'application, 105 observations concernant la mise à niveau, 39
propriétés du serveur d'application, 198 options d'installation, 18, 24
propriétés en configuration sans surveillance, 232 protection de reprise, 18, 24
protocoles SSL, 124 tentative d'inscription du distributeur, 245
routeurs, 85 Content Store
sans surveillance, 225, 227 définition, 262
sauvegarde, 193, 206 erreur d'initialisation dans Oracle, 257
sécurité partagée avec d'autres serveurs, 126 pilotes JDBC, 78
serveur de messagerie, 92, 101, 104 suppression de tables dans une base de données, 251
serveur Web, 81 Content Store Oracle
service Cognos 8, 121 erreur d'initialisation, 257
service d'autorité de certification, 208 niveaux de compatibilité, 257
servlets pour la passerelle, 109 copyright, 2
spécifications relatives au code d'accès unique avec Micro- coréen
soft Analysis Server ou Microsoft SQL Server, 167 les caractères s'affichent de façon incorrecte après la mise
tâches requises, 90, 96 à niveau, 251
test, 95, 113 courriers électroniques
configuration sans surveillance modification de l'encodage, 136
configuration, 225 création
modification des propriétés, 232 base de données Content Store, 57
configuration système requise, 57 bibliothèque d'indicateurs, 75
Framework Manager, 64 connexions de la source de données à la bibliothèque
Metric Designer, 66 d'indicateurs, 93, 107
pack d'indicateurs, 93, 107
270
Index
création de tableaux de bord Cognos 8 exemples de Cognos, 213

installation d'une passerelle sur un ordinateur séparé, 22 verrouillées par Cognos Configuration, 254
installation des composants sur un même ordinateur, 21 droits d'accès
répartition des composants, 21 définition, 262
création de tableaux de bord Cognos 8
installation des composants d'application sur un ordina- E
teur séparé, 23
cube MS, 246 échec du script de démarrage, 249
cubes échec du téléchargement de ressources, 245
accès dans Cognos 8, 14 emplacement des fichiers temporaires
ouverture impossible, 246 configuration, 120
cubes Cognos propriétés, 120
accès dans Cognos 8, 28 emplacements
graphiques de type Carte, 124
encodage de caractères non pris en charge, 241
D environnements
date d'expiration du contenu pris en charge, 60
répertoire d'images, 81 environnements de démonstration, 90, 109
DB2, 246 environnements pris en charge, 60
base de données Content Store, 73 équilibrage de charge, 89
bibliothèque d'indicateurs, 77 activation et désactivation de services, 120
configuration de pilotes JDBC, 129 configuration des paramètres de serveur de messagerie, 92,
connectivité à la base de données, 59, 60 101, 104
pages de codes, 85 définition, 17, 23
pilotes JDBC, 78 erreur CFG-ERR-0106, 239
variables d'environnement, 73 erreur cryptographique, 255
DecisionStream vers Cognos 8 erreur de contexte, 249
observations concernant la mise à niveau, 26 erreur de page non trouvée
définition démarrage de Cognos 8 sous Windows 2003, 246
connexions à la source de données, 90 erreur de répertoire introuvable, 246
demandes de signature de certificat erreur de serveur HTTP 500, 257
création, 209 erreur DPR-ERR-2022, 248
démarrage erreur DPR-ERR-2058, 246
échec du téléchargement de cognos.xts, 248 erreur du délai d'attente CGI, 257
échec du téléchargement des ressources, 245 erreur HTTP 404, 246
erreur SQL1224N retournée par DB2 en cas de connexion erreur Java lors du démarrage de la configuration, 255
depuis AIX, 245 espace-noms
impossible d'ouvrir Cognos Connection, 246 nouvelle création, 255
impossible de démarrer le service, 240 espace-noms
page non trouvée, 246 connexion impossible, 244
problèmes, 239 espace-noms de Cognos
Report Studio ne démarre pas, 248 nouvelle création, 255
service Cognos 8, 256 espaces-noms
dépannage, 237 définition, 262
déploiement de Cognos 8, 198 espaces-noms
désactivation authentification, 165
accès anonyme, 156 configuration de fournisseurs d'authentification personna-
travail de mise à jour du contenu, 221 lisés, 175
désinstallation configuration pour une passerelle, 120
Cognos 8, 68 suppression, 190
Framework Manager, 68 test, 189
Metric Designer, 68 Essbase, 246
Metrics Manager, 50 Event Studio
désinstallation du service ReportNet, 250 description des composants, 12
distributeur rétablissement de la base de données à son état d'origine,
annuler l'inscription, 202 223
échec du démarrage sur l'ordinateur des composants Excel
d'application, 258 non-fonctionnement du type de rapport multipage, 249
domaines exemples
arborescences de domaines d'Active Directory Server, 169 connexions à la source de données, 215
configuration pour les témoins (cookies), 136 Cube DB2, 216
données cube MSAS, 216

Index
Event Studio, 222 définition, 262

Metric Designer, 213 fournisseurs d'authentification personnalisés, 175
Metric Studio, 218 fournisseurs de sécurité
exemples (Cognos) copie des fichiers nécessaires dans un emplacement JVM,
configuration, 213 207
modèles, 222 définition, 262
suppression, 224 Framework Manager
exportation accès à Cognos 8 hors d'un pare-feu, 109
fichiers de configuration, 227 configuration, 19, 109
configuration des systèmes de contrôle de la source, 110
F configuration sur un autre ordinateur, 109
configuration système requise, 64
fichier .jar description des composants, 13
erreur lors du démarrage de la configuration, 255 désinstallation, 68
fichier apache_mod exemples de modèles, 222
configuration pour les passerelles, 109 installation, 64
fichier cogstartup.lock, 238 observations concernant la mise à niveau, 39
fichier cogstartup.xml, 230, 234 options d'installation, 19
fichier non valide, 255 test de l'installation et de la configuration, 96, 114
modification manuelle des propriétés, 232 fuseaux horaires
fichier cogstartup.xml non valide, 255 modification, 136
fichier de mise à niveau de ReportNet à Cognos 8, 239 fuseaux horaires du serveur
fichier de verrouillage de configuration, 238 modification, 136
fichier de verrouillage de configuration de démarrage, 238
fichier non trouvé, 246
fichier p2pd.war pour WebLogic, 249 G
fichier response.ats, 225 glyphes
fichiers chase_referral, 169 définition, 262
fichiers d'archive Java, Voir fichier jar graphiques de type Carte, 124
fichiers d'archives Enterprise groupes
déploiement de Cognos 8, 234 définition, 262
fichiers d'archives Web
déploiement de Cognos 8, 234 H
fichiers de configuration
applications.xml pour Cognos Portal Services, 155 HTTPS
coglocale.xml, 232 définition, 263
cogstartup.xml, 230
exportation, 227 I
fichiers de réponses IBM DB2
définition, 262 création de chaînes de connexion, 90, 98
fichiers de spécification de transfert (.ats) IBM Directory Server
configuration, 225 authentification LDAP, 179
fichiers des fournisseurs de sécurité IBM WebSphere, 191
copie dans l'environnement JVM du serveur d'application, images
195 chargement dans Report Studio, 81
fichiers EAR Voir fichiers d'archives Enterprise date d'expiration du contenu, 81
fichiers journaux, 237 impossible d'ouvrir Cognos Configuration, 238
configuration de démarrage, 238 impossible de chiffrer les informations cryptographiques, 253
configuration des paramètres régionaux, 238 index, 14
désinstallation, 239 indicateur de sécurité
exécution, 238 paramètre de témoins (cookies), 136
mode silencieux, 239 installation
récapitulatif des transferts, 238 Cognos 8, 57, 60, 225
transfert, 237 flux de travail, 31
fichiers WAR Voir fichiers d'archives Web Framework Manager, 64
Firefox liste contrôle, 57
paramètres du navigateur, 83 Metric Designer, 66
flux de travail options de Content Manager, 18, 24
installation et configuration, 31 options de Framework Manager, 19
fonction SaferAPIGetTrustedSignon problèmes, 239
utilisation pour l'authentification, 173 sans surveillance, 225
fournisseurs d'authentification test, 95, 113
272
Index
installation sans surveillance configuration, 130

configuration, 225 serveurs de journalisation distants, 128
installation sur un seul ordinateur utilisation des fichiers, 129
configuration, 90 journaux des événements, 129
flux de travail d'installation et de configuration, 32, 34, 35 JRE
installations en mode silencieux Voir installations sans sur- mise à jour, 81
veillance JVM
installations réparties changement, 193, 206
configuration, 96 copie des fichiers de fournisseur de sécurité, 195
configuration de Framework Manager, 109
flux de travail d'installation et de configuration, 33, 34, 36 L
Metric Designer, 24
scénarios, 15, 21 langue du produit
installer définition, 263
installation sans surveillance, 225 langues
utilisation d'un fichier de spécification de transfert (.ats), incompatibilité après la mise à niveau, 251
225 personnalisation de la prise en charge des paramètres
utilisation des fichiers de spécification de transfert (.ats), régionaux du contenu, 133
225 personnalisation pour l'interface utilisateur, 132
interface tables de conversion, 251
personnalisation de la prise en charge linguistique, 132 langues du produit
interface de passerelle commune (CGI) mise en correspondance pour l'interface utilisateur, 135
définition, 263 LDAP
remplacement, 137 activation du code d'accès unique, 182
interface utilisateur activation du protocole SSL, 182
mise en correspondance pour la langue du produit, 135 Active Directory Server, 177
personnalisation de la prise en charge linguistique, 132 configuration d'un espace-noms, 176
Internet Explorer IBM Directory Server, 179
paramètres du navigateur, 83 modification de la propriété Correspondance des identités
invites externes, 183
définition, 263 Novell Directory Server, 180
ISAPI propriétés personnalisées, 182
accès à Cognos 8, 137 utilisation pour authentification, 175
configuration pour la passerelle, 109 Linux
utilisation pour une passerelle, 257 configuration système requise, 57
fonctions et composants non pris en charge, 60
messages de journalisation, 129
J
japonais M
les caractères s'affichent de façon incorrecte après la mise
à niveau, 251 machines virtuelles, 205
Java Map Manager
changement de version, 206 description des composants, 13
configuration d'une passerelle de type servlet pour des ser- messages d'erreur
veurs Web compatibles Java, 139 CAM-CRP-1064, 244
mise à jour des environnements JRE, 81 CAM-CRP-1315, 254
types de machine virtuelle, 205 CFG-ERR-0106, 239
JAVA_HOME CM-CFG-029, 256
définition, 255 Délai d'attente CGI, 257
JDBC, 78 demande incorrecte, 250
base de données Content Store, 59 DPR-ERR-2002, 248
bases de données Oracle, 78 DPR-ERR-2058, 245, 246
bibliothèque d'indicateurs, 60 Échec du chargement de la classe de servlets sur le serveur
connectivité à la base de données Content Store, 59 WebLogic, 258
DB2, 78 échec du téléchargement des ressources spécifiées, 245
journal des événements Windows Erreur HTTP 404, 246
destination des messages de journalisation, 129 HTTP 500 sous Oracle, 257
journal système impossible de chiffrer des informations cryptographiques,
destination des messages de journalisation, 129 253
journalisation, 128 impossible de désérialiser l'attribut contextuel, 249
base de données, 129 informations cryptographiques altérées, 255
client de base de données, 129 Java Runtime Environment, 255
page non trouvée, 246

Index
PRS-CSE-1255, 244 incidence sur les caractères chinois, japonais ou coréens,

SoapSocketException, 245 251
SQL1224N, 245 message dans Cognos Configuration, 250
vous avez choisi de télécharger un fichier, 248 Metrics Manager, 50
messages de journalisation Metrics Manager et informations de sécurité, 50
activation pour Cognos Application Firewall, 119 projets Metric Designer, 39, 113
Metric Designer ReportNet, 38
configuration, 112 ReportNet vers Cognos 8, 45
configuration système requise, 26, 66 utilisation de la configuration silencieuse, 49
description des composants, 13 mode sans surveillance, 225
désinstallation, 68 mode silencieux Voir mode sans surveillance
installation, 66 modèle
mise à niveau de projets, 39 modification de la taille du modèle, 121
répartition des composants, 24 modèles
test de l'installation et de la configuration, 96, 115 exemples de bases de données, 222
Metric Studio modification pour les exemples, 220
création d'un pack d'indicateurs, 93 modèles Architect
description des composants, 12 migration vers Cognos 8, 27
flux de travail d'installation et de configuration, 35 modification
Metrics Manager encodage des courriers électroniques, 136
désinstallation, 50 exemples de modèles, 220
mise à niveau, 50 modèle de configuration, 121
mise à niveau de calendriers personnalisés, 53 paramètres de configuration implicites, 115
mise à niveau des informations de sécurité, 50 type de JVM, 205
Microsoft .NET Framework, 148 URI, 115
installation pour les clients Cognos Office Connection, monnaie
150 personnalisation de la prise en charge, 132
Microsoft Active Directory Server, 257 mots de passe
Microsoft Analysis Server modification en configuration sans surveillance, 232
spécifications relatives aux espaces-noms, 167 MSAS, 246
Microsoft Excel multi_domain_tree, 169
configuration des propriétés personnalisées pour Cognos
Office Connection, 146 N
Microsoft Office Excel
non-fonctionnement du type de rapport multipage, 249 navigateurs Web
Microsoft PowerPoint configuration, 83
configuration des propriétés personnalisées pour Cognos erreurs au démarrage du portail Web, 246, 248
Office Connection, 146 paramètres de sécurité, 57
Microsoft SQL Server Netscape
base de données Content Store, 72 paramètres du navigateur, 83
bibliothèque d'indicateurs, 75 nouvelle création de l'espace-noms de Cognos, 255
connectivité à la base de données, 59, 60 Novell Directory Server
création de chaînes de connexion, 90, 98 espace-noms LDAP, 180
spécifications relatives aux espaces-noms, 167 NTLM, 186
Microsoft Word activation du code d'accès unique, 187
configuration des propriétés personnalisées pour Cognos configuration, 186
Office Connection, 146 NTLM Voir également sécurité native Windows (NTLM)
migration
à partir d'autres produits de Cognos vers Cognos 8, 27, 37 O
mise à jour Oracle
environnement java, 81 base de données Content Store, 73
mise à niveau bibliothèque d'indicateurs, 76
à partir d'autres produits de Cognos vers Cognos 8, 26 connectivité à la base de données, 59, 60
à partir de Metrics Manager, 37 création de chaînes de connexion, 90, 98
à partir de ReportNet, 37 pilotes JDBC, 78
à partir de Series 7, 37 pilotes JDBC de base de données, 129
bibliothèque d'indicateurs, 39, 94, 108 prise en charge multilingue, 85
Cognos 8 sur un serveur d'application, 203 serveur d'application, 201
Cognos 8, 39 variables d'environnement, 73
Content Store, 245 variables d'environnement de la bibliothèque d'indicateurs
impossible de désinstaller le service ReportNet, 250 sous UNIX, 79
ordinateur Content Manager en attente, 18, 24
274
Index
configuration, 102 code d'accès unique à l'aide deSiteMinder, 164

Portal Services, 155
P désactivation de la connexion anonyme dans Cognos 8,
156
packs d'indicateurs disponibilité sous Linux, 60
création, 93, 107 indication du fichier applications.xml, 155
définition, 263 portlets
pages de codes des sources de données, 85 définition, 264
panne de réseau ports
échec du démarrage des services, 244 exécution de plusieurs versions de Cognos 8, 53
paramètres non valides modification, 115
base de données Content Store, 241 paramètres de configuration implicites, 63
Cognos Configuration, 241 ports déjà utilisés, 240
paramètres régionaux PowerPlay
définition, 263 accès aux index et classeurs depuis Cognos 8, 14
paramètres régionaux de l'utilisateur activation de l'accès anonyme pour Cognos Office Con-
mise en correspondance avec les paramètres régionaux du nection, 146
contenu, 133 PowerPlay Web vers Cognos 8
paramètres régionaux du contenu observations concernant la mise à niveau, 26
mise en correspondance avec les paramètres régionaux de problèmes d'ouverture de Cognos Configuration, 238
l'utilisateur, 133 problèmes de configuration, 251
personnalisation, 133 problèmes de portail
pare-feu ouverture impossible, 246
observations concernant l'installation, 19, 25 programmes de correction de découpage
pare-feu serveurs d'application, 192
accès entre Framework Manager et Cognos 8, 109 projets
passeports mise à niveau des projets de Metrics Designer, 39, 113
définition, 263 propriété CognosGateway
passerelle pour Cognos Office Connection dans Microsoft Power-
paramètres recommandés pour Microsoft IIS, 257 Point, 146
utilisation d'ISAPI, 257 propriété Correspondance des identités externes
passerelle servlet modification pour un espace-noms LDAP, 183
configuration, 139 propriétés
passerelles configuration pour serveur d'application, 198
configuration, 106 emplacement des fichiers temporaires, 120
configuration d'apache_mod, 109 modification en configuration sans surveillance, 232
configuration d'un servlet, 109 propriétés d'utilisateur personnalisées
configuration ISAPI, 109 Active Directory Server, 168
configuration pour Cognos 8, 137 LDAP, 182
configuration pour l'utilisation d'un espace-noms, 120 protection de reprise, 18, 24
configuration requise, 17, 23 protocole SOAP (simple object access protocol)
définition, 264 définition, 264
description des composants, 12 protocoles SSL
installation, 60 configuration, 124
installation sur un ordinateur distinct, 16 pseudonymes
installation sur un ordinateur séparé des composants de configuration sur Apache Web Server, 137
création de tableaux de bord de Cognos 8, 22 configuration sur des serveurs Web, 81
passerelles Apache définition, 264
configuration, 137
pilotes JDBC
configuration de bases de données DB2, 129 Q
configuration de bases de données Oracle, 129 qualité de la protection dans le cadre de connexions SSL, 127
polices Query Studio
configuration, 122 description des composants, 11
modification des paramètres implicites, 123
modification pour les rapports PDF, 123 R
non trouvées au démarrage de Cognos Configuration, 256
portail rapports
erreurs au démarrage, 246, 248 modification de la police implicite, 123
portail Plumtree personnalisation de la prise en charge linguistique, 133
code d'accès unique à l'aide de l'authentification HTTP de rapports Impromptu Web Reports
base, 163 migration vers Cognos 8, 28
rapports PowerPlay Web

Index
migration vers Cognos 8, 27 composants, 14

références d'identification Series 7
définition, 264 mise à niveau vers Cognos 8, 37
références d'identification de l'utilisateur serveur Cognos BI
modification en configuration sans surveillance, 232 serveur non disponible, 241
répertoires virtuels serveur d'application Oracle, 191
Cognos 8, 81 erreur de serveur HTTP 500, 257
Cognos Office Connection, 144 serveur de messagerie
Report Studio configuration, 92, 101, 104
chargement d'images, 81 serveur Web iPlanet Voir serveur Web Sun Java System
description des composants, 11 serveur Web Java System
modification de l'emplacement des graphiques de type configuration des alias, 81
Carte, 124 serveur Web Sun Java System
ne démarre pas, 248 passerelle servlet, 139
ReportNet serveur Web Sun ONE Voir serveur Web Sun Java System
exécution sur le même ordinateur que Cognos 8, 53 serveurs d'application
mise à niveau, 26, 38 changement de la configuration implicite, 191
mise à niveau vers Cognos 8, 38 code d'accès unique pour le portail WebSphere, 163
ressources configuration, 198
ajout, 230 échec du chargement de la classe de servlets dans WebLo-
routeurs gic, 258
configuration, 85 échec du script de démarrage, 249
mise à niveau de Cognos 8, 203
S passerelles du servlet, 139
scripts de démarrage, 197
SAP scripts de démarrage pour le serveur d'application Oracle,
activation du code d'accès unique, 189 201
serveur d'application, 191, 200 serveurs de journalisation distants, 128
utilisation pour authentification, 187 configuration, 130
SAP BW serveurs de rapports
connectivité, 188 installation, 60
paramètres d'autorisation pour les administrateurs de serveurs Web, 19, 25
Cognos 8, 188 activation SSL, 82
paramètres d'autorisation pour les utilisateurs de code d'accès unique utilisant Active Directory et le serveur
Cognos 8, 187 Web IIS, 170
sauvegarde configuration, 81
informations Cognos 8, 193, 206 définition du temps de chargement de Report Studio, 81
scintillement, 259 passerelles du servlet, 139
scintillement de l'écran, 259 types MIME pour Cognos Office Connection, 144
scripts serveurs Web Apache
pour améliorer les performances de la bibliothèque d'indi- configuration en tant que passerelle, 137
cateurs, 253 serveurs Web IIS
suppression de tables dans des bases de données, 251 code d'accès unique utilisant Active Directory, 170
scripts de démarrage connexion unique pour les documents Cognos Office Con-
serveurs d'application nection basés sur des rapports PowerPlay, 146
scripts Java serveurs Web Windows IIS
activation dans les navigateurs Web, 83 paramètres de la passerelle recommandés, 257
secret partagé service Cognos 8
code d'accès unique pour Portal Services, 157 configuration, 121
Secure Socket Layer Voir protocole SSL service Cognos 8
sécurité démarrage, 256
activation pour Microsoft .NET Framework, 151 service ReportNet, 250
mise à niveau de Metrics Manager, 50 services
paramètres des navigateurs Web, 57 activation et désactivation, 120
sécurité native Windows (NTLM) désinstallation, 68
activation du code d'accès unique, 187 échec du démarrage après une panne de réseau, 244
utilisation pour authentification, 186 impossible de démarrer, 240
sécurité partagée SiteMinder
configuration entre Cognos 8 et d'autres serveurs, 126 activation du code d'accès unique, 186
séquences d'assemblage code d'accès unique pour le portail Plumtree, 164
sensibilité à la casse, 241 configuration d'espaces-noms, 184
Series 7 SSL, 185
276
Index
utilisation pour authentification, 183 définition, 264

vérification de scripts intersites dans Cognos Application types MIME
Firewall, 119 pour Cognos Office Connection, 144
SiteMinder de Netegrity
activation du code d'accès unique, 186 U
protection de l'alias Web de Cognos 8, 186
utilisation pour authentification, 183 UDB Voir DB2
vérification de scripts intersites dans Cognos Application UNIX
Firewall, 119 configuration de variables d'environnement pour la biblio-
source OLAP, 246 thèque d'indicateurs, 79
sources de données configuration système requise, 57
définition, 264 erreur de police non trouvée, 256
description des composants, 13 messages de journalisation, 129
exemples de connexions, 215 Upfront
spécifications de rapport accès à des rapports et cubes depuis Cognos 8, 14
définition, 264 migration de contenu vers Cognos 8, 27
SSL URI
activation pour serveur d'application, 202 modification, 115
activation sur les serveurs Web, 82 paramètres de configuration implicites, 63
Active Directory Server, 169 URI de Content Manager, 102, 105
annuaire d'utilisateurs de SiteMinder, 185 UTF-8
configuration de la sécurité partagée avec d'autres ser- encodage pour les courriers électroniques, 136
veurs, 126 utilisateurs
configuration pour Cognos Office Connection, 145 définition, 264
espace-noms LDAP, 182
qualité de la protection, 127 V
utilisation de l'espace-noms Cognos Series 7, 172 Vacances et aventure Voir exemples de Cognos
suppression variables d'environnement
exemples de Cognos, 224 base de données Content Store, 71
Sybase configuration pour les composants d'application, 105
pilotes de base de données, 79 configuration pour Metric Designer, 112
Sybase Adaptive Server Enterprise configuration pour serveurs d'application, 194
base de données Content Store, 75 configuration sous UNIX pour la bibliothèque d'indica-
systèmes de contrôle de la source teurs, 79
configuration de Framework Manager, 110 DB2, 73
Oracle, 73
T vérification de scripts intersites
tables configuration dans Cognos Application Firewall, 119
suppression dans une base de données, 251 Version du document, 2
tâches versions
définition, 264 mises à niveau ReportNet prises en charge, 38
tâches requises visualiseur Cognos
configuration, 90, 96 description des composants, 11
témoins (cookies)
activation dans les navigateurs Web, 83 W
paramètres, 136 WebLogic
personnalisation, 136 déploiement du fichier p2pd.war, 250
témoins (cookies) HTML Voir Témoins (cookies) échec du chargement de la classe de servlets, 258
test échec du script de démarrage, 249
configuration, 95, 113 impossible de désérialiser l'attribut contextuel, 249
installation, 95, 113 script de démarrage, 197
installation de Cognos Office Connection, 153 serveur d'application, 199
Tomcat WebSphere
paramètres de configuration implicites, 63 code d'accès unique à l'aide du serveur d'application, 163
touche de tabulation échec du script de démarrage, 249
problèmes dans Cognos Configuration, 254 serveur d'application, 198
Transformer Windows
accès aux cubes Cognos, 14 configuration système requise, 57
accès aux données dans Cognos 8, 28 Windows IIS
description des composants, 13 paramètres de la passerelle recommandés, 257
travaux

Index
X
XML (extensible markup language)
définition, 265
278

Inst CR Winux

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Inst CR Winux

Hochgeladen von

Copyright:

Verfügbare Formate

Cognos(R) 8 Business Intelligence

Cognos(R) 8 Business Intelligence - Lisezmoi

GUIDE D'INSTALLATION ET DE CONFIGURATION

Guide d'installation et de configuration 3

Guide d'installation et de configuration 5

Guide d'installation et de configuration 7

Ce guide contient des instructions d'installation, de mise à niveau, de configuration et de test de

Cognos 8 - Guide de dépannage Aide les administrateurs à rapidement identifier et résoudre

Cognos Configuration - Guide de Utilisation de Cognos Configuration pour configurer Cognos

Cognos 8 Architecture and Planification de l'architecture de Cognos 8, développement

Metric Studio - Guide de Suivi des indicateurs d'un tableau de bord

Guide d'installation et de configuration 9

Cognos 8 and Composite Installation, configuration et utilisation du module

Guide d'installation et de configuration 11

Cognos Office Connection

Composite Information Server

Guide d'installation et de configuration 13

Cognos 8 avec des applications Cognos Series 7

Cognos Series 7 Upfront

PowerPlay Cognos Series 7

Répartition des composants de création de rapports de

Installation de tous les composants sur un même ordinateur

Guide d'installation et de configuration 15

Installation des passerelles sur différents ordinateurs

Installation des composants d'application et des applications Content Manager

Guide d'installation et de configuration 17

Installation de plusieurs applications Content Manager

Installation des produits de Cognos 8 sur le même ordinateur

Répartition des composants de Framework Manager

Serveurs Web autres que Microsoft IIS

Observations concernant le pare-feu

Guide d'installation et de configuration 19

Répartition des composants de création de tableaux de bord

Installation de tous les composants sur un même ordinateur

Guide d'installation et de configuration 21

Installation des passerelles sur différents ordinateurs

Installation des composants d'application et des applications Content Manager

Guide d'installation et de configuration 23

• configurer les propriétés cryptographiques,

Installation de plusieurs applications Content Manager

Installation des produits de Cognos 8 sur le même ordinateur

Répartition des composants de Metric Designer

Serveurs Web autres que Microsoft IIS

Observations concernant le pare-feu

Guide d'installation et de configuration 25

Cognos 8 avec d'autres produits de Cognos

Produits de Cognos pouvant être mis à niveau vers Cognos 8

Cognos Metrics Manager

Cognos PowerPlay Web

Produits Cognos Series 7 pouvant migrer vers Cognos 8

Guide d'installation et de configuration 27

Rapports Impromptu Web Reports

Produits de Cognos fonctionnant avec Cognos 8

Cognos Planning - Analyst

Cognos Planning - Contributor

Contenu Cognos Series 7 pouvant être créé à nouveau dans Cognos 8

Guide d'installation et de configuration 29

Installation de Cognos 8 avec Metric Studio

Guide d'installation et de configuration 31

Installation sur un seul ordinateur

Installation de Cognos 8 sans Metric Studio

Guide d'installation et de configuration 33

Installation sur un seul ordinateur