Vous êtes sur la page 1sur 278

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

Guide d'installation et de configuration 5


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

Guide d'installation et de configuration 7


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

Guide d'installation et de configuration 9


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.

Guide d'installation et de configuration 11


Chapitre 1 : Composants utilisés par Cognos 8

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
Chapitre 1 : Composants utilisés par Cognos 8

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.

Guide d'installation et de configuration 13


Chapitre 1 : Composants utilisés par Cognos 8

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.

Guide d'installation et de configuration 15


Chapitre 2 : Options de répartition de Cognos 8

É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
Chapitre 2 : Options de répartition 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.
,QVWDOODWLRQGH
6HUYHXU:HE 6HUYHXU:HE SOXVLHXUVSDVVHUHOOHV
3DVVHUHOOH 3DVVHUHOOH

&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU

%DVHGHGRQQpHV %DVHVGHGRQQpHV
&RQWHQW6WRUH GHUHTXrWHV

Configuration requise
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 votre serveur Web pour afficher le contenu de Cognos,
• 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.

Guide d'installation et de configuration 17


Chapitre 2 : Options de répartition de Cognos 8

,QVWDOODWLRQGHSOXVLHXUV
FRPSRVDQWVG
DSSOLFDWLRQ
)UDPHZRUN0DQDJHU

6HUYHXU:HE
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ

2UGLQDWHXUV&RQWHQW0DQDJHU
HQDWWHQWH

&RQWHQW0DQDJHU
DFWLISDUGpIDXW

%DVHGHGRQQpHV %DVHVGHGRQQpHV
&RQWHQW6WRUH GHUHTXrWHV

Configuration requise
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 :
• configurer les propriétés cryptographiques,
• 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
Chapitre 2 : Options de répartition de Cognos 8

Configuration requise
Sur chaque ordinateur sur lequel vous avez installé Content Manager, vous devez :
• configurer les propriétés cryptographiques,
• indiquer les informations de connexion à la base de données Content Store.
• définir les URI du distributeur.
• définir tous les URI de Content Manager.
• 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.

Guide d'installation et de configuration 19


Chapitre 2 : Options de répartition de Cognos 8

)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

 

Configuration requise
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
Chapitre 2 : Options de répartition de Cognos 8

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.

Guide d'installation et de configuration 21


Chapitre 2 : Options de répartition de Cognos 8

,QVWDOODWLRQGHVFRPSRVDQWVGHFUpDWLRQ
6HUYHXU:HE GHWDEOHDX[GHERUG&RJQRV
VXUXQVHXORUGLQDWHXU
3DVVHUHOOH
&RPSRVDQWVG
DSSOLFDWLRQ
&RQWHQW0DQDJHU

%DVHGHGRQQpHV %LEOLRWKqTXHV
&RQWHQW6WRUH G
LQGLFDWHXUV

Configuration requise
Si vous installez tous les composants de création de tableaux de bord 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.

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

%DVHGHGRQQpHV %LEOLRWKqTXHV
&RQWHQW6WRUH G
LQGLFDWHXUV

22
Chapitre 2 : Options de répartition de Cognos 8

Configuration requise
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 propriétés cryptographiques,
• configurer votre serveur Web pour afficher le contenu de Cognos,
• 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

%DVHGHGRQQpHV %LEOLRWKqTXHV
&RQWHQW6WRUH G
LQGLFDWHXUV

Configuration requise
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 :

Guide d'installation et de configuration 23


Chapitre 2 : Options de répartition de Cognos 8

• configurer les propriétés cryptographiques,


• définir tous les URI de Content Manager.
• définir les URI du distributeur.

Installation de plusieurs applications Content Manager


Vous pouvez installer un nombre quelconque d'installations de Content Manager, mais une seule
est 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.

Configuration requise
Sur chaque ordinateur sur lequel vous avez installé Content Manager, vous devez :
• configurer les propriétés cryptographiques,
• indiquer les informations de connexion à la base de données Content Store.
• définir les URI du distributeur.
• définir tous les URI de Content Manager.

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
Chapitre 2 : Options de répartition de Cognos 8

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.

Guide d'installation et de configuration 25


Chapitre 2 : Options de répartition de Cognos 8

SDUHIHXUpVHDX
6HUYHXU:HE
3DVVHUHOOH


SDUHIHXUpVHDX
&RPSRVDQWV
G
DSSOLFDWLRQ
0HWULF
 'HVLJQHU

 

Configuration requise
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 de la passerelle
• 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
Chapitre 2 : Options de répartition de Cognos 8

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.

Guide d'installation et de configuration 27


Chapitre 2 : Options de répartition de Cognos 8

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
Chapitre 2 : Options de répartition de Cognos 8

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.

Guide d'installation et de configuration 29


Chapitre 2 : Options de répartition 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).

Guide d'installation et de configuration 31


Chapitre 3 : Flux de travail dans Cognos 8

Installation sur un seul ordinateur


,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

,QVWDOODWLRQGH &UpDWLRQG
XQH 'pILQLWLRQGHV
&RJQRV EDVHGHGRQQpHV SURSULpWpVGHFRQQH[LRQ
&RQWHQW6WRUH  jODEDVHGHGRQQpHV
&RQWHQW6WRUH 

,QVWDOODWLRQGH &UpDWLRQG
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
Chapitre 3 : Flux de travail dans Cognos 8

Installation répartie
,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

,QVWDOODWLRQGH &UpDWLRQG
XQH &RQILJXUDWLRQ
&RJQRV EDVHGHGRQQpHV GHVRUGLQDWHXUV
VXUXQRXSOXVLHXUV &RQWHQW6WRUH  &RQWHQW0DQDJHU
RUGLQDWHXUV

,QVWDOODWLRQGH &UpDWLRQG
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).

Guide d'installation et de configuration 33


Chapitre 3 : Flux de travail dans Cognos 8

Installation sur un seul ordinateur


,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

'pILQLWLRQGHV
&UpDWLRQG
XQH
,QVWDOODWLRQGH SURSULpWpVGH
EDVHGHGRQQpHV
&RJQRV FRQQH[LRQjOD
&RQWHQW6WRUH
EDVHGHGRQQpHV
&RQWHQW6WRUH

9pULILFDWLRQ &RQILJXUDWLRQGHV
&RQILJXUDWLRQG
XQ
GHVSDUDPqWUHV FOLHQWVGHEDVH
FRPSWHGHVHUYHXU
LPSOLFLWHV GHGRQQpHV
GHPHVVDJHULH
HWG
XQHEDVH
GHGRQQpHV
GHQRWLILFDWLRQ
0LVHjMRXUGH
O
HQYLURQQHPHQW
-DYD
7HVWGHO
LQVWDOODWLRQ
HWGHOD
FRQILJXUDWLRQ
&RQILJXUDWLRQGX
VHUYHXU:HE

)LQDOLVDWLRQGH
ODFRQILJXUDWLRQ

&RQILJXUDWLRQGHV
QDYLJDWHXUV:HE

Installation répartie
,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

,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
Chapitre 3 : Flux de travail dans Cognos 8

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).

Installation sur un seul ordinateur


,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

&UpDWLRQG
XQHEDVH
,QVWDOODWLRQGH GHGRQQpHV &UpDWLRQG
XQ
0HWULF6WXGLR GHELEOLRWKqTXH SDFNG
LQGLFDWHXUV
G
LQGLFDWHXUV

9pULILFDWLRQ &RQILJXUDWLRQGHV
7HVWGHO
LQVWDOODWLRQ
GHVSDUDPqWUHV FOLHQWVGHEDVH
HWGHOD
LPSOLFLWHV GHGRQQpHV
FRQILJXUDWLRQ

'pILQLWLRQGHV
YDULDEOHV
)LQDOLVDWLRQGH
G
HQYLURQQHPHQW
ODFRQILJXUDWLRQ
GHODELEOLRWKqTXH
G
LQGLFDWHXUVVRXV
81,;

Guide d'installation et de configuration 35


Chapitre 3 : Flux de travail dans Cognos 8

Installation répartie
,QVWDOODWLRQ &RQILJXUDWLRQGHO
HQYLURQQHPHQW &RQILJXUDWLRQ

,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é.

Guide d'installation et de configuration 37


Chapitre 4 : Mise à niveau vers Cognos 8

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
Chapitre 4 : Mise à niveau vers Cognos 8

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).

Guide d'installation et de configuration 39


Chapitre 4 : Mise à niveau vers Cognos 8

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
Chapitre 4 : Mise à niveau vers Cognos 8

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 :
emplacement_c8/templates/ps
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é.

Guide d'installation et de configuration 41


Chapitre 4 : Mise à niveau vers Cognos 8

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.
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
• 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
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 nouvel emplacement, dans le même répertoire qu'il
occupait dans une version antérieure, le cas échéant.
Par exemple :
emplacement_c8/templates/ps
Si vous êtes invité à remplacer les fichiers existants, cliquez sur Oui.
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.
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 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.
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.

42
Chapitre 4 : Mise à niveau vers Cognos 8

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.
8. Démarrez 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.
9. Installez (p. 64) et configurez (p. 109) Framework Manager.
10. 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.
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.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
12. Si vous utilisez des pages créées dans ReportNet, 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é.
13. 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.
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é.

Guide d'installation et de configuration 43


Chapitre 4 : Mise à niveau vers Cognos 8

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
Chapitre 4 : Mise à niveau vers Cognos 8

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.

Guide d'installation et de configuration 45


Chapitre 4 : Mise à niveau vers Cognos 8

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.
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é :
• crnlocale.xml dans le répertoire emplacement_crn/configuration
• server.xml dans le répertoire emplacement_crn/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_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 :
emplacement_crn/templates/ps

46
Chapitre 4 : Mise à niveau vers Cognos 8

Si vous êtes invité à remplacer les fichiers existants, cliquez sur Oui.
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-
ble que les versions antérieures de ces fichiers ne soient pas compatibles avec Cognos 8.
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 ReportNet, 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.
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é :
• crnlocale.xml dans le répertoire emplacement_crn/configuration
• server.xml dans le répertoire emplacement_crn/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_crn/templates/ps
• 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.

Guide d'installation et de configuration 47


Chapitre 4 : Mise à niveau vers Cognos 8

• 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
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 nouvel emplacement, dans le même répertoire qu'il
occupait dans ReportNet, le cas échéant.
Par exemple :
emplacement_c8/templates/ps
Si vous êtes invité à remplacer les fichiers existants, cliquez sur Oui.
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.
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 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 à
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.
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.
8. Démarrez 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.
9. Installez (p. 64) et configurez (p. 109) Framework Manager.
10. 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.
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.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

48
Chapitre 4 : Mise à niveau vers Cognos 8

12. Si vous utilisez des pages créées dans ReportNet, 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é.
13. 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.
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.
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é.

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

Guide d'installation et de configuration 49


Chapitre 4 : Mise à niveau vers Cognos 8

./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
Chapitre 4 : Mise à niveau vers Cognos 8

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é.

Guide d'installation et de configuration 51


Chapitre 4 : Mise à niveau vers Cognos 8

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.
L'un des suffixes suivants peut être ajouté afin de préciser les
autorisations pour un type d'objet spécifique : metric ou .scorecard.

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
L'un des suffixes suivants peut être ajouté afin de préciser les
autorisations pour un type d'objet spécifique : metric ou .scorecard.

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.
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).

52
Chapitre 4 : Mise à niveau vers Cognos 8

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 :

Guide d'installation et de configuration 53


Chapitre 4 : Mise à niveau vers Cognos 8

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
Chapitre 4 : Mise à niveau vers Cognos 8

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-
nées Content Store.
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.

Guide d'installation et de configuration 55


Chapitre 4 : Mise à niveau vers Cognos 8

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

Guide d'installation et de configuration 57


Chapitre 5 : Installation de Cognos 8

Configuration requise Spécifications


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
• Microsoft SQL Server
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
Chapitre 5 : Installation de Cognos 8

Configuration requise Spécifications


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

Guide d'installation et de configuration 59


Chapitre 5 : Installation de Cognos 8

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
Chapitre 5 : Installation de Cognos 8

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

Guide d'installation et de configuration 61


Chapitre 5 : Installation de Cognos 8

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
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é.
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


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. 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.
Si vous installez Cognos 8 sur un ordinateur sur lequel est installé ReportNet tout en conser-
vant ce dernier actif, vous devez installer Cognos 8 dans un répertoire différent.

62
Chapitre 5 : Installation de Cognos 8

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

Guide d'installation et de configuration 63


Chapitre 5 : Installation de Cognos 8

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.

Configuration requise Spécifications


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
Chapitre 5 : Installation de Cognos 8

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.
2. Si vous procédez à l'installation dans un répertoire contenant d'autres composants de Cognos
8, arrêtez le service Cognos 8.
3. Insérez le CD de votre produit de modélisation de Cognos dans le lecteur.
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.
4. Sélectionnez la langue d'installation.
5. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers nécessaires
sur votre ordinateur.
Si vous installez Cognos 8 sur un ordinateur sur lequel est installé ReportNet tout en conser-
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.
6. 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.
7. Cliquez sur Terminer.
Utilisez le menu Démarrer de Windows pour démarrer Cognos Configuration depuis le dos-
sier des raccourcis.
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é.
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).

Guide d'installation et de configuration 65


Chapitre 5 : Installation de Cognos 8

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.

Configuration requise Spécifications


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

66
Chapitre 5 : Installation de Cognos 8

Configuration requise Spécifications


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
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. Insérez le CD de votre produit de modélisation de Cognos dans le lecteur.
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 à utiliser pour exécuter l’Assistant d'installation.
4. Suivez les instructions fournies par l'Assistant d'installation pour copier les fichiers nécessaires
sur votre ordinateur.
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.
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é.
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.

Guide d'installation et de configuration 67


Chapitre 5 : Installation de Cognos 8

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.
• Si vous n'utilisez pas X Windows, saisissez :
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
• Si vous n'utilisez pas X Windows, saisissez :
./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
Chapitre 5 : Installation de Cognos 8

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
composants de Cognos 8.
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.
3. Supprimez tous les fichiers Internet temporaires.
Pour en savoir davantage, reportez-vous à la documentation sur le navigateur Web.

Procédure pour Framework Manager


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 pour désinstaller le programme.
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.
3. Supprimez tous les fichiers Internet temporaires.
Pour en savoir davantage, reportez-vous à la documentation sur le navigateur Web.

Procédure pour Metric Designer


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 pour désinstaller le programme.
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.
3. Supprimez tous les fichiers Internet temporaires.
Pour en savoir davantage, reportez-vous à la documentation sur le navigateur Web.

Guide d'installation et de configuration 69


Chapitre 5 : Installation de Cognos 8

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 :
• Microsoft SQL Server
• 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.

Guide d'installation et de configuration 71


Chapitre 6 : Configuration de l'environnement

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
données Content Store.

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
Chapitre 6 : Configuration de l'environnement

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.
3. 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 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

Guide d'installation et de configuration 73


Chapitre 6 : Configuration de l'environnement

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.
11. Accordez, créez et annulez les droits d'accès à la base de données pour le compte utilisateur.
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
Chapitre 6 : Configuration de l'environnement

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.
8. 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 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.
9. Accordez, créez et annulez les droits d'accès à la base de données pour le compte utilisateur.
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 :

Guide d'installation et de configuration 75


Chapitre 6 : Configuration de l'environnement

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
cmm_create_db.cmd en saisissant la commande suivante :
chemin_accès_script cmm_create_db sidchemin_accèsversion_base_de_données
[utilisateur_à_créer]
Utilisez les valeurs suivantes dans la commande :

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.

3. Indiquez quel compte utilisateur sera utilisé par Metric Studio pour accéder à la base de don-
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
Chapitre 6 : Configuration de l'environnement

• 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
cmm_create_db.cmd en saisissant la commande suivante :
Sous Windows, saisissez
cmm_create_db instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd
Sous UNIX, saisissez
cmm_create_db.sh instance_bdnom_utilisateurmot_de_passenom_bd lecteurpseudonyme_bd
Utilisez les valeurs suivantes dans la commande :

Valeur 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.
2. Indiquez quel compte utilisateur sera utilisé par Metric Studio pour accéder à la base de don-
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.

Guide d'installation et de configuration 77


Chapitre 6 : Configuration de l'environnement

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.

Procédure pour Oracle


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
Chapitre 6 : Configuration de l'environnement

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).

Guide d'installation et de configuration 79


Chapitre 6 : Configuration de l'environnement

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
Chapitre 6 : Configuration de l'environnement

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.

Guide d'installation et de configuration 81


Chapitre 6 : Configuration de l'environnement

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
Chapitre 6 : Configuration de l'environnement

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
Sous Windows, saisissez
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.

Guide d'installation et de configuration 83


Chapitre 6 : Configuration de l'environnement

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
Chapitre 6 : Configuration de l'environnement

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.

Guide d'installation et de configuration 85


Chapitre 6 : Configuration de l'environnement

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

Type d'objet RFC à protéger FUGR

S_TABU_DIS Activité 03

Groupes d'autorisation &NC&

S_USER_GRP Activité 03, 05

86
Chapitre 6 : Configuration de l'environnement

Objet d'autorisation Zone Valeur


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 *


création de rapports

S_RS_COMP1 Activité *

Nom (identificateur) des *


composants de création de
rapports

Type des composants de *


création de rapports

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.

Guide d'installation et de configuration 87


Chapitre 6 : Configuration de l'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
données Content Store.
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.

Guide d'installation et de configuration 89


Chapitre 7 : Configuration de Cognos 8

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
Cognos Configuration.
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.
Utilisez la liste de contrôle suivante comme guide de configuration :
❑ 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
de données Content Store.
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
Chapitre 7 : Configuration de Cognos 8

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)))

Guide d'installation et de configuration 91


Chapitre 7 : Configuration de Cognos 8

• 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
Chapitre 7 : Configuration de Cognos 8

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.
Par exemple, une URL JDBC
jdbc:JSQLConnect://localhost\\instance1/user=sa/<autres propriétés si nécessaire>
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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).

Guide d'installation et de configuration 93


Chapitre 7 : Configuration de Cognos 8

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


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.

94
Chapitre 7 : Configuration de Cognos 8

• 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 l'option Mettre à niveau.
L'assistant met à niveau les schémas et autres informations de la base de données.
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, 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
1. Démarrez Cognos Configuration.
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.

Guide d'installation et de configuration 95


Chapitre 7 : Configuration de Cognos 8

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.

Procédure pour Framework Manager


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.

Procédure pour Metric Designer


1. Démarrez le service Cognos 8.
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
Chapitre 7 : Configuration de Cognos 8

• 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.
Utilisez la liste de contrôle suivante comme guide de configuration :
❑ 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.

Guide d'installation et de configuration 97


Chapitre 7 : Configuration de Cognos 8

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
de données Content Store.

98
Chapitre 7 : Configuration de Cognos 8

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


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 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.
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.
Par exemple, une URL JDBC
jdbc:JSQLConnect://localhost\\instance1/user=sa/<autres propriétés si nécessaire>
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
Les références d'identification pour la connexion sont immédiatement chiffrées.
5. 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 Content Store, puis cliquez sur
l'option Tester.

Guide d'installation et de configuration 99


Chapitre 7 : Configuration de Cognos 8

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.
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.

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.

100
Chapitre 7 : Configuration de Cognos 8

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 ReportNet.

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 la version précédente.

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.
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 :

Guide d'installation et de configuration 101


Chapitre 7 : Configuration de Cognos 8

• 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.
Par exemple, une URL JDBC
jdbc:JSQLConnect://localhost\\instance1/user=sa/<autres propriétés si nécessaire>
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.

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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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
Chapitre 7 : Configuration de Cognos 8

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.
• Cliquez sur le bouton OK.
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.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
9. Dans le menu Opérations, cliquez sur l'option 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é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.
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.
3. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
4. 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.
5. 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.
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.
• Cliquez sur le bouton OK.
6. Dans la fenêtre Explorateur, dans la section Sécurité, cliquez sur l'option Cryptographie.
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
Manager actif par défaut.
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.
13. Dans le menu Fichier, cliquez sur l'option Enregistrer.
14. Dans le menu Opérations, cliquez sur l'option Démarrer.

Guide d'installation et de configuration 103


Chapitre 7 : Configuration de Cognos 8

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.

Configuration des ordinateurs des composants d'application


Vous pouvez installer les composants d'application sur un ou plusieurs ordinateurs, en fonction de
votre environnement.
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


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.
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.
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 la version précédente.

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.
5. Saisissez les valeurs appropriées dans la boîte de dialogue Valeur - Compte et mot de passe,
puis cliquez sur le bouton OK.

104
Chapitre 7 : Configuration de Cognos 8

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.
Par exemple, une URL JDBC
jdbc:JSQLConnect://localhost\\instance1/user=sa/<autres propriétés si nécessaire>
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.

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
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
4. 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.
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 :
• 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.
• 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.
• Cliquez sur le bouton OK.
7. Dans la fenêtre Explorateur, dans la section Sécurité, Cryptographie, cliquez sur l'option
Cognos, fournisseur cryptographique implicite.

Guide d'installation et de configuration 105


Chapitre 7 : Configuration de Cognos 8

8. 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
Manager actif par défaut.
9. 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.
10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
11. Si vous utilisez Tomcat, dans le menu Opérations, cliquez sur 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é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.
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
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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
composants d'application.
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
Chapitre 7 : Configuration de Cognos 8

• 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.
4. Dans la fenêtre Explorateur, dans la section Sécurité, Cryptographie, cliquez sur l'option
Cognos, fournisseur cryptographique implicite.
5. 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
Manager actif par défaut.
6. 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.
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.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
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 :

Guide d'installation et de configuration 107


Chapitre 7 : Configuration de Cognos 8

• 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.

Procédure avec une bibliothèque d'indicateurs existante


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 l'option Mettre à niveau.
L'assistant met à niveau les schémas et autres informations de la base de données.
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, reportez-vous au Guide d'admi-
nistration et de sécurité.

108
Chapitre 7 : Configuration de Cognos 8

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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.

Guide d'installation et de configuration 109


Chapitre 7 : Configuration de Cognos 8

• Pour faire appel à un serveur Web Apache, utilisez la syntaxe suivante :


Pour le module Apache 1,3,
http://nom_hôte:port/cognos8/cgi-bin/mod_cognos.dll
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.
7. 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
Manager actif par défaut.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
1. Démarrez Cognos Configuration.
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
Chapitre 7 : Configuration de Cognos 8

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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
1. Démarrez le service Cognos 8.
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.
7. Cliquez sur le bouton OK.
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.

Guide d'installation et de configuration 111


Chapitre 7 : Configuration de Cognos 8

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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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
Chapitre 7 : Configuration de Cognos 8

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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
1. Démarrez le service Cognos 8.
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.
8. Cliquez sur le bouton OK.

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.

Guide d'installation et de configuration 113


Chapitre 7 : Configuration de Cognos 8

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


1. Démarrez Cognos Configuration.
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.
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.

Procédure pour Framework Manager


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.

114
Chapitre 7 : Configuration de Cognos 8

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.

Procédure pour Metric Designer


1. Démarrez le service Cognos 8.
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

Guide d'installation et de configuration 115


Chapitre 7 : Configuration de Cognos 8

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
Chapitre 7 : Configuration de Cognos 8

Procédure
1. Démarrez Cognos Configuration.
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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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


1. Démarrez Cognos Configuration.

Guide d'installation et de configuration 117


Chapitre 7 : Configuration de Cognos 8

2. Dans la fenêtre Explorateur, dans la section Sécurité, cliquez sur l'option Cryptographie.
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
5. Le test du fournisseur cryptographique doit être effectué sur une passerelle uniquement. Dans
la 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


1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, dans la section Sécurité, Cryptographie, cliquez sur l'option
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
Chapitre 7 : Configuration de Cognos 8

3. Dans le menu Fichier, cliquez sur l'option Enregistrer.


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.
• Cliquez sur le bouton OK.

Guide d'installation et de configuration 119


Chapitre 7 : Configuration de Cognos 8

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
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 7 : Configuration de Cognos 8

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
1. Démarrez Cognos Configuration.
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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
1. Démarrez Cognos Configuration.
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.

Guide d'installation et de configuration 121


Chapitre 7 : Configuration de Cognos 8

7. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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.
6. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.

122
Chapitre 7 : Configuration de Cognos 8

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 (;).
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
4. Cliquez sur le bouton Ajouter.
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.
9. Cliquez sur le bouton OK.
10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
À 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
1. Démarrez Cognos Configuration sur chaque ordinateur Content Manager.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.

Guide d'installation et de configuration 123


Chapitre 7 : Configuration de Cognos 8

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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
6. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 7 : Configuration de Cognos 8

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.

Guide d'installation et de configuration 125


Chapitre 7 : Configuration de Cognos 8

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
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, cliquez sur l'option Environnement.
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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 7 : Configuration de Cognos 8

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 :
• Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -E -T -r fichier_destination -k emplacement_c8/configura-
tion/signkeypair/jCAKeystore -p mot_de_passe
• Sous Windows, saisissez
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 :
• Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -T -i -r fichier_certificat_autorité_de_certification -k
emplacement_c8/configuration/signkeypair/jCAKeystore -p mot_de_passe
• Sous Windows, saisissez
ThirdPartyCertificateTool.bat -T -i -r fichier_certificat_autorité_de_certification -k
emplacement_c8\configuration\signkeypair\jCAKeystore -p mot_de_passe

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.

Guide d'installation et de configuration 127


Chapitre 7 : Configuration de Cognos 8

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
1. Démarrez Cognos Configuration.
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.
5. Cliquez sur le bouton OK.
6. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 7 : Configuration de Cognos 8

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.

Procédure pour Oracle


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.

Guide d'installation et de configuration 129


Chapitre 7 : Configuration de Cognos 8

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
Chapitre 7 : Configuration de Cognos 8

• 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.
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>
• 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.
11. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.

Guide d'installation et de configuration 131


Chapitre 7 : Configuration de Cognos 8

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
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 Langues du produit.
4. Cliquez sur le bouton Ajouter.
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.
7. Cliquez sur le bouton OK.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.

Personnalisation de la prise en charge de la monnaie


Si vous souhaitez disposer de monnaies 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
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 Monnaies.
4. Cliquez sur le bouton Ajouter.

132
Chapitre 7 : Configuration de Cognos 8

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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
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 Paramètres régionaux (contenu).
4. Cliquez sur le bouton Ajouter.
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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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.

Guide d'installation et de configuration 133


Chapitre 7 : Configuration de Cognos 8

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
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 Correspondances des paramètres régionaux (contenu).
4. Cliquez sur le bouton Ajouter.
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
Chapitre 7 : Configuration de Cognos 8

• 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.
8. Cliquez sur le bouton OK.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

Mise en correspondance des langues du produit


Utilisez la table Correspondance des langues du produit pour indiquer la langue 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
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 Correspondance des langues du produit.
4. Cliquez sur le bouton Ajouter.
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.
8. Cliquez sur le bouton OK.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

Guide d'installation et de configuration 135


Chapitre 7 : Configuration de Cognos 8

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
1. Démarrez Cognos Configuration.
2. Dans le menu Opérations, cliquez sur l'option Modifier la configuration globale.
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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
1. Démarrez Cognos Configuration.
2. Dans le menu Opérations, cliquez sur l'option Modifier la configuration globale.
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.
6. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 7 : Configuration de Cognos 8

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
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 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.
5. Cliquez sur le bouton OK.

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.

Guide d'installation et de configuration 137


Chapitre 7 : Configuration de Cognos 8

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
Chapitre 7 : Configuration de Cognos 8

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.

Guide d'installation et de configuration 139


Chapitre 7 : Configuration de Cognos 8

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>
<!--Should the Gateway URL decode incoming cookies?
Use 'true' if you're running
Java System or iPlanet or
Sun ONE Web Server and 'false' otherwise.-->
<param-name>urldecodeCookies</param-name>
<!--"true" or "false" -->
<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é.
7. Enregistrez la configuration.
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
Chapitre 7 : Configuration de Cognos 8

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.

Guide d'installation et de configuration 141


Chapitre 7 : Configuration de Cognos 8

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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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é.

Guide d'installation et de configuration 143


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
Chapitre 8 : Configuration de Cognos Office Connection

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.
5. Cliquez sur Terminer.

Guide d'installation et de configuration 145


Chapitre 8 : Configuration de Cognos Office Connection

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
1. Démarrez Cognos Configuration sur chaque ordinateur où est installé Content Manager.
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 8 : Configuration de Cognos Office Connection

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.

Guide d'installation et de configuration 147


Chapitre 8 : Configuration de Cognos Office Connection

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
Chapitre 8 : Configuration de Cognos Office Connection

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
d'installation et de
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
d'installation et de
configuration.

Guide d'installation et de configuration 149


Chapitre 8 : Configuration de Cognos Office Connection

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
Chapitre 8 : Configuration de Cognos Office Connection

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.

Guide d'installation et de configuration 151


Chapitre 8 : Configuration de Cognos Office Connection

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.
10. Cliquez sur Terminer.
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
Chapitre 8 : Configuration de Cognos Office Connection

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.

Guide d'installation et de configuration 153


Chapitre 8 : Configuration de 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.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
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.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.
❑ 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'.

Guide d'installation et de configuration 155


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.
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
1. Démarrez Cognos Configuration.
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, vérifiez que l'option Autoriser les connexions anonymes a la valeur
Faux.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
5. Répétez les étapes 1 à 4 sur tous les serveurs sur lesquels les composants de Cognos 8 sont ins-
tallés.

156
Chapitre 9 : Configuration de Cognos Portal Services

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.

Guide d'installation et de configuration 157


Chapitre 9 : Configuration de Cognos Portal Services

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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
5. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Exemple pour une passerelle de type CGI :
http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/port-
lets/sdk?wsdl&b_action=cps.wsdl

158
Chapitre 9 : Configuration de Cognos Portal Services

Exemple pour une passerelle de type servlet :


http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
• Pour les portlets de liste de surveillance de Metrics Manager
URI_passerelle/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type CGI :
http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/port-
lets/cmm?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type servlet :
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl

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
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
Exemple pour une passerelle de type CGI :
http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/port-
lets/sdk?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type servlet :
http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
• Pour les portlets de liste de surveillance de Metrics Manager
URI_passerelle/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type CGI :
http://monserveur/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/port-
lets/cmm?wsdl&b_action=cps.wsdl
Exemple pour une passerelle de type servlet :
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl

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 :

Guide d'installation et de configuration 159


Chapitre 9 : Configuration de Cognos Portal Services

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
Chapitre 9 : Configuration de Cognos Portal Services

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.
Pour en savoir davantage, reportez-vous à la documentation de votre serveur Web.
3. 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.
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")})

Guide d'installation et de configuration 161


Chapitre 9 : Configuration de Cognos Portal Services

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.
Pour en savoir davantage, reportez-vous au manuel SAP Enterprise Portal Administration
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.
Pour en savoir davantage, reportez-vous au manuel SAP Enterprise Portal Administration
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
en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

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
en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

162
Chapitre 9 : Configuration de Cognos Portal Services

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
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.
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.
Pour en savoir davantage, reportez-vous à la documentation de votre serveur Web.
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

Guide d'installation et de configuration 163


Chapitre 9 : Configuration de Cognos Portal Services

• 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

Guide d'installation et de configuration 165


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
1. Démarrez Cognos Configuration sur chaque ordinateur Content Manager.
2. Dans la fenêtre Explorateur, dans la section Sécurité, Authentification, cliquez sur l'option
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

Procédure
1. Démarrez Cognos Configuration sur chaque ordinateur Content Manager.
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 ?.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.

Guide d'installation et de configuration 167


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

• 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.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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
1. Sur chaque ordinateur sur lequel vous avez installé Content Manager, démarrez Cognos Con-
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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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é.
8. Cliquez sur le bouton OK.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
1. Sur chaque ordinateur sur lequel vous avez installé Content Manager, démarrez Cognos Con-
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, indiquez la propriété Hôte et port :

Guide d'installation et de configuration 169


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

• 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

7. Cliquez sur le bouton OK.


8. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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


composants de Cognos 8
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


1. Sur chaque ordinateur sur lequel vous avez installé Content Manager, démarrez Cognos Con-
figuration.
2. Dans la section Sécurité, Authentification de la fenêtre Explorateur, cliquez sur l'espace-noms
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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

5. Dans la colonne Nom, saisissez singleSignonOption


6. Dans la colonne Valeur, saisissez IdentityMapping
7. Cliquez sur le bouton OK.
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
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.

Guide d'installation et de configuration 171


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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.

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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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]*/

Guide d'installation et de configuration 173


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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é


Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
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
1. Sur chaque ordinateur sur lequel vous avez installé Content Manager, démarrez Cognos Con-
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.
3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification.
4. Dans la liste Type, cliquez sur l'option Fournisseur Java personnalisé, puis sur le bouton OK.
Le nouveau fournisseur d'authentification s'affiche dans la 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.
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.
7. Dans le menu Fichier, cliquez sur l'option Enregistrer.
8. 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é.

Configuration des composants de Cognos 8 pour LDAP


Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
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.

Guide d'installation et de configuration 175


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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


Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
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
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. 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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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é.

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
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.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe deux-points
(:).
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. Pour la propriété Identificateur unique, il est recommandé de saisir
objectGuid
8. 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.
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.

Guide d'installation et de configuration 177


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

Mises en
correspondance Propriété LDAP Valeur LDAP
Dossier Classe d'objets « organizationalunit,organizatio

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.
10. Dans le menu Fichier, cliquez sur l'option Enregistrer.
11. 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é.

178
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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
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 LDAP, puis sur le bouton OK.
Le nouvel espace-noms 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.
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 l'espace-noms d'authentification existant.
7. Si, lors de recherches, le fournisseur d'authentification LDAP doit établir une liaison avec le
serveur d'annuaire à l'aide d'une option Lier le nom unique et le mot de passe de l'utilisateur
spécifique, indiquez ces valeurs.
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
correspondance Propriété LDAP Valeur LDAP
Dossier Classe d'objets organizationalunit,organization

Description description

Nom ou,o

Groupe Classe d'objets groupofnames

Description description

Member member

Nom cn

Compte Classe d'objets organizationalperson

Téléphone professionnel telephonenumber

Paramètres régionaux du (ne pas saisir de valeur)


contenu

Description description

Courrier électronique (ne pas saisir de valeur)

Télécopieur/téléphone facsimiletelephonenumber

Guide d'installation et de configuration 179


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

Mises en
correspondance Propriété LDAP Valeur LDAP
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.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
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 LDAP, puis sur le bouton OK.
Le nouvel espace-noms 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é Identificateurd'espace-noms, indiquez un identifi-
cateur unique pour l'espace-noms.
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 l'espace-noms d'authentification existant.
Pour la propriété Fichier de référence d'utilisateur, indiquez (cn=${userID})
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.
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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

Mises en
correspondance Propriété LDAP Valeur LDAP
Dossier Classe d'objets organizationalunit,organization

Description description

Nom ou,o

Groupe Classe d'objets groupofnames

Description description

Member member

Nom cn

Compte Classe d'objets inetorgperson

Téléphone professionnel telephonenumber

Paramètres régionaux du contenu preferredlanguage

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 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.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

Guide d'installation et de configuration 181


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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


composants de Cognos 8
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
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 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é.
8. Cliquez sur le bouton OK.
9. Dans le menu Fichier, cliquez sur l'option Enregistrer.

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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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.

Guide d'installation et de configuration 183


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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
1. Sur l'ordinateur où vous avez installé Content Manager, démarrez Cognos Configuration.
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.
3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification.
4. Dans la liste Type, cliquez sur l'espace-noms SiteMinder de Netegrity, puis sur le bouton OK.
Le nouveau fournisseur d'authentification s'affiche dans la 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.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe deux-points
(:).
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. 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.
13. Dans le menu Fichier, cliquez sur l'option Enregistrer.
14. 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.
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).

Guide d'installation et de configuration 185


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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


Vous pouvez configurer les composants de Cognos 8 de façon à ce qu'ils utilisent un espace-noms
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
1. Sur l'ordinateur où vous avez installé Content Manager, démarrez Cognos Configuration.
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.
3. Dans la zone Nom, saisissez le nom de votre espace-noms d'authentification.
4. Dans la liste Type, cliquez sur l'option NTLM, puis sur le bouton OK.
Le nouveau fournisseur d'authentification s'affiche dans la 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.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe
deux-points (:).

186
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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. Dans le menu Fichier, cliquez sur l'option Enregistrer.
8. 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é.

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.
4. 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é.

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.

Objet d'autorisation Zone Valeur


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

Guide d'installation et de configuration 187


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

Objet d'autorisation Zone Valeur


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.

Objet d'autorisation Zone Valeur


S_RFC Activité 16
Contrôle d'autorisation pour
l'accès RFC

RFC_NAME PRGN_J2EE, SHSS, SOA3

Type d'objet RFC à protéger FUGR

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
1. Sur l'ordinateur où vous avez installé Content Manager, démarrez Cognos Configuration.
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 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 SAP, puis sur le bouton OK.
Le nouveau fournisseur d'authentification s'affiche dans la fenêtre Explorateur, sous le com-
posant Authentification.

188
Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'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.
Conseil : La propriété Identificateur d'espace-noms ne doit pas contenir de signe deux-points
(:).
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.
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.
8. Dans le menu Fichier, cliquez sur l'option Enregistrer.
9. 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.

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é.

Guide d'installation et de configuration 189


Chapitre 10 : Configuration des composants de Cognos 8 pour un fournisseur d'authentification

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
1. Sur l'ordinateur où vous avez installé Content Manager, démarrez Cognos Configuration.
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.
4. Dans le menu Fichier, cliquez sur l'option Enregistrer.
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).

Guide d'installation et de configuration 191


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
Chapitre 11 : Changement de serveur d'application

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.

Guide d'installation et de configuration 193


Chapitre 11 : Changement de serveur d'application

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
Chapitre 11 : Changement de serveur d'application

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.
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.

Guide d'installation et de configuration 195


Chapitre 11 : Changement de serveur d'application

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 la passerelle
• 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.
5. Enregistrez la configuration.
Les nouvelles clés cryptographiques sont créées à l'aide de la machine virtuelle Java définie par
la variable JAVA_HOME.

196
Chapitre 11 : Changement de serveur d'application

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

Guide d'installation et de configuration 197


Chapitre 11 : Changement de serveur d'application

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
votre environnement.
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
7. Enregistrez et fermez le fichier.

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.
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 512 Mo) comme
valeurs de départ. Vous pourrez toujours les modifier plus tard en fonction des besoins de
votre environnement.
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.
4. Enregistrez et fermez le fichier.

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.
4. Définissez la mémoire utilisée par la machine virtuelle Java.

198
Chapitre 11 : Changement de serveur d'application

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.
Conseil : Utilisez entre 25 et 50 % de votre mémoire physique (soit au moins 512 Mo) comme
valeurs de départ. Vous pourrez toujours les modifier plus tard en fonction des besoins de
votre environnement.
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
En général, la mémoire est définie en ajoutant ou en modifiant les deux paramètres JVM:
-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.

Guide d'installation et de configuration 199


Chapitre 11 : Changement de serveur d'application

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.
11. 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 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.
9. 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 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
Chapitre 11 : Changement de serveur d'application

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.
6. Définissez la mémoire utilisée par la machine virtuelle Java.
Suivez les instructions fournies par SAP. Pour en savoir davantage, consultez la note
SAP 723909 dans le portail de support SAP.
Si votre ordinateur dispose de moins de 1,5 Go de 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.
2. Définissez la 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 512 Mo) comme
valeurs de départ. Vous pourrez toujours les modifier plus tard en fonction des besoins de
votre environnement.
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.

Guide d'installation et de configuration 201


Chapitre 11 : Changement de serveur d'application

7. 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.

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
Chapitre 11 : Changement de serveur d'application

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
1. Démarrez Cognos 8.
2. Importez l'intégralité de la base de données Content Store à l'aide de l'outil Déploiement
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

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 :

Guide d'installation et de configuration 203


Chapitre 11 : Changement de serveur d'application

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
composants de Cognos 8.

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

4. Enregistrez et fermez le fichier.

Guide d'installation et de configuration 205


Chapitre 12 : Options de configuration avancées

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
Chapitre 12 : Options de configuration avancées

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.
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.

Guide d'installation et de configuration 207


Chapitre 12 : Options de configuration avancées

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.
5. Démarrez Cognos Configuration.
6. Enregistrez la configuration.
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.
Pour en savoir davantage, reportez-vous au Guide d'administration et de sécurité.

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
Chapitre 12 : Options de configuration avancées

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

Guide d'installation et de configuration 209


Chapitre 12 : Options de configuration avancées

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
Sous Windows, saisissez
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 :
Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MaSociété,C=CA" -r encryptRe-
quest.csr -D ../configuration/encryptkeypair/jEncKeystore -p mot_de_passe
Sous Windows, saisissez
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 :
Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D ../configuration/signkeypair/jSign-
Keystore -p mot_de_passe -t ca.cer
Sous Windows, saisissez
ThirdPartyCertificateTool.bat-i -s -r signCertificate.cer -D ../configuration/signkeypair/jSign-
Keystore -p mot_de_passe -t ca.cer

210
Chapitre 12 : Options de configuration avancées

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 :
Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D ../configuration/encryptkey-
pair/jEncKeystore -p mot_de_passe -t ca.cer
Sous Windows, saisissez
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:
Sous UNIX ou Linux, saisissez
ThirdPartyCertificateTool.sh -T -i -r ca.cer -D ../configuration/signkeypair/jCAKeystore -p
mot_de_passe
Sous Windows, saisissez
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
1. Démarrez Cognos Configuration.
2. Dans la fenêtre Explorateur, dans la section Sécurité, Cryptographie, cliquez sur l'option
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

Guide d'installation et de configuration 211


Chapitre 12 : Options de configuration avancées

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


5. Dans le menu Fichier, cliquez sur l'option Enregistrer.
6. Pour démarrer le service Cognos 8, dans le menu Opérations, cliquez sur l'option 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é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.

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-